SYNOPSIS

[-hinpsv ] [-b IP ] [-f TYPE ] [-I NAME ] [-l LEVEL ] [-m BPS ] [-o <1,2,3> ] [-t SEC ] [-w MSEC ] [-x HOST:PORT ] [-z BYTES ] [SRC]:PORT [DST]:PORT

DESCRIPTION

redirects TCP connections coming in on a local port, [SRC]:PORT to a specified address/port combination, [DST]:PORT Both the SRC and DST arguments can be left out, will then use 0.0.0.0

can be run either from inetd or as a standalone daemon. In --inetd mode the listening SRC:PORT combo is handled by another process, usually inetd and a connected socket is handed over to via stdin. Hence only [DST]:PORT is required in --inetd mode. In standalone mode can run either in the foreground, -n or in the background, detached like a proper UNIX daemon. This is the default. When running in the foreground log messages are also printed to stderr, unless the -s flag is given.

Depending on how redir was compiled, not all options may be available.

OPTIONS

Mandatory arguments to long options are mandatory for short options too.

-b, --bind=IP

Forces to pick a specific address/interface to bind to when it listens for incoming connections.

-h, -help

Show built-in help text.

-f, -ftp=TYPE

When using for an FTP server, this will cause redir to also redirect FTP connections. Type should be specified as either "port", "pasv", or "both", to specify what type of FTP connection to handle. Note that --transproxy often makes one or the other (generally port) undesirable.

-i, --inetd

Run as a process started from inetd(1), with the connection passed as stdin and stdout on startup.

-I, --ident=STR

Specify program identity (name) to be used for TCP wrapper checks and syslog messages.

-l, --loglevel=LEVEL

Set log level: none, err, notice, info, debug. Default is notice.

-n, --foreground

Run in foreground, do not detach from controlling terminal.

-p, --transproxy

On a Linux system with transparent proxying enabled, causes to make connections appear as if they had come from their true origin. See the file transproxy.txt in the distribution, and the Linux Documentation/networking/tproxy.txt for details. Untested on modern Linux kernels.

-s, --syslog

Log messages to syslog.

-t, --timeout=SEC

Timeout and close the connection after SEC seconds of inactivity.

-v

Show program version.

-x, --connect

Redirects connections through an HTTP proxy which supports the CONNECT command. Specify the address and port of the proxy using [DST]:PORT --connect requires the hostname and port which the HTTP proxy will be asked to connect to.

TRAFFIC SHAPING

The following options control traffic shaping, if is built with shaping enabled.

-m, --max-bandwidth=BPS

Reduce the bandwidth to be no more than BPS bits/sec. The algorithm is basic, the goal is to simulate a slow connection, so there is no peak acceptance.

-o, --wait-in-out=<1,2,3>

Apply --max-bandwidth and --random-wait for input(1), output(2), or both(3).

-w, --random-wait=MSEC

Wait between 0 and 2 x n milliseconds before each "packet". A "packet" is a block of data read in one time by redir. A "packet" size is always less than the bufsize (see also --bufsize

-z, --bufsize=BYTES

Set the bufsize (defaut 4096) in bytes. Can be used combined with --max-bandwidth or --random-wait to simulate a slow connection.

AUTHORS

is written by Nigel Metheringham and Sam Creasey, with contributions from many others. It is currently being maintained at GitHub by Joachim Nilsson.