REXEC(3N)               COMMAND REFERENCE               REXEC(3N)



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 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 authenticate to the foreign host;
     otherwise the environment and then the user's .netrc file in
     his or her 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; it will normally be the
     value returned from the call getservbyname(exec,tcp) (see
     getservent(3n)).  The protocol for connection is described
     in detail in rexecd(8n).

     If the call succeeds, a socket of type SOCK_STREAM is
     returned to the caller, and given to the remote command as
     stdin and stdout.  If fd2p is nonzero, then an auxiliary
     channel to a control process will be set up, and a
     descriptor for it will be placed in *fd2p.  The control
     process will return diagnostic output from the command (unit
     2) on this channel, and will also accept bytes on this
     channel as being UTek signal numbers, to be forwarded to the
     process group of the command.  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
     signals to the remote process, although you may be able to
     get its attention by using out-of-band data.

CAVEATS
     There is no way to specify options to the socket call which
     rexec makes.

SEE ALSO
     rcmd(3n), rexecd(8n), .rhosts(5n), and hosts.equiv(5n).









Printed 3/13/89                                                 1

%%index%%
na:288,93;
sy:381,1222;
de:1603,2263;
ca:3866,272;
se:4138,214;
%%index%%000000000097