mdw@git.distorted.org.uk Git - qmail/blob - tcp-env.1

   1 .TH tcp-env 1
   2 .SH NAME
   3 tcp-env \- set up TCP-related environment variables
   4 .SH SYNOPSIS
   5 .B tcp-env
   6 [
   7 .B \-rR
   8 ]
   9 [
  10 .B \-t\fItimeout
  11 ]
  12 .I program
  13 [
  14 .I arg ...
  15 ]
  16 .SH DESCRIPTION
  17 The input for
  18 .B tcp-env
  19 must be a TCP connection.
  20 .B tcp-env
  21 finds out information about that connection,
  22 puts the information into several environment variables
  23 as described in
  24 .B tcp-environ(5),
  25 and runs
  26 .I program
  27 with the given arguments.
  28
  29 Usually
  30 .B tcp-env
  31 is run from
  32 .BR inetd .
  33 It might instead be run from another server
  34 that already sets up the right environment variables;
  35 if
  36 .B PROTO
  37 is set to
  38 .B TCP
  39 when
  40 .B tcp-env
  41 is invoked,
  42 .B tcp-env
  43 assumes that all the other variables are set up properly,
  44 and it does not check whether the input is a TCP connection.
  45 .SH OPTIONS
  46 .TP
  47 .B \-r
  48 (Default.)
  49 Attempt to obtain
  50 .B TCPREMOTEINFO
  51 from the remote host.
  52 .TP
  53 .B \-R
  54 Do not attempt to obtain
  55 .B TCPREMOTEINFO
  56 from the remote host.
  57 .TP
  58 .B \-t\fItimeout
  59 Give up on the
  60 .B TCPREMOTEINFO
  61 connection attempt after
  62 .I timeout
  63 seconds.
  64 Default: 30.
  65 .SH "SEE ALSO"
  66 tcp-environ(5),
  67 inetd(8)