diff options
Diffstat (limited to '')
-rw-r--r-- | cpukit/score/include/rtems/score/timespec.h | 130 |
1 files changed, 130 insertions, 0 deletions
diff --git a/cpukit/score/include/rtems/score/timespec.h b/cpukit/score/include/rtems/score/timespec.h new file mode 100644 index 0000000000..b8c4d16f24 --- /dev/null +++ b/cpukit/score/include/rtems/score/timespec.h @@ -0,0 +1,130 @@ +/** + * @file rtems/score/timespec.h + * + * This include file contains helpers for manipulating timespecs. + */ + +/* + * COPYRIGHT (c) 1989-2007. + * On-Line Applications Research Corporation (OAR). + * + * The license and distribution terms for this file may be + * found in the file LICENSE in this distribution or at + * http://www.rtems.com/license/LICENSE. + * + * $Id$ + */ + +#ifndef _RTEMS_SCORE_TIMESPEC_H +#define _RTEMS_SCORE_TIMESPEC_H + +/** + * @defgroup Timespec Helpers + * + * This handler encapsulates functionality related to manipulating + * POSIX struct timespecs. + */ +/**@{*/ + +#ifdef __cplusplus +extern "C" { +#endif + +#include <sys/types.h> +#include <rtems/score/tod.h> +#include <rtems/score/watchdog.h> + +/** @brief Is Timespec Valid + * + * This method determines the validatity of a timespec. + * + * @param[in] time is the timespec instance to validate. + * + * @return This method returns true if @a time is valid and + * false otherwise. + */ +boolean _Timespec_Is_valid( + const struct timespec *time +); + +/** @brief Timespec Less Than Operator + * + * This method is the less than operator for timespecs. + * + * @param[in] lhs is the left hand side timespec + * @param[in] rhs is the left hand side timespec + * + * @return This method returns true if @a lhs is less than the @a rhs and + * false otherwise. + */ +boolean _Timespec_Less_than( + const struct timespec *lhs, + const struct timespec *rhs +); + +/** @brief Add to a Timespec + * + * This routine adds two timespecs. The second argument is added + * to the first. + * + * @param[in] time is the base time to be added to + * @param[in] add is the timespec to add to the first argument + * + * @return This method returns the number of seconds @a time increased by. + */ +uint32_t _Timespec_Add_to( + struct timespec *time, + const struct timespec *add +); + +/** @brief Convert Timespec to Number of Ticks + * + * This routine convert the @a time timespec to the corresponding number + * of clock ticks. + * + * @param[in] time is the time to be converted + * + * @return This method returns the number of ticks computed. + */ +uint32_t _Timespec_To_ticks( + const struct timespec *time +); + +/** @brief Convert Ticks to Timespec + * + * This routine converts the @a ticks value to the corresponding + * timespec format @a time. + * + * @param[in] time is the timespec format time result + * @param[in] ticks is the number of ticks to convert + */ +void _Timespec_From_ticks( + uint32_t ticks, + struct timespec *time +); + +/** @brief Subtract Two Timespec + * + * This routine subtracts two timespecs. @a result is set to + * @a end - @a start. + * + * @param[in] start is the starting time + * @param[in] end is the ending time + * @param[in] result is the difference between starting and ending time. + * + * @return This method fills in @a result. + */ +void _Timespec_Subtract( + const struct timespec *start, + const struct timespec *end, + struct timespec *result +); + +#ifdef __cplusplus +} +#endif + +/**@}*/ + +#endif +/* end of include file */ |