NODE_SPEC Aegis NODE_SPEC
NAME
node_spec - Node Specification Syntax
DESCRIPTION
Node specifications permit a node's communications software to locate
other nodes in a local ring or in an internet. Typically, you use node
specifications when shell commands require them. lusr, netstat, lvolfs
are a few examples of shell commands that accept node specifications. On
nodes with SR9.0 or SR9.SATURN software, a node specification can be one
of the following:
- An internet address
- A node name
Internet Addresses
An internet address has the format:
[net].node_id
The 'net' represents a network number and the 'node_id' represents a
hexadecimal node ID. A network number of 0 refers to the local network.
If a node is cataloged (in either your local cache or the ns_helper
database), then you can omit the network number when you use an internet
address. If you provide only the node ID, the system will obtain the
network number from either your local cache or the ns_helper database. If
you provide a complete internet address, the system will attempt to
locate the node only on the network you specify. Thus, if you specify an
incorrect network number, the system will look for the node on the
network that you specify, and then report an error; the system will
@i[not] attempt to locate the node on another network.
If a node is not cataloged, the system cannot obtain a network number if
you provide only a node ID. In this case, the system assumes that the
node is on the local ring. Thus, for an uncataloged node on the local
network, you must provide the node ID, but the network number is
optional. However, you must provide both the network number and node ID
for an uncataloged node on a remote network.
Node Names
You can use a node name as a node specification only if the node is
cataloged (in either your local cache or the the ns_helper database.)
When you use a node name, the system obtains the internet address
associated with the name. If a node is not cataloged, you must use an
internet address to specify the node.
Note that both disked and diskless nodes can be cataloged and named.
EXAMPLES
The following examples illustrate ways you can specify a node with an ID
of A105, a name of //casey, and a network number of 4051237A. (These
examples assume that //casey is cataloged in the ns_helper database.)
Note that hex IDs that start with a letter must be preceded by a '0' for
the shell to parse them correctly.
1. $ lusr -n 0A105
2. $ lusr -n //casey
3. $ lusr -n 4051237A.A105
In addition, if you are using a node on ring 4051237A, you can use the
following internet address to refer to //casey:
4. $ lusr -n 0.A105 ('0' indicates the local network.)