home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / aserrorcode.z / aserrorcode
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaasssseeeerrrrrrrroooorrrrccccooooddddeeee((((3333xxxx))))                                                aaaasssseeeerrrrrrrroooorrrrccccooooddddeeee((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aserrorcode - array services error information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  13.  
  14.      eeeexxxxtttteeeerrrrnnnn aaaasssseeeerrrrrrrroooorrrr____tttt aaaasssseeeerrrrrrrroooorrrrccccooooddddeeee;;;;
  15.  
  16.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrnnnnoooocccc((((eeeerrrrrrrroooorrrrccccooooddddeeee))))
  17.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrwwwwhhhhaaaattttcccc((((eeeerrrrrrrroooorrrrccccooooddddeeee))))
  18.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrwwwwhhhhyyyycccc((((eeeerrrrrrrroooorrrrccccooooddddeeee))))
  19.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrreeeexxxxttttrrrraaaacccc((((eeeerrrrrrrroooorrrrccccooooddddeeee))))
  20.  
  21.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrnnnnoooo    ...
  22.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrwwwwhhhhaaaatttt  ...
  23.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrrwwwwhhhhyyyy   ...
  24.      ####ddddeeeeffffiiiinnnneeee aaaasssseeeerrrrrrrreeeexxxxttttrrrraaaa ...
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _a_s_e_r_r_o_r_c_o_d_e is a global variable maintained by the array services
  28.      library, lllliiiibbbbaaaarrrrrrrraaaayyyy.  Many array services functions store detailed status
  29.      in this variable when they complete.  The variable _a_s_e_r_r_o_r_c_o_d_e is made up
  30.      of four fields, which can be accessed with the following macros:
  31.  
  32.      _aaaa_ssss_eeee_rrrr_rrrr_nnnn_oooo
  33.           Summarizes the results of the most recent array services function.
  34.           This is similar to the libc variable _e_r_r_n_o in that it is only set if
  35.           some sort of error condition occurred.
  36.  
  37.      _aaaa_ssss_eeee_rrrr_rrrr_wwww_hhhh_aaaa_tttt
  38.           For certain values of _a_s_e_r_r_n_o, this field describes the particular
  39.           component that experienced trouble.
  40.  
  41.      _aaaa_ssss_eeee_rrrr_rrrr_wwww_hhhh_yyyy
  42.           For certain values of _a_s_e_r_r_n_o, this field describes why the error
  43.           occurred.
  44.  
  45.      _aaaa_ssss_eeee_rrrr_rrrr_eeee_xxxx_tttt_rrrr_aaaa
  46.           Certain combinations of _a_s_e_r_r_n_o, _a_s_e_r_r_w_h_a_t and/or _a_s_e_r_r_w_h_y may cause
  47.           some additional information to be stored in this field.  The exact
  48.           information depends on the particular combination.
  49.  
  50.      The specific values that can be stored in these fields are described in
  51.      the file <arraysvcs.h>.
  52.  
  53.      The individual fields of an error code can be extracted from an arbitrary
  54.      value using the _a_s_e_r_r_n_o_c, _a_s_e_r_r_w_h_a_t_c, _a_s_e_r_r_w_h_y_c and _a_s_e_r_r_e_x_t_r_a_c functions
  55.      respectively.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaasssseeeerrrrrrrroooorrrrccccooooddddeeee((((3333xxxx))))                                                aaaasssseeeerrrrrrrroooorrrrccccooooddddeeee((((3333xxxx))))
  71.  
  72.  
  73.  
  74. NOTES
  75.      _a_s_e_r_r_o_r_c_o_d_e is defined in the library "libarray.so", and will be loaded
  76.      if the option "-larray" is used with _c_c(1) or _l_d(1).
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      asmakeerror(3X), asperror(3X), asstrerror(3X), array_sessions(5).
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.