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)