SrrNameLocate
SrrNameLocate — locates a process by name.
Syntax
#include <srripc.h>
pid_t SrrNameLocate( | nid_t | n, |
| | const char* | name, |
| | unsigned* | sz, |
| | unsigned* | copies); |
Arguments
- n
- The
node to search. If set to 0 the
local node is searched.
- name
- The name of the process to
locate.
- sz
- An
initial value for the size of the virtual circuit buffer,
if the name is on a different node.
This size will generally be the size of the largest
message. A value of 0 is possible,
since virtual circuits expand as needed.
- copies
- If any value other than
NULL is passed, this gets set to
1 if the name has been located,
and 0 if not.
Returns
On success, the ID of the process that attached the name. On failure, -1 and errno is set.
Errors
- ESRCH The named process does not exist.
