atmarp man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

atmarp(8)							     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 -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  [perma‐
       nent]

       /usr/sbin/atmarp -v  [lis=lis_number] +|-vc vpi_number vci_number host‐
       name

OPTIONS
       Displays all entries in the ATM Address Resolution Protocol  (ARP)  ta‐
       ble.   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  configu‐
	      ration  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
	      appears in the /etc/atmhosts file or a 40-digit AESA with selec‐
	      tor 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 spec‐
	      ified  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 cir‐
	      cuit (SVC) or permanent 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 identi‐
	      fier (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 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 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
       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
       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 enable the	perma‐
       nent	    option,	    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 Per‐
       manent VCs :	     vpi    vci	   VC Type
		      ---    ---    -------
		       0     345     PVC

SEE ALSO
       Files: atmhosts(4), hosts(4)

								     atmarp(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net