1RPSPAWN(2)                    LAM REMOTE LIBRARY                    RPSPAWN(2)
2
3
4

NAME

6       rpspawn - Spawn a LAM process onto a remote node.
7

SYNOPSIS

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

ARGUMENTS

15       src_node    source node where selected process are running
16
17       dest_node   destination node where new process will be spawned
18
19       sflags      method by which the existing  process  is  selected  -  See
20                   rpstate(2).
21
22       svalue      selection matching value, if required, otherwise ignored
23
24       argv        null-terminated  array  of strings to be passed as command-
25                   line arguments to the new process
26
27       pid         new process ID (output)
28
29       idx         new process index (output)
30

DESCRIPTION

32       When a process is spawned, the program is copied and  rerun  as  a  new
33       process.
34
35       If  argv  is  the  null  pointer, the program arguments of the original
36       process are used.
37
38       One and only one process is spawned by  rpspawn().   If  multiple  pro‐
39       cesses are selected, only one process is chosen.
40

ERRORS

42       ENOPDESCRIPTORS     The remote process descriptor table is full.
43
44       ENOFLDESCRIPTORS    The table of strorage blocks (kept by the flat dae‐
45                           mon) is full.
46
47       ENOTPROCESS         No matching process exists.
48
49       EINVAL              The selection method is invalid.
50

SEE ALSO

52       rpcreate(2), rploadgo(2)
53
54
55
56LAM 7.1.2                         March, 2006                       RPSPAWN(2)