atmarp(8)atmarp(8)NAMEatmarp - Creates ATM Logical IP Subnet (LIS) interface, configures the
ATM Address Resolution Protocol (ARP) module, and configures and dis‐
plays the ATM ARP table
SYNOPSIS
/usr/sbin/atmarp hostname
/usr/sbin/atmarp -a
/usr/sbin/atmarp -c lis=lis_number driver=driver_name [atm_address]
/usr/sbin/atmarp -d [lis=lis_number] hostname
/usr/sbin/atmarp -h [lis=lis_number]
/usr/sbin/atmarp -h lis=lis_number server
/usr/sbin/atmarp -h lis=lis_number client atm_address ip_address
[retry_time]
/usr/sbin/atmarp -r lis=lis_number
/usr/sbin/atmarp -s [lis=lis_number] atm_address ip_address [perma‐
nent]
/usr/sbin/atmarp -v [lis=lis_number] +|-vc vpi_number vci_number host‐
name
OPTIONS
Displays all entries in the ATM Address Resolution Protocol (ARP) ta‐
ble. Creates a Logical IP Subnet (LIS) interface on the driver speci‐
fied. If you do not specify an ATM address, the IP convergence module
selects an ATM address for the LIS interface.
If the local host is connected to an ATM switch that does not
support the Interim Local Management Interface (ILMI) protocol,
and you are using SVCs, you must provide atm_address. Deletes
the entry for hostname from the ATM ARP table.
You can also specify a LIS number. If you do not specify a LIS
number, the command uses LIS 0 (the default), and deletes all
entries with the IP address of hostname. Displays the configu‐
ration information for the local host on the logical IP subnet
(LIS). A host on the LIS can be either an ARP server or client.
You can also specify a LIS number. If you do not specify a LIS
number, the configuration information for all LISs is displayed.
Configures the local host on the specified LIS as an ATM ARP
server. You must specify an LIS number. Configures the local
host on the specified LIS as an ATM ARP client. You must spec‐
ify the following arguments: Specifies the LIS number you want
to configure. Specifies the ATM End System Address (AESA) of
the ATM ARP server. This can be either the host name as it
appears in the /etc/atmhosts file or a 40-digit AESA with selec‐
tor byte. Specifies the IP address of the ATM ARP server. This
can be either the host name as it appears in the /etc/hosts file
or a numeric IP address in standard dot notation. If the ATM
ARP server does not have an IP address, enter the value 0.0.0.0.
You can also specify a retry_time value. If the client cannot
establish a connection with a server, this is the amount of time
(in seconds) that the client waits before trying to establish a
connection.
If you do not specify a retry_time value, the client randomly
selects a value between 0 and 60 seconds. Reads the local ATM
address, IP address, and ATM ARP configuration type on the spec‐
ified LIS. You must specify an LIS number. Creates an
atm_address entry for ip_address in the ATM ARP table. You must
specify the following arguments: Specifies the ATM address for
the entry. This can be either the host name as it appears in the
/etc/atmhosts file or a 40-digit AESA with selector byte. For
PVCs, enter the PVC host name or 40 hexadecimal zeros (0). See
atmhosts(4) for more information. Specifies the IP address for
the corresponding ATM address. This can be either the host name
as it appears in the /etc/hosts file or a numeric IP address in
standard dot notation.
You can also specify a LIS number. If you do not specify a LIS
number, the entry applies to LIS 0.
You can also specify the permanent argument. This creates an
ATM ARP table entry that is not subject to the RFC 1577 aging
rules. Creates (+) or removes (-) an association between an
established virtual circuit (VC), either switched virtual cir‐
cuit (SVC) or permanent virtual circuit (PVC), and a remote IP
entity that does not support classical IP. You must specify the
following arguments: Specifies the virtual path identifier (VPI)
for the virtual circuit. Specifies the virtual channel identi‐
fier (VCI) for the virtual circuit. Specifies the hostname
assigned to the ARP entry.
You can also specify a LIS number. If you do not specify a LIS
number, the association applies to LIS 0.
In order to associate an established VC with a remote IP entity,
the ATM address entry must be marked as permanent, by using the
atmarp-s command, and there must be an InARP request pending on
that VC. See the Description section for information on InARP
requests.
Specifying the atmarp command with only the hostname parameter displays
the ARP entry for hostname.
DESCRIPTION
The atmarp command creates a logical IP subnet (LIS) interface over the
ATM network. You can create multiple LIS interfaces on an ATM driver.
Hosts connected to ATM communicate directly to other hosts within the
same LIS. All members of a LIS have the same IP network/subnet number
and address mask. Communication to hosts outside of the local LIS is
provided via an IP router. For more information on ATM LIS see
RFC1577.
If you do not specify an ATM address when creating a LIS interface, the
IP convergence module selects an End System Identifier (ESI) and a
selector byte, which it registers with the ATM switch.
If your local switch does not support dynamic address registration, you
can specify an ATM address. In this case, the ATM address should be a
full 20-byte ATM address (19-byte prefix and ESI) already registered
with the switch and an unused selector byte. To create and register an
ESI uses atmconfig command.
The atmarp command also configures the ATM ARP module to operate in
either client or server mode.
In client mode, ATM ARP makes a connection to the ATM ARP server and
sends all ARP resolution requests to the server. To configure ATM ARP
clients, you must supply both the ATM address and IP address of the ATM
ARP server. This is the full 20-byte ATM End System Address (AESA).
Both these values are required for the client to contact the server.
In server mode, ATM ARP accepts connections from all ATM ARP clients on
the LIS and determines both their ATM and IP addresses to build a table
that is used to map IP addresses to ATM addresses. When functioning as
a server, ATM ARP will accept ARP resolution requests from all clients
on the LIS. See RFC 1577 for a description of the function of the ARP
server. To configure an ATM ARP server, you only need to inform the
ATM ARP module that it will be functioning as a server. No other data
is required. As a result of server configuration, the server's full
20-byte AESA is displayed. Hosts on the LIS use this address when the
are configured as ATM ARP clients.
The atmarp command also enables you to read the local ATM address, IP
address, and the ATM ARP configuration type (ATM ARP server or ATM ARP
client) on a specified LIS.
In addition, the atmarp command enables you to create and delete
entries in the ATM ARP table, display entries in the ATM ARP table,
toggle the permanent option for entries, to display the local host's
ATM configuration status, and to create and remove an association
between an established VC and a remote IP entity that does not support
classical IP.
In creating an association between an established VC (PVC or SVC) and a
remote IP entity, the ATM ARP entry must be marked as permanent and
there must be an InARP request pending on that VC. An InARP request on
a VC is considered pending in the following cases: A system administra‐
tor establishes a PVC and the local host issues an InARP request on the
PVC to establish the identity of the remote node. A remote system
establishes an SVC for use with IP. The local host issues an InARP
request on the SVC to determine the identity on the remote end of the
SVC.
In either case, if the remote system does not support RFC 1577, the
local host never receives a response to the InARP request, leaving the
request pending.
EXAMPLES
To create LIS 0 on driver lta0, enter: # atmarp-c lis=0 driver=lta0 To
display the local host's ATM ARP configuration information on LIS 0,
enter: # atmarp-h lis=0 Host has been configured as a CLIENT on lis0.
Server ATM address: arpserver \
(3900000000000000000000000088002b802e5000) Server IP address: atm3
(130.142.128.3) To configure the local host on LIS 0 as a client using
host3 as a server and specify a retry time of 32 seconds, enter: #
atmarp-h lis=0 client host3 host3 32 This host is now a CLIENT on
lis0. Connect retry value is : 32 seconds To read the local ATM
address, IP address and ATM ARP configuration type on LIS 0, enter: #
atmarp-r lis=0 LIS 0 has been configured as an ARP client IP address:
130.142.128.20 ATM address: 3900000000000000000000000088002b8020d000 To
display the ATM ARP entry for host central, enter: # atmarp central IP
Address : central (130.142.128.4) ATM Address :
3900000000000000000000000088002b2235b000 Flags : Complete VCs :
vpi vci VC Type
-------------
0 34 SVC To display the entire ATM ARP table,
enter: # atmarp-a
Number of entries : 3
IP Address : office1 (130.142.128.8) ATM Address :
3900000000000000000000000088002b802e5001 Flags : Complete VCs :
vpi vci VC Type
-------------
0 35 SVC
IP Address : central (130.142.128.4) ATM Address :
3900000000000000000000000088002b2235b000 Flags : Complete Stale
VCs : vpi vci VC Type
-------------
0 34 SVC
IP Address : office2 (130.142.128.2) ATM Address : office2
(3900000000000000000000000088002b33aab000) Flags : Complete VCs
: vpi vci VC Type
-------------
0 33 SVC To display the local host's ATM ARP
configuration information, enter: # atmarp-h Host has been configured
as a CLIENT on lis0. Server ATM address: arpserver \
(3900000000000000000000000008002b2241703a) Server IP address: atm3
(130.142.128.3) To create an ATM ARP table entry and enable the perma‐
nent option, enter: # atmarp-s
3900000000000000000000000088002b33aab000 \ 130.142.128.2 permanent IP
Address : host1 (130.142.128.2) ATM Address : host1
(3900000000000000000000000088002b33aab000) Flags : Complete Per‐
manent VCs : None. To associate a PVC with a VPI of 0 and a
VCI of 345 with the entry for host1, enter: # atmarp-v +vc 0 345 host1
IP Address : host1 (130.142.128.2) ATM Address : host1
(3900000000000000000000000088002b33aab000) Flags : Complete Per‐
manent VCs : vpi vci VC Type
-------------
0 345 PVC
SEE ALSO
Files: atmhosts(4), hosts(4)atmarp(8)