node_spec — Apollo



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. A
     node specification can be one of the following:

       -  A node ID

       -  A node name

     Node IDs

     A node ID has the format:

     [net.]node_id

     The net represents a Domain/OS network number and the node_id represents
     a hexadecimal node number.  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 a node ID.
     If you provide only the node number, the system will obtain the network
     number from either your local cache or the ns_helper database. If you
     provide a complete node ID, 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 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 number.  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 number, but the network number
     is optional.  However, you must provide both the network number and node
     number for an uncataloged node on a remote network.

     Node Names

     A node name has the format:

     //node_name

     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 Domain/OS internet
     address associated with the name.  If a node is not cataloged, you must
     use a node ID 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 a node
     number of A105, a name of //casey, and a network number of 4051237A.
     (These examples assume that //casey is cataloged in the ns_helper
     database.)

       1. $ lusr -n A105

       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.)


NOTES
     For some commands, you may specify a node with a pathname.  The node on
     which that file or directory resides will be the specified node.
Museum
