TUNNELIT

Section: Maintenance Commands (8)
Updated: 17 Aug 2009
Index Return to Main Contents
 

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>

 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
AUTHOR
This document was created by man2html, using the manual pages.
Time: 13:56:16 GMT, August 17, 2009