2.11BSD#431 - /usr/man/cat3/rexec.0

REXEC(3)	    UNIX Programmer's Manual		 REXEC(3)


NAME
     rexec - return stream to a remote command

SYNOPSIS
     rem = rexec(ahost, inport, user, passwd, cmd, fd2p);
     char **ahost;
     int inport;
     char *user, *passwd, *cmd;
     int *fd2p;

DESCRIPTION
     Rexec looks up the host *ahost using gethostbyname(3N),
     returning -1 if the host does not exist.  Otherwise *ahost
     is set to the standard name of the host.  If a username and
     password are both specified, then these are used to authen-
     ticate to the foreign host; otherwise the environment and
     then the user's .netrc file in his home directory are
     searched for appropriate information.  If all this fails,
     the user is prompted for the information.

     The port inport specifies which well-known DARPA Internet
     port to use for the connection; the call
     ``getservbyname("exec", "tcp")'' (see getservent(3N)) will
     return a pointer to a structure, which contains the neces-
     sary port.  The protocol for connection is described in
     detail in rexecd(8C).

     If the connection succeeds, a socket in the Internet domain
     of type SOCK_STREAM is returned to the caller, and given to
     the remote command as stdin and stdout.  If fd2p is non-
     zero, then an auxiliary channel to a control process will be
     setup, and a descriptor for it will be placed in *fd2p.  The
     control process will return diagnostic output from the com-
     mand (unit 2) on this channel, and will also accept bytes on
     this channel as being UNIX signal numbers, to be forwarded
     to the process group of the command.  The diagnostic infor-
     mation returned does not include remote authorization
     failure, as the secondary connection is set up after author-
     ization has been verified.  If fd2p is 0, then the stderr
     (unit 2 of the remote command) will be made the same as the
     stdout and no provision is made for sending arbitrary sig-
     nals to the remote process, although you may be able to get
     its attention by using out-of-band data.

SEE ALSO
     rcmd(3), rexecd(8C)


Printed 11/26/99	  May 14, 1986				1