# IPTUNNEL - Create and manage IP tunnels - man(8) - [phpMan]

[_IPTUNNEL_(8)](https://www.chedong.com/phpMan.php/man/IPTUNNEL/8/markdown)                            System Manager's Manual                           [_IPTUNNEL_(8)](https://www.chedong.com/phpMan.php/man/IPTUNNEL/8/markdown)

## NAME
       iptunnel - Create and manage IP tunnels


## SYNOPSIS
       **iptunnel **{ add | change | del | show } [ NAME ]
         [ mode { ipip | gre | sit } ] [ remote ADDR ] [ local ADDR ]
         [ [i|o]seq ] [ [i|o]key KEY ] [ [i|o]csum ]
         [ ttl TTL ] [ tos TOS ] [ nopmtudisc ] [ dev PHYS_DEV ]

       **iptunnel **-V | --version

       **Where**: NAME := STRING
              ADDR := { IP_ADDRESS | any }
              TOS  := { NUMBER | inherit }
              TTL  := { 1..255 | inherit }
              KEY  := { DOTTED_QUAD | NUMBER }


## DESCRIPTION
       **iptunnel **can be used to add, change, delete and show IP tunnels on the machine.


## OPTIONS
       **help   **Show the help text.


       **show   **List existing IP tunnels.


### { add | change | del } [ NAME ]
              Specify  an  action (**add**, **change **or **delete **an IP tunnel) to be executed by **iptunnel **on
              the tunnel named **NAME**, which must be a string.  You must specify one action.


### mode PROTOCOL
              Specify the **PROTOCOL **to be used for the IP tunnel.  It can be **ipip **for TCP/IP, **gre **for
              Cisco GRE tunnel (RFCs 1701 and 1702), or **sit **for IPv6-in-IPv4 tunneling.


### remote ADDR
              Set the remote (i.e., destination) address of the tunnel.  **ADDR **must be an IP  address
              or the word **any**.


### local ADDR
              Set the local (i.e., source) address of the tunnel.  **ADDR **must be an IP address or the
              word **any**.


       **iseq   **Require that all incoming packets are serialized.  Only applicable for **GRE **tunnels.


       **oseq   **Enable  serialization  (sequencing) for all outgoing packets.  Only applicable for **GRE**
              tunnels.


### ikey KEY
              Specify the input key for the Cisco GRE tunnel.  **KEY **must be  either  in  dotted  quad
              (dotted decimal) or a number.  Only applicable for **GRE **tunnels.


### okey KEY
              Same as **ikey**, but set the output key instead.  Only applicable for **GRE **tunnels.


       **icsum  **Require  that all incoming packets have the correct checksum.  Only applicable for **GRE**
              tunnels.


       **ocsum  **Calculate checksums for all outgoing packets.  Only applicable for **GRE **tunnels.


### ttl TTL
              Specify the **Time-To-Live **value for the IP tunnel.  **TTL **must be a value between  **1  **and
              **255**,  or  the  word  **inherit**, which causes the field to be copied from the original IP
              header.


### tos TOS
              Specify the **Type-Of-Service **value for the IP tunnel.  **TOS **must be a  value  between  **1**
              and **255**, or the word **inherit**, which causes the field to be copied from the original IP
              header.


### nopmtudisc
              Disable **Path MTU Discovery **on this tunnel.  Note that a fixed **ttl **is incompatible with
              this option.


### dev PHYS_DEV
              Bind the tunnel to the device **PHYS_DEV**.


## HOMEPAGE
### <<https://sourceforge.net/projects/net-tools/>>


## AUTHORS
       This  manpage was written by Sergio Durigan Junior <sergiodj (at) sergiodj (dot) net>.  A few
       parts were inspired by [**ip-tunnel(1)](https://www.chedong.com/phpMan.php/man/ip-tunnel/1/markdown)**'s manpage.


       Permission is granted to copy, distribute and/or modify this document under the terms of  the
       GNU  General  Public  License,  Version 2 or any later version published by the Free Software
       Foundation.

February 2018                               version 1.60                                 [_IPTUNNEL_(8)](https://www.chedong.com/phpMan.php/man/IPTUNNEL/8/markdown)