1Coverage-Area: Clocks and Timers (TMR) 2Area-Code: tmr 3 4/* 5COVERAGE DOCUMENT FOR TIMERS 6============================ 7 8This 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// ================================================= 23clock YES MED 24clock_getcpuclockid YES LOW 25clock_getres YES MED 26clock_gettime YES* MED 27clock_settime YES* MED 28clock_nanosleep YES* HIGH 29nanosleep YES HIGH 30timer_create YES* HIGH 31timer_delete YES MED 32timer_getoverrun YES HIGH 33timer_gettime YES MED 34timer_settime YES MED 35// =================================================== 36 37// *Incomplete because process time clocks functionality not in current version 38// under test. 39 40/* 41NOTES 42===== 43See the BUILD file in the main directory for the most up-to-date 44information on how to compile tests from within the framework. 45 46Some additional notes: 47If you want to get CLOCK_MONOTONIC, though, one option that worked 48with HRT 2.5.54bk6 and below and RH7.3 was to include 49/usr/src/linux/Documentation/high-res-timers/lib/posix_time.h 50and turn on -D_POSIX_TIMERS. 51 52Testing BIN List 53================ 54Items which I'd like to test more in the future (possibly in functional or 55stress 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 68document. 69 70POSIX Timers Implementations 71============================ 72glibc Timers in user-space - http://ftp.gnu.org/gnu/glibc/ 73High Res Timers - http://high-res-timers.sourceforge.net 74Alternate 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 80Maintainer: Julie Fleischer 81