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

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.