`alive`

Output list of nodes (QNX)

Syntax:

alive [-aehv] [-c columns]

alive -u

Options:

-a: Show all nodes (alive normally stops after the last non-masked node).
-c columns: Display nodes in columns columns (default is 6).
-e: Don't show masked nodes in the list (overrides the -a option).
-f: Force an attempt to talk to all nodes, even those currently marked as down in qnx_net_alive() list.
-h: Horizontal (i.e. in rows) format
-u: Show only "Up" nodes, and display node numbers only. Nodes are displayed in a single column.
-v: Vertical (i.e. in columns) format. (default)

The alive utility outputs a list of nodes, and the status for each, to standard output. By default, the list is in table form (nodes are listed in columns). A node can be in one of the following states:

If a node is:	It means that the node:
Up	is up and that `alive` was able to create a virtual circuit (VC) to its `Proc` manager.
Down	isn't up, isn't running QNX 4, or is marked as "down" in the qnx_net_alive() list. See Caveat.
Mask	has been masked using the `netmap` utility. Normally, this is an Arcnet node that runs DOS or QNX, for which an attempt to create a virtual circuit would result in a timeout.

Examples:

Show the status of all nodes, up to the last non-masked node:

alive

For every node alive on the network, put a list of its serial ports into the file allser:

alive -u | xargs -in1 ls -l //{}/dev/ser\* >allser

Files:

The alive utility writes the alive list to standard output. Any errors that occur will result in diagnostic messages to standard error. Standard input is not used.

Exit status:

0: Successful completion.
>0: An error occurred.

Caveats:

The alive utility will communicate only with the nodes present in the Network manager's node-mapping table, and which are listed in the qnx_net_alive() list which is maintained by the name locators. The name locator can be fooled if the name locators have not been correctly distributed on the network (see nameloc). In this case, the -f option can be specified to force alive to make an attempt to talk to every node.