# 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

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 322 |