Provided by: ucspi-tcp-ipv6_0.88-3_i386 bug


       tcpserver - accept incoming TCP connections


       tcpserver [ -146jpPhHrRoOdDqQv ] [ -climit ] [ -xrules.cdb ] [ -Bbanner
       ] [ -ggid ] [ -uuid ] [ -bbacklog ] [ -llocalname ]  [  -ttimeout  ]  [
       -Iinterface ] host port program [ arg ...  ]


       tcpserver waits for connections from TCP clients.  For each connection,
       it runs program with the given arguments,  with  descriptor  0  reading
       from the network and descriptor 1 writing to the network.

       The  server's  address  is  given  by  host  and  port.  host can be 0,
       allowing connections  from  any  host;  or  a  particular  IP  address,
       allowing  connections  only  to  that address; or a host name, allowing
       connections to the first IP address for  that  host.   port  may  be  a
       numeric  port  number  or  a  port  name.  If port is 0, tcpserver will
       choose a free port.

       tcpserver sets up several environment variables, as described  in  tcp-

       tcpserver exits when it receives SIGTERM.


              Do  not  handle  more  than  limit simultaneous connections.  If
              there are limit simultaneous copies of  program  running,  defer
              acceptance  of  a new connection until one copy finishes.  limit
              must be a positive integer.  Default: 40.

              Follow the rules compiled into  rules.cdb  by  tcprules.   These
              rules  may  specify  setting  environment variables or rejecting
              connections from bad sources.

              tcpserver does not read rules.cdb into  memory;  you  can  rerun
              tcprules to change tcpserver's behavior on the fly.

              Write banner to the network immediately after each connection is
              made.  tcpserver writes banner before looking up  TCPREMOTEHOST,
              before looking up TCPREMOTEINFO, and before checking rules.cdb.

              This  feature  can  be used to reduce latency in protocols where
              the client waits for a greeting from the server.

       -ggid  Switch group ID to gid after preparing to  receive  connections.
              gid must be a positive integer.

       -uuid  Switch  user  ID  to uid after preparing to receive connections.
              uid must be a positive integer.

       -1     After preparing to receive connections,  print  the  local  port
              number to standard output.

       -4     Fall  back  to  IPv4  sockets.  This is necessary for terminally
              broken systems like OpenBSD which  will  not  let  IPv6  sockets
              connect to V4-mapped IPv6 addresses.  Please note that this also
              applies to DNS lookups, so you will have to use an DNS  resolver
              with an IPv6 address to accept IPv6 connections.  Use DNSCACHEIP
              to set the DNS resolver IP dynamically.

       -6     Force IPv6 mode in UCSPI environment variables,  even  for  IPv4
              connections.   This  will set $PROTO to TCP6 and put IPv4-mapped
              IPv6 addresses in TCPLOCALIP and TCPREMOTEIP.

              Bind to the network interface interface ("eth0"  on  Linux,  for
              example).   This  is only defined and needed for IPv6 link-local

              Allow up to backlog simultaneous  SYN_RECEIVEDs.   Default:  20.
              On  some  systems,  backlog  is  silently  limited  to  5.   See
              listen(2) for more details.

       -o     Leave IP options alone.  If the client is sending packets  along
              an IP source route, send packets back along the same route.

       -O     (Default.)   Kill  IP  options.   A  client can still use source
              routing to connect and to send data, but packets  will  be  sent
              back along the default route.

       -d     (Default.)   Delay  sending  data  for  a  fraction  of a second
              whenever the remote host is responding slowly,  to  make  better
              use of the network.

       -D     Never   delay   sending   data;  enable  TCP_NODELAY.   This  is
              appropriate for interactive connections.

       -q     Quiet.  Do not print any messages.

       -Q     (Default.)  Print error messages.

       -v     Verbose.  Print all available messages.


       -p     Paranoid.  After looking up the remote host name, look up the IP
              addresses  for  that  name,  and  make  sure one of them matches
              TCPREMOTEIP.  If none of them do, unset TCPREMOTEHOST.

       -P     (Default.)  Not paranoid.

       -h     (Default.)  Look up the remote host name and set TCPREMOTEHOST.

       -H     Do not look up the remote host name.

              Do  not  look  up  the  local  host  name;  use  localname   for

       -r     (Default.)   Attempt  to  obtain  TCPREMOTEINFO  from the remote

       -R     Do not attempt to obtain TCPREMOTEINFO from the remote host.

              Give up on the TCPREMOTEINFO connection  attempt  after  timeout
              seconds. Default: 26.


       argv0(1),  fixcr(1), recordio(1), tcpclient(1), tcprules(1), listen(2),