t_rcvuderr(S)             (TLI/XTI) 6 January 1993             t_rcvuderr(S)


 Name

    t_rcvuderr - receive a unit data error indication

 Syntax


    TLI syntax


    cc . . .  -lnsls


    #include <sys/tiuser.h>

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


    XTI syntax


    cc . . .  -lxti


    #include <xti.h>

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


 Description

    This function is used in connectionless mode to receive information con-
    cerning 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.  fd identifies the local transport endpoint
    through which the error report is received, and uderr points to a tuderr
    structure containing the following members:

       struct netbuf addr;
       struct netbuf opt;
       long   error;

    netbuf is described in netbuf(FP).  The maxlen (see netbuf(FP)) 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 structure 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 care to identify the data unit that produced an
    error, uderr may be set to NULL and trcvuderr simply clears the error
    indication without reporting any information to the user.

 Return value

    The trcvuderr function returns 0 on successful completion and -1 on
    failure, and terrno is set to indicate the error.

 Diagnostics

    On failure, terrno may be set to one of the following:

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

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

    [TNOTSUPPORT]     This function is not supported by the underlying trans-
                      port provider.

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

    [TSYSERR]         A system error occurred during execution of this func-
                      tion.  One possibility is an I/O error where not all of
                      the message was received; when this error occurs, errno
                      is set to EIO.  Another is that a protocol error
                      occurred; when this error occurs, errno is set to
                      EPROTO.

 See also

    netbuf(FP), trcvudata(S), tsndudata(S)

 Standards conformance

    trcvuderr is conformant with:
    AT&T SVID Issue 2;
    X/Open Portability Guide, Issue 3, 1989;
    and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2).