1LPATTACH(2)                    LAM LOCAL LIBRARY                   LPATTACH(2)
2
3
4

NAME

6       lpattach,  lpdetach  - Attach, detach a LAM process from remote process
7       management.
8

SYNOPSIS

10       int lpattach (char *name);
11       int lpdetach (int pid, int status);
12

DESCRIPTION

14       Remote process management allows a process to be selected by other pro‐
15       cesses  throughout  the multicomputer for control or monitoring in such
16       functions as rpdoom(2), rpstate(2) and rpspawn(2).
17
18       The name argument helps identify the process.  It is useful  to  choose
19       the  program  name,  as  found in argv[0], for this argument.  The name
20       will be seen in the output of  the  state(1)  command.   lpattach()  is
21       called by kenter(2) and is not typically called directly.
22
23       The  function  lpdetach()  makes  a  LAM process inaccessible to remote
24       process management and should be called just prior to process  termina‐
25       tion.   The  status  argument  is an exit code.  If a parent process is
26       waiting for the calling process to terminate, lpdetach() will pass  the
27       termination  status  back  to  the  parent.   lpdetach()  is  called by
28       kexit(2) and is not typically called directly.
29
30       The pid argument makes it possible for one process  to  remove  another
31       from  remote  process  management.   This  is  intended as an emergency
32       clean-up measure.  The normal value for this argument is 0, which indi‐
33       cates the action is to be taken on the calling process.
34

ERRORS

36       ENOPDESCRIPTORS     The remote process descriptor table is full.
37
38       ENOTPROCESS         The  process whose process identifier was passed to
39                           lpdetach() is not currently being managed.
40

SEE ALSO

42       rpdoom(2), rpstate(2)
43
44
45
46LAM 7.1.2                         March, 2006                      LPATTACH(2)
Impressum