LCNODE(1M) Domain/OS SysV LCNODE(1M)
NAME
lcnode - list nodes connected to the network
SYNOPSIS
/etc/lcnode [options]
DESCRIPTION
lcnode lists the nodes currently connected to the network. The list
contains the ID of every node connected, the time at which the node was
started, the current time, and the name of each node's entry directory.
This command reports only the nodes that respond within a preset time
limit. If a node is connected, but temporarily unable to respond within
the specified time, it does not appear in the produced list.
In Apollo Token Ring networks and IBM Token Ring (802.5) networks, lcnode
provides, by default, an ordered list of nodes. The order is based on
network topology: lcnode starts with your own node and lists other nodes
in the order in which the token touches them. Two-node (point-to-point)
networks (Chat and IIC) are, by definition, listed in order.
In 802.3 (Ethernet) networks, lcnode starts with your own node and lists
other nodes in an unpredictable order.
OPTIONS
-m[e] Request information about your node only. This option
displays the node ID.
-b[rief] Request brief output. lcnode lists only the entry
directory name for each connected node. Note that the
entry directory of a diskless node is the entry directory
of its paging partner.
-id When used with -brief, display the node ID in addition to
the entry directory.
-c[ount] Request node count only. lcnode lists only the number of
nodes responding to its query.
-max[nodes] n Set a limit on the number of nodes you want to see, even
if more could respond.
-from node_spec
Starts the node list at some node other than your own.
This is especially useful in an internet environment, for
looking at networks other than your own. See help
node_spec for details about node specification syntax.
-name When you specify the -brief option, lcnode normally prints
the entry directory for each node. If you specify -name
with -brief, lcnode prints the node name cataloged with
the naming server. Only diskless nodes are printed
differently. A diskless node's entry directory is its
partner's node name; a diskless node's node name is
uniquely its own.
Unless the -from option specifies your own node, the list
includes only an unbroken sequence of nodes running Aegis
SR9.0 or later. The rest of the node list is lost,
starting with the first node running a pre-SR9.0 Aegis.
-norder For ring networks: list nodes in an unpredictable order.
(Default mode for ring networks is ordered.) The -norder
option generally enables lcnode to run faster and more
reliably.
Note that for 802.3 (Ethernet) networks, lcnode runs in
"unordered" mode whether or not you specify -norder.
-r[igorous] This flag causes lcnode to produce the most accurate
listing possible of Apollo Token Ring topologies. With
this option, lcnode takes approximately 3 times as long to
complete as without it, but accuracy is dramatically
improved. The flag has no effect on other network types.
The -r option eliminates duplicate entries from lcnode
output.
EXAMPLES
1. $ /etc/lcnode
The node ID of this node is 21. 3 other nodes responded.
id Boot time Current time Entry Directory
21 1987/06/09 9:21:44 1987/06/09 16:06:22 //dollar
17 1987/06/09 13:52:02 1987/06/09 16:06:13 //quarter
27 1987/06/09 12:53:28 1987/06/09 16:06:07 //nickel
11 1987/06/09 12:03:39 1987/06/09 16:06:15 ** DISKLESS **
//diskless_$11 partner node: 17
2. $ /etc/lcnode -me
The node id of this node is 21.
3. $ /etc/lcnode -b
//dollar
//quarter
//nickel
//quarter
(//quarter appears once as the host for a diskless node and
once for the node with the disk.)
4. $ /etc/lcnode -b -name
//dollar
//quarter
//nickel
//diskless_$000011
(-name shows you the name under which diskless node 11
is cataloged)
5. $ /etc/lcnode -c
466 other nodes responded.
6. $ /etc/lcnode -c -b
466
7. $ /etc/lcnode -c -m
The node id of this node is 116A.
466 other nodes responded.
8. $ /etc/lcnode -b -id
21 //dollar
17 //quarter
27 //nickel
11 //quarter
9. $ /etc/lcnode -from 0FAD.3924 -max 2
Starting from node 3924.
1 other node responded,
but more might have responded with a high -max value.
Node id Boot time Current time Entry Directory
3924 1985/02/14 17:20:45 1985/02/14 19:07:04 //laurel
34Bf 1985/02/14 18:46:52 1985/02/14 19:08:09 //hardy
10. $ /etc/lcnode -norder -max 5
The node ID of this node is 26CF4.
4 other nodes responded in random order,
but more might have responded with a high -MAX value.
Node ID Boot time Current time Entry Directory
26CF4 1990/07/06 16:58:47 1990/07/17 11:28:59 //moon
15AE3 1990/07/10 21:56:05 1990/07/17 11:19:36 //star
12975 1990/05/09 11:50:09 1990/07/17 11:19:14 //planet
DD7E 1990/07/14 10:04:47 1990/07/17 11:29:58 //nova
1911C 1990/06/13 13:48:42 1990/07/17 11:35:29 //meteor
WARNINGS
?(lcnode) List may not be complete - unknown request type (OS/network)
indicates that lcnode may not have reported nodes running SR9.2 or
earlier versions of Domain system software.
SEE ALSO
More information is available. Type
help lcnet For information on listing connected networks in an
internet environment