home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / timer_getoverrun.z / timer_getoverrun
Encoding:
Text File  |  1998-10-20  |  3.1 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ttttiiiimmmmeeeerrrr____ggggeeeettttoooovvvveeeerrrrrrrruuuunnnn((((3333CCCC))))                                      ttttiiiimmmmeeeerrrr____ggggeeeettttoooovvvveeeerrrrrrrruuuunnnn((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_oooo_vvvv_eeee_rrrr_rrrr_uuuu_nnnn - get the posix timer overrun count
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_mmmm_eeee_...._hhhh_>>>>
  13.      _iiii_nnnn_tttt _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_oooo_vvvv_eeee_rrrr_rrrr_uuuu_nnnn _((((_tttt_iiii_mmmm_eeee_rrrr______tttt _t_i_m_e_r_i_d_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_oooo_vvvv_eeee_rrrr_rrrr_uuuu_nnnn returns the current expiration notification overrun
  17.      count for the posix timer named by _t_i_m_e_r_i_d.
  18.  
  19.      An overrun count is the number of timer expiration notifications which
  20.      were not delivered to the process due to an already pending signal from
  21.      _t_i_m_e_r_i_d.  This overrun condition may occur because a given posix timer
  22.      can only queue one signal to the process at any point in time.
  23.  
  24.      If the returned overrun count is positive, then the count represents the
  25.      number of timer overruns up to, but not including {_DDDD_EEEE_LLLL_AAAA_YYYY_TTTT_IIII_MMMM_EEEE_RRRR______MMMM_AAAA_XXXX} [see
  26.      _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C)].
  27.  
  28.      If the returned overrun count is zero, then no timer expiration overruns
  29.      have occurred between the last expiration notification and the time of
  30.      the call to _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_oooo_vvvv_eeee_rrrr_rrrr_uuuu_nnnn.
  31.  
  32.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_oooo_vvvv_eeee_rrrr_rrrr_uuuu_nnnn will fail if the following is true:
  33.  
  34.      [EINVAL]    The _t_i_m_e_r_i_d does not name a valid posix timer.
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      timer_create(3C), timer_delete(3C), timer_gettime(3C), timer_settime(3C),
  38.      sysconf(3C)
  39.  
  40. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  41.      Upon successful completion, the timer overrun count is returned to the
  42.      calling process. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to
  43.      indicate the error.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.