NAME

vanessa_socket_pipe - Trivial TCP/IP pipe based on libvanessa_socket

SYNOPSIS

vanessa_socket_pipe [options]

DESCRIPTION

A TCP/IP pipe is a user space programme that listens for TCP/IP connections on port on the local host and when a client connects makes a connection to a TCP port, possibly on another host. Once both connections are established data sent on one connection is relayed to the other, hence forming a bi-directional pipe.

Uses include enabling connections to specific ports on hosts behind a packet filter.

This code is intended primarily as an example of how many of the features of libvanessa_socket work.

OPTIONS

-c|--connection_limit:: Maximum number of connections to accept simultaneously. A value of zero sets no limit on the number of simultaneous connections. (default 0)
-d|--debug:: Turn on verbose debuging to stderr.
-h|--help:: Display this message.
-L|--listen_port:: Port to listen on. (mandatory)
-l|--listen_host:: Address to listen on. May be a hostname or an IP address. If not defined then listen on all local addresses.
-n|--no_lookup:: Turn off lookup of hostnames and portnames. That is, hosts must be given as IP addresses and ports must be given as numbers.
-O|--outgoing_port:: Define a port to connect to. If not specified -l|--listen_port will be used.
-o|--outgoing_host:: Define host to connect to. May be a hostname or an IP address. (mandatory)
-q|--quiet:: Only log errors. Overriden by -d|--debug.
-t|--timeout:: Idle timeout in seconds. Value of zero sets infinite timeout. (default 1800)
Notes:: Default value for binary flags is off.
-L|--listen_port and -o|--outgoing_host must be defined.

AUTHOR

Simon Horman <horms@verge.net.au>