t_rcvuderr(3)

NAME

t_rcvuderr − receive a unit data error indication

SYNOPSIS

#include <xti.h> (for XTI)

#include <tiuser.h> (for TLI)

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. The argument fd identifies the local transport endpoint through which the error report will be received, and uderr points to a type t_uderr structure used to specify the protocol 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 t_uderr structure has the following members:

struct netbuf addr;
struct netbuf opt;
long error;

The type netbuf structure is defined in the <xti.h> or <tiuser.h> header file. This structure, which is used to define buffer parameters, has the following members:

unsigned int maxlen maximum byte length of the data buffer

unsigned int len actual byte length of data written to buffer

char *buf points to buffer location

The maxlen field of addr and opt must be set before calling 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 identified 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 t_rcvuderr() will simply clear the error indication without reporting any information to the user.

ERRORS

On failure, t_errno 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 protocol address or options information is not sufficient 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.

RETURN VALUE

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error.

NOTE

In HP-UX 9.0, XTI (X/Open Transport Interface) supports only OSI as a transport provider, and is available only as part of the OSI Transport Services 9000 product. Users of this product can access XTI versions of the t_* routines by linking with /usr/lib/libxti.a. For more information on XTI, see "HP-UX/9000 XTI Programmer’s Guide".

In HP-UX 9.0, TLI (Transport Layer Interface) supports any transport provider which is compliant with TPI (Transport Provider Interface). TLI is available only as part of the STREAMS product. Users of this product can access TLI versions of the t_* routines by linking with /usr/lib/libnsl_s.a. For more information on TLI, see the TLI section of "STREAMS/UX for HP 9000 Reference Manual".

Museum

Related Articles