rexec(3)                            CLIX                            rexec(3)



  NAME

    rexec - Returns a stream to a remote command

  LIBRARY

    Berkeley Software Distribution (libbsd.a)

  SYNOPSIS

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

  DESCRIPTION

    The rexec() function looks up the host ahost using gethostbyname(),
    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,
    these are used to authenticate to the foreign host; otherwise the
    environment and then the user's file in the 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 Defense Advanced Research
    Project Agency (DARPA) Internet port to use for the connection; the call

    getservbyname("exec", "tcp")

    (see getservent()) will return a pointer to a structure, which contains
    the necessary port.  The protocol for connection is described in detail in
    rexecd().

    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 nonzero, an auxiliary channel to a control
    process will be set up, and a descriptor for it will be placed in the
    integer pointed to by fd2p.  The control process will return diagnostic
    output from the command (unit 2) on this channel, and will also accept
    bytes on the channel as being CLIX signal numbers to be forwarded to the
    process group of the command.  The diagnostic information returned does
    not include remote authorization failure, as the secondary connection is
    set up after authorization has been verified.  If fd2p is 0, the stderr
    (unit 2 of the remote command) will be the same as the stdout with no
    provision for sending arbitrary signals to the remote process.  Although,
    out-of-band data could be used to attract its attention.




  2/94 - Intergraph Corporation                                              1

  rexec(3)                            CLIX                            rexec(3)



  RETURN VALUES

    See the DISCUSSION.

  RELATED INFORMATION

    Commands:  rexecd(1)

    Functions:  gethostent(3), getservent(3), rcmd(3)













































  2                                              Intergraph Corporation - 2/94