GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  IV_POPEN_REQUEST_CLOSE (3)

NAME

IV_POPEN_REQUEST_INIT, iv_popen_request_submit, iv_popen_request_close - popen(3) for ivykis applications

CONTENTS

Synopsis
Description

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)
Search for    or go to Top of page |  Section 3 |  Main Index


ivykis IV_POPEN (3) 2010-09-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.