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

NAME

6       rpstate - Report status of LAM processes on a remote node.
7

SYNOPSIS

9       #include <preq.h>
10
11       int  rpstate(int node, int sflags, int svalue, struct pstate *stat_tab,
12              int maxsize);
13

ARGUMENTS

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

DESCRIPTION

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

RETURN VALUE

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

SEE ALSO

84       kstate(2), rploadgo(2)
85
86
87
88LAM 7.1.2                         March, 2006                       RPSTATE(2)
Impressum