Name
t_rcvuderr - receive a unit data error indication
Syntax
#include <tiuser.h>
int t_rcvuderr(fd, uderr)
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 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(NSL). The maxlen [see netbuf
in intro(NSL)] 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:
[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(NSL), t_rcvudata(NSL), t_sndudata(NSL).
Network Programmer's Guide.
Diagnostics
The t_rcvuderr function returns 0 on successful completion
and -1 on failure, and t_errno is set to indicate the error.
Standards Conformance
t_rcvuderr is conformant with:
AT&T SVID Issue 2, Select Code 307-127.
(printed 6/18/89)