NAME
rfio_popen, rfio_pclose - start a process and open a pipe to it
SYNOPSIS
#include <sys/types.h>
#include "rfio_api.h"
FILE *rfio_popen (const char *command, const char *type);
int rfio_pclose (FILE *fs);
DESCRIPTION
rfio_popen starts a process and opens a pipe to it.
command is a pointer to a string specifying the shell command to be
executed.
type is a mode indicator for the pipe. One of the characters "r" or
"w".
rfio_pclose waits for the forked process to terminate and returns the
exit status of the command.
EXAMPLE
int c;
FILE *rf;
rf = rfio_popen (command, "r");
if (rf == NULL) {
rfio_perror ("rfio_popen");
exit (1);
}
while ((c = rfio_pread (buf, 1, sizeof(buf), rf)) > 0) {
...
}
c = rfio_pclose (rf);
RETURN VALUE
This routine returns NULL if the operation failed or a non-NULL pointer
to a FILE structure if the operation was successful. If it fails,
serrno variable is set appropriately.
ERRORS
ENOMEM Not enough memory.
EINVAL The mode provided is invalid.
ECONNRESET Connection reset by peer
ETIMEDOUT Connection timed out
ECONNREFUSED Connection refused
EHOSTUNREACH No route to host
SENOSHOST Host unknown.
SENOSSERV Service unknown.
SEUMSG2LONG Command string too long.
SECOMERR Communication error.
SEE ALSO
rfio_pread(3), rfio_pwrite(3)
AUTHOR
LCG Grid Deployment Team