NAME

atmarp − 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 −d ip_address

/usr/sbin/atmarp −h

/usr/sbin/atmarp −h server

/usr/sbin/atmarp −h client atm_address ip_address [retry_time]

/usr/sbin/atmarp −p hostname

/usr/sbin/atmarp −s atm_address ip_address [permanent]

/usr/sbin/atmarp −v +|-vc vpi_number vci_number hostname

FLAGS

−aDisplays all entries in the ATM Address Resolution Protocol (ARP) table. 

d ip_address
Deletes the entry for ip_address from the ATM ARP table. 

−hDisplays the configuration information for the local host on the logical IP subnet (LIS).  A host can be either a server or client. 

−h server
Configures the local host as an ATM ARP server.

−h client atm_address ip_address [retry_time]
Configures the local host as an ATM ARP client.  You must specify the following arguments:

atm_addressSpecifies the ATM address (full 20-byte NSAP) of the ATM ARP server.  This can be either the host name as it appears in the /etc/atmhosts file or a 40-digit ATM address with selector byte. 

ip_addressSpecifies 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. 

−p hostname
Toggles the permanent flag for the hostname entry in the ATM ARP table.  If the flag is present, issuing this command removes the flag.  If the flag is absent, issuing this command adds the flag to the entry.  You can also add the permanent flag when you create an ATM ARP table entry by using the atmarp −s command. 

−s 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_addressSpecifies the ATM address (full 20-byte NSAP) for the entry. 

ip_addressSpecifies the IP address for the corresponding ATM address. 

You can also specify the permanent argument.  This creates an ATM ARP table entry that is not subject to the RFC 1577 aging rules.  You can also use the atmarp −p command to toggle the ATM ARP entry’s permanent flag on and off. 

−v +|- 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_numberSpecifies the virtual path identifier (VPI) for the virtual circuit. 

vci_numberSpecifies the virtual channel identifier (VPI) for the virtual circuit. 

hostnameSpecifies the hostname assigned to the ARP entry. 

In order to associate an established VC with a remote IP entity, the ATM address entry must be marked as permanent, either using the atmarp −p hostname command or 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 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 (NSAP) ATM address.  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 (NSAP) ATM address is displayed.  Hosts on the LIS use this address when the are configured as ATM ARP clients. 

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 flag 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. 

RESTRICTIONS

Only a single LIS is currently supported. 

EXAMPLES

     1.To display the ATM ARP entry for host central, enter:

# atmarp central
IP Address :   central (130.142.128.4)
ATM Address :  3900000000000000000000000008002b2242083a
Flags :        Complete Stale
VCs :          vpi    vci    VC Type
               ---    ---    -------
               0      34     SVC

     2.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)

     3.To configure the local host host3 as a client and specify a retry time of 32 seconds, enter:

# atmarp −h client host3 host3 32
This host is now a CLIENT on lis0.
Connect retry value is : 32 seconds

     4.To display the entire ATM ARP table, enter:

# atmarp −a
Number of entries : 3
IP Address :   office1 (130.142.128.8)
ATM Address :  3900000000000000000000000008002b2240b83a
Flags :        Complete Stale
VCs :          vpi    vci    VC Type
               ---    ---    -------
               0      35     SVC
IP Address :   central (130.142.128.4)
ATM Address :  3900000000000000000000000008002b2242083a
Flags :        Complete Stale
VCs :          vpi    vci    VC Type
               ---    ---    -------
               0      34     SVC
IP Address :   office2 (130.142.128.2)
ATM Address :  office2 (3900000000000000000000000008002b2241083a)
Flags :        Complete
VCs :          vpi    vci    VC Type
               ---    ---    -------
               0      33     SVC

     5.To create a ATM ARP table entry and enable the permanent flag, enter:

# atmarp −s 130.142.128.2 \
3900000000000000000000000008002b2241083a permanent
IP Address :   host1 (130.142.128.2)
ATM Address :  host1 (3900000000000000000000000008002b2241083a)
Flags :        Complete Permanent
VCs :          None.

     6.To toggle the permanent flag for host host1’s ATM ARP table entry, enter:

# atmarp −p host1
IP Address :   host1 (130.142.128.2)
ATM Address :  host1 (3900000000000000000000000008002b2241083a)
Flags :        Complete
VCs :          None.

     7.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 (3900000000000000000000000008002b2241083a)
Flags :        Complete Permanent
VCs :          vpi    vci    VC Type
               ---    ---    -------
                0     345     PVC

RELATED INFORMATION

Files: atmhosts(4), hosts(4)