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)