NAME
atmarp - manipulate Internet to ATM address mappings
SYNOPSIS
atmarp [-N] hostname
atmarp [-N] -a
atmarp -d hostname
atmarp -f
atmarp -s hostname device vpi vci aal [encapsulation] [peak]
atmarp -l device vpi vci aal [decapsulation]
atmarp -x device vpi vci
atmarp -c hostname device vpi vci revalidate [peak]
atmarp -r hostname
atmarp -m device vpi vci aal [encapsulation] [peak]
atmarp -u
atmarp -n NSAPaddress device
atmarp -z device
atmarp -o hostname NSAPaddress device
atmarp -p NSAPaddress device
atmarp -g device
atmarp -t device
atmarp -v device
DESCRIPTION
The atmarp program displays and deletes Internet-to-ATM
address translation table entries used by the ATM address
resolution protocol. It also allows IP traffic to particu-
lar destinations to be routed over Permanent Virtual Cir-
cuits (PVCs). This functionality is only needed for special
applications which may require the use of PVCs for IP
traffic. This program does not actually control the crea-
tion of the PVCs.
If the single argument hostname is given, the ATM ARP entry
for hostname is displayed. When used with the -N flag, the
network address is displayed in numerical form. When the -N
flag is not specified, both the symbolic and numerical forms
are displayed.
OPTIONS
-a Display all of the current ATM ARP table
entries. When used with -N flag, the network
address is displayed in numerical form. When
- N flag is not specified, both the symbolic
and numerical forms are displayed.
-d Delete address mapping for specified host-
name from the ATM ARP table. If an ATM con-
nection is open to the specified host then
the connection is closed.
-f Delete all dynamic address mappings from the
ATM ARP table and close all Switched Virtual
Channels (SVCs) to all hosts in the table.
-s Set ARP entry for outgoing Permanent Virtual
Channel (PVC). All traffic to hostname will
be encapsulated based on encapsulation and
sent via the device interface on VPI vpi, VCI
vci, using AAL type aal. device must be one
which supports SPANS signaling (e.g. fa0).
Specifying peak will limit all traffic to
hostname to peak kilobits per second. If
peak is not specified, no rate control is
applied.
-l Attach IP to an incoming PVC. All traffic
received on the interface device with VPI
vpi, VCI vci, and AAL type aal will be decap-
sulated based upon decapsulation and handed
over to IP. device must be one which sup-
ports SPANS signaling (e.g. fa0).
-x Detach IP from an incoming SVC or PVC. IP
traffic will no longer be accepted on the
specified VPI and VCI.
-c Set ARP entry for RFC 1577 (Classical IP)
Permanent Virtual Channel (PVC). Also attach
IP to this PVC. All traffic to hostname will
be sent via the device interface on VPI vpi,
VCI vci, using AAL type 5. device must be one
which supports Q.2931 signaling (e.g. qaa0).
Specifying peak will limit all traffic to
hostname to peak kilobits per second. If
peak is not specified, no rate control is
applied. The entry will be revalidated by
sending an InARP request over the PVC at 15
minute intervals if revalidate is non-zero.
To disable this feature, use 0 for the
revalidate parameter.
-r Remove ARP entry for RFC 1577 (Classical IP)
Permanent Virtual Channel (PVC). Also detach
IP from this PVC. IP traffic will no longer
be accepted on VPI/VCI associated with this
entry.
-m Set IP multicast default outgoing PVC. All
traffic destined for an IP multicast address
not found in the ARP table will be encapsu-
lated based on encapsulation and sent via the
device interface on VPI vpi, VCI vci, using
AAL type aal. Specifying peak will limit all
traffic to hostname to peak kilobits per
second. If peak is not specified, no rate
control is applied.
-u Remove IP multicast default outgoing PVC.
All traffic destined for an IP multicast
address not found in the ARP table will be
sent over a multicast SVC, if one can be
created to the appropriate multicast group.
-n Configure the NSAP address for device dev-
ice. The NSAP address is specified as 40 hex-
adecimal characters, with or without a lead-
ing 0x and interspersed dots (e.g.
0x0102030405060708090a0b0c0d0e0f1011121314).
-z Display the NSAP address for device device.
device must be one which supports Q.2931 sig-
naling (e.g. qaa0).
-o Add an NSAP-address-to-IP-address mapping to
the ARP table. The NSAP address is specified
as 40 hexadecimal characters, with or without
a leading 0x and interspersed dots (e.g.
0x01.0203.04.050607.0809.0a0b.0c0d.0e0f10111213.14).
This creates a single ARP entry for hostname
and is used to connect to hosts which do not
support ARP.
-p Set the ARP server's NSAP address for the
device device. The NSAP address is specified
as 40 hexadecimal characters, with or without
a leading 0x and interspersed dots (e.g.
01.0203.04.050607.0809.0a0b.0c0d.0e0f10111213.14).
-g Get the ARP server address that has been
configured for the device device.
-t Tell whether or not we are the ARP server
for device's IP subnet.
-v Display ARP Server connection information
for the device device. This information is
useful for debugging. It includes the VPVC
over which we are communicating with the ARP
Server, the number of times we have unsuc-
cessfully attempted to connect to the ARP
Server, whether or not we are in the process
of connecting to the ARP Server (meaning we
have sent a SETUP but have not yet received a
CONNECT or a RELEASE COMPLETE), and the
number of Inverse ARP packets we have sent.
device must be one which supports Q.2931 sig-
naling (e.g. qaa0).
RESTRICTIONS
Currently vpi must be zero (0) and vci must be less than
1024 for all incoming PVCs. aal must be one of 3, 4, or 5.
encapsulation and decapsulation must be either NULL (no
encapsulation or decapsulation performed) or LLC (IEEE LLC
encapsulation and decapsulation performed).
NOTES
The peak rate is based on the 48 byte payload of an ATM
cell. The maximum data rate at the ATM Adaptation Layer for
100 Mb TAXI is 87.3 Mb/sec, 122.2 Mb/sec for 140 Mb TAXI,
and 135.6 Mb/sec for SONET-OC3. This rate is limited by Phy-
sical Layer, ATM Layer, and Adaptation Layer overhead. Rate
control is only available on FORE 200-series adapters.
Attempts to use this optional parameter with 100-series
adapters will result in an error.
EXAMPLE
The following example displays the address mapping for host-
name piranha1. An ATM address is comprised of the ATM switch
identifier and port number. The host may be specified by
name or by number, using Internet dot notation.
example% atmarp piranha1
fa0: piranha1 (192.135.217.1): vpi.vci=0.32 aal=5
switch.port=f1150ab4.6
flags=() encapsulation=NULL peak rate=10000
SEE ALSO
arp(8C), cport(8C), cpath(8C), cchan(8C)