NAME¶
imcrc - IMC scheme configuration commands file
DESCRIPTION¶
IMC scheme configuration commands are passed to
ipnadmin either in a file
of text lines or interactively at
ipnadmin's command prompt (:).
Commands are interpreted line-by line, with exactly one command per line.
IMC scheme configuration commands simply establish which nodes are the local
node's parents and children within a single IMC multicast tree. This single
spanning tree, an overlay on a single BP-based network, is used to convey all
multicast group membership assertions and cancellations in the network, for
all groups. Each node privately tracks which of its immediate
"relatives" in the tree are members of which multicast groups and on
this basis selectively forwards -- directly, to all (and only) interested
relatives -- the bundles destined for the members of each group.
Note that all of a node's immediate relatives in the multicast tree
must
be among its immediate neighbors in the underlying network. This is because
multicast bundles can only be correctly forwarded within the tree if each
forwarding node knows the identity of the relative that passed the bundle to
it, so that the bundle is not passed back to that relative creating a routing
loop. The identity of that prior forwarding node can only be known if the
forwarding node was a neighbor, because no prior forwarding node (aside from
the source) other than the immediate proximate (neighboring) sender of a
received bundle is ever known.
IMC group IDs are unsigned integers, just as IPN node IDs are unsigned integers.
The members of a group are nodes identified by node number, and the multicast
tree parent and children of a node are neighboring nodes identified by node
number.
The formats and effects of the IMC scheme configuration commands are described
below.
GENERAL COMMANDS¶
- ?
- The help command. This will display a listing of the commands and
their formats. It is the same as the h command.
- #
- Comment line. Lines beginning with # are not interpreted.
- e { 1 | 0 }
- Echo control. Setting echo to 1 causes all output printed by ipnadmin to
be logged as well as sent to stdout. Setting echo to 0 disables this
behavior.
- h
- The help command. This will display a listing of the commands and
their formats. It is the same as the ? command.
KINSHIP COMMANDS¶
- a node_nbr { 1 | 0 }
- The add kin command. This command adds the neighboring node
identified by node_nbr as an immediate relative of the local node.
The Boolean value that follows the node number indicates whether or not
this node is the local node's parent within the tree.
- c node_nbr { 1 | 0 }
- The change kin command. This command changes the parentage status
of the indicated relative according to Boolean value that follows the node
number, as noted for the add kin command.
- d node_nbr
- The delete kin command. This command deletes the immediate
multicast tree relative identified by node_nbr. That node still
exists but it is no longer a parent or child of the local node.
- i node_nbr
- This command will print information (the parentage switch) for the
multicast tree relative identified by node_nbr.
- l
- This command lists all of the local node's multicast tree relatives,
indicating which one is its parent in the tree.
EXAMPLES¶
- a 983 1
- Declares that 983 is the local node's parent in the network's multicast
tree.
SEE ALSO¶
imcadmin(1)