fmu_send(3)                         CLIX                         fmu_send(3)



  NAME

    fmu_send - Sends files to a remote system

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

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

  PARAMETERS

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

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

  DESCRIPTION

    The fmu_send() function copies one or more files from a local system to a
    remote system.  The connection must be established with fmu_connect()
    before the fmu_send() function is called.

  EXAMPLES

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

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


    2.  To copy the local file sample1 to sample2 on the remote system:

        fmu_send ("sample1", "sample2")


  RETURN VALUES

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

  ERRORS

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

    [TBADF]



  2/94 - Intergraph Corporation                                              1

  fmu_send(3)                         CLIX                         fmu_send(3)



           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.

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

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

    [EOE]  The destination file must be a directory when sending or receiving
           multiple files.

    [E30]  Error opening file.

  RELATED INFORMATION

    Functions:  fmu_receive(3), fmu_connect(3)
























  2                                              Intergraph Corporation - 2/94