t_rcvuderr(3xti) [ultrix man page]

t_rcvuderr(3xti)														  t_rcvuderr(3xti)

Name
       t_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 members:
		 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 function 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 indica-
       tion 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 protocol 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 Also
       t_rcvudata(3xti), t_sndudata(3xti)

																  t_rcvuderr(3xti)

t_rcvuderr(3)						     Library Functions Manual						     t_rcvuderr(3)

NAME

       t_rcvuderr() - receive a unit data error indication

SYNOPSIS

DESCRIPTION

       The function is used in connectionless mode to receive information concerning 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 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 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 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 iden-
       tified 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 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.

       [TPROTO] 	   (XTI only) This error indicates that a communication problem has been detected between XTI and the  transport  provider
			   for which there is no other suitable XTI (

SEE ALSO

       t_look(3), t_rcvudata(3), t_sndudata(3), thread_safety(5).

STANDARDS CONFORMANCE

																     t_rcvuderr(3)