Return to rexec.3x CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/rexec.3x, revision 1.1

1.1     ! root        1: .TH REXEC 3X "17 March 1982"
        !             2: .UC 
        !             3: .SH NAME
        !             4: rexec \- return stream to a remote command
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .B "rem = rexec(ahost, inport, user, passwd, cmd, fd2p);"
        !             8: .B char **ahost;
        !             9: .B u_short inport;
        !            10: .B "char *user, *passwd, *cmd;"
        !            11: .B int *fd2p;
        !            12: .fi
        !            13: .SH DESCRIPTION
        !            14: .I Rexec
        !            15: looks up the host
        !            16: .I *ahost
        !            17: using
        !            18: .IR gethostbyname (3N),
        !            19: returning \-1 if the host does not exist.
        !            20: Otherwise
        !            21: .I *ahost
        !            22: is set to the standard name of the host.
        !            23: If a username and password are both specified, then these
        !            24: are used to authenticate to the foreign host; otherwise
        !            25: the environment and then the user's
        !            26: .I .netrc
        !            27: file in his
        !            28: home directory are searched for appropriate information.
        !            29: If all this fails, the user is prompted for the information.
        !            30: .PP
        !            31: The port
        !            32: .I inport
        !            33: specifies which well-known DARPA Internet port to use for
        !            34: the connection; it will normally be the value returned from
        !            35: the call ``getservbyname("exec", "tcp")'' (see 
        !            36: .IR getservent (3N)).
        !            37: The protocol for connection is described in detail in
        !            38: .IR rexecd (8C).
        !            39: .PP
        !            40: If the call succeeds, a socket of type SOCK_STREAM is returned to
        !            41: the caller, and given to the remote command as
        !            42: .B stdin
        !            43: and
        !            44: .BR stdout .
        !            45: If
        !            46: .I fd2p
        !            47: is non-zero, then a auxiliary channel to a control
        !            48: process will be setup, and a descriptor for it will be placed
        !            49: in
        !            50: .IR *fd2p .
        !            51: The control process will return diagnostic
        !            52: output from the command (unit 2) on this channel, and will also
        !            53: accept bytes on this channel as being UNIX signal numbers, to be
        !            54: forwarded to the process group of the command.
        !            55: If
        !            56: .I fd2p
        !            57: is 0, then the 
        !            58: .B stderr
        !            59: (unit 2 of the remote
        !            60: command) will be made the same as the 
        !            61: .B stdout
        !            62: and no
        !            63: provision is made for sending arbitrary signals to the remote process,
        !            64: although you may be able to get its attention by using out-of-band data.
        !            65: .SH SEE ALSO
        !            66: rcmd(3X), rexecd(8C)
        !            67: .SH BUGS
        !            68: There is no way to specify options to the
        !            69: .I socket
        !            70: call
        !            71: which
        !            72: .I rexec
        !            73: makes.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.