unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



atmarp(8)							    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 logi-
      cal 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 estab-
      lish 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 vir-
      tual 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 cir-
	  cuit.

      vci_number
	  Specifies the	virtual	channel	identifier (VCI) for the virtual cir-
	  cuit.

      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	con-
  figure 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)