c8198bd5f9
There is no "version 2" of the "Lesser" General Public License. It is either "GPL version 2.0" or "Lesser GPL version 2.1". This patch replaces all occurrences of "Lesser GPL version 2" with "Lesser GPL version 2.1" in comment section. Signed-off-by: Chetan Pant <chetan4windows@gmail.com> Acked-by: Daniel P. Berrangé <berrange@redhat.com> Message-Id: <20201014134033.14095-1-chetan4windows@gmail.com> Signed-off-by: Laurent Vivier <laurent@vivier.eu>
91 lines
2.7 KiB
C
91 lines
2.7 KiB
C
/*
|
|
* QEMU I/O channels external command driver
|
|
*
|
|
* Copyright (c) 2015 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#ifndef QIO_CHANNEL_COMMAND_H
|
|
#define QIO_CHANNEL_COMMAND_H
|
|
|
|
#include "io/channel.h"
|
|
#include "qom/object.h"
|
|
|
|
#define TYPE_QIO_CHANNEL_COMMAND "qio-channel-command"
|
|
OBJECT_DECLARE_SIMPLE_TYPE(QIOChannelCommand, QIO_CHANNEL_COMMAND)
|
|
|
|
|
|
|
|
/**
|
|
* QIOChannelCommand:
|
|
*
|
|
* The QIOChannelCommand class provides a channel implementation
|
|
* that can transport data with an externally running command
|
|
* via its stdio streams.
|
|
*/
|
|
|
|
struct QIOChannelCommand {
|
|
QIOChannel parent;
|
|
int writefd;
|
|
int readfd;
|
|
pid_t pid;
|
|
};
|
|
|
|
|
|
/**
|
|
* qio_channel_command_new_pid:
|
|
* @writefd: the FD connected to the command's stdin
|
|
* @readfd: the FD connected to the command's stdout
|
|
* @pid: the PID of the running child command
|
|
* @errp: pointer to a NULL-initialized error object
|
|
*
|
|
* Create a channel for performing I/O with the
|
|
* previously spawned command identified by @pid.
|
|
* The two file descriptors provide the connection
|
|
* to command's stdio streams, either one or which
|
|
* may be -1 to indicate that stream is not open.
|
|
*
|
|
* The channel will take ownership of the process
|
|
* @pid and will kill it when closing the channel.
|
|
* Similarly it will take responsibility for
|
|
* closing the file descriptors @writefd and @readfd.
|
|
*
|
|
* Returns: the command channel object, or NULL on error
|
|
*/
|
|
QIOChannelCommand *
|
|
qio_channel_command_new_pid(int writefd,
|
|
int readfd,
|
|
pid_t pid);
|
|
|
|
/**
|
|
* qio_channel_command_new_spawn:
|
|
* @argv: the NULL terminated list of command arguments
|
|
* @flags: the I/O mode, one of O_RDONLY, O_WRONLY, O_RDWR
|
|
* @errp: pointer to a NULL-initialized error object
|
|
*
|
|
* Create a channel for performing I/O with the
|
|
* command to be spawned with arguments @argv.
|
|
*
|
|
* Returns: the command channel object, or NULL on error
|
|
*/
|
|
QIOChannelCommand *
|
|
qio_channel_command_new_spawn(const char *const argv[],
|
|
int flags,
|
|
Error **errp);
|
|
|
|
|
|
#endif /* QIO_CHANNEL_COMMAND_H */
|