Linux repositories inspector

iv_popen(3)

ivykis
2010-09-04
Aliases: iv_popen_request_close(3), iv_popen_request_close(3), IV_POPEN_REQUEST_INIT(3), IV_POPEN_REQUEST_INIT(3), iv_popen_request_submit(3), iv_popen_request_submit(3)

libivykis-dev

Development libraries, header files and docs for libivykis

ivykis-devel

Development files for the ivykis package

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

⇧ Top