t_rcvuderr(3)                       CLIX                       t_rcvuderr(3)



  NAME

    t_rcvuderr - Receives a unit data error indication.

  LIBRARY

    Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_rcvuderr(
      int fd ,
      struct t_uderr *uderr );

  PARAMETERS

    fd      An integer identifying the local transport endpoint through which
            the error report is received

    uderr   A pointer to a t_uderr structure

  DESCRIPTION

    This function is used in connectionless mode to receive information
    concerning an error on a previously sent data unit, and should only be
    issued following a unit data error indication.  It informs the transport
    user that a data unit with a specific destination address and protocol
    options produced an error.  The uderr parameter points to a t_uderr()
    structure containing the following members:

    struct netbuf addr;
    struct netbuf opt;
    long error;

    The netbuf is described in intro.  The maxlen [see netbuf in intro] field
    of addr and opt must be set before issuing this function to indicate the
    maximum size of the buffer for each.

    On return from this call, the addr specifies the destination protocol
    address of the erroneous data unit, the opt structure identifies
    protocol-specific options that were associated with the data unit, and
    error specifies a protocol-dependent error code.

    If the user does not identify the data unit that produced an error, uderr
    may be set to NULL and t_rcvuderr() clears the error indication without
    reporting information to the user.

    On failure, t_errno() may be set to one of the following:




  2/94 - Intergraph Corporation                                              1

  t_rcvuderr(3)                       CLIX                       t_rcvuderr(3)



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

    [TNOUDERR]
           No unit data error indication currently exists on the specified
           transport endpoint.

    [TBUFOVFLW]
           The number of bytes allocated for the incoming protocol address or
           options is not sufficient to store the information.  The unit data
           error information to be returned in uderr is discarded.

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

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

  RETURN VALUES

    The t_rcvuderr() function returns 0 on successful completion and -1 on
    failure, and t_errno() is set to indicate the error.

  RELATED INFORMATION

    Functions:  t_rcvudata(3), t_sndudata(3)

    AT&T UNIX System V Network Programmer's Guide
























  2                                              Intergraph Corporation - 2/94