home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / bioerror.z / bioerror
Encoding:
Text File  |  1998-10-30  |  4.0 KB  |  66 lines
  1.  
  2.  
  3.  
  4. bbbbiiiiooooeeeerrrrrrrroooorrrr((((DDDD3333))))                                                      bbbbiiiiooooeeeerrrrrrrroooorrrr((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr - manipulate error fields within a buffer header
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_bbbb_uuuu_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _vvvv_oooo_iiii_dddd _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr_((((_bbbb_uuuu_ffff______tttt _****_b_p_,,,, _iiii_nnnn_tttt _e_r_r_n_o_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _b_p        Pointer to the buffer header structure.
  19.  
  20.      _e_r_r_n_o     Error number to be set, or zero to indicate that the error
  21.                fields within the buffer header should be cleared.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr is used to manipulate the error fields within a buffer header
  25.      (_bbbb_uuuu_ffff(D4) structure).
  26.  
  27.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  28.      None
  29.  
  30. UUUUSSSSAAAAGGGGEEEE
  31.      Driver code (for example, a _ssss_tttt_rrrr_aaaa_tttt_eeee_gggg_yyyy(D2) routine) that wishes to report
  32.      an I/O error condition associated with the buffer pointed to by _b_p should
  33.      call _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr with _e_r_r_n_o set to the appropriate error number.  This will
  34.      set the appropriate fields within the buffer header so that higher level
  35.      code can detect the error and retrieve the error number using
  36.      _gggg_eeee_tttt_eeee_rrrr_rrrr_oooo_rrrr(D3).
  37.  
  38.      The error fields within the buffer header can be cleared by calling
  39.      _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr with _e_r_r_n_o set to zero.
  40.  
  41.      On multiprocessor systems, DDI/DKI conforming drivers are no longer
  42.      permitted to manipulate the error fields of the _bbbb_uuuu_ffff structure directly.
  43.      _bbbb_iiii_oooo_eeee_rrrr_rrrr_oooo_rrrr must be used for this purpose.
  44.  
  45.    LLLLeeeevvvveeeellll
  46.      Base or Interrupt.
  47.  
  48.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  49.      Does not sleep.
  50.  
  51.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  52.      across calls to this function.
  53.  
  54. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  55.      _bbbb_uuuu_ffff(D4), _eeee_rrrr_rrrr_nnnn_oooo_ssss(D5), _gggg_eeee_tttt_eeee_bbbb_llll_kkkk(D3), _gggg_eeee_tttt_eeee_rrrr_rrrr_oooo_rrrr(D3), _gggg_eeee_tttt_rrrr_bbbb_uuuu_ffff(D3),
  56.      _nnnn_gggg_eeee_tttt_eeee_bbbb_llll_kkkk(D3), _ssss_tttt_rrrr_aaaa_tttt_eeee_gggg_yyyy(D2)
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.