t_rcvuderr(3N)							t_rcvuderr(3N)

NAME    [Toc]    [Back]

     t_rcvuderr	- receive a unit data error indication

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     int t_rcvuderr (int fd, struct t_uderr *uderr);

DESCRIPTION    [Toc]    [Back]

     This function is used in connectionless mode to receive information
     concerning	an error on a previously sent data unit, and should be issued
     only after	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(3N).	The maxlen [see	netbuf in intro(3N)]
     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.

     This function resides within both the X/Open compliant libxnet and	the
     SVR4 compliant libnsl Network Services libraries.	Network	Services
     applications which	require	X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must linkload
 with -lnsl.

     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.




									Page 1






t_rcvuderr(3N)							t_rcvuderr(3N)



     TBUFOVFLW	       There are two different conditions in which TBUFOVFLW
		       will be returned.  If _XOPEN_SOURCE is defined and the
		       number of bytes allocated for incoming data is greater
		       than zero and is	not sufficient to store	the data.  If
		       _XOPEN_SOURCE is	not defined and	the number of bytes
		       allocated for incoming data is not sufficient to	store
		       the data.  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    [Toc]    [Back]

     intro(3N),	t_rcvudata(3N),	t_sndudata(3N)

DIAGNOSTICS    [Toc]    [Back]

     t_rcvuderr	returns	0 on successful	completion and -1 on failure and
     t_errno is	set to indicate	the error.


									PPPPaaaaggggeeee 2222