add(8) CLIX add(8)
NAME
add - Adds a static entry to the IP routing table
SYNOPSIS
add nodename NSAP_address SNPA_address [port]
FLAGS
nodename This is the hostname of the remote system to be added to
the routing table.
NSAP_address Network service access point (NSAP) address (Type 1 or 2)
of the remote system. Only hexadecimal digits are
accepted. Do not punctuate the NSAP address with spaces,
periods, or other characters.
SNPA_Address SNPA address of the remote system (if the system is on the
same subnetwork) or of the first intermediate system (if
the system is on a different subnetwork than the local
system) in the path to the remote system. The SNPA address
consists of 7 bytes. The first six bytes identify the MAC
address; the seventh specifies the LSAP address (always
fe). Only hexadecimal digits are accepted. Do not enter
spaces or other punctuation.
If you are adding a system reachable through a wide area
network (using a product such as the OSI/WAN transport
package), the SNPA is in X.121 format (up to 15 decimal
digits).
port An optional argument that specifies the MAC driver that is
attached to the subnetwork over which the remote system is
accessed. The port number of a MAC driver is specified in
the STREAMS configuration file.
If you are adding a system reachable over a wide area
network, specify the port number of the SNDCF driver. This
number is one higher than the port number of the last MAC
driver.
If you do not specify a port, it defaults to 0.
DESCRIPTION
The add utility allows you to add the addresses of remote systems to the
local IP routing table. When ES-IS routing exchange protocol is being
used, the user does not normally have to be aware of this table; it is
modified dynamically as remote systems go on- and off-line. However, this
protocol may not always be able to provide the necessary routing
2/94 - Intergraph Corporation 1
add(8) CLIX add(8)
information for all reachable systems (for example, systems that do not
use the ES-IS protocol). The add utility provides a means to enter the
routing information manually and update the /etc/hosts.osi file.
EXAMPLES
The following example illustrates adding an NSAP address and an SNPA
address of a host named foo to the local IP routing table:
add foo 47000400060001020701012b5501 0207010061B1fe
NOTES
This utility works only with systems having end system-intermediate system
(ES-IS) enabled.
DIAGNOSTICS
usage: add nodename dst snpa [port]
Cause: you entered the command line arguments incorrectly.
Action: reenter the command line making sure you enter at least
the correct nodename, destination NSAP address, and SNPA.
add: invalid NSAP-address length
Cause: the NSAP address you entered was too long or it contained
an odd number of characters.
Action: check the NSAP address and reenter the corrected command
line. The address must contain an even number of hexadecimal
characters (since a byte consists of two digits), and its length
must be 40 characters or less.
add: invalid SNPA-address length
Cause: the SNPA address contained the wrong number of characters.
Action: check the SNPA address and reenter the corrected command
line.
add: invalid hexadecimal character c in address
Cause: a character that was not a valid hexadecimal digit was
specified in either the NSAP or SNPA address.
Action: check the NSAP or SNPA address, and reenter the command
line. These addresses must contain only the characters 0 - 9 and a
- f (or A - F).
RELATED INFORMATION
Intergraph ISO/OSI Administrator's Guide
2 Intergraph Corporation - 2/94