fmu_receive(3)                      CLIX                      fmu_receive(3)



  NAME

    fmu_receive - Receives files from a remote system

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

    char *fmu_receive(
      char *srcfile ,
      char *dstfile );

  PARAMETERS

    srcfile   Points to a pathname specifying the source file(s) on the remote
              system.

    dstfile   Points to a pathname specifying the destination file (or
              directory) on the local system.

  DESCRIPTION

    The fmu_receive() function copies one or more files from a remote system
    to the local system.

    The connection must be established with the fmu_connect() function before
    fmu_receive() is called.

  EXAMPLES

    1.  To copy the remote file sample to /usr/tmp/sample2 on the local
        system:

        fmu_receive ("sample", "/usr/tmp/sample2")


    2.  To copy all remote files beginning with a to /usr/tmp on the local
        system:

        fmu_receive ("a*", "/usr/tmp")


  RETURN VALUES

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

  ERRORS




  2/94 - Intergraph Corporation                                              1

  fmu_receive(3)                      CLIX                      fmu_receive(3)



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

    [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 has occurred on this transport endpoint and
           requires immediate attention.

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

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

    [INC_ERR(eoe)]
           Destination file must be a directory when sending or receiving
           multiple files.

  RELATED INFORMATION

    Functions: fmu_send(3), fmu_connect(3)






















  2                                              Intergraph Corporation - 2/94