t_rcvuderr(3N)                 DG/UX R4.11MU05                t_rcvuderr(3N)


NAME
       trcvuderr - receive a unit data error indication

SYNOPSIS
       #include <tiuser.h>

       int trcvuderr (int fd, struct tuderr *uderr);

DESCRIPTION
       This function is used in connectionless mode to receive information
       concerning an error on a previously sent data unit, and should be
       issued only after 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 will be received,
       and uderr points to a tuderr structure containing the following
       members:

              struct netbuf addr;
              struct netbuf opt;
              long error;

       netbuf is described in intro(3).  The maxlen [see netbuf in intro(3)]
       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 will simply clear the
       error indication without reporting any information to the user.

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

       [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 will be
                         discarded.

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

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

SEE ALSO
       intro(3), trcvudata(3N), tsndudata(3N).
       UNIX System V Network Programmer's Guide.

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


Licensed material--property of copyright holder(s)