Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

iptunnel(8)							  iptunnel(8)


  iptunnel - Creates, deletes, and displays configured tunnels


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


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

  The iptunnel command can perform one of the following	operations:

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

      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.

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

	  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

      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

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


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

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

   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 to

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

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

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

       Then, enter:
	    # iptunnel delete ipt5
	    interface ipt5 deleted


  Commands: ifconfig(8).

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