t_rcvuderr(3xti)t_rcvuderr(3xti)Namet_rcvuderr - receive a unit error indication
Syntax
#include <xti.h>
int t_rcvuderr(fd, uderr)
int fd;
struct t_uderr *uderr;
Arguments
fd Identifies the local transport endpoint through which the
error report is received.
uderr Points to a t_uderr structure containing the following mem‐
bers:
struct netbuf addr;
struct netbuf opt;
long error;
On return from this call, the members have the following
meanings:
addr Specifies the destination protocol address of the
erroneous data unit.
opt Identifies protocol-specific options that were
associated with the data unit.
error Specifies a protocol-dependent error code.
Description
This function is used in connectionless mode to receive information
concerning an error on a previously sent data unit and should 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.
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.
If the user does not care to identify the data unit that produced an
error, uderr may be set to NULL, and simply clears the error indication
without reporting any information to the user.
──────────────────────────────────────────────
Parameters Before Call After Call
──────────────────────────────────────────────
fd x /
uderr->addr.maxlen x /
uderr->addr.len / x
uderr->addr.buf x (x)
uderr->opt.maxlen x /
uderr->opt.len / x
uderr->opt.buf x (x)
uderr->error / x
──────────────────────────────────────────────
Return Values
Upon successful completion, a value of 0 is returned. On failure, a
value of -1 is returned, and t_errno is set to indicate the error.
Diagnostics
On failure, t_errno is set to one of the following:
[BADF] 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 pro‐
tocol 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 Alsot_rcvudata(3xti), t_sndudata(3xti)t_rcvuderr(3xti)