This routine is part of the XTI interfaces which evolved from the TLI interfaces. XTI represents the future evolution of these interfaces. However, TLI interfaces are
supported for compatibility. When using a TLI routine that has the same name as an XTI routine, the tiuser.h header file must be used. Refer to the TLI COMPATIBILITY section for
a description of differences between the two interfaces.
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. The argument 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;
t_scalar_t error;
|
The maxlen field of addr and opt must be set before calling this function to indicate the maximum size of the buffer for each. If this field is set to zero for addr or opt, no information is returned in the buf field of this parameter.
On return from this call, the addr structure specifies the destination protocol address of the erroneous data unit, the opt structure identifies 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 a null pointer, and t_rcvuderr() will simply clear the error indication without reporting any information to the user.
|