atmarp(8) [freebsd man page]
ATMARP(8) Maintenance Commands ATMARP(8) NAME
atmarp - administer classical IP over ATM connections SYNOPSIS
atmarp -a atmarp -c [[atm]number] atmarp -q ip_addr [qos qos] [sndbuf bytes] atmarp -s ip_addr [itf.]vpi.vci [qos qos] [sndbuf bytes] [temp] [pub] [null] atmarp -s ip_addr atm_addr [qos qos] [sndbuf bytes] [temp] [pub] [arpsrv] atmarp -d ip_addr [arpsrv] atmarp -V DESCRIPTION
atmarp is used to maintain the ATMARP table of the ATMARP demon. The table can be listed, new PVC and SVC entries can be added, and exist- ing entries can be deleted. In addition to that, atmarp is also used to create new IP over ATM interfaces. Note that the kernel has its own ATMARP table containing only entries for destinations to which a connection exists. The table of atmarpd can also contain currently unused entries. OPTIONS
-a list the current ATMARP table. -c create the specified IP interface. If the interface number is omitted, the operating system assigns the next free number and atmarp prints the resulting interface name (e.g. `atm0') on standard output. -q sets the QOS and the send buffer size to use as the default for all VCs generated for that IP network (ip_addr must be the address of the network). -s set up a PVC or create an SVC entry. The following options are recognized: qos qos uses the specified quality of service (see qos(7) for the syntax). UBR at link speed is used by default. sndbuf bytes tries to set the send buffer to the specified number of bytes. A system default value is used if sndbuf is not specified. temp does not mark the entry as permanent, i.e. it will time out and then be removed. pub publishes the entry (only relevant for ATMARP server). ATMARP requests for entries not marked for publishing yield an ATMARP_NAK response. null uses NULL encapsulation instead of LLC/SNAP encapsulation on the PVC. This option is not available for SVCs, because the LLC/SNAP header is required to identify ATMARP packets. null also implies that the entry is permanent. arpsrv identifies the entry pointing to the ATMARP server. Note that the node acting as the ATMARP server must have no ATMARP server entry in its ATMARP table. -d delete the specified ARP entry. In order to prevent accidental deletion of the ATMARP server entry, the arpsrv flag must be speci- fied when deleting it. -V print the version number of atmarp on standard output and exit. FILES
/var/run/atmarpd.table ATMARP table AUTHOR
Werner Almesberger, EPFL ICA <Werner.Almesberger@epfl.ch> SEE ALSO
atmarpd(8), clip(8), qos(7) Linux April 26, 2000 ATMARP(8)
Check Out this Related Man Page
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 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
Displays all entries in the ATM Address Resolution Protocol (ARP) table. 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 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 specify 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 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. Reads the local ATM address, IP address, and ATM ARP configuration type on the specified 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 circuit (SVC) or per- manent 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 identifier (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 net- work/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 reg- ister 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 admin- istrator 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 dis- play 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 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. 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 : Com- plete Permanent VCs : vpi vci VC Type --- --- ------- 0 345 PVC SEE ALSO
Files: atmhosts(4), hosts(4) atmarp(8)