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.

Description

Errors

    ESRCH The named process does not exist.

See Also

SrrNameAttach, SrrNameLocate