home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / timer_gettime.z / timer_gettime
Encoding:
Text File  |  2002-10-03  |  3.2 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ttttiiiimmmmeeeerrrr____ggggeeeettttttttiiiimmmmeeee((((3333CCCC))))                                            ttttiiiimmmmeeeerrrr____ggggeeeettttttttiiiimmmmeeee((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_tttt_iiii_mmmm_eeee - get the time remaining before posix timer expiration
  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_tttt_iiii_mmmm_eeee _((((_tttt_iiii_mmmm_eeee_rrrr______tttt _t_i_m_e_r_i_d_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _iiii_tttt_iiii_mmmm_eeee_rrrr_ssss_pppp_eeee_cccc _****_v_a_l_u_e_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_tttt_iiii_mmmm_eeee retrieves the time remaining before the posix timer named
  17.      by _t_i_m_e_r_i_d expires, as well as, the periodic timer interval between
  18.      expirations and stores the information at memory address _v_a_l_u_e.
  19.  
  20.      The _iiii_tttt______vvvv_aaaa_llll_uuuu_eeee field of _v_a_l_u_e contains the time remainder, while the
  21.      _iiii_tttt______iiii_nnnn_tttt_eeee_rrrr_vvvv_aaaa_llll field contains the periodic timer interval.  If _iiii_tttt______vvvv_aaaa_llll_uuuu_eeee
  22.      contains zero after a successful return, then the timer is disarmed.  If
  23.      _iiii_tttt______iiii_nnnn_tttt_eeee_rrrr_vvvv_aaaa_llll contains zero after a successful return, then the timer is
  24.      not periodic.
  25.  
  26.      _tttt_iiii_mmmm_eeee_rrrr______gggg_eeee_tttt_tttt_iiii_mmmm_eeee will fail if one or more of the following are true:
  27.  
  28.      [EINVAL]    The _t_i_m_e_r_i_d does not name a valid posix timer.
  29.  
  30.      [EFAULT]    The address specified by _v_a_l_u_e is outside the range of the
  31.                  address space of the calling process.
  32.  
  33. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  34.      timer_create(3C), timer_delete(3C), timer_getoverrun(3C),
  35.      timer_settime(3C), clock_settime(2), clock_gettime(2), clock_getres(2),
  36.      getitimer(2), setiitimer(2)
  37.  
  38. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  39.      Upon successful completion, a value of 0 is returned to the calling
  40.      process. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to
  41.      indicate the error.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.