*** UNIX MANUAL PAGE BROWSER ***

atmarp(8) System Manager's Manual atmarp(8) NAME atmarp - 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 -d hostname /usr/sbin/atmarp -c lis=lis_number driver=driver_name [atm_address] /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 -s atm_address ip_address [permanent] /usr/sbin/atmarp -v +|-vc vpi_number vci_number hostname /usr/sbin/atmarp -r lis=lis_number FLAGS Displays all entries in the ATM Address Resolution Protocol (ARP) ta- ble. Deletes the entry for hostname from the ATM ARP table. 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. 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. 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 ap- pears in the /etc/atmhosts file or a 40-digit AESA with selector 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. Creates an atm_ad- dress entry for ip_address in the ATM ARP table. You must spec- ify 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 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 es- tablished 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 fol- lowing 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 as- signed 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, 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. Reads the local ATM address, IP address, and ATM ARP configuration type on the specified LIS. You must specify an LIS number. 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 se- lector 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 ei- ther 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 en- tries in the ATM ARP table, display entries in the ATM ARP table, tog- gle 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 classi- cal 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 es- tablishes an SVC for use with IP. The local host issues an InARP re- quest 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 lo- cal 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 con- figuration 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 ad- dress, 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 ad- dress: 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 en- able the permanent flag, 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 Permanent VCs : vpi vci VC Type --- --- ------- 0 345 PVC RELATED INFORMATION Files: atmhosts(4), hosts(4). delim off atmarp(8)