readme

fsmlabs的real time linux的内核

******************************************************************
 
 * Copyright (c) 2002, Intel Corporation. All rights reserved.
 * Created by:  julie.n.fleischer REMOVE-THIS AT intel DOT com
 * This file is licensed under the GPL license.  For the full content
 * of this license, see the COPYING file at the top level of this
 * source tree.
 
        Addapted by J. Vidal <[e-mail]> to RTLinux 10-12-02.
 
******************************************************************

TEST: 1-1.c
 * Test that timer_gettime() sets sets itimerspec.it_value to the
 * amount of time remaining.
 * - Create and arm a timer.
 * - Call timer_gettime().
 * - Ensure the value returned is within ACCEPTABLEDELTA less than
 *   the value set.
 *
 * Signal SIGCONT will be used so that it will not affect the test if
 * the timer expires.
 * Clock CLOCK_REALTIME will be used.

******************************************************************

TEST: 1-2.c
 * Test that timer_gettime() sets sets itimerspec.it_value to the
 * amount of time remaining in the middle of a timer.
 * - Create and arm a timer for TIMERSEC seconds.
 * - Sleep for SLEEPSEC < TIMERSEC.
 * - Call timer_gettime().
 * - Ensure the value returned is within ACCEPTABLEDELTA less than
 *   TIMERSEC-SLEEPSEC.
 *
 * Signal SIGCONT will be used so that it will not affect the test if
 * the timer expires.
 * Clock CLOCK_REALTIME will be used.

******************************************************************

TEST: 1-3.c
 * Test that timer_gettime() sets sets itimerspec.it_value to the
 * amount of time remaining in the middle of a timer.
 * - Create and arm a timer for TIMERNSEC nanoseconds.
 * - Sleep for SLEEPNSEC < TIMERNSEC.
 * - Call timer_gettime().
 * - Ensure the value returned is within ACCEPTABLEDELTA less than
 *   TIMERNSEC-SLEEPNSEC.
 *
 * Signal SIGCONT will be used so that it will not affect the test if
 * the timer expires.
 * Clock CLOCK_REALTIME will be used.
	 * Algorithm for determining success:
	 * - itsget must be < itsset
	 * - itsset-itsget nsec must be <= ACCEPTABLEDELTA

******************************************************************

TEST: 1-4.c
 * Test that timer_gettime() sets itimerspec.it_value to the amount of
 * time remaining after it has expired once and is reloaded.  Also
 * test that timer_gettime() sets itimerspec.it_interval to the
 * interval remaining.
 * - Create and arm a timer for TIMERVALSEC seconds with interval
 *   TIMERINTERVALSEC seconds.
 * - Sleep for SLEEPSEC > TIMERVALSEC, but < TIMERINTERVAL seconds
 * - Call timer_gettime().
 * - Ensure the value returned is within ACCEPTABLEDELTA less than
 *   TIMERINTERVALSEC - (SLEEPSEC-TIMERVALSEC).
 * - Ensure that interval TIMERINTERVALSEC is returned.
 *
 * Signal SIGCONT will be used so that it will not affect the test if
 * the timer expires.
 * Clock CLOCK_REALTIME will be used.
	 * Check interval first
	 * Check value next
	 * value should be < TIMERINTERVALSEC - (SLEEPSEC-TIMERVALSEC)

******************************************************************

TEST: 2-1.c
 *
 * Test that timer_gettime() sets itimerspec.it_value = 0 if the timer
 * was previously disarmed because it had just been created.
 *
 * For this test, signal SIGCONT will be used so that the test will
 * not abort.  Clock CLOCK_REALTIME will be used.

******************************************************************

TEST: 2-2.c
 *
 * Test that timer_gettime() sets itimerspec.it_value = 0 if 
 * the timer was previously disarmed because it had just expired with
 * no repeating interval.
 *
 * For this test, signal SIGCONT will be used so that the test will
 * not abort.  Clock CLOCK_REALTIME will be used.
	 * set up timer that will expire
	 * let timer expire (just call sleep())

******************************************************************

TEST: 3-1.c
 * Test that timer_gettime() returns a relative amount even on
 * absolute timers.
 * - Create and arm an absolute timer.
 * - Call timer_gettime()
 * - Ensure the value returned is within ACCEPTABLEDELTA less than
 *   the value set.  If it is, the values returned were indeed relative.
 *
 * Signal SIGCONT will be used so that it will not affect the test if
 * the timer expires.
 * Clock CLOCK_REALTIME will be used.

******************************************************************

TEST: 6-1.c
 *
 * Test that timer_gettime() sets errno = EINVAL if no timers have been
 * created yet and it is called with a bogus timer ID.

******************************************************************

TEST: 6-2.c
 *
 * Test that timer_gettime() sets errno = EINVAL timerid != a timer ID
 * created via timer_create().  [Try to set timerid to a timer ID
 * created + 1.]
 *
 * For this test, signal SIGCONT will be used, clock CLOCK_REALTIME
 * will be used.