t_rcvuderr(3N)t_rcvuderr(3N)NAMEt_rcvuderr - receive a unit data error indication
SYNOPSIS
#ifdef _XOPEN_SOURCE
#include <xti.h>
#else
#include <tiuser.h>
#endif
int t_rcvuderr (int fd, struct t_uderr *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 t_uderr
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 t_rcvuderr will simply clear the
error indication without reporting any information to the user.
This function resides within both the X/Open compliant libxnet and the
SVR4 compliant libnsl Network Services libraries. Network Services
applications which require X/Open compliance must link-load with -lxnet.
Network Services applications which require SVR4 compliance must link-
load with -lnsl.
On failure, t_errno 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.
Page 1
t_rcvuderr(3N)t_rcvuderr(3N)
TBUFOVFLW There are two different conditions in which TBUFOVFLW
will be returned. If _XOPEN_SOURCE is defined and the
number of bytes allocated for incoming data is greater
than zero and is not sufficient to store the data. If
_XOPEN_SOURCE is not defined and the number of bytes
allocated for incoming data is not sufficient to store
the data. 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 ALSOintro(3N), t_rcvudata(3N), t_sndudata(3N)DIAGNOSTICSt_rcvuderr returns 0 on successful completion and -1 on failure and
t_errno is set to indicate the error.
Page 2
