T_RCVUDERR(3N) (Networking Support Utilities) T_RCVUDERR(3N)
NAME
t_rcvuderr - receive a unit data error indication
SYNOPSIS
#include <tiuser.h>
int trcvuderr(fd, uderr)
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 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 will be received,
and uderr points to a t_uderr 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 t_rcvuderr
will simply clear the error indication without reporting any
information to the user.
On failure, t_errno may be set to one of the following:
Page 1 May 1989
T_RCVUDERR(3N) (Networking Support Utilities) T_RCVUDERR(3N)
[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), t_rcvudata(3N), t_sndudata(3N).
Network Programmer's Guide, Vol. 1.
DIAGNOSTICS
t_rcvuderr returns 0 on successful completion and -1 on
failure and t_errno is set to indicate the error.
Page 2 May 1989