10.4;ctnode (catalog_node), revision 2.0, 91/03/28
ctnode (catalog_node) - catalog a node in the network.
usage: ctnode {node_name [net.]node_id [-root] | -n [net.]node_id | -update}
[[-from //node... [-md|-ms]] [-on //node...]
[-r] [-l]
[-idupl]
DESCRIPTION
ctnode informs the local node that a remote node exists, thereby enabling
network file access to the remote node. The command catalogs the
node_name in the local copy of the network root directory as the entry
directory for the remote node. In other words, ctnode adds the directory
//node_name to your copy of the network root directory.
For information on deleting a node_name entry, type help uctnode.
We assign a node ID to every node during the manufacturing process. To
find out the node ID of a node, type the following command at its
keyboard:
$ lcnode -me
ctnode supports the ability to merge information from another node's
network root into your own, or any other node's network root. The merge
options (-md and -ms) add the entry for a node to the target, provided
the entry does not already exist and the source has exactly one entry for
that node. In the case of one source and one target entry that match for
a node, those entries are assumed to be correct. All other cases are
considered to be ambiguous and the "confusion-resolution protocol" is
invoked.
This "confusion-resolution protocol" first attempts to verify the correct
entry name with the node itself. If the node is available, the reply
from the node is cataloged regardless of whether -md or -ms is used
because an answer from the node itself is assumed to be the truth.
If the node is unavailable to resolve an ambiguity, the entry containing
the most recent UID (latest time stamp portion of the UID) is used. In
this case, existing entries in the target directory are only updated if
the -ms option is used. Multiple name/ID pairs are permitted.
If you do not specify -n, -update, or -from, the node_name and
net.node_id arguments are required.
node_name (optional)
Specify the name of the node you wish to catalog. If the
net.node_id argument is specified, then node_name is
required.
Default if omitted: you must use -n, -update, or -from
[net.]node_id (optional)
Specify the hexadecimal ID (and optional network ID) of
the node you wish to catalog. The node must be connected
to the network when this command is executed. If the
node_name argument is specified, then node_id or
[net].node_id is required.
Default if omitted: you must use -n, -update, or -from
Multiple name/ID pairs are permitted.
OPTIONS
If you do not specify -n, -update, or -from, the node_name and
[net.]node_id arguments are required. The -n, -update, and merge options
work only for remote nodes running Aegis SR5.0 or later. The
[net.]node_id forms work only when both the local and remote nodes run
Aegis SR9.0 or later.
-root Catalog node_name as the entry directory name for node_id
in both the master network root directory and the local
copy of the network root directory. This option is valid
only if the node_name and node_id arguments are
specified. This option is not valid if the -n option is
specified.
-n [net.]node_id...
Copy the entry directory name from the network root
directory of the specified remote node to the network
root directory of the local node. You do not need to
know the entry directory name. However, you must specify
the node_id or the net.node_id of the remote node.
Multiple node_id's and net.node_id's may be specified.
Use this option instead of the node_name net.node_id
argument pair. This option is not valid if the -r option
is specified.
-update Obtain a list of nodes currently responding to a network
inquiry and perform the same operation as -n for each
node. Names are replaced with the most current version,
if they already exist in your local copy of the network
root directory, and new names are added.
-from //node ...
Look in the specified list of network root directories
for the names to add to the target network root, or use
this network root as the source for names to merge into
the target network root. Wildcards may be used to
specify source node names. The -from option is not
supported in a Domain internet environment.
-md This option is used with -from. Merges all names in the
source network root into the target network root.
Preference is given to existing names in the target if
there are unresolved conflicts (see the discussion of
"confusion-resolution protocol" above).
-ms This option is the same as -md, except that preference is
given to entries in the source network root when there
are unresolved conflicts (see the discussion of
"confusion-resolution protocol" above).
-on //node ... Catalog names in the network root of the specified nodes
instead of the local network root. Wildcards may be used
to specify target node names. The -on option is not
supported in a Domain internet environment.
-r Replace cataloged names if they already exist. An error
occurs if you do not specify this option and try to add a
node_name that has already been cataloged (unless you are
using -update).
-l List node names as they are cataloged.
-idupl Ignore entry (suppress error messages) if name already
exists in the target.
Add the node whose ID is 21 and whose entry directory name is os to your
node's catalog:
$ /etc/ctnode os 21
Bring your node's catalog up to date with any new nodes on the network:
$ /etc/ctnode -update
Copy names os and eve from the network root on //master.
$ /etc/ctnode os eve -from //master
Add node ID 21 with the name os to the network root of all nodes whose
names begin with "a".
$ /etc/ctnode os 21 -on //a?*
Merge network root of os into local network root, resolving conflicts:
$ /etc/ctnode -md -from //os