t_rcvuderr(3N)          NETWORK FUNCTIONS          t_rcvuderr(3N)



NAME
     t_rcvuderr - receive a unit data error indication

SYNOPSIS
     #include <tiuser.h>

     int t_rcvuderr (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 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 end-
     point 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(3).  The maxlen [see netbuf  in
     intro(3)]  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.  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 end-
                       point.

     [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.



            Last change: Networking Support Utilities           1

t_rcvuderr(3N)          NETWORK FUNCTIONS          t_rcvuderr(3N)



     [TNOTSUPPORT]     This function  is  not  supported  by  the
                       underlying transport provider.

     [TSYSERR]         A system error has occurred during  execu-
                       tion of this function.

SEE ALSO
     intro(3), t_rcvudata(3N), t_sndudata(3N).
     UNIX System V Network Programmer's Guide.

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










































            Last change: Networking Support Utilities           2