t_rcvuderr(3N)        (Networking Support Utilities)         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.




   7/91                                                                 Page 1

   t_rcvuderr(3N)        (Networking Support Utilities)         t_rcvuderr(3N)


         [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).
         Programmer's Guide: Networking Interfaces.

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








































   Page 2                                                                 7/91