sni_rxw(3)                          CLIX                          sni_rxw(3)



  NAME

    sni_rxw - Receives a data buffer

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

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

  PARAMETERS

    sd        A pointer to a network interface descriptor

    buffer    The buffer to receive data

    len       The number of bytes received

    timeout   The number of milliseconds to wait to receive data

  DESCRIPTION

    The sni_rxw() function receives data sent by a remote node into the buffer
    specified by buffer.  The size of the buffer is specified in the integer
    pointed to by len.  Upon successful completion, len contains the number of
    bytes received.  Completion occurs when either a complete message is
    received or the receiving buffer becomes full.

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

    The timeout parameter specifies the amount of time (in milliseconds) the
    call waits to receive data.  If data is not received in the time
    specified, the call is unsuccessful and a pointer to an error message is
    returned.  A timeout value of 0 indicates no time constraint.

  NOTES

    In general, timeout should not be used.

  CAUTIONS

    If received data is larger than the specified size of the buffer, the data
    will be truncated.  The remaining data will be lost.



  2/94 - Intergraph Corporation                                              1

  sni_rxw(3)                          CLIX                          sni_rxw(3)



  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_txw(3)














































  2                                              Intergraph Corporation - 2/94