aserrorcode(3x)

NAME
     aserrorcode - array services error information

SYNOPSIS
     #include <arraysvcs.h>

     extern aserror_t aserrorcode;

     #define aserrnoc(errorcode)
     #define aserrwhatc(errorcode)
     #define aserrwhyc(errorcode)
     #define aserrextrac(errorcode)

     #define aserrno    ...
     #define aserrwhat  ...
     #define aserrwhy   ...
     #define aserrextra ...

DESCRIPTION
     aserrorcode is a global variable maintained by the array services
     library, libarray.  Many array services functions store detailed status
     in this variable when they complete.  The variable aserrorcode is made up
     of four fields, which can be accessed with the following macros:

     aserrno
          Summarizes the results of the most recent array services function.
          This is similar to the libc variable errno in that it is only set if
          some sort of error condition occurred.

     aserrwhat
          For certain values of aserrno, this field describes the particular
          component that experienced trouble.

     aserrwhy
          For certain values of aserrno, this field describes why the error
          occurred.

     aserrextra
          Certain combinations of aserrno, aserrwhat and/or aserrwhy may cause
          some additional information to be stored in this field.  The exact
          information depends on the particular combination.

     The specific values that can be stored in these fields are described in
     the file <arraysvcs.h>.

     The individual fields of an error code can be extracted from an arbitrary
     value using the aserrnoc, aserrwhatc, aserrwhyc and aserrextrac functions
     respectively.
NOTES
     aserrorcode is defined in the library "libarray.so", and will be loaded
     if the option "-larray" is used with cc(1) or ld(1).

SEE ALSO
     asmakeerror(3X), asperror(3X), asstrerror(3X), array_sessions(5).