 |
Index for
Section 8 |
|
 |
Alphabetical
listing for A |
|
 |
Bottom of
page |
|
atmarp(8)
NAME
atmarp - Creates ATM Logical IP Subnet (LIS) interface, configures the ATM
Address Resolution Protocol (ARP) module, and configures and displays 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 [permanent]
/usr/sbin/atmarp -v [lis=lis_number] +|-vc vpi_number vci_number hostname
OPTIONS
-a Displays all entries in the ATM Address Resolution Protocol (ARP)
table.
-c lis=lis_number driver=driver_name [atm_address]
Creates a Logical IP Subnet (LIS) interface on the driver specified.
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.
-d [lis=lis_number] hostname
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.
-h [lis=lis_number]
Displays the configuration 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.
-h lis=lis_number server
Configures the local host on the specified LIS as an ATM ARP server.
You must specify an LIS number.
-h lis=lis_number client atm_address ip_address [retry_time]
Configures the local host on the specified LIS as an ATM ARP client.
You must specify the following arguments:
lis=lis_number
Specifies the LIS number you want to configure.
atm_address
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 selector byte.
ip_address
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.
-r lis=lis_number
Reads the local ATM address, IP address, and ATM ARP configuration type
on the specified LIS. You must specify an LIS number.
-s [lis=lis_number] atm_address ip_address [permanent]
Creates an atm_address entry for ip_address in the ATM ARP table. You
must specify the following arguments:
atm_address
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.
ip_address
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.
-v [lis=lis_number] +|- vpi_number vci_number hostname
Creates (+) or removes (-) an association between an established
virtual circuit (VC), either switched virtual circuit (SVC) or
permanent virtual circuit (PVC), and a remote IP entity that does not
support classical IP. You must specify the following arguments:
vpi_number
Specifies the virtual path identifier (VPI) for the virtual
circuit.
vci_number
Specifies the virtual channel identifier (VCI) for the virtual
circuit.
hostname
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 administrator 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
1. To create LIS 0 on driver lta0, enter:
# atmarp -c lis=0 driver=lta0
2. 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)
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
4. 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
5. 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
6. 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
7. 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)
8. To create an ATM ARP table entry and enable the permanent option,
enter:
# atmarp -s 3900000000000000000000000088002b33aab000 \
130.142.128.2 permanent
IP Address : host1 (130.142.128.2)
ATM Address : host1 (3900000000000000000000000088002b33aab000)
Flags : Complete Permanent
VCs : None.
9. 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 Permanent
VCs : vpi vci VC Type
--- --- -------
0 345 PVC
SEE ALSO
Files: atmhosts(4), hosts(4)
|
Index for
Section 8 |
|
|
Alphabetical
listing for A |
|
 |
Top of
page |
|