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)