1RPGO(2) LAM REMOTE LIBRARY RPGO(2)
2
3
4
6 rpgo - Create a LAM process on a remote node from tagged storage.
7
9 #include <kio.h>
10
11 int rpgo(int node, int loadtag, int flags, int argvtag, int *pid, int
12 *idx);
13
15 node where new process will be created
16
17 loadtag storage tag for program file
18
19 flags runtime flags passed to new process
20
21 argvtag storage tag for null-terminated array of strings to be
22 passed as command-line arguments to the new process
23
24 pid new process identifier (output)
25
26 idx new process index (output)
27
29 The executable program and the argument structure must already be
30 loaded on the target node via the "flat storage" service. The program
31 is typically loaded from a file with rload(2). The argument structure
32 is assumed to be packed contiguously: the null terminated array of
33 string pointers followed immediately by the strings themselves. It is
34 typically loaded to the target node with rflat(2). The storage tags,
35 loadtag and argvtag, are erased from the target node after the call to
36 rpgo().
37
38 See rploadgo(2) for valid process runtime flags.
39
41 EBADTAG Either or both of loadtag and argvtag are invalid.
42
43 ENOPDESCRIPTORS The remote process descriptor table is full.
44
45 ENOFLDESCRIPTORS The table of strorage blocks (kept by the flat dae‐
46 mon) is full.
47
49 rflat(2), rload(2), rploadgo(2), rpwait(2)
50
51
52
53LAM 7.1.2 March, 2006 RPGO(2)