unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



iptunnel(8)							  iptunnel(8)



NAME

  iptunnel - Creates, deletes, and displays configured tunnels

SYNOPSIS

  /usr/sbin/iptunnel  [operation] [args]

DESCRIPTION

  The iptunnel command creates configured tunnels for sending and receiving
  IPV6 or IPV4 packets that are	encapsulated as	the payload of an IPV4
  datagram.

  The iptunnel command can perform one of the following	operations:

  create
      Creates a	tunnel interface, which	you must subsequently configure	by
      using the	ifconfig command. The syntax of	the create operation is	as
      follows:



      iptunnel create [-I int-name] [v4-dest] [v4-src]



      -I int-name
	  Specifies the	interface unit of the tunnel to	be created. This is
	  an optional parameter.  The int-name parameter has the following
	  form:	iptx, where x is the interface unit number. By default,	the
	  interface name selected for the tunnel is iptx+1, or the value of
	  the interface	unit number of the last	tunnel created plus 1.

      v4-dest
	  Specifies the	remote end-point to which a tunnel is to be created.

      v4-src
	  Sets the IPV4	source address in the encapsulating header.  The tun-
	  nel is enabled (packets are sent/received on the tunnel) only	if
	  v4-src is a valid address on the system.  This is an optional
	  parameter.

  delete
      Deletes a	tunnel interface.  You must disable the	tunnel before you can
      delete it	by executing the following command:
	   # ifconfig tunnel name down	delete abort

  show
      Shows the	tunnel attributes (name, tunnel	end points, next hop for tun-
      neled packets).



EXAMPLES

   1.  To create a tunnel from hobbes to calvin, enter:
	    # iptunnel create -I ipt5 calvin \
	    ipt5  iftype 208 src 16.140.16.86 dst 16.140.16.91


   2.  To display the tunnel attributes, enter:
	    # iptunnel show ipt5
	    interface ipt5 src 16.140.16.86 dst	16.140.16.91 gate 16.140.16.86

   3.  To configuring the tunnel to encapsulate	IPv6 packets, enter:
	    # ifconfig ipt5 ipv6 up

       IPv6 packets will be sent as payloads of	IPv4 datagrams from
       16.140.16.86 to 16.140.16.91.

       The tunnel may also be used to send IPV4	packets	encapsulated within
       IPV4 headers as follows:
	    # ifconfig ipt5 10.10.80.60	netmask	255.255.255.0

       To verify the previous command, enter:
	    # ifconfig ipt5
	    ipt5: flags=4c1<&lt;UP,RUNNING,NOARP,MULTICAST>&gt;
		 16.140.16.86 -->&gt; 16.140.16.91
		 rxmt 1000, reach time 30000, dad tries	1, mtu 1280, hops 64, token len	64
		 inet 10.10.80.60 netmask ffffff00  ipmtu 1280
		 inet6 fe80::108c:1056

   4.  To deleting the tunnel, enter:
	    # ifconfig ipt5 down delete	abort
	    ipt5: delete inet address 10.10.80.60
	    10.10.80.60: aborting 0 tcp	connection(s)

       Then, enter:
	    # iptunnel delete ipt5
	    interface ipt5 deleted



SEE ALSO

  Commands: ifconfig(8).

  RFC 2003, IP Encapsulation within IP,	Perkins, C., October 1996