Return to rexec.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man3

Annotation of 43BSDTahoe/man/man3/rexec.3, revision 1.1.1.1

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

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