1 Coverage-Area: Clocks and Timers (TMR) 2 Area-Code: tmr 3 4 /* 5 COVERAGE DOCUMENT FOR TIMERS 6 ============================ 7 8 This document lists the items that will be tested for POSIX timers. 9 10 Item to Test Status 11 ========================================================== 12 || Definitions DONE || 13 || Behavior DONE with TMR and CS || 14 || tags planned. || 15 || see table below || 16 || Functionality STOPPED FOR NOW || 17 || Stress STOPPED FOR NOW || 18 ========================================================== 19 */ 20 21 // Function Complete? Priority 22 // ================================================= 23 clock YES MED 24 clock_getcpuclockid YES LOW 25 clock_getres YES MED 26 clock_gettime YES* MED 27 clock_settime YES* MED 28 clock_nanosleep YES* HIGH 29 nanosleep YES HIGH 30 timer_create YES* HIGH 31 timer_delete YES MED 32 timer_getoverrun YES HIGH 33 timer_gettime YES MED 34 timer_settime YES MED 35 // =================================================== 36 37 // *Incomplete because process time clocks functionality not in current version 38 // under test. 39 40 /* 41 NOTES 42 ===== 43 See the BUILD file in the main directory for the most up-to-date 44 information on how to compile tests from within the framework. 45 46 Some additional notes: 47 If you want to get CLOCK_MONOTONIC, though, one option that worked 48 with HRT 2.5.54bk6 and below and RH7.3 was to include 49 /usr/src/linux/Documentation/high-res-timers/lib/posix_time.h 50 and turn on -D_POSIX_TIMERS. 51 52 Testing BIN List 53 ================ 54 Items which I'd like to test more in the future (possibly in functional or 55 stress tests). 56 57 - Absolute timers and clock changes: 58 - test setting the time for a timer where the interval is large 59 - also, test where the delta between old and new clock time is large 60 => forces division of large numbers, could have inaccuracies (would 61 probably? be a stress test) 62 63 - test clock_nanosleep() or nanosleep() with a variety of different signals 64 being sent to interrupt it (esp. if they have no user-handler) 65 -> probably also stress 66 67 - Also, there may be some ideas for stress tests in the Base Definitions 68 document. 69 70 POSIX Timers Implementations 71 ============================ 72 glibc Timers in user-space - http://ftp.gnu.org/gnu/glibc/ 73 High Res Timers - http://high-res-timers.sourceforge.net 74 Alternate High Res Timers - http://high-res-timers.sourceforge.net (look 75 on mailing list for Jim Houston's alternate 76 implementation -- patch that goes on top 77 of George Anzinger's HRT) 78 */ 79 80 Maintainer: Julie Fleischer 81
