t_rcvuderr(3N)    UNIX System V(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(3N).  The maxlen [see netbuf in intro(3N)]
      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.





10/89                                                                    Page 1

t_rcvuderr(3N)    UNIX System V(Networking Support Utilities)    t_rcvuderr(3N)


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

SEE ALSO
      intro(3N), 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                                                                    10/89