qnx_name_nodes()

find a given name on all nodes

Synopsis:

#include <sys/name.h>

int qnx_name_nodes( pid_t vid,
                   char *name,
                   unsigned num,
                   nid_t *nids );

Description:

This function searches all nodes in the network for processes registered as name, and puts the node number of each node that has it into nids. The arguments are as follows:

vid: the ID of a virtual circuit to a name locator
name: the name you're looking for
num: the size of the nids array.
nids: an array of node IDs, to be filled in by the function

In contrast to qnx_name_locate(), which finds one occurrence of name, this function finds all occurrences, and lets the application determine which of them to use.

Returns:

The number of nodes found with the given name.

Classification:

QNX

Safety:
Interrupt handler	No
Signal handler	Yes
Thread	Yes

See also:

qnx_name_locate(), qnx_name_attach(), qnx_name_detach(), qnx_name_query(), nameloc utility

"Process symbolic names" in the Process Manager chapter of the QNX System Architecture guide