fmu_rcmd(3)                         CLIX                         fmu_rcmd(3)



  NAME

    fmu_rcmd - Executes the specified command on a remote system

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

    char *fmu_rcmd(
      char *command );

  PARAMETERS

    command   The variable, command, refers to the remote command string to be
              executed.  This string must be less than 255 characters in
              length.

  DESCRIPTION

    The fmu_rcmd() function executes the variable, command, on the remote
    system.  All stdout generated by the remote command is written to stdout.

    The connection must be established with the fmu_connect() function prior
    to calling the fmu_rcmd() function.

  EXAMPLES

    To perform an ls -ls on the /usr/tmp directory on the remote system:

    fmu_rcmd ("ls -ls /usr/tmp")


  NOTES

    The remote command cannot be greater than 255 characters in length.

  CAUTIONS

    If command requires input, the fmu_rcmd() function will hang indefinitely.

  RETURN VALUES

    Upon successful completion, a null pointer is returned.  Otherwise, a
    pointer to an error message is returned.

  ERRORS

    The fmu_rcmd() function fails if one or more of the following are true:




  2/94 - Intergraph Corporation                                              1

  fmu_rcmd(3)                         CLIX                         fmu_rcmd(3)



    [TBADF]
           The specified file descriptor does not refer to a transport
           endpoint.

    [TFLOW]
           The O_NDELAY was set, but the flow control mechanism prevented the
           transport provider from accepting data at this time.

    [TNODATA]
           O_NDELAY was set, but no data is currently available from the
           transport provider.

    [TLOOK]
           An asynchronous event occurred on this transport endpoint and
           requires immediate attention.

    [TNOTSUPPORT]
           This function is not supported by the underlying transport
           provider.

    [TSYSERR]
           A system error occurred during execution of this function.

  RELATED INFORMATION

    Functions:  fmu_receive(3), fmu_send(3), fmu_connect(3)




























  2                                              Intergraph Corporation - 2/94