]> bbs.cooldavid.org Git - net-next-2.6.git/blame - include/linux/timer.h
8139cp: fix checksum broken
[net-next-2.6.git] / include / linux / timer.h
CommitLineData
1da177e4
LT
1#ifndef _LINUX_TIMER_H
2#define _LINUX_TIMER_H
3
1da177e4 4#include <linux/list.h>
82f67cd9 5#include <linux/ktime.h>
1da177e4 6#include <linux/stddef.h>
c6f3a97f 7#include <linux/debugobjects.h>
6f2b9b9a 8#include <linux/stringify.h>
1da177e4 9
a6fa8e5a 10struct tvec_base;
1da177e4
LT
11
12struct timer_list {
3bbb9ec9
AV
13 /*
14 * All fields that change during normal runtime grouped to the
15 * same cacheline
16 */
1da177e4
LT
17 struct list_head entry;
18 unsigned long expires;
3bbb9ec9 19 struct tvec_base *base;
1da177e4 20
1da177e4
LT
21 void (*function)(unsigned long);
22 unsigned long data;
23
3bbb9ec9
AV
24 int slack;
25
82f67cd9
IM
26#ifdef CONFIG_TIMER_STATS
27 void *start_site;
28 char start_comm[16];
29 int start_pid;
30#endif
6f2b9b9a
JB
31#ifdef CONFIG_LOCKDEP
32 struct lockdep_map lockdep_map;
33#endif
1da177e4
LT
34};
35
a6fa8e5a 36extern struct tvec_base boot_tvec_bases;
55c888d6 37
6f2b9b9a
JB
38#ifdef CONFIG_LOCKDEP
39/*
40 * NB: because we have to copy the lockdep_map, setting the lockdep_map key
41 * (second argument) here is required, otherwise it could be initialised to
42 * the copy of the lockdep_map later! We use the pointer to and the string
43 * "<file>:<line>" as the key resp. the name of the lockdep_map.
44 */
45#define __TIMER_LOCKDEP_MAP_INITIALIZER(_kn) \
46 .lockdep_map = STATIC_LOCKDEP_MAP_INIT(_kn, &_kn),
47#else
48#define __TIMER_LOCKDEP_MAP_INITIALIZER(_kn)
49#endif
50
1da177e4 51#define TIMER_INITIALIZER(_function, _expires, _data) { \
c6f3a97f 52 .entry = { .prev = TIMER_ENTRY_STATIC }, \
1da177e4
LT
53 .function = (_function), \
54 .expires = (_expires), \
55 .data = (_data), \
3691c519 56 .base = &boot_tvec_bases, \
6f2b9b9a
JB
57 __TIMER_LOCKDEP_MAP_INITIALIZER( \
58 __FILE__ ":" __stringify(__LINE__)) \
1da177e4
LT
59 }
60
8d06afab
IM
61#define DEFINE_TIMER(_name, _function, _expires, _data) \
62 struct timer_list _name = \
63 TIMER_INITIALIZER(_function, _expires, _data)
64
6f2b9b9a
JB
65void init_timer_key(struct timer_list *timer,
66 const char *name,
67 struct lock_class_key *key);
68void init_timer_deferrable_key(struct timer_list *timer,
69 const char *name,
70 struct lock_class_key *key);
71
72#ifdef CONFIG_LOCKDEP
73#define init_timer(timer) \
74 do { \
75 static struct lock_class_key __key; \
76 init_timer_key((timer), #timer, &__key); \
77 } while (0)
78
79#define init_timer_deferrable(timer) \
80 do { \
81 static struct lock_class_key __key; \
82 init_timer_deferrable_key((timer), #timer, &__key); \
83 } while (0)
84
85#define init_timer_on_stack(timer) \
86 do { \
87 static struct lock_class_key __key; \
88 init_timer_on_stack_key((timer), #timer, &__key); \
89 } while (0)
90
91#define setup_timer(timer, fn, data) \
92 do { \
93 static struct lock_class_key __key; \
94 setup_timer_key((timer), #timer, &__key, (fn), (data));\
95 } while (0)
96
97#define setup_timer_on_stack(timer, fn, data) \
98 do { \
99 static struct lock_class_key __key; \
100 setup_timer_on_stack_key((timer), #timer, &__key, \
101 (fn), (data)); \
102 } while (0)
8cadd283
JB
103#define setup_deferrable_timer_on_stack(timer, fn, data) \
104 do { \
105 static struct lock_class_key __key; \
106 setup_deferrable_timer_on_stack_key((timer), #timer, \
107 &__key, (fn), \
108 (data)); \
109 } while (0)
6f2b9b9a
JB
110#else
111#define init_timer(timer)\
112 init_timer_key((timer), NULL, NULL)
113#define init_timer_deferrable(timer)\
114 init_timer_deferrable_key((timer), NULL, NULL)
115#define init_timer_on_stack(timer)\
116 init_timer_on_stack_key((timer), NULL, NULL)
117#define setup_timer(timer, fn, data)\
118 setup_timer_key((timer), NULL, NULL, (fn), (data))
119#define setup_timer_on_stack(timer, fn, data)\
120 setup_timer_on_stack_key((timer), NULL, NULL, (fn), (data))
8cadd283
JB
121#define setup_deferrable_timer_on_stack(timer, fn, data)\
122 setup_deferrable_timer_on_stack_key((timer), NULL, NULL, (fn), (data))
6f2b9b9a 123#endif
1da177e4 124
c6f3a97f 125#ifdef CONFIG_DEBUG_OBJECTS_TIMERS
6f2b9b9a
JB
126extern void init_timer_on_stack_key(struct timer_list *timer,
127 const char *name,
128 struct lock_class_key *key);
c6f3a97f
TG
129extern void destroy_timer_on_stack(struct timer_list *timer);
130#else
131static inline void destroy_timer_on_stack(struct timer_list *timer) { }
6f2b9b9a
JB
132static inline void init_timer_on_stack_key(struct timer_list *timer,
133 const char *name,
134 struct lock_class_key *key)
c6f3a97f 135{
6f2b9b9a 136 init_timer_key(timer, name, key);
c6f3a97f
TG
137}
138#endif
139
6f2b9b9a
JB
140static inline void setup_timer_key(struct timer_list * timer,
141 const char *name,
142 struct lock_class_key *key,
a8db2db1
ON
143 void (*function)(unsigned long),
144 unsigned long data)
145{
146 timer->function = function;
147 timer->data = data;
6f2b9b9a 148 init_timer_key(timer, name, key);
a8db2db1
ON
149}
150
6f2b9b9a
JB
151static inline void setup_timer_on_stack_key(struct timer_list *timer,
152 const char *name,
153 struct lock_class_key *key,
c6f3a97f
TG
154 void (*function)(unsigned long),
155 unsigned long data)
156{
157 timer->function = function;
158 timer->data = data;
6f2b9b9a 159 init_timer_on_stack_key(timer, name, key);
c6f3a97f
TG
160}
161
8cadd283
JB
162extern void setup_deferrable_timer_on_stack_key(struct timer_list *timer,
163 const char *name,
164 struct lock_class_key *key,
165 void (*function)(unsigned long),
166 unsigned long data);
167
45f8bde0 168/**
1da177e4
LT
169 * timer_pending - is a timer pending?
170 * @timer: the timer in question
171 *
172 * timer_pending will tell whether a given timer is currently pending,
173 * or not. Callers must ensure serialization wrt. other operations done
174 * to this timer, eg. interrupt contexts, or other CPUs on SMP.
175 *
176 * return value: 1 if the timer is pending, 0 if not.
177 */
178static inline int timer_pending(const struct timer_list * timer)
179{
55c888d6 180 return timer->entry.next != NULL;
1da177e4
LT
181}
182
183extern void add_timer_on(struct timer_list *timer, int cpu);
184extern int del_timer(struct timer_list * timer);
1da177e4 185extern int mod_timer(struct timer_list *timer, unsigned long expires);
74019224 186extern int mod_timer_pending(struct timer_list *timer, unsigned long expires);
597d0275 187extern int mod_timer_pinned(struct timer_list *timer, unsigned long expires);
1da177e4 188
3bbb9ec9
AV
189extern void set_timer_slack(struct timer_list *time, int slack_hz);
190
597d0275
AB
191#define TIMER_NOT_PINNED 0
192#define TIMER_PINNED 1
eaad084b
TG
193/*
194 * The jiffies value which is added to now, when there is no timer
195 * in the timer wheel:
196 */
197#define NEXT_TIMER_MAX_DELTA ((1UL << 30) - 1)
198
fd064b9b
TG
199/*
200 * Return when the next timer-wheel timeout occurs (in absolute jiffies),
201 * locks the timer base and does the comparison against the given
202 * jiffie.
203 */
204extern unsigned long get_next_timer_interrupt(unsigned long now);
1da177e4 205
82f67cd9
IM
206/*
207 * Timer-statistics info:
208 */
209#ifdef CONFIG_TIMER_STATS
210
507e1231
HC
211extern int timer_stats_active;
212
c5c061b8
VP
213#define TIMER_STATS_FLAG_DEFERRABLE 0x1
214
82f67cd9
IM
215extern void init_timer_stats(void);
216
217extern void timer_stats_update_stats(void *timer, pid_t pid, void *startf,
c5c061b8
VP
218 void *timerf, char *comm,
219 unsigned int timer_flag);
82f67cd9
IM
220
221extern void __timer_stats_timer_set_start_info(struct timer_list *timer,
222 void *addr);
223
224static inline void timer_stats_timer_set_start_info(struct timer_list *timer)
225{
507e1231
HC
226 if (likely(!timer_stats_active))
227 return;
82f67cd9
IM
228 __timer_stats_timer_set_start_info(timer, __builtin_return_address(0));
229}
230
231static inline void timer_stats_timer_clear_start_info(struct timer_list *timer)
232{
233 timer->start_site = NULL;
234}
235#else
236static inline void init_timer_stats(void)
237{
238}
239
82f67cd9
IM
240static inline void timer_stats_timer_set_start_info(struct timer_list *timer)
241{
242}
243
244static inline void timer_stats_timer_clear_start_info(struct timer_list *timer)
245{
246}
247#endif
248
74019224 249extern void add_timer(struct timer_list *timer);
1da177e4
LT
250
251#ifdef CONFIG_SMP
fd450b73 252 extern int try_to_del_timer_sync(struct timer_list *timer);
1da177e4 253 extern int del_timer_sync(struct timer_list *timer);
1da177e4 254#else
fd450b73
ON
255# define try_to_del_timer_sync(t) del_timer(t)
256# define del_timer_sync(t) del_timer(t)
1da177e4
LT
257#endif
258
55c888d6
ON
259#define del_singleshot_timer_sync(t) del_timer_sync(t)
260
1da177e4
LT
261extern void init_timers(void);
262extern void run_local_timers(void);
05cfb614 263struct hrtimer;
c9cb2e3d 264extern enum hrtimer_restart it_real_fn(struct hrtimer *);
1da177e4 265
4c36a5de
AV
266unsigned long __round_jiffies(unsigned long j, int cpu);
267unsigned long __round_jiffies_relative(unsigned long j, int cpu);
268unsigned long round_jiffies(unsigned long j);
269unsigned long round_jiffies_relative(unsigned long j);
270
9c133c46
AS
271unsigned long __round_jiffies_up(unsigned long j, int cpu);
272unsigned long __round_jiffies_up_relative(unsigned long j, int cpu);
273unsigned long round_jiffies_up(unsigned long j);
274unsigned long round_jiffies_up_relative(unsigned long j);
275
1da177e4 276#endif