IPTUNNEL(8)

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)'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.