IPTUNNEL(8)

🎀 IPTUNNEL(8) 🎀

Okay bestie, this is the manual page for iptunnel, the System Manager's Manual entry that teaches you how to make, change, delete and peek at IP tunnels 🦋✨

✨ 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 🦋

Okay so iptunnel is literally the tool you use to add, change, delete and show IP tunnels on your machine. It's giving main character energy 👑

🌸 OPTIONS 🌸

• help — Pulls up the help text 🧚
• show — Lists all the IP tunnels that already exist 👀
• { add | change | del } [ NAME ] — Picks the action you want (add, change, or delete) and aims it at the tunnel called NAME, which has to be a string 💅 You gotta pick exactly one action, no cap.
• mode PROTOCOL — Chooses the PROTOCOL for the tunnel 🌈 It can be ipip for TCP/IP, gre for Cisco GRE tunnels (RFCs 1701 and 1702), or sit for IPv6-in-IPv4 tunneling.
• remote ADDR — Sets the remote (aka destination) address of the tunnel 📍 ADDR has to be an IP address or the word any.
• local ADDR — Sets the local (aka source) address of the tunnel 🏠 ADDR has to be an IP address or the word any.
• iseq — Requires that every incoming packet is serialized 🔢 Only works for GRE tunnels.
• oseq — Turns on serialization (sequencing) for every outgoing packet 🍓 Only works for GRE tunnels.
• ikey KEY — Sets the input key for the Cisco GRE tunnel 🔑 KEY can be a dotted quad (dotted decimal) or a number. Only works for GRE tunnels.
• okey KEY — Literally the same as ikey, except it sets the output key instead 🔁 Only works for GRE tunnels.
• icsum — Requires every incoming packet to have the correct checksum ✅ Only works for GRE tunnels.
• ocsum — Calculates checksums for every outgoing packet 🧮 Only works for GRE tunnels.
• ttl TTL — Sets the Time-To-Live value for the tunnel ⏳ TTL has to be a number from 1 to 255, or the word inherit, which copies the field over from the original IP header.
• tos TOS — Sets the Type-Of-Service value for the tunnel 🎯 TOS has to be a number from 1 to 255, or the word inherit, which copies the field over from the original IP header.
• nopmtudisc — Turns off Path MTU Discovery on this tunnel 🙅‍♀️ Heads up: a fixed ttl doesn't play nice with this option.
• dev PHYS_DEV — Binds 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. Share the love, but keep it free 🌈

Bestie, that's the whole tea ☕💜 This page is from February 2018, version 1.60, so go slay your tunnels responsibly 🦋✨