NAME¶
IV_POPEN_REQUEST_INIT, iv_popen_request_submit, iv_popen_request_close -
popen(3) for ivykis applications
SYNOPSIS¶
#include <iv_popen.h>
struct iv_popen_request {
char *file;
char **argv;
char *type;
};
void IV_POPEN_REQUEST_INIT(struct iv_popen_request *this);
int iv_popen_request_submit(struct iv_popen_request *this);
void iv_popen_request_close(struct iv_popen_request *this);
DESCRIPTION¶
iv_popen provides
ivykis(3) applications with an asynchronous
version of
popen(3) that is integrated with the ivykis event loop.
After initialising a
struct iv_popen_request object using
IV_POPEN_REQUEST_INIT and assigning its
->file and
->argv and
->type members, one can call
iv_popen_request_submit on it to fork off a child process which will
call
execvp(2) on
->file and
->argv, while in the
parent process returning a file descriptor that is connected to the child's
standard input (if
->type equals "w") or standard output
(if
->type equals "r").
When the application is done with the child process, it should call
iv_popen_request_close, and close the file descriptor returned by
iv_popen_request_submit (this is not done automatically).
iv_popen will continue to monitor the child's process state while it is
running, by registering an
iv_wait(3) interest for its process ID.
If the child process has not yet terminated when
iv_popen_request_close
is called,
iv_popen will attempt to terminate the child process in the
background by sending it a series of SIGTERM and SIGKILL signals.
iv_popen_request_close must be called from the same thread that
iv_popen_request_submit was called from on this object.
SEE ALSO¶
ivykis(3),
iv_wait(3),
execvp(2),
popen(3)