DragonFly On-Line Manual Pages

iv_popen(3)               ivykis programmer's manual               iv_popen(3)

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)

ivykis                            2010-09-04                       iv_popen(3)