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