NAME

coprocv, coprocvp, coprocvpe, coprocs, coprocsp - execute a command in coprocessing mode

SYNOPSIS

#include <execs.h>

pid_t coprocv(const char *path, char *const argv[], int pipefd[2]);
pid_t coprocve(const char *path, char *const argv[],
char *const envp[], int pipefd[2]);
pid_t coprocvp(const char *file, char *const argv[], int pipefd[2]);
pid_t coprocvpe(const char *file, char *const argv[],
char *const envp[], int pipefd[2]);

pid_t coprocs(const char *path, const char *command, int pipefd[2]);
pid_t coprocse(const char *path, const char *command,
char *const envp[], int pipefd[2]);
pid_t coprocsp(const char *command, int pipefd[2]);
pid_t coprocspe(const char *command, char *const envp[],
int pipefd[2]);

These functions are provided by libexecs. Link with -lexecs.

DESCRIPTION

These functions run commands in coprocessing mode. They differs in the way to specify the executable file to run and its parameters. All of them define two pipes (by pipe(2)), create a new process by fork(2), redirect the standard input and output of the new process in the two pipes, and exec a program by one of the exec(3) functions.

The calling program controls both the standard input and the standard output of the called process: writing to pipefd[1] provides input to the coprocess while the coprocess output can be retrieved from pipefd[0].

coprocv, coprocve, coprocvp, coprocvpe, coprocs, coprocse, coprocsp, and coprocsp differ as they define the executable file to run and its arguments as execv, execve, execvp, execvpe, execs, execse, execsp, and execsp, respectively.

BUGS

Bug reports should be addressed to <info@virtualsquare.org>

AUTHOR

Renzo Davoli <renzo@cs.unibo.it>