TUNNELIT(8)

NAME
tunnelit-p2p - Tunnel Ethernet links over TCP or UDP

SYNOPSIS
tunnelit-p2p [ -VFhluo ] [-p port] [-H host] [-d devname] [-f tunpath] [-t keepalive]

DESCRIPTION
tunnelit-p2p is a utility to tunnel Ethernet links over a TCP or a UDP socket. This is done by creating a local interface (using the TUN/TAP driver) on two systems that can reach each other over TCP or UDP, and forwarding whatever is received by one to the other. It is intentionally simple, and has no authentication or encryption. The same client program is used on both the sender and the receiver.

OPTIONS
-V
    Print version and exit
-F
    Run in foreground, the default behavior is to background after creating the TUN/TAP interface.
-h
    Print usage information and exit in success.
-l
    Be a listener, the default action is to connect to a remote host
-u
    Use a UDP socket instead of a TCP socket. This option implies the -o option.
-o
    Only allow one host to connect to our listener. It is generally a good idea to only have one host connect to a listener for bandwidth reasons. Anything received by one socket is transmitted to all connected sockets.
-p port
    Specify the port to connect to the remote host (specified using the -H option) on, or to listen on if the -l option was specified. The default is 656.
-H host
    Specify the host to connect to. Can be either a DNS name or an IP address. This option is required unless the -l option is specified.
-d devname
    Specify the local TUN/TAP device name to create. The default is to let the system decide (usually "tap%d"). It can include a "%d" to indicate a numeric value should be generated for you. (i.e., "eth%d" will create an interface named "eth3" if you already have "eth0", "eth1", and "eth2").
-f tunpath
    Specify the path to TUN/TAP user-space interface (i.e., "/dev/net/tun").
-t keepalive
    Specify how often, in seconds, to send empty keep-alive packets to maintain the connection. The value 0 may be used to specify that keep-alives are never sent. The default is 900 seconds.

FILES
NONE

AUTHOR
Roy Keene <tunnelit@rkeene.org>