blob: 944ca6e6f1c22f213626e860408277e65a360dda [file] [log] [blame]
John Stultzff3ead92011-01-11 09:42:13 -08001/*
2 * Alarmtimer interface
3 *
4 * This interface provides a timer which is similarto hrtimers,
5 * but triggers a RTC alarm if the box is suspend.
6 *
7 * This interface is influenced by the Android RTC Alarm timer
8 * interface.
9 *
10 * Copyright (C) 2010 IBM Corperation
11 *
12 * Author: John Stultz <john.stultz@linaro.org>
13 *
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License version 2 as
16 * published by the Free Software Foundation.
17 */
18#include <linux/time.h>
19#include <linux/hrtimer.h>
20#include <linux/timerqueue.h>
21#include <linux/rtc.h>
Ingo Molnar174cd4b2017-02-02 19:15:33 +010022#include <linux/sched/signal.h>
Ingo Molnarb17b0152017-02-08 18:51:35 +010023#include <linux/sched/debug.h>
John Stultzff3ead92011-01-11 09:42:13 -080024#include <linux/alarmtimer.h>
25#include <linux/mutex.h>
26#include <linux/platform_device.h>
27#include <linux/posix-timers.h>
28#include <linux/workqueue.h>
29#include <linux/freezer.h>
30
Baolin Wang4a057542016-11-28 14:35:21 -080031#define CREATE_TRACE_POINTS
32#include <trace/events/alarmtimer.h>
33
John Stultz180bf812011-04-28 12:58:11 -070034/**
35 * struct alarm_base - Alarm timer bases
36 * @lock: Lock for syncrhonized access to the base
37 * @timerqueue: Timerqueue head managing the list of events
John Stultz180bf812011-04-28 12:58:11 -070038 * @gettime: Function to read the time correlating to the base
39 * @base_clockid: clockid for the base
John Stultz180bf812011-04-28 12:58:11 -070040 */
John Stultzff3ead92011-01-11 09:42:13 -080041static struct alarm_base {
42 spinlock_t lock;
43 struct timerqueue_head timerqueue;
John Stultzff3ead92011-01-11 09:42:13 -080044 ktime_t (*gettime)(void);
45 clockid_t base_clockid;
John Stultzff3ead92011-01-11 09:42:13 -080046} alarm_bases[ALARM_NUMTYPE];
47
Baolin Wang4a057542016-11-28 14:35:21 -080048/* freezer information to handle clock_nanosleep triggered wakeups */
49static enum alarmtimer_type freezer_alarmtype;
50static ktime_t freezer_expires;
John Stultzc008ba582011-06-16 18:27:09 -070051static ktime_t freezer_delta;
52static DEFINE_SPINLOCK(freezer_delta_lock);
53
Todd Poynor59a93c22012-08-09 00:37:27 -070054static struct wakeup_source *ws;
55
John Stultz472647d2011-04-29 15:03:10 -070056#ifdef CONFIG_RTC_CLASS
John Stultz180bf812011-04-28 12:58:11 -070057/* rtc timer and device for setting alarm wakeups at suspend */
Thomas Gleixnerc5e14e72012-03-24 12:46:23 +010058static struct rtc_timer rtctimer;
John Stultzff3ead92011-01-11 09:42:13 -080059static struct rtc_device *rtcdev;
John Stultzc008ba582011-06-16 18:27:09 -070060static DEFINE_SPINLOCK(rtcdev_lock);
John Stultzff3ead92011-01-11 09:42:13 -080061
John Stultzc008ba582011-06-16 18:27:09 -070062/**
John Stultzc008ba582011-06-16 18:27:09 -070063 * alarmtimer_get_rtcdev - Return selected rtcdevice
64 *
65 * This function returns the rtc device to use for wakealarms.
66 * If one has not already been chosen, it checks to see if a
67 * functional rtc device is available.
68 */
John Stultz57c498f2012-04-20 12:31:45 -070069struct rtc_device *alarmtimer_get_rtcdev(void)
John Stultzc008ba582011-06-16 18:27:09 -070070{
John Stultzc008ba582011-06-16 18:27:09 -070071 unsigned long flags;
72 struct rtc_device *ret;
73
74 spin_lock_irqsave(&rtcdev_lock, flags);
John Stultzc008ba582011-06-16 18:27:09 -070075 ret = rtcdev;
76 spin_unlock_irqrestore(&rtcdev_lock, flags);
77
78 return ret;
79}
Pramod Gurav71d5d2b2014-06-13 11:49:42 +053080EXPORT_SYMBOL_GPL(alarmtimer_get_rtcdev);
John Stultz8bc0daf2011-07-14 18:35:13 -070081
82static int alarmtimer_rtc_add_device(struct device *dev,
83 struct class_interface *class_intf)
84{
85 unsigned long flags;
86 struct rtc_device *rtc = to_rtc_device(dev);
87
88 if (rtcdev)
89 return -EBUSY;
90
91 if (!rtc->ops->set_alarm)
92 return -1;
93 if (!device_may_wakeup(rtc->dev.parent))
94 return -1;
95
96 spin_lock_irqsave(&rtcdev_lock, flags);
97 if (!rtcdev) {
98 rtcdev = rtc;
99 /* hold a reference so it doesn't go away */
100 get_device(dev);
101 }
102 spin_unlock_irqrestore(&rtcdev_lock, flags);
103 return 0;
104}
105
Thomas Gleixnerc5e14e72012-03-24 12:46:23 +0100106static inline void alarmtimer_rtc_timer_init(void)
107{
108 rtc_timer_init(&rtctimer, NULL, NULL);
109}
110
John Stultz8bc0daf2011-07-14 18:35:13 -0700111static struct class_interface alarmtimer_rtc_interface = {
112 .add_dev = &alarmtimer_rtc_add_device,
113};
114
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200115static int alarmtimer_rtc_interface_setup(void)
John Stultz8bc0daf2011-07-14 18:35:13 -0700116{
117 alarmtimer_rtc_interface.class = rtc_class;
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200118 return class_interface_register(&alarmtimer_rtc_interface);
119}
120static void alarmtimer_rtc_interface_remove(void)
121{
122 class_interface_unregister(&alarmtimer_rtc_interface);
John Stultz8bc0daf2011-07-14 18:35:13 -0700123}
John Stultz1c6b39a2011-06-16 18:47:37 -0700124#else
John Stultz57c498f2012-04-20 12:31:45 -0700125struct rtc_device *alarmtimer_get_rtcdev(void)
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200126{
127 return NULL;
128}
129#define rtcdev (NULL)
130static inline int alarmtimer_rtc_interface_setup(void) { return 0; }
131static inline void alarmtimer_rtc_interface_remove(void) { }
Thomas Gleixnerc5e14e72012-03-24 12:46:23 +0100132static inline void alarmtimer_rtc_timer_init(void) { }
John Stultzc008ba582011-06-16 18:27:09 -0700133#endif
John Stultzff3ead92011-01-11 09:42:13 -0800134
John Stultz180bf812011-04-28 12:58:11 -0700135/**
John Stultzff3ead92011-01-11 09:42:13 -0800136 * alarmtimer_enqueue - Adds an alarm timer to an alarm_base timerqueue
137 * @base: pointer to the base where the timer is being run
138 * @alarm: pointer to alarm being enqueued.
139 *
John Stultzdae373b2012-09-13 19:12:16 -0400140 * Adds alarm to a alarm_base timerqueue
John Stultzff3ead92011-01-11 09:42:13 -0800141 *
142 * Must hold base->lock when calling.
143 */
144static void alarmtimer_enqueue(struct alarm_base *base, struct alarm *alarm)
145{
John Stultzdae373b2012-09-13 19:12:16 -0400146 if (alarm->state & ALARMTIMER_STATE_ENQUEUED)
147 timerqueue_del(&base->timerqueue, &alarm->node);
148
John Stultzff3ead92011-01-11 09:42:13 -0800149 timerqueue_add(&base->timerqueue, &alarm->node);
John Stultza28cde82011-08-10 12:30:21 -0700150 alarm->state |= ALARMTIMER_STATE_ENQUEUED;
John Stultzff3ead92011-01-11 09:42:13 -0800151}
152
John Stultz180bf812011-04-28 12:58:11 -0700153/**
John Stultza65bcc12012-09-13 19:25:22 -0400154 * alarmtimer_dequeue - Removes an alarm timer from an alarm_base timerqueue
John Stultzff3ead92011-01-11 09:42:13 -0800155 * @base: pointer to the base where the timer is running
156 * @alarm: pointer to alarm being removed
157 *
John Stultzdae373b2012-09-13 19:12:16 -0400158 * Removes alarm to a alarm_base timerqueue
John Stultzff3ead92011-01-11 09:42:13 -0800159 *
160 * Must hold base->lock when calling.
161 */
John Stultza65bcc12012-09-13 19:25:22 -0400162static void alarmtimer_dequeue(struct alarm_base *base, struct alarm *alarm)
John Stultzff3ead92011-01-11 09:42:13 -0800163{
John Stultza28cde82011-08-10 12:30:21 -0700164 if (!(alarm->state & ALARMTIMER_STATE_ENQUEUED))
165 return;
166
John Stultzff3ead92011-01-11 09:42:13 -0800167 timerqueue_del(&base->timerqueue, &alarm->node);
John Stultza28cde82011-08-10 12:30:21 -0700168 alarm->state &= ~ALARMTIMER_STATE_ENQUEUED;
John Stultzff3ead92011-01-11 09:42:13 -0800169}
170
John Stultz7068b7a2011-04-28 13:29:18 -0700171
John Stultz180bf812011-04-28 12:58:11 -0700172/**
John Stultz7068b7a2011-04-28 13:29:18 -0700173 * alarmtimer_fired - Handles alarm hrtimer being fired.
174 * @timer: pointer to hrtimer being run
John Stultzff3ead92011-01-11 09:42:13 -0800175 *
John Stultz180bf812011-04-28 12:58:11 -0700176 * When a alarm timer fires, this runs through the timerqueue to
177 * see which alarms expired, and runs those. If there are more alarm
178 * timers queued for the future, we set the hrtimer to fire when
179 * when the next future alarm timer expires.
John Stultzff3ead92011-01-11 09:42:13 -0800180 */
John Stultz7068b7a2011-04-28 13:29:18 -0700181static enum hrtimer_restart alarmtimer_fired(struct hrtimer *timer)
John Stultzff3ead92011-01-11 09:42:13 -0800182{
John Stultzdae373b2012-09-13 19:12:16 -0400183 struct alarm *alarm = container_of(timer, struct alarm, timer);
184 struct alarm_base *base = &alarm_bases[alarm->type];
John Stultzff3ead92011-01-11 09:42:13 -0800185 unsigned long flags;
John Stultz7068b7a2011-04-28 13:29:18 -0700186 int ret = HRTIMER_NORESTART;
John Stultz54da23b2011-08-10 11:08:07 -0700187 int restart = ALARMTIMER_NORESTART;
John Stultzff3ead92011-01-11 09:42:13 -0800188
189 spin_lock_irqsave(&base->lock, flags);
John Stultza65bcc12012-09-13 19:25:22 -0400190 alarmtimer_dequeue(base, alarm);
John Stultzdae373b2012-09-13 19:12:16 -0400191 spin_unlock_irqrestore(&base->lock, flags);
John Stultzff3ead92011-01-11 09:42:13 -0800192
John Stultzdae373b2012-09-13 19:12:16 -0400193 if (alarm->function)
194 restart = alarm->function(alarm, base->gettime());
John Stultzff3ead92011-01-11 09:42:13 -0800195
John Stultzdae373b2012-09-13 19:12:16 -0400196 spin_lock_irqsave(&base->lock, flags);
197 if (restart != ALARMTIMER_NORESTART) {
198 hrtimer_set_expires(&alarm->timer, alarm->node.expires);
199 alarmtimer_enqueue(base, alarm);
John Stultz7068b7a2011-04-28 13:29:18 -0700200 ret = HRTIMER_RESTART;
John Stultzff3ead92011-01-11 09:42:13 -0800201 }
202 spin_unlock_irqrestore(&base->lock, flags);
John Stultzff3ead92011-01-11 09:42:13 -0800203
Baolin Wang4a057542016-11-28 14:35:21 -0800204 trace_alarmtimer_fired(alarm, base->gettime());
John Stultz7068b7a2011-04-28 13:29:18 -0700205 return ret;
John Stultzff3ead92011-01-11 09:42:13 -0800206
John Stultzff3ead92011-01-11 09:42:13 -0800207}
208
Todd Poynor6cffe002013-05-15 14:38:11 -0700209ktime_t alarm_expires_remaining(const struct alarm *alarm)
210{
211 struct alarm_base *base = &alarm_bases[alarm->type];
212 return ktime_sub(alarm->node.expires, base->gettime());
213}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200214EXPORT_SYMBOL_GPL(alarm_expires_remaining);
Todd Poynor6cffe002013-05-15 14:38:11 -0700215
John Stultz472647d2011-04-29 15:03:10 -0700216#ifdef CONFIG_RTC_CLASS
John Stultz180bf812011-04-28 12:58:11 -0700217/**
John Stultzff3ead92011-01-11 09:42:13 -0800218 * alarmtimer_suspend - Suspend time callback
219 * @dev: unused
220 * @state: unused
221 *
222 * When we are going into suspend, we look through the bases
223 * to see which is the soonest timer to expire. We then
224 * set an rtc timer to fire that far into the future, which
225 * will wake us from suspend.
226 */
227static int alarmtimer_suspend(struct device *dev)
228{
Baolin Wang4a057542016-11-28 14:35:21 -0800229 ktime_t min, now, expires;
230 int i, ret, type;
John Stultzc008ba582011-06-16 18:27:09 -0700231 struct rtc_device *rtc;
Baolin Wang4a057542016-11-28 14:35:21 -0800232 unsigned long flags;
233 struct rtc_time tm;
John Stultzff3ead92011-01-11 09:42:13 -0800234
235 spin_lock_irqsave(&freezer_delta_lock, flags);
236 min = freezer_delta;
Baolin Wang4a057542016-11-28 14:35:21 -0800237 expires = freezer_expires;
238 type = freezer_alarmtype;
Thomas Gleixner8b0e1952016-12-25 12:30:41 +0100239 freezer_delta = 0;
John Stultzff3ead92011-01-11 09:42:13 -0800240 spin_unlock_irqrestore(&freezer_delta_lock, flags);
241
John Stultz8bc0daf2011-07-14 18:35:13 -0700242 rtc = alarmtimer_get_rtcdev();
John Stultzff3ead92011-01-11 09:42:13 -0800243 /* If we have no rtcdev, just return */
John Stultzc008ba582011-06-16 18:27:09 -0700244 if (!rtc)
John Stultzff3ead92011-01-11 09:42:13 -0800245 return 0;
246
247 /* Find the soonest timer to expire*/
248 for (i = 0; i < ALARM_NUMTYPE; i++) {
249 struct alarm_base *base = &alarm_bases[i];
250 struct timerqueue_node *next;
251 ktime_t delta;
252
253 spin_lock_irqsave(&base->lock, flags);
254 next = timerqueue_getnext(&base->timerqueue);
255 spin_unlock_irqrestore(&base->lock, flags);
256 if (!next)
257 continue;
258 delta = ktime_sub(next->expires, base->gettime());
Thomas Gleixner2456e852016-12-25 11:38:40 +0100259 if (!min || (delta < min)) {
Baolin Wang4a057542016-11-28 14:35:21 -0800260 expires = next->expires;
John Stultzff3ead92011-01-11 09:42:13 -0800261 min = delta;
Baolin Wang4a057542016-11-28 14:35:21 -0800262 type = i;
263 }
John Stultzff3ead92011-01-11 09:42:13 -0800264 }
Thomas Gleixner2456e852016-12-25 11:38:40 +0100265 if (min == 0)
John Stultzff3ead92011-01-11 09:42:13 -0800266 return 0;
267
Todd Poynor59a93c22012-08-09 00:37:27 -0700268 if (ktime_to_ns(min) < 2 * NSEC_PER_SEC) {
269 __pm_wakeup_event(ws, 2 * MSEC_PER_SEC);
270 return -EBUSY;
271 }
John Stultzff3ead92011-01-11 09:42:13 -0800272
Baolin Wang4a057542016-11-28 14:35:21 -0800273 trace_alarmtimer_suspend(expires, type);
274
John Stultzff3ead92011-01-11 09:42:13 -0800275 /* Setup an rtc timer to fire that far in the future */
John Stultzc008ba582011-06-16 18:27:09 -0700276 rtc_timer_cancel(rtc, &rtctimer);
277 rtc_read_time(rtc, &tm);
John Stultzff3ead92011-01-11 09:42:13 -0800278 now = rtc_tm_to_ktime(tm);
279 now = ktime_add(now, min);
280
Todd Poynor59a93c22012-08-09 00:37:27 -0700281 /* Set alarm, if in the past reject suspend briefly to handle */
Thomas Gleixner8b0e1952016-12-25 12:30:41 +0100282 ret = rtc_timer_start(rtc, &rtctimer, now, 0);
Todd Poynor59a93c22012-08-09 00:37:27 -0700283 if (ret < 0)
284 __pm_wakeup_event(ws, MSEC_PER_SEC);
285 return ret;
John Stultzff3ead92011-01-11 09:42:13 -0800286}
zhuo-haoa0e32132015-11-17 20:08:07 +0800287
288static int alarmtimer_resume(struct device *dev)
289{
290 struct rtc_device *rtc;
291
292 rtc = alarmtimer_get_rtcdev();
293 if (rtc)
294 rtc_timer_cancel(rtc, &rtctimer);
295 return 0;
296}
297
John Stultz472647d2011-04-29 15:03:10 -0700298#else
299static int alarmtimer_suspend(struct device *dev)
300{
301 return 0;
302}
zhuo-haoa0e32132015-11-17 20:08:07 +0800303
304static int alarmtimer_resume(struct device *dev)
305{
306 return 0;
307}
John Stultz472647d2011-04-29 15:03:10 -0700308#endif
John Stultzff3ead92011-01-11 09:42:13 -0800309
John Stultz9a7adcf52011-01-11 09:54:33 -0800310static void alarmtimer_freezerset(ktime_t absexp, enum alarmtimer_type type)
311{
Baolin Wang4a057542016-11-28 14:35:21 -0800312 struct alarm_base *base;
John Stultz9a7adcf52011-01-11 09:54:33 -0800313 unsigned long flags;
Baolin Wang4a057542016-11-28 14:35:21 -0800314 ktime_t delta;
315
316 switch(type) {
317 case ALARM_REALTIME:
318 base = &alarm_bases[ALARM_REALTIME];
319 type = ALARM_REALTIME_FREEZER;
320 break;
321 case ALARM_BOOTTIME:
322 base = &alarm_bases[ALARM_BOOTTIME];
323 type = ALARM_BOOTTIME_FREEZER;
324 break;
325 default:
326 WARN_ONCE(1, "Invalid alarm type: %d\n", type);
327 return;
328 }
John Stultz9a7adcf52011-01-11 09:54:33 -0800329
330 delta = ktime_sub(absexp, base->gettime());
331
332 spin_lock_irqsave(&freezer_delta_lock, flags);
Thomas Gleixner2456e852016-12-25 11:38:40 +0100333 if (!freezer_delta || (delta < freezer_delta)) {
John Stultz9a7adcf52011-01-11 09:54:33 -0800334 freezer_delta = delta;
Baolin Wang4a057542016-11-28 14:35:21 -0800335 freezer_expires = absexp;
336 freezer_alarmtype = type;
337 }
John Stultz9a7adcf52011-01-11 09:54:33 -0800338 spin_unlock_irqrestore(&freezer_delta_lock, flags);
339}
340
341
John Stultz180bf812011-04-28 12:58:11 -0700342/**
John Stultzff3ead92011-01-11 09:42:13 -0800343 * alarm_init - Initialize an alarm structure
344 * @alarm: ptr to alarm to be initialized
345 * @type: the type of the alarm
346 * @function: callback that is run when the alarm fires
John Stultzff3ead92011-01-11 09:42:13 -0800347 */
348void alarm_init(struct alarm *alarm, enum alarmtimer_type type,
John Stultz4b413082011-08-10 10:37:59 -0700349 enum alarmtimer_restart (*function)(struct alarm *, ktime_t))
John Stultzff3ead92011-01-11 09:42:13 -0800350{
351 timerqueue_init(&alarm->node);
John Stultzdae373b2012-09-13 19:12:16 -0400352 hrtimer_init(&alarm->timer, alarm_bases[type].base_clockid,
353 HRTIMER_MODE_ABS);
354 alarm->timer.function = alarmtimer_fired;
John Stultzff3ead92011-01-11 09:42:13 -0800355 alarm->function = function;
356 alarm->type = type;
John Stultza28cde82011-08-10 12:30:21 -0700357 alarm->state = ALARMTIMER_STATE_INACTIVE;
John Stultzff3ead92011-01-11 09:42:13 -0800358}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200359EXPORT_SYMBOL_GPL(alarm_init);
John Stultzff3ead92011-01-11 09:42:13 -0800360
John Stultz180bf812011-04-28 12:58:11 -0700361/**
Todd Poynor6cffe002013-05-15 14:38:11 -0700362 * alarm_start - Sets an absolute alarm to fire
John Stultzff3ead92011-01-11 09:42:13 -0800363 * @alarm: ptr to alarm to set
364 * @start: time to run the alarm
John Stultzff3ead92011-01-11 09:42:13 -0800365 */
Thomas Gleixnerb1932172015-04-14 21:09:18 +0000366void alarm_start(struct alarm *alarm, ktime_t start)
John Stultzff3ead92011-01-11 09:42:13 -0800367{
368 struct alarm_base *base = &alarm_bases[alarm->type];
369 unsigned long flags;
370
371 spin_lock_irqsave(&base->lock, flags);
John Stultzff3ead92011-01-11 09:42:13 -0800372 alarm->node.expires = start;
John Stultzff3ead92011-01-11 09:42:13 -0800373 alarmtimer_enqueue(base, alarm);
Thomas Gleixnerb1932172015-04-14 21:09:18 +0000374 hrtimer_start(&alarm->timer, alarm->node.expires, HRTIMER_MODE_ABS);
John Stultzff3ead92011-01-11 09:42:13 -0800375 spin_unlock_irqrestore(&base->lock, flags);
Baolin Wang4a057542016-11-28 14:35:21 -0800376
377 trace_alarmtimer_start(alarm, base->gettime());
John Stultzff3ead92011-01-11 09:42:13 -0800378}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200379EXPORT_SYMBOL_GPL(alarm_start);
John Stultzff3ead92011-01-11 09:42:13 -0800380
John Stultz180bf812011-04-28 12:58:11 -0700381/**
Todd Poynor6cffe002013-05-15 14:38:11 -0700382 * alarm_start_relative - Sets a relative alarm to fire
383 * @alarm: ptr to alarm to set
384 * @start: time relative to now to run the alarm
385 */
Thomas Gleixnerb1932172015-04-14 21:09:18 +0000386void alarm_start_relative(struct alarm *alarm, ktime_t start)
Todd Poynor6cffe002013-05-15 14:38:11 -0700387{
388 struct alarm_base *base = &alarm_bases[alarm->type];
389
390 start = ktime_add(start, base->gettime());
Thomas Gleixnerb1932172015-04-14 21:09:18 +0000391 alarm_start(alarm, start);
Todd Poynor6cffe002013-05-15 14:38:11 -0700392}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200393EXPORT_SYMBOL_GPL(alarm_start_relative);
Todd Poynor6cffe002013-05-15 14:38:11 -0700394
395void alarm_restart(struct alarm *alarm)
396{
397 struct alarm_base *base = &alarm_bases[alarm->type];
398 unsigned long flags;
399
400 spin_lock_irqsave(&base->lock, flags);
401 hrtimer_set_expires(&alarm->timer, alarm->node.expires);
402 hrtimer_restart(&alarm->timer);
403 alarmtimer_enqueue(base, alarm);
404 spin_unlock_irqrestore(&base->lock, flags);
405}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200406EXPORT_SYMBOL_GPL(alarm_restart);
Todd Poynor6cffe002013-05-15 14:38:11 -0700407
408/**
John Stultz9082c462011-08-10 12:41:36 -0700409 * alarm_try_to_cancel - Tries to cancel an alarm timer
John Stultzff3ead92011-01-11 09:42:13 -0800410 * @alarm: ptr to alarm to be canceled
John Stultz9082c462011-08-10 12:41:36 -0700411 *
412 * Returns 1 if the timer was canceled, 0 if it was not running,
413 * and -1 if the callback was running
John Stultzff3ead92011-01-11 09:42:13 -0800414 */
John Stultz9082c462011-08-10 12:41:36 -0700415int alarm_try_to_cancel(struct alarm *alarm)
John Stultzff3ead92011-01-11 09:42:13 -0800416{
417 struct alarm_base *base = &alarm_bases[alarm->type];
418 unsigned long flags;
John Stultzdae373b2012-09-13 19:12:16 -0400419 int ret;
420
John Stultzff3ead92011-01-11 09:42:13 -0800421 spin_lock_irqsave(&base->lock, flags);
John Stultzdae373b2012-09-13 19:12:16 -0400422 ret = hrtimer_try_to_cancel(&alarm->timer);
423 if (ret >= 0)
John Stultza65bcc12012-09-13 19:25:22 -0400424 alarmtimer_dequeue(base, alarm);
John Stultzff3ead92011-01-11 09:42:13 -0800425 spin_unlock_irqrestore(&base->lock, flags);
Baolin Wang4a057542016-11-28 14:35:21 -0800426
427 trace_alarmtimer_cancel(alarm, base->gettime());
John Stultz9082c462011-08-10 12:41:36 -0700428 return ret;
John Stultzff3ead92011-01-11 09:42:13 -0800429}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200430EXPORT_SYMBOL_GPL(alarm_try_to_cancel);
John Stultzff3ead92011-01-11 09:42:13 -0800431
432
John Stultz9082c462011-08-10 12:41:36 -0700433/**
434 * alarm_cancel - Spins trying to cancel an alarm timer until it is done
435 * @alarm: ptr to alarm to be canceled
436 *
437 * Returns 1 if the timer was canceled, 0 if it was not active.
438 */
439int alarm_cancel(struct alarm *alarm)
440{
441 for (;;) {
442 int ret = alarm_try_to_cancel(alarm);
443 if (ret >= 0)
444 return ret;
445 cpu_relax();
446 }
447}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200448EXPORT_SYMBOL_GPL(alarm_cancel);
John Stultz9082c462011-08-10 12:41:36 -0700449
John Stultzdce75a82011-08-10 11:31:03 -0700450
451u64 alarm_forward(struct alarm *alarm, ktime_t now, ktime_t interval)
452{
453 u64 overrun = 1;
454 ktime_t delta;
455
456 delta = ktime_sub(now, alarm->node.expires);
457
Thomas Gleixner2456e852016-12-25 11:38:40 +0100458 if (delta < 0)
John Stultzdce75a82011-08-10 11:31:03 -0700459 return 0;
460
Thomas Gleixner2456e852016-12-25 11:38:40 +0100461 if (unlikely(delta >= interval)) {
John Stultzdce75a82011-08-10 11:31:03 -0700462 s64 incr = ktime_to_ns(interval);
463
464 overrun = ktime_divns(delta, incr);
465
466 alarm->node.expires = ktime_add_ns(alarm->node.expires,
467 incr*overrun);
468
Thomas Gleixner2456e852016-12-25 11:38:40 +0100469 if (alarm->node.expires > now)
John Stultzdce75a82011-08-10 11:31:03 -0700470 return overrun;
471 /*
472 * This (and the ktime_add() below) is the
473 * correction for exact:
474 */
475 overrun++;
476 }
477
478 alarm->node.expires = ktime_add(alarm->node.expires, interval);
479 return overrun;
480}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200481EXPORT_SYMBOL_GPL(alarm_forward);
John Stultzdce75a82011-08-10 11:31:03 -0700482
Todd Poynor6cffe002013-05-15 14:38:11 -0700483u64 alarm_forward_now(struct alarm *alarm, ktime_t interval)
484{
485 struct alarm_base *base = &alarm_bases[alarm->type];
486
487 return alarm_forward(alarm, base->gettime(), interval);
488}
Marcus Gelderie11682a42013-06-04 09:32:09 +0200489EXPORT_SYMBOL_GPL(alarm_forward_now);
John Stultzdce75a82011-08-10 11:31:03 -0700490
491
John Stultz180bf812011-04-28 12:58:11 -0700492/**
John Stultz9a7adcf52011-01-11 09:54:33 -0800493 * clock2alarm - helper that converts from clockid to alarmtypes
494 * @clockid: clockid.
John Stultz9a7adcf52011-01-11 09:54:33 -0800495 */
496static enum alarmtimer_type clock2alarm(clockid_t clockid)
497{
498 if (clockid == CLOCK_REALTIME_ALARM)
499 return ALARM_REALTIME;
500 if (clockid == CLOCK_BOOTTIME_ALARM)
501 return ALARM_BOOTTIME;
502 return -1;
503}
504
John Stultz180bf812011-04-28 12:58:11 -0700505/**
John Stultz9a7adcf52011-01-11 09:54:33 -0800506 * alarm_handle_timer - Callback for posix timers
507 * @alarm: alarm that fired
508 *
509 * Posix timer callback for expired alarm timers.
510 */
John Stultz4b413082011-08-10 10:37:59 -0700511static enum alarmtimer_restart alarm_handle_timer(struct alarm *alarm,
512 ktime_t now)
John Stultz9a7adcf52011-01-11 09:54:33 -0800513{
Richard Larocque474e941b2014-09-09 18:31:05 -0700514 unsigned long flags;
John Stultz9a7adcf52011-01-11 09:54:33 -0800515 struct k_itimer *ptr = container_of(alarm, struct k_itimer,
John Stultz9e264762011-08-10 12:09:24 -0700516 it.alarm.alarmtimer);
Richard Larocque474e941b2014-09-09 18:31:05 -0700517 enum alarmtimer_restart result = ALARMTIMER_NORESTART;
518
519 spin_lock_irqsave(&ptr->it_lock, flags);
Richard Larocque265b81d2014-09-09 18:31:04 -0700520 if ((ptr->it_sigev_notify & ~SIGEV_THREAD_ID) != SIGEV_NONE) {
Nicolas Pitreb6f8a922016-12-14 15:06:13 -0800521 if (IS_ENABLED(CONFIG_POSIX_TIMERS) &&
522 posix_timer_event(ptr, 0) != 0)
Richard Larocque265b81d2014-09-09 18:31:04 -0700523 ptr->it_overrun++;
524 }
John Stultz4b413082011-08-10 10:37:59 -0700525
John Stultz54da23b2011-08-10 11:08:07 -0700526 /* Re-add periodic timers */
Thomas Gleixner2456e852016-12-25 11:38:40 +0100527 if (ptr->it.alarm.interval) {
John Stultz9e264762011-08-10 12:09:24 -0700528 ptr->it_overrun += alarm_forward(alarm, now,
529 ptr->it.alarm.interval);
Richard Larocque474e941b2014-09-09 18:31:05 -0700530 result = ALARMTIMER_RESTART;
John Stultz54da23b2011-08-10 11:08:07 -0700531 }
Richard Larocque474e941b2014-09-09 18:31:05 -0700532 spin_unlock_irqrestore(&ptr->it_lock, flags);
533
534 return result;
John Stultz9a7adcf52011-01-11 09:54:33 -0800535}
536
John Stultz180bf812011-04-28 12:58:11 -0700537/**
John Stultz9a7adcf52011-01-11 09:54:33 -0800538 * alarm_clock_getres - posix getres interface
539 * @which_clock: clockid
540 * @tp: timespec to fill
541 *
542 * Returns the granularity of underlying alarm base clock
543 */
544static int alarm_clock_getres(const clockid_t which_clock, struct timespec *tp)
545{
John Stultz1c6b39a2011-06-16 18:47:37 -0700546 if (!alarmtimer_get_rtcdev())
KOSAKI Motohiro98d6f4d2013-10-14 17:33:16 -0400547 return -EINVAL;
John Stultz1c6b39a2011-06-16 18:47:37 -0700548
Thomas Gleixner056a3ca2015-04-14 21:08:32 +0000549 tp->tv_sec = 0;
550 tp->tv_nsec = hrtimer_resolution;
551 return 0;
John Stultz9a7adcf52011-01-11 09:54:33 -0800552}
553
554/**
555 * alarm_clock_get - posix clock_get interface
556 * @which_clock: clockid
557 * @tp: timespec to fill.
558 *
559 * Provides the underlying alarm base time.
560 */
Deepa Dinamani3c9c12f2017-03-26 12:04:14 -0700561static int alarm_clock_get(clockid_t which_clock, struct timespec64 *tp)
John Stultz9a7adcf52011-01-11 09:54:33 -0800562{
563 struct alarm_base *base = &alarm_bases[clock2alarm(which_clock)];
564
John Stultz1c6b39a2011-06-16 18:47:37 -0700565 if (!alarmtimer_get_rtcdev())
KOSAKI Motohiro98d6f4d2013-10-14 17:33:16 -0400566 return -EINVAL;
John Stultz1c6b39a2011-06-16 18:47:37 -0700567
Deepa Dinamani3c9c12f2017-03-26 12:04:14 -0700568 *tp = ktime_to_timespec64(base->gettime());
John Stultz9a7adcf52011-01-11 09:54:33 -0800569 return 0;
570}
571
572/**
573 * alarm_timer_create - posix timer_create interface
574 * @new_timer: k_itimer pointer to manage
575 *
576 * Initializes the k_itimer structure.
577 */
578static int alarm_timer_create(struct k_itimer *new_timer)
579{
580 enum alarmtimer_type type;
John Stultz9a7adcf52011-01-11 09:54:33 -0800581
John Stultz1c6b39a2011-06-16 18:47:37 -0700582 if (!alarmtimer_get_rtcdev())
583 return -ENOTSUPP;
584
John Stultz9a7adcf52011-01-11 09:54:33 -0800585 if (!capable(CAP_WAKE_ALARM))
586 return -EPERM;
587
588 type = clock2alarm(new_timer->it_clock);
John Stultz9e264762011-08-10 12:09:24 -0700589 alarm_init(&new_timer->it.alarm.alarmtimer, type, alarm_handle_timer);
John Stultz9a7adcf52011-01-11 09:54:33 -0800590 return 0;
591}
592
593/**
594 * alarm_timer_get - posix timer_get interface
595 * @new_timer: k_itimer pointer
596 * @cur_setting: itimerspec data to fill
597 *
Richard Larocquee86fea72014-09-09 18:31:03 -0700598 * Copies out the current itimerspec data
John Stultz9a7adcf52011-01-11 09:54:33 -0800599 */
600static void alarm_timer_get(struct k_itimer *timr,
601 struct itimerspec *cur_setting)
602{
Richard Larocquee86fea72014-09-09 18:31:03 -0700603 ktime_t relative_expiry_time =
604 alarm_expires_remaining(&(timr->it.alarm.alarmtimer));
John Stultzea7802f2011-08-04 07:51:56 -0700605
Richard Larocquee86fea72014-09-09 18:31:03 -0700606 if (ktime_to_ns(relative_expiry_time) > 0) {
607 cur_setting->it_value = ktime_to_timespec(relative_expiry_time);
608 } else {
609 cur_setting->it_value.tv_sec = 0;
610 cur_setting->it_value.tv_nsec = 0;
611 }
612
613 cur_setting->it_interval = ktime_to_timespec(timr->it.alarm.interval);
John Stultz9a7adcf52011-01-11 09:54:33 -0800614}
615
616/**
617 * alarm_timer_del - posix timer_del interface
618 * @timr: k_itimer pointer to be deleted
619 *
620 * Cancels any programmed alarms for the given timer.
621 */
622static int alarm_timer_del(struct k_itimer *timr)
623{
John Stultz1c6b39a2011-06-16 18:47:37 -0700624 if (!rtcdev)
625 return -ENOTSUPP;
626
John Stultz9082c462011-08-10 12:41:36 -0700627 if (alarm_try_to_cancel(&timr->it.alarm.alarmtimer) < 0)
628 return TIMER_RETRY;
629
John Stultz9a7adcf52011-01-11 09:54:33 -0800630 return 0;
631}
632
633/**
634 * alarm_timer_set - posix timer_set interface
635 * @timr: k_itimer pointer to be deleted
636 * @flags: timer flags
637 * @new_setting: itimerspec to be used
638 * @old_setting: itimerspec being replaced
639 *
640 * Sets the timer to new_setting, and starts the timer.
641 */
642static int alarm_timer_set(struct k_itimer *timr, int flags,
643 struct itimerspec *new_setting,
644 struct itimerspec *old_setting)
645{
John Stultz16927772014-07-07 14:06:11 -0700646 ktime_t exp;
647
John Stultz1c6b39a2011-06-16 18:47:37 -0700648 if (!rtcdev)
649 return -ENOTSUPP;
650
John Stultz16927772014-07-07 14:06:11 -0700651 if (flags & ~TIMER_ABSTIME)
652 return -EINVAL;
653
John Stultz971c90b2011-08-04 07:25:35 -0700654 if (old_setting)
655 alarm_timer_get(timr, old_setting);
John Stultz9a7adcf52011-01-11 09:54:33 -0800656
657 /* If the timer was already set, cancel it */
John Stultz9082c462011-08-10 12:41:36 -0700658 if (alarm_try_to_cancel(&timr->it.alarm.alarmtimer) < 0)
659 return TIMER_RETRY;
John Stultz9a7adcf52011-01-11 09:54:33 -0800660
661 /* start the timer */
John Stultz9e264762011-08-10 12:09:24 -0700662 timr->it.alarm.interval = timespec_to_ktime(new_setting->it_interval);
John Stultz16927772014-07-07 14:06:11 -0700663 exp = timespec_to_ktime(new_setting->it_value);
664 /* Convert (if necessary) to absolute time */
665 if (flags != TIMER_ABSTIME) {
666 ktime_t now;
667
668 now = alarm_bases[timr->it.alarm.alarmtimer.type].gettime();
669 exp = ktime_add(now, exp);
670 }
671
672 alarm_start(&timr->it.alarm.alarmtimer, exp);
John Stultz9a7adcf52011-01-11 09:54:33 -0800673 return 0;
674}
675
676/**
677 * alarmtimer_nsleep_wakeup - Wakeup function for alarm_timer_nsleep
678 * @alarm: ptr to alarm that fired
679 *
680 * Wakes up the task that set the alarmtimer
681 */
John Stultz4b413082011-08-10 10:37:59 -0700682static enum alarmtimer_restart alarmtimer_nsleep_wakeup(struct alarm *alarm,
683 ktime_t now)
John Stultz9a7adcf52011-01-11 09:54:33 -0800684{
685 struct task_struct *task = (struct task_struct *)alarm->data;
686
687 alarm->data = NULL;
688 if (task)
689 wake_up_process(task);
John Stultz4b413082011-08-10 10:37:59 -0700690 return ALARMTIMER_NORESTART;
John Stultz9a7adcf52011-01-11 09:54:33 -0800691}
692
693/**
694 * alarmtimer_do_nsleep - Internal alarmtimer nsleep implementation
695 * @alarm: ptr to alarmtimer
696 * @absexp: absolute expiration time
697 *
698 * Sets the alarm timer and sleeps until it is fired or interrupted.
699 */
700static int alarmtimer_do_nsleep(struct alarm *alarm, ktime_t absexp)
701{
702 alarm->data = (void *)current;
703 do {
704 set_current_state(TASK_INTERRUPTIBLE);
John Stultz9e264762011-08-10 12:09:24 -0700705 alarm_start(alarm, absexp);
John Stultz9a7adcf52011-01-11 09:54:33 -0800706 if (likely(alarm->data))
707 schedule();
708
709 alarm_cancel(alarm);
710 } while (alarm->data && !signal_pending(current));
711
712 __set_current_state(TASK_RUNNING);
713
714 return (alarm->data == NULL);
715}
716
717
718/**
719 * update_rmtp - Update remaining timespec value
720 * @exp: expiration time
721 * @type: timer type
722 * @rmtp: user pointer to remaining timepsec value
723 *
724 * Helper function that fills in rmtp value with time between
725 * now and the exp value
726 */
727static int update_rmtp(ktime_t exp, enum alarmtimer_type type,
728 struct timespec __user *rmtp)
729{
730 struct timespec rmt;
731 ktime_t rem;
732
733 rem = ktime_sub(exp, alarm_bases[type].gettime());
734
Thomas Gleixner2456e852016-12-25 11:38:40 +0100735 if (rem <= 0)
John Stultz9a7adcf52011-01-11 09:54:33 -0800736 return 0;
737 rmt = ktime_to_timespec(rem);
738
739 if (copy_to_user(rmtp, &rmt, sizeof(*rmtp)))
740 return -EFAULT;
741
742 return 1;
743
744}
745
746/**
747 * alarm_timer_nsleep_restart - restartblock alarmtimer nsleep
748 * @restart: ptr to restart block
749 *
750 * Handles restarted clock_nanosleep calls
751 */
752static long __sched alarm_timer_nsleep_restart(struct restart_block *restart)
753{
Thomas Gleixnerab8177b2011-05-20 13:05:15 +0200754 enum alarmtimer_type type = restart->nanosleep.clockid;
John Stultz9a7adcf52011-01-11 09:54:33 -0800755 ktime_t exp;
756 struct timespec __user *rmtp;
757 struct alarm alarm;
758 int ret = 0;
759
Thomas Gleixner2456e852016-12-25 11:38:40 +0100760 exp = restart->nanosleep.expires;
John Stultz9a7adcf52011-01-11 09:54:33 -0800761 alarm_init(&alarm, type, alarmtimer_nsleep_wakeup);
762
763 if (alarmtimer_do_nsleep(&alarm, exp))
764 goto out;
765
766 if (freezing(current))
767 alarmtimer_freezerset(exp, type);
768
769 rmtp = restart->nanosleep.rmtp;
770 if (rmtp) {
771 ret = update_rmtp(exp, type, rmtp);
772 if (ret <= 0)
773 goto out;
774 }
775
776
777 /* The other values in restart are already filled in */
778 ret = -ERESTART_RESTARTBLOCK;
779out:
780 return ret;
781}
782
783/**
784 * alarm_timer_nsleep - alarmtimer nanosleep
785 * @which_clock: clockid
786 * @flags: determins abstime or relative
787 * @tsreq: requested sleep time (abs or rel)
788 * @rmtp: remaining sleep time saved
789 *
790 * Handles clock_nanosleep calls against _ALARM clockids
791 */
792static int alarm_timer_nsleep(const clockid_t which_clock, int flags,
793 struct timespec *tsreq, struct timespec __user *rmtp)
794{
795 enum alarmtimer_type type = clock2alarm(which_clock);
796 struct alarm alarm;
797 ktime_t exp;
798 int ret = 0;
799 struct restart_block *restart;
800
John Stultz1c6b39a2011-06-16 18:47:37 -0700801 if (!alarmtimer_get_rtcdev())
802 return -ENOTSUPP;
803
John Stultz16927772014-07-07 14:06:11 -0700804 if (flags & ~TIMER_ABSTIME)
805 return -EINVAL;
806
John Stultz9a7adcf52011-01-11 09:54:33 -0800807 if (!capable(CAP_WAKE_ALARM))
808 return -EPERM;
809
810 alarm_init(&alarm, type, alarmtimer_nsleep_wakeup);
811
812 exp = timespec_to_ktime(*tsreq);
813 /* Convert (if necessary) to absolute time */
814 if (flags != TIMER_ABSTIME) {
815 ktime_t now = alarm_bases[type].gettime();
816 exp = ktime_add(now, exp);
817 }
818
819 if (alarmtimer_do_nsleep(&alarm, exp))
820 goto out;
821
822 if (freezing(current))
823 alarmtimer_freezerset(exp, type);
824
825 /* abs timers don't set remaining time or restart */
826 if (flags == TIMER_ABSTIME) {
827 ret = -ERESTARTNOHAND;
828 goto out;
829 }
830
831 if (rmtp) {
832 ret = update_rmtp(exp, type, rmtp);
833 if (ret <= 0)
834 goto out;
835 }
836
Andy Lutomirskif56141e2015-02-12 15:01:14 -0800837 restart = &current->restart_block;
John Stultz9a7adcf52011-01-11 09:54:33 -0800838 restart->fn = alarm_timer_nsleep_restart;
Thomas Gleixnerab8177b2011-05-20 13:05:15 +0200839 restart->nanosleep.clockid = type;
Thomas Gleixner2456e852016-12-25 11:38:40 +0100840 restart->nanosleep.expires = exp;
John Stultz9a7adcf52011-01-11 09:54:33 -0800841 restart->nanosleep.rmtp = rmtp;
842 ret = -ERESTART_RESTARTBLOCK;
843
844out:
845 return ret;
846}
John Stultzff3ead92011-01-11 09:42:13 -0800847
John Stultzff3ead92011-01-11 09:42:13 -0800848
849/* Suspend hook structures */
850static const struct dev_pm_ops alarmtimer_pm_ops = {
851 .suspend = alarmtimer_suspend,
zhuo-haoa0e32132015-11-17 20:08:07 +0800852 .resume = alarmtimer_resume,
John Stultzff3ead92011-01-11 09:42:13 -0800853};
854
855static struct platform_driver alarmtimer_driver = {
856 .driver = {
857 .name = "alarmtimer",
858 .pm = &alarmtimer_pm_ops,
859 }
860};
861
862/**
863 * alarmtimer_init - Initialize alarm timer code
864 *
865 * This function initializes the alarm bases and registers
866 * the posix clock ids.
867 */
868static int __init alarmtimer_init(void)
869{
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200870 struct platform_device *pdev;
John Stultzff3ead92011-01-11 09:42:13 -0800871 int error = 0;
872 int i;
John Stultz9a7adcf52011-01-11 09:54:33 -0800873 struct k_clock alarm_clock = {
874 .clock_getres = alarm_clock_getres,
875 .clock_get = alarm_clock_get,
876 .timer_create = alarm_timer_create,
877 .timer_set = alarm_timer_set,
878 .timer_del = alarm_timer_del,
879 .timer_get = alarm_timer_get,
880 .nsleep = alarm_timer_nsleep,
881 };
882
Thomas Gleixnerc5e14e72012-03-24 12:46:23 +0100883 alarmtimer_rtc_timer_init();
John Stultzad30dfa2012-03-23 15:52:25 -0700884
Nicolas Pitrebaa73d92016-11-11 00:10:10 -0500885 if (IS_ENABLED(CONFIG_POSIX_TIMERS)) {
886 posix_timers_register_clock(CLOCK_REALTIME_ALARM, &alarm_clock);
887 posix_timers_register_clock(CLOCK_BOOTTIME_ALARM, &alarm_clock);
888 }
John Stultzff3ead92011-01-11 09:42:13 -0800889
890 /* Initialize alarm bases */
891 alarm_bases[ALARM_REALTIME].base_clockid = CLOCK_REALTIME;
892 alarm_bases[ALARM_REALTIME].gettime = &ktime_get_real;
893 alarm_bases[ALARM_BOOTTIME].base_clockid = CLOCK_BOOTTIME;
894 alarm_bases[ALARM_BOOTTIME].gettime = &ktime_get_boottime;
895 for (i = 0; i < ALARM_NUMTYPE; i++) {
896 timerqueue_init_head(&alarm_bases[i].timerqueue);
897 spin_lock_init(&alarm_bases[i].lock);
John Stultzff3ead92011-01-11 09:42:13 -0800898 }
John Stultz8bc0daf2011-07-14 18:35:13 -0700899
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200900 error = alarmtimer_rtc_interface_setup();
901 if (error)
902 return error;
John Stultzff3ead92011-01-11 09:42:13 -0800903
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200904 error = platform_driver_register(&alarmtimer_driver);
905 if (error)
906 goto out_if;
907
908 pdev = platform_device_register_simple("alarmtimer", -1, NULL, 0);
909 if (IS_ERR(pdev)) {
910 error = PTR_ERR(pdev);
911 goto out_drv;
912 }
Todd Poynor59a93c22012-08-09 00:37:27 -0700913 ws = wakeup_source_register("alarmtimer");
Thomas Gleixner4523f6a2011-09-14 10:54:29 +0200914 return 0;
915
916out_drv:
917 platform_driver_unregister(&alarmtimer_driver);
918out_if:
919 alarmtimer_rtc_interface_remove();
John Stultzff3ead92011-01-11 09:42:13 -0800920 return error;
921}
922device_initcall(alarmtimer_init);