Loading...
Searching...
No Matches
timer.h
Go to the documentation of this file.
/*
* (C) 2008, 2009 by Holger Hans Peter Freyther <zecke@selfish.org>
* All Rights Reserved
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
*/
#pragma once
#include <sys/time.h>
#include <time.h>
#include <stdbool.h>
#include <osmocom/core/linuxlist.h>
#include <osmocom/core/linuxrbtree.h>
#include <osmocom/core/timer_compat.h>
/* convert absolute time (in seconds) to elapsed days/hours/minutes */
#define OSMO_SEC2MIN(sec) ((sec % (60 * 60)) / 60)
#define OSMO_SEC2HRS(sec) ((sec % (60 * 60 * 24)) / (60 * 60))
#define OSMO_SEC2DAY(sec) ((sec % (60 * 60 * 24 * 365)) / (60 * 60 * 24)) /* we ignore leap year for simplicity */
struct osmo_timer_list {
struct rb_node node;
struct llist_head list;
struct timeval timeout;
unsigned int active : 1;
void (*cb)(void*);
void *data;
};
/*
* timer management
*/
void osmo_timer_setup(struct osmo_timer_list *timer, void (*cb)(void *data), void *data);
void osmo_timer_add(struct osmo_timer_list *timer);
void osmo_timer_schedule(struct osmo_timer_list *timer, int seconds, int microseconds);
void osmo_timer_del(struct osmo_timer_list *timer);
int osmo_timer_pending(const struct osmo_timer_list *timer);
int osmo_timer_remaining(const struct osmo_timer_list *timer,
const struct timeval *now,
struct timeval *remaining);
/*
* internal timer list management
*/
struct timeval *osmo_timers_nearest(void);
int osmo_timers_nearest_ms(void);
void osmo_timers_prepare(void);
int osmo_timers_update(void);
int osmo_timers_check(void);
int osmo_gettimeofday(struct timeval *tv, struct timezone *tz);
int osmo_clock_gettime(clockid_t clk_id, struct timespec *tp);
/*
* timer override
*/
extern bool osmo_gettimeofday_override;
extern struct timeval osmo_gettimeofday_override_time;
void osmo_gettimeofday_override_add(time_t secs, suseconds_t usecs);
void osmo_clock_override_enable(clockid_t clk_id, bool enable);
void osmo_clock_override_add(clockid_t clk_id, time_t secs, long nsecs);
struct timespec *osmo_clock_override_gettimespec(clockid_t clk_id);
osmo_clock_override_gettimespec
struct timespec * osmo_clock_override_gettimespec(clockid_t clk_id)
osmo_timer_remaining
int osmo_timer_remaining(const struct osmo_timer_list *timer, const struct timeval *now, struct timeval *remaining)
compute the remaining time of a timer
Definition timer.c:148
osmo_timer_del
void osmo_timer_del(struct osmo_timer_list *timer)
delete a timer from timer management
Definition timer.c:116
osmo_clock_override_enable
void osmo_clock_override_enable(clockid_t clk_id, bool enable)
osmo_timers_prepare
void osmo_timers_prepare(void)
Find the nearest time and update nearest_p.
Definition timer.c:224
osmo_timers_nearest
struct timeval * osmo_timers_nearest(void)
Determine time between now and the nearest timer.
Definition timer.c:175
osmo_timer_setup
void osmo_timer_setup(struct osmo_timer_list *timer, void(*cb)(void *data), void *data)
set up timer callback and data
Definition timer.c:70
osmo_clock_override_add
void osmo_clock_override_add(clockid_t clk_id, time_t secs, long nsecs)
osmo_gettimeofday
int osmo_gettimeofday(struct timeval *tv, struct timezone *tz)
shim around gettimeofday to be able to set the time manually.
Definition timer_gettimeofday.c:56
osmo_timer_add
void osmo_timer_add(struct osmo_timer_list *timer)
add a new timer to the timer management
Definition timer.c:80
osmo_timer_schedule
void osmo_timer_schedule(struct osmo_timer_list *timer, int seconds, int microseconds)
schedule a timer at a given future relative time
Definition timer.c:99
osmo_gettimeofday_override_time
struct timeval osmo_gettimeofday_override_time
Definition timer_gettimeofday.c:45
osmo_gettimeofday_override
bool osmo_gettimeofday_override
Definition timer_gettimeofday.c:44
osmo_clock_gettime
int osmo_clock_gettime(clockid_t clk_id, struct timespec *tp)
osmo_timer_pending
int osmo_timer_pending(const struct osmo_timer_list *timer)
check if given timer is still pending
Definition timer.c:134
osmo_timers_check
int osmo_timers_check(void)
Check how many timers we have in the system.
Definition timer.c:288
osmo_timers_nearest_ms
int osmo_timers_nearest_ms(void)
Determine time between now and the nearest timer in milliseconds.
Definition timer.c:186
osmo_timers_update
int osmo_timers_update(void)
fire all timers... and remove them
Definition timer.c:242
osmo_gettimeofday_override_add
void osmo_gettimeofday_override_add(time_t secs, suseconds_t usecs)
convenience function to advance the fake time.
Definition timer_gettimeofday.c:68
linuxlist.h
Simple doubly linked list implementation.
linuxrbtree.h
llist_head
(double) linked list header structure
Definition linuxlist.h:46
osmo_timer_list
A structure representing a single instance of a timer.
Definition timer.h:52
osmo_timer_list::list
struct llist_head list
internal list header
Definition timer.h:54
osmo_timer_list::active
unsigned int active
is it active?
Definition timer.h:56
osmo_timer_list::node
struct rb_node node
rb-tree node header
Definition timer.h:53
osmo_timer_list::cb
void(* cb)(void *)
call-back called at timeout
Definition timer.h:58
osmo_timer_list::data
void * data
user data for callback
Definition timer.h:59
osmo_timer_list::timeout
struct timeval timeout
expiration time
Definition timer.h:55
rb_node
Definition linuxrbtree.h:95
timer_compat.h
Compatibility header with some helpers.