tcpproxy(8) =========== NAME ---- tcpproxy - IPv4/IPv6 tcp connection proxy SYNOPSIS -------- .... tcpproxy [ -h|--help ] [ -D|--nodaemonize ] [ -u|--username ] [ -g|--groupname ] [ -C|--chroot ] [ -P|--write-pid ] [ -L|--log :[,[,[..]]] ] [ -U|--debug ] [ -l|--local-addr ] [ -t|--local-resolv (ipv4|4|ipv6|6) ] [ -p|--local-port ] [ -r|--remote-addr ] [ -R|--remote-resolv (ipv4|4|ipv6|6) ] [ -o|--remote-port ] [ -s|--source-addr ] [ -S|--source-resolv (ipv4|4|ipv6|6) ] [ -b|--buffer-size ] [ -c|--config ] .... DESCRIPTION ----------- *tcpproxy* is a simple tcp connection proxy which combines the features of rinetd and 6tunnel. *tcpproxy* supports IPv4 and IPv6 and also supports connections from IPv6 to IPv4 endpoints and vice versa. OPTIONS ------- The following options can be passed to the *tcpproxy* daemon: *-D, --nodaemonize*:: This option instructs *tcpproxy* to run in foreground instead of becoming a daemon which is the default. *-u, --username *:: run as this user. If no group is specified (*-g*) the default group of the user is used. The default is to not drop privileges. *-g, --groupname *:: run as this group. If no username is specified (*-u*) this gets ignored. The default is to not drop privileges. *-C, --chroot *:: Instruct *tcpproxy* to run in a chroot jail. The default is to not run in chroot. *-P, --write-pid *:: Instruct *tcpproxy* to write it's pid to this file. The default is to not create a pid file. *-L, --log :[,[,[..]]]*:: add log target to logging system. This can be invoked several times in order to log to different targets at the same time. Every target hast its own log level which is a number between 0 and 5. Where 0 means disabling log and 5 means debug messages are enabled. + The file target can be used more the once with different levels. If no target is provided at the command line a single target with the config *syslog:3,tcpproxy,daemon* is added. + The following targets are supported: *syslog*;; log to syslog daemon, parameters [,[,]] *file*;; log to file, parameters [,] *stdout*;; log to standard output, parameters *stderr*;; log to standard error, parameters *-U, --debug*:: This option instructs *tcpproxy* to run in debug mode. It implicits *-D* (don't daemonize) and adds a log target with the configuration *stdout:5* (logging with maximum level). In future releases there might be additional output when this option is supplied. *-l, --local-addr *:: The local address to bind to. By default *tcpproxy* will listen on any interface (IPv6 and IPv4). *-t|--local-resolv (ipv4|4|ipv6|6)*:: When resolving the local address (see above) use only IPv4 or IPv6. The default is to resolv both. *-p, --local-port *:: The local port to bind to. By default there is no port defined in which case *tcpproxy* will try to read the configuration file. *-r, --remote-addr *:: The remote address to connect to. Unless the configuration file should be used this must be set to a valid address or hostname. *-R|--remote-resolv (ipv4|4|ipv6|6)*:: When resolving the remote address (see above) use only IPv4 or IPv6. The default is to resolv both. *-o, --remote-port *:: The remote port to connect to. Unless the configuration file should be used this must be set to a valid port or servicename. *-s, --source-addr *:: Instruct tcpproxy to use this source address for connections to *-R|--remote-address*. By default *tcpproxy* uses the default source address for the defined remote host. *-S|--source-resolv (ipv4|4|ipv6|6)*:: When resolving the source address (see above) use only IPv4 or IPv6. The default is to resolv both. *-b, --buffer-size *:: The size of the transmit buffers to use. *tcpproxy* will allocate two buffers of this size for any client which is connected. By default a value of 10Kbytes is used. *-c, --config *:: The path to the configuration file to be used. This is only evaluated if the local port is omitted. EXAMPLES -------- nothing yet.. BUGS ---- Most likely there are some bugs in *tcpproxy*. If you find a bug, please let the developers know at tcpproxy@spreadspace.org. Of course, patches are preferred. SEE ALSO -------- nothing yet.. AUTHORS ------- Christian Pointner RESOURCES --------- Main web site: http://www.spreadspace.org/tcpproxy/ COPYING ------- Copyright \(C) 2010 Christian Pointner. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.