sni_txw(3)                          CLIX                          sni_txw(3)



  NAME

    sni_txw - Transmits a data buffer

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

    char *sni_txw(
      long (*sd ,
      char *buffer ,
      int *len ,
      long timeout );

  PARAMETERS

    sd        A pointer to a long integer representing an interface descriptor

    buffer    A pointer to the buffer from which data is transferred

    len       A pointer to the length of data to transfer

    timeout   The length of time in milliseconds to wait before abandoning the
              transfer

  DESCRIPTION

    The sni_txw() function transmits data to a remote node from the buffer.
    The size of the buffer is specified in the integer pointed to by the
    variable len.  Upon successful completion, the len variable will contain
    the actual number of bytes transmitted.

    The sd variable is a pointer to a Simple Network Interface (SNI)
    descriptor assigned using either the sni_accept() or sni_connect()
    function.

    The timeout variable specifies the amount of time (in milliseconds) that
    the call waits for an acknowledgment from the remote node.  If the
    acknowledgment is not received in the time specified, the call is
    considered unsuccessful and a pointer to an error message is returned.

    A timeout value of 0 indicates no time constraint.

  NOTES

    In general, timeouts should not be used.

  CAUTIONS




  2/94 - Intergraph Corporation                                              1

  sni_txw(3)                          CLIX                          sni_txw(3)



    The sni_txw function is considered complete when the buffer is queued.
    The data is transmitted asynchronously until all data is successfully
    received by the remote node.

  RETURN VALUES

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

  RELATED INFORMATION

    Functions:  sni_accept(3), sni_close(3), sni_connect(3), sni_rxw(3)










































  2                                              Intergraph Corporation - 2/94