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