home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SLPerror.z / SLPerror
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSLLLLPPPPeeeerrrrrrrroooorrrr((((3333))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSLLLLPPPPeeeerrrrrrrroooorrrr((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SLPerror, SLErrorString - obtain libspool execution error messages
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssppppoooooooollll....hhhh>>>>
  13.  
  14.      vvvvooooiiiidddd SSSSLLLLPPPPeeeerrrrrrrroooorrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ssss))));;;;
  15.  
  16.      cccchhhhaaaarrrr**** SSSSLLLLEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg((((iiiinnnntttt eeeerrrrrrrr____ccccooooddddeeee))));;;;
  17.  
  18.      eeeexxxxtttteeeerrrrnnnn iiiinnnntttt SSSSLLLLeeeerrrrrrrrnnnnoooo;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _S_L_P_e_r_r_o_r prints error messages to standard error in a format similar to
  22.      the standard C library function _p_e_r_r_o_r(_3_C). _S_L_E_r_r_o_r_S_t_r_i_n_g returns the
  23.      error string corresponding to the _l_i_b_s_p_o_o_l error code specified by
  24.      _e_r_r__c_o_d_e. The function is similar to the C library function _s_t_r_e_r_r_o_r(_3_C).
  25.  
  26.      If an error occurs during a _l_i_b_s_p_o_o_l function call, the global error
  27.      variable _S_L_e_r_r_n_o will be set with an error code.  The symbolic names for
  28.      these error codes are defined in _s_p_o_o_l._h.
  29.  
  30.      The value of _S_L_e_r_r_n_o is used by _S_L_P_e_r_r_o_r as an index to a table of error
  31.      messages. _S_L_e_r_r_n_o can be passed to _S_L_E_r_r_o_r_S_t_r_i_n_g to obtain the _l_i_b_s_p_o_o_l
  32.      error message corresponding to the error code.  The variable _S_L_e_r_r_n_o is
  33.      globally available to user programs.
  34.  
  35.      A call to _S_L_P_e_r_r_o_r will print the user-supplied string _s followed by a
  36.      colon (:), a space, and the error message corresponding to the current
  37.      value of _S_L_e_r_r_n_o. If the string _s is the NULL string (""), no colon or
  38.      space will be printed, only the error message.
  39.  
  40.      To be of most use, a call to _S_L_P_e_r_r_o_r should be made immediately
  41.      following the _l_i_b_s_p_o_o_l function call where an error has been detected.
  42.  
  43. SSSSPPPPOOOOOOOOLLLLIIIINNNNGGGG SSSSYYYYSSSSTTTTEEEEMMMM EEEERRRRRRRROOOORRRRSSSS
  44.      _l_i_b_s_p_o_o_l provides a C interface to the UNIX print spooling systems. In
  45.      fact, many _l_i_b_s_p_o_o_l functions execute the spooling system shell commands.
  46.      If an error has been detected after the execution of a _l_i_b_s_p_o_o_l function
  47.      and _S_L_e_r_r_n_o is found to be set to SSSSLLLL____EEEERRRRRRRR____SSSSPPPPOOOOOOOOLLLLEEEERRRR____EEEERRRRRRRROOOORRRR, this indicates
  48.      that an error has occurred during the execution of a spooling system
  49.      command. Under this condition _S_L_P_e_r_r_o_r will report only that a spooling
  50.      system error has occurred. To obtain the actual spooling system command
  51.      error message(s) and exit status, call the function _S_L_G_e_t_S_p_o_o_l_e_r_E_r_r_o_r(_3).
  52.  
  53. NNNNOOOOTTTTEEEE
  54.      The global variables _S_L_e_r_r_l_i_s_t and _S_L_n_e_r_r should no longer be referenced.
  55.      The function _S_L_E_r_r_o_r_S_t_r_i_n_g should be used.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSLLLLPPPPeeeerrrrrrrroooorrrr((((3333))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSLLLLPPPPeeeerrrrrrrroooorrrr((((3333))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      SLGetSpoolerError(3), libspool(3)
  76.  
  77.  
  78.  
  79.  
  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.