rpspawn

Langue: en

Version: 59059 (mandriva - 22/10/07)

Section: 2 (Appels système)

NAME

rpspawn - Spawn a LAM process onto a remote node.

SYNOPSIS

#include <preq.h>
int rpspawn(int src_node, int dest_node, int sflags, int svalue, char **argv, int *pid, int *idx);

ARGUMENTS

src_node
source node where selected process are running
dest_node
destination node where new process will be spawned
sflags
method by which the existing process is selected - See rpstate(2).
svalue
selection matching value, if required, otherwise ignored
argv
null-terminated array of strings to be passed as command-line arguments to the new process
pid
new process ID (output)
idx
new process index (output)

DESCRIPTION

When a process is spawned, the program is copied and rerun as a new process.

If argv is the null pointer, the program arguments of the original process are used.

One and only one process is spawned by rpspawn(). If multiple processes are selected, only one process is chosen.

ERRORS

ENOPDESCRIPTORS
The remote process descriptor table is full.
ENOFLDESCRIPTORS
The table of strorage blocks (kept by the flat daemon) is full.
ENOTPROCESS
No matching process exists.
EINVAL
The selection method is invalid.

SEE ALSO

rpcreate(2), rploadgo(2)