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>

                                               12th February 2001                         VANESSA_SOCKET_PIPE(1)