Manual Pages for UNIX Operating System command usage for man t_errno

Networking Services Library Functions               t_errno(3NSL)



NAME
     t_errno - XTI error return value

SYNOPSIS
     #include 


DESCRIPTION
     This error return value is part of the XTI  interfaces  that
     evolved  from  the TLI interfaces. XTI represents the future
     evolution of these interfaces. However, TLI  interfaces  are
     supported for compatibility. When using a TLI interface that
     has the same name as an XTI interfaces, a different  header-
     file,  ,  must be used. Refer the the TLI COMPATI-
     BILITY section for a description of differences between  the
     two interfaces.


     t_errno is used by XTI functions to return error values.


     XTI functions provide an error number in  t_errno which  has
     type   int and is defined in  . The value of  t_errno
     will be defined only after a call  to  a  XTI  function  for
     which  it  is  explicitly  stated  to be set and until it is
     changed by the next XTI function call. The value of  t_errno
     should  only be examined when it is indicated to be valid by
     a function's return value. Programs should obtain the defin-
     ition of  t_errno by the inclusion of  . The practice
     of defining  t_errno in program as  extern  int  t_errno  is
     obsolescent.  No XTI function sets  t_errno to 0 to indicate
     an error.


     It is unspecified whether t_errno is a macro or an  identif-
     ier  with  external  linkage.   It  represents  a modifiable
     lvalue of type int. If a macro definition is  suppressed  in
     order  to  access  an  actual object or a program defines an
     identifier with name  t_errno, the behavior is undefined.


     The symbolic values stored in  t_errno by  an  XTI  function
     are defined in the ERRORS sections in all relevant XTI func-
     tion definition pages.

TLI COMPATIBILITY
     t_errno is also  used  by  TLI  functions  to  return  error
     values.


     The XTI and TLI interface definitions have common names  but
     use   different  header  files.  This,  and  other  semantic



SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions               t_errno(3NSL)



     differences between the two interfaces are described in  the
     subsections below.

  Interface Header
     The XTI interfaces use the header file, . TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:
       #include 

  Error Description Values
     The t_errno values that can be set by the XTI interface  but
     cannot be set by the TLI interface are:
       TNOSTRUCTYPE
       TBADNAME
       TBADQLEN
       TADDRBUSY
       TINDOUT
       TPROVMISMATCH
       TRESADDR
       TQFULL
       TPROTO

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5)


















SunOS 5.11           Last change: 7 May 1998                    2