t_rcvuderr(3N) t_rcvuderr(3N)
NAME
trcvuderr - receive a unit data error indication
SYNOPSIS
#include <sys/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 trans-
port 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;
The maxlen field of addr and opt must be set before issuing this func-
tion 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 identi-
fies 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.
ERRORS
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 proto-
col 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.
Page 1 Reliant UNIX 5.44 Printed 11/98
t_rcvuderr(3N) t_rcvuderr(3N)
DIAGNOSTICS
trcvuderr returns 0 on successful completion and -1 on failure and
terrno is set to indicate the error.
SEE ALSO
trcvudata(3N), tsndudata(3N).
Page 2 Reliant UNIX 5.44 Printed 11/98