Index Index for
Section 8
Index Alphabetical
listing for I
Bottom of page Bottom of
page		 

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
	  tunnel 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
      tunneled 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<UP,RUNNING,NOARP,MULTICAST>
		 16.140.16.86 --> 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

Index Index for
Section 8
Index Alphabetical
listing for I
Top of page Top of
page