1RPSTATE(2) LAM REMOTE LIBRARY RPSTATE(2)
2
3
4
6 rpstate - Report status of LAM processes on a remote node.
7
9 #include <preq.h>
10
11 int rpstate(int node, int sflags, int svalue, struct pstate *stat_tab,
12 int maxsize);
13
15 node target node where selected processes are running
16
17 sflags selection method
18
19 svalue selection matching value, if required, otherwise ignored
20
21 stat_tab array of remote process status structures (output)
22
23 maxsize size of stat_tab array
24
26 Selection Methods
27 Processes to be reported from the target node are selected by one of
28 several methods, chosen in the sflags argument. The selection method
29 codes are defined in <preq.h>.
30
31 SELECT_PID Select by process ID. The svalue argument contains
32 the process ID.
33
34 SELECT_INDEX Select by process table index. The svalue argument
35 contains the index.
36
37 SELECT_APPL Select all application (user) processes.
38
39 SELECT_SYS Select all system processes.
40
41 SELECT_ALL Select all application and all system processes.
42
43 Remote Process Status
44 The status structure array, stat_tab, is filled with information on the
45 selected processes. The structure is defined in <preq.h>.
46
47 struct pstate {
48 int ps_reply;
49 int ps_index;
50 int ps_pid;
51 int ps_rtf;
52 int ps_nodeid;
53 int ps_event;
54 struct kstatus ps_kernel;
55 char ps_name[PSMAXNAME];
56 char ps_loadpt[PSMAXNAME];
57 };
58
59 ps_reply internal use by rpstate()
60
61 ps_index index within target node
62
63 ps_pid identifier within target node
64
65 ps_rtf runtime flags, see rploadgo(2)
66
67 ps_nodeid parent's node identifier
68
69 ps_event parent's event for reporting process's exit
70
71 ps_kernel kernel status, see kstate(2)
72
73 ps_name argv[0], usually the program name, see kenter(2)
74
75 ps_loadpt load module filename
76
78 Upon successful completion, the number of selected processes is
79 returned. This could be more or less than maxsize. If an error
80 occurred, -1 is returned and the global variable errno is set to indi‐
81 cate the error.
82
84 kstate(2), rploadgo(2)
85
86
87
88LAM 7.1.2 March, 2006 RPSTATE(2)