t_rcvuderr(3)t_rcvuderr(3)NAMEt_rcvuderr() - receive a unit data error indication
SYNOPSISDESCRIPTION
The function is used in connectionless mode to receive information con‐
cerning an error on a previously sent data unit. This function 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. uderr points to a type structure used to specify the proto‐
col address, protocol options, and the nature of the error associated
with the data unit sent through the transport endpoint specified by the
fd parameter. The structure has the following members:
The type structure is defined in the or header file. This structure,
which is used to define buffer parameters, has the following members:
maximum byte length of the data buffer
actual byte length of data written to buffer
points to buffer location
The maxlen field of addr and opt must be set before calling 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‐
fied 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 a null pointer, and will simply clear the
error indication without reporting any information to the user.
Valid States
Fork Safety
is not fork-safe.
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a
value of −1 is returned and is set to indicate the error.
ERRORS
On failure, is 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 at
the specified transport endpoint.
[TBUFOVFLW] The number of bytes allocated for the incoming pro‐
tocol address or options information is not suffi‐
cient to store that 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 occurred during execution of this
function.
[TPROTO] (XTI only) This error indicates that a communica‐
tion problem has been detected between XTI and the
transport provider for which there is no other
suitable XTI (
SEE ALSOt_look(3), t_rcvudata(3), t_sndudata(3), thread_safety(5).
STANDARDS CONFORMANCEt_rcvuderr(3)