1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Timers abstract layer
7 #include <linux/delay.h>
8 #include <linux/init.h>
9 #include <linux/slab.h>
10 #include <linux/time.h>
11 #include <linux/mutex.h>
12 #include <linux/device.h>
13 #include <linux/module.h>
14 #include <linux/string.h>
15 #include <linux/sched/signal.h>
16 #include <sound/core.h>
17 #include <sound/timer.h>
18 #include <sound/control.h>
19 #include <sound/info.h>
20 #include <sound/minors.h>
21 #include <sound/initval.h>
22 #include <linux/kmod.h>
25 #define SNDRV_TIMER_IFLG_PAUSED 0x00010000
26 #define SNDRV_TIMER_IFLG_DEAD 0x00020000
28 #if IS_ENABLED(CONFIG_SND_HRTIMER)
29 #define DEFAULT_TIMER_LIMIT 4
31 #define DEFAULT_TIMER_LIMIT 1
34 static int timer_limit = DEFAULT_TIMER_LIMIT;
35 static int timer_tstamp_monotonic = 1;
37 MODULE_DESCRIPTION("ALSA timer interface");
38 MODULE_LICENSE("GPL");
39 module_param(timer_limit, int, 0444);
40 MODULE_PARM_DESC(timer_limit, "Maximum global timers in system.");
41 module_param(timer_tstamp_monotonic, int, 0444);
42 MODULE_PARM_DESC(timer_tstamp_monotonic, "Use posix monotonic clock source for timestamps (default).");
44 MODULE_ALIAS_CHARDEV(CONFIG_SND_MAJOR, SNDRV_MINOR_TIMER);
45 MODULE_ALIAS("devname:snd/timer");
47 enum timer_tread_format {
48 TREAD_FORMAT_NONE = 0,
53 struct snd_timer_tread32 {
60 struct snd_timer_tread64 {
69 struct snd_timer_user {
70 struct snd_timer_instance *timeri;
71 int tread; /* enhanced read with timestamps and events */
73 unsigned long overrun;
79 struct snd_timer_read *queue;
80 struct snd_timer_tread64 *tqueue;
82 unsigned long last_resolution;
84 struct timespec64 tstamp; /* trigger tstamp */
85 wait_queue_head_t qchange_sleep;
86 struct snd_fasync *fasync;
87 struct mutex ioctl_lock;
90 struct snd_timer_status32 {
91 s32 tstamp_sec; /* Timestamp - last update */
93 unsigned int resolution; /* current period resolution in ns */
94 unsigned int lost; /* counter of master tick lost */
95 unsigned int overrun; /* count of read queue overruns */
96 unsigned int queue; /* used queue size */
97 unsigned char reserved[64]; /* reserved */
100 #define SNDRV_TIMER_IOCTL_STATUS32 _IOR('T', 0x14, struct snd_timer_status32)
102 struct snd_timer_status64 {
103 s64 tstamp_sec; /* Timestamp - last update */
105 unsigned int resolution; /* current period resolution in ns */
106 unsigned int lost; /* counter of master tick lost */
107 unsigned int overrun; /* count of read queue overruns */
108 unsigned int queue; /* used queue size */
109 unsigned char reserved[64]; /* reserved */
112 #define SNDRV_TIMER_IOCTL_STATUS64 _IOR('T', 0x14, struct snd_timer_status64)
115 static LIST_HEAD(snd_timer_list);
117 /* list of slave instances */
118 static LIST_HEAD(snd_timer_slave_list);
120 /* lock for slave active lists */
121 static DEFINE_SPINLOCK(slave_active_lock);
123 #define MAX_SLAVE_INSTANCES 1000
124 static int num_slaves;
126 static DEFINE_MUTEX(register_mutex);
128 static int snd_timer_free(struct snd_timer *timer);
129 static int snd_timer_dev_free(struct snd_device *device);
130 static int snd_timer_dev_register(struct snd_device *device);
131 static int snd_timer_dev_disconnect(struct snd_device *device);
133 static void snd_timer_reschedule(struct snd_timer * timer, unsigned long ticks_left);
136 * create a timer instance with the given owner string.
138 struct snd_timer_instance *snd_timer_instance_new(const char *owner)
140 struct snd_timer_instance *timeri;
142 timeri = kzalloc(sizeof(*timeri), GFP_KERNEL);
145 timeri->owner = kstrdup(owner, GFP_KERNEL);
146 if (! timeri->owner) {
150 INIT_LIST_HEAD(&timeri->open_list);
151 INIT_LIST_HEAD(&timeri->active_list);
152 INIT_LIST_HEAD(&timeri->ack_list);
153 INIT_LIST_HEAD(&timeri->slave_list_head);
154 INIT_LIST_HEAD(&timeri->slave_active_head);
158 EXPORT_SYMBOL(snd_timer_instance_new);
160 void snd_timer_instance_free(struct snd_timer_instance *timeri)
163 if (timeri->private_free)
164 timeri->private_free(timeri);
165 kfree(timeri->owner);
169 EXPORT_SYMBOL(snd_timer_instance_free);
172 * find a timer instance from the given timer id
174 static struct snd_timer *snd_timer_find(struct snd_timer_id *tid)
176 struct snd_timer *timer;
178 list_for_each_entry(timer, &snd_timer_list, device_list) {
179 if (timer->tmr_class != tid->dev_class)
181 if ((timer->tmr_class == SNDRV_TIMER_CLASS_CARD ||
182 timer->tmr_class == SNDRV_TIMER_CLASS_PCM) &&
183 (timer->card == NULL ||
184 timer->card->number != tid->card))
186 if (timer->tmr_device != tid->device)
188 if (timer->tmr_subdevice != tid->subdevice)
195 #ifdef CONFIG_MODULES
197 static void snd_timer_request(struct snd_timer_id *tid)
199 switch (tid->dev_class) {
200 case SNDRV_TIMER_CLASS_GLOBAL:
201 if (tid->device < timer_limit)
202 request_module("snd-timer-%i", tid->device);
204 case SNDRV_TIMER_CLASS_CARD:
205 case SNDRV_TIMER_CLASS_PCM:
206 if (tid->card < snd_ecards_limit)
207 request_module("snd-card-%i", tid->card);
216 /* move the slave if it belongs to the master; return 1 if match */
217 static int check_matching_master_slave(struct snd_timer_instance *master,
218 struct snd_timer_instance *slave)
220 if (slave->slave_class != master->slave_class ||
221 slave->slave_id != master->slave_id)
223 if (master->timer->num_instances >= master->timer->max_instances)
225 list_move_tail(&slave->open_list, &master->slave_list_head);
226 master->timer->num_instances++;
227 guard(spinlock_irq)(&slave_active_lock);
228 guard(spinlock)(&master->timer->lock);
229 slave->master = master;
230 slave->timer = master->timer;
231 if (slave->flags & SNDRV_TIMER_IFLG_RUNNING)
232 list_add_tail(&slave->active_list, &master->slave_active_head);
237 * look for a master instance matching with the slave id of the given slave.
238 * when found, relink the open_link of the slave.
240 * call this with register_mutex down.
242 static int snd_timer_check_slave(struct snd_timer_instance *slave)
244 struct snd_timer *timer;
245 struct snd_timer_instance *master;
248 /* FIXME: it's really dumb to look up all entries.. */
249 list_for_each_entry(timer, &snd_timer_list, device_list) {
250 list_for_each_entry(master, &timer->open_list_head, open_list) {
251 err = check_matching_master_slave(master, slave);
252 if (err != 0) /* match found or error */
257 return err < 0 ? err : 0;
261 * look for slave instances matching with the slave id of the given master.
262 * when found, relink the open_link of slaves.
264 * call this with register_mutex down.
266 static int snd_timer_check_master(struct snd_timer_instance *master)
268 struct snd_timer_instance *slave, *tmp;
271 /* check all pending slaves */
272 list_for_each_entry_safe(slave, tmp, &snd_timer_slave_list, open_list) {
273 err = check_matching_master_slave(master, slave);
277 return err < 0 ? err : 0;
280 static void snd_timer_close_locked(struct snd_timer_instance *timeri,
281 struct device **card_devp_to_put);
284 * open a timer instance
285 * when opening a master, the slave id must be here given.
287 int snd_timer_open(struct snd_timer_instance *timeri,
288 struct snd_timer_id *tid,
289 unsigned int slave_id)
291 struct snd_timer *timer;
292 struct device *card_dev_to_put = NULL;
295 mutex_lock(®ister_mutex);
296 if (tid->dev_class == SNDRV_TIMER_CLASS_SLAVE) {
297 /* open a slave instance */
298 if (tid->dev_sclass <= SNDRV_TIMER_SCLASS_NONE ||
299 tid->dev_sclass > SNDRV_TIMER_SCLASS_OSS_SEQUENCER) {
300 pr_debug("ALSA: timer: invalid slave class %i\n",
305 if (num_slaves >= MAX_SLAVE_INSTANCES) {
309 timeri->slave_class = tid->dev_sclass;
310 timeri->slave_id = tid->device;
311 timeri->flags |= SNDRV_TIMER_IFLG_SLAVE;
312 list_add_tail(&timeri->open_list, &snd_timer_slave_list);
314 err = snd_timer_check_slave(timeri);
318 /* open a master instance */
319 timer = snd_timer_find(tid);
320 #ifdef CONFIG_MODULES
322 mutex_unlock(®ister_mutex);
323 snd_timer_request(tid);
324 mutex_lock(®ister_mutex);
325 timer = snd_timer_find(tid);
332 if (!list_empty(&timer->open_list_head)) {
333 struct snd_timer_instance *t =
334 list_entry(timer->open_list_head.next,
335 struct snd_timer_instance, open_list);
336 if (t->flags & SNDRV_TIMER_IFLG_EXCLUSIVE) {
341 if (timer->num_instances >= timer->max_instances) {
345 if (!try_module_get(timer->module)) {
349 /* take a card refcount for safe disconnection */
351 get_device(&timer->card->card_dev);
352 card_dev_to_put = &timer->card->card_dev;
355 if (list_empty(&timer->open_list_head) && timer->hw.open) {
356 err = timer->hw.open(timer);
358 module_put(timer->module);
363 timeri->timer = timer;
364 timeri->slave_class = tid->dev_sclass;
365 timeri->slave_id = slave_id;
367 list_add_tail(&timeri->open_list, &timer->open_list_head);
368 timer->num_instances++;
369 err = snd_timer_check_master(timeri);
372 snd_timer_close_locked(timeri, &card_dev_to_put);
375 mutex_unlock(®ister_mutex);
376 /* put_device() is called after unlock for avoiding deadlock */
377 if (err < 0 && card_dev_to_put)
378 put_device(card_dev_to_put);
381 EXPORT_SYMBOL(snd_timer_open);
383 /* remove slave links, called from snd_timer_close_locked() below */
384 static void remove_slave_links(struct snd_timer_instance *timeri,
385 struct snd_timer *timer)
387 struct snd_timer_instance *slave, *tmp;
389 guard(spinlock_irq)(&slave_active_lock);
390 guard(spinlock)(&timer->lock);
391 timeri->timer = NULL;
392 list_for_each_entry_safe(slave, tmp, &timeri->slave_list_head, open_list) {
393 list_move_tail(&slave->open_list, &snd_timer_slave_list);
394 timer->num_instances--;
395 slave->master = NULL;
397 list_del_init(&slave->ack_list);
398 list_del_init(&slave->active_list);
403 * close a timer instance
404 * call this with register_mutex down.
406 static void snd_timer_close_locked(struct snd_timer_instance *timeri,
407 struct device **card_devp_to_put)
409 struct snd_timer *timer = timeri->timer;
412 guard(spinlock_irq)(&timer->lock);
413 timeri->flags |= SNDRV_TIMER_IFLG_DEAD;
416 if (!list_empty(&timeri->open_list)) {
417 list_del_init(&timeri->open_list);
418 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
422 /* force to stop the timer */
423 snd_timer_stop(timeri);
426 timer->num_instances--;
427 /* wait, until the active callback is finished */
428 spin_lock_irq(&timer->lock);
429 while (timeri->flags & SNDRV_TIMER_IFLG_CALLBACK) {
430 spin_unlock_irq(&timer->lock);
432 spin_lock_irq(&timer->lock);
434 spin_unlock_irq(&timer->lock);
436 remove_slave_links(timeri, timer);
438 /* slave doesn't need to release timer resources below */
439 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
444 if (list_empty(&timer->open_list_head) && timer->hw.close)
445 timer->hw.close(timer);
446 /* release a card refcount for safe disconnection */
448 *card_devp_to_put = &timer->card->card_dev;
449 module_put(timer->module);
454 * close a timer instance
456 void snd_timer_close(struct snd_timer_instance *timeri)
458 struct device *card_dev_to_put = NULL;
460 if (snd_BUG_ON(!timeri))
463 scoped_guard(mutex, ®ister_mutex)
464 snd_timer_close_locked(timeri, &card_dev_to_put);
465 /* put_device() is called after unlock for avoiding deadlock */
467 put_device(card_dev_to_put);
469 EXPORT_SYMBOL(snd_timer_close);
471 static unsigned long snd_timer_hw_resolution(struct snd_timer *timer)
473 if (timer->hw.c_resolution)
474 return timer->hw.c_resolution(timer);
476 return timer->hw.resolution;
479 unsigned long snd_timer_resolution(struct snd_timer_instance *timeri)
481 struct snd_timer * timer;
482 unsigned long ret = 0;
486 timer = timeri->timer;
488 guard(spinlock_irqsave)(&timer->lock);
489 ret = snd_timer_hw_resolution(timer);
493 EXPORT_SYMBOL(snd_timer_resolution);
495 static void snd_timer_notify1(struct snd_timer_instance *ti, int event)
497 struct snd_timer *timer = ti->timer;
498 unsigned long resolution = 0;
499 struct snd_timer_instance *ts;
500 struct timespec64 tstamp;
502 if (timer_tstamp_monotonic)
503 ktime_get_ts64(&tstamp);
505 ktime_get_real_ts64(&tstamp);
506 if (snd_BUG_ON(event < SNDRV_TIMER_EVENT_START ||
507 event > SNDRV_TIMER_EVENT_PAUSE))
510 (event == SNDRV_TIMER_EVENT_START ||
511 event == SNDRV_TIMER_EVENT_CONTINUE))
512 resolution = snd_timer_hw_resolution(timer);
514 ti->ccallback(ti, event, &tstamp, resolution);
515 if (ti->flags & SNDRV_TIMER_IFLG_SLAVE)
519 if (timer->hw.flags & SNDRV_TIMER_HW_SLAVE)
521 event += 10; /* convert to SNDRV_TIMER_EVENT_MXXX */
522 list_for_each_entry(ts, &ti->slave_active_head, active_list)
524 ts->ccallback(ts, event, &tstamp, resolution);
527 /* start/continue a master timer */
528 static int snd_timer_start1(struct snd_timer_instance *timeri,
529 bool start, unsigned long ticks)
531 struct snd_timer *timer;
534 timer = timeri->timer;
538 guard(spinlock_irqsave)(&timer->lock);
539 if (timeri->flags & SNDRV_TIMER_IFLG_DEAD)
541 if (timer->card && timer->card->shutdown)
543 if (timeri->flags & (SNDRV_TIMER_IFLG_RUNNING |
544 SNDRV_TIMER_IFLG_START))
547 /* check the actual time for the start tick;
548 * bail out as error if it's way too low (< 100us)
551 if ((u64)snd_timer_hw_resolution(timer) * ticks < 100000)
556 timeri->ticks = timeri->cticks = ticks;
557 else if (!timeri->cticks)
561 list_move_tail(&timeri->active_list, &timer->active_list_head);
562 if (timer->running) {
563 if (timer->hw.flags & SNDRV_TIMER_HW_SLAVE)
565 timer->flags |= SNDRV_TIMER_FLG_RESCHED;
566 timeri->flags |= SNDRV_TIMER_IFLG_START;
567 result = 1; /* delayed start */
570 timer->sticks = ticks;
571 timer->hw.start(timer);
574 timeri->flags |= SNDRV_TIMER_IFLG_RUNNING;
577 snd_timer_notify1(timeri, start ? SNDRV_TIMER_EVENT_START :
578 SNDRV_TIMER_EVENT_CONTINUE);
582 /* start/continue a slave timer */
583 static int snd_timer_start_slave(struct snd_timer_instance *timeri,
586 guard(spinlock_irqsave)(&slave_active_lock);
587 if (timeri->flags & SNDRV_TIMER_IFLG_DEAD)
589 if (timeri->flags & SNDRV_TIMER_IFLG_RUNNING)
591 timeri->flags |= SNDRV_TIMER_IFLG_RUNNING;
592 if (timeri->master && timeri->timer) {
593 guard(spinlock)(&timeri->timer->lock);
594 list_add_tail(&timeri->active_list,
595 &timeri->master->slave_active_head);
596 snd_timer_notify1(timeri, start ? SNDRV_TIMER_EVENT_START :
597 SNDRV_TIMER_EVENT_CONTINUE);
599 return 1; /* delayed start */
602 /* stop/pause a master timer */
603 static int snd_timer_stop1(struct snd_timer_instance *timeri, bool stop)
605 struct snd_timer *timer;
607 timer = timeri->timer;
610 guard(spinlock_irqsave)(&timer->lock);
611 list_del_init(&timeri->ack_list);
612 list_del_init(&timeri->active_list);
613 if (!(timeri->flags & (SNDRV_TIMER_IFLG_RUNNING |
614 SNDRV_TIMER_IFLG_START)))
616 if (timer->card && timer->card->shutdown)
619 timeri->cticks = timeri->ticks;
622 if ((timeri->flags & SNDRV_TIMER_IFLG_RUNNING) &&
623 !(--timer->running)) {
624 timer->hw.stop(timer);
625 if (timer->flags & SNDRV_TIMER_FLG_RESCHED) {
626 timer->flags &= ~SNDRV_TIMER_FLG_RESCHED;
627 snd_timer_reschedule(timer, 0);
628 if (timer->flags & SNDRV_TIMER_FLG_CHANGE) {
629 timer->flags &= ~SNDRV_TIMER_FLG_CHANGE;
630 timer->hw.start(timer);
634 timeri->flags &= ~(SNDRV_TIMER_IFLG_RUNNING | SNDRV_TIMER_IFLG_START);
636 timeri->flags &= ~SNDRV_TIMER_IFLG_PAUSED;
638 timeri->flags |= SNDRV_TIMER_IFLG_PAUSED;
639 snd_timer_notify1(timeri, stop ? SNDRV_TIMER_EVENT_STOP :
640 SNDRV_TIMER_EVENT_PAUSE);
644 /* stop/pause a slave timer */
645 static int snd_timer_stop_slave(struct snd_timer_instance *timeri, bool stop)
649 guard(spinlock_irqsave)(&slave_active_lock);
650 running = timeri->flags & SNDRV_TIMER_IFLG_RUNNING;
651 timeri->flags &= ~SNDRV_TIMER_IFLG_RUNNING;
653 guard(spinlock)(&timeri->timer->lock);
654 list_del_init(&timeri->ack_list);
655 list_del_init(&timeri->active_list);
657 snd_timer_notify1(timeri, stop ? SNDRV_TIMER_EVENT_STOP :
658 SNDRV_TIMER_EVENT_PAUSE);
660 return running ? 0 : -EBUSY;
664 * start the timer instance
666 int snd_timer_start(struct snd_timer_instance *timeri, unsigned int ticks)
668 if (timeri == NULL || ticks < 1)
670 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
671 return snd_timer_start_slave(timeri, true);
673 return snd_timer_start1(timeri, true, ticks);
675 EXPORT_SYMBOL(snd_timer_start);
678 * stop the timer instance.
680 * do not call this from the timer callback!
682 int snd_timer_stop(struct snd_timer_instance *timeri)
684 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
685 return snd_timer_stop_slave(timeri, true);
687 return snd_timer_stop1(timeri, true);
689 EXPORT_SYMBOL(snd_timer_stop);
692 * start again.. the tick is kept.
694 int snd_timer_continue(struct snd_timer_instance *timeri)
696 /* timer can continue only after pause */
697 if (!(timeri->flags & SNDRV_TIMER_IFLG_PAUSED))
700 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
701 return snd_timer_start_slave(timeri, false);
703 return snd_timer_start1(timeri, false, 0);
705 EXPORT_SYMBOL(snd_timer_continue);
708 * pause.. remember the ticks left
710 int snd_timer_pause(struct snd_timer_instance * timeri)
712 if (timeri->flags & SNDRV_TIMER_IFLG_SLAVE)
713 return snd_timer_stop_slave(timeri, false);
715 return snd_timer_stop1(timeri, false);
717 EXPORT_SYMBOL(snd_timer_pause);
720 * reschedule the timer
722 * start pending instances and check the scheduling ticks.
723 * when the scheduling ticks is changed set CHANGE flag to reprogram the timer.
725 static void snd_timer_reschedule(struct snd_timer * timer, unsigned long ticks_left)
727 struct snd_timer_instance *ti;
728 unsigned long ticks = ~0UL;
730 list_for_each_entry(ti, &timer->active_list_head, active_list) {
731 if (ti->flags & SNDRV_TIMER_IFLG_START) {
732 ti->flags &= ~SNDRV_TIMER_IFLG_START;
733 ti->flags |= SNDRV_TIMER_IFLG_RUNNING;
736 if (ti->flags & SNDRV_TIMER_IFLG_RUNNING) {
737 if (ticks > ti->cticks)
742 timer->flags &= ~SNDRV_TIMER_FLG_RESCHED;
745 if (ticks > timer->hw.ticks)
746 ticks = timer->hw.ticks;
747 if (ticks_left != ticks)
748 timer->flags |= SNDRV_TIMER_FLG_CHANGE;
749 timer->sticks = ticks;
752 /* call callbacks in timer ack list */
753 static void snd_timer_process_callbacks(struct snd_timer *timer,
754 struct list_head *head)
756 struct snd_timer_instance *ti;
757 unsigned long resolution, ticks;
759 while (!list_empty(head)) {
760 ti = list_first_entry(head, struct snd_timer_instance,
763 /* remove from ack_list and make empty */
764 list_del_init(&ti->ack_list);
766 if (!(ti->flags & SNDRV_TIMER_IFLG_DEAD)) {
769 resolution = ti->resolution;
770 ti->flags |= SNDRV_TIMER_IFLG_CALLBACK;
771 spin_unlock(&timer->lock);
773 ti->callback(ti, resolution, ticks);
774 spin_lock(&timer->lock);
775 ti->flags &= ~SNDRV_TIMER_IFLG_CALLBACK;
780 /* clear pending instances from ack list */
781 static void snd_timer_clear_callbacks(struct snd_timer *timer,
782 struct list_head *head)
784 guard(spinlock_irqsave)(&timer->lock);
785 while (!list_empty(head))
786 list_del_init(head->next);
793 static void snd_timer_work(struct work_struct *work)
795 struct snd_timer *timer = container_of(work, struct snd_timer, task_work);
797 if (timer->card && timer->card->shutdown) {
798 snd_timer_clear_callbacks(timer, &timer->sack_list_head);
802 guard(spinlock_irqsave)(&timer->lock);
803 snd_timer_process_callbacks(timer, &timer->sack_list_head);
809 * ticks_left is usually equal to timer->sticks.
812 void snd_timer_interrupt(struct snd_timer * timer, unsigned long ticks_left)
814 struct snd_timer_instance *ti, *ts, *tmp;
815 unsigned long resolution;
816 struct list_head *ack_list_head;
821 if (timer->card && timer->card->shutdown) {
822 snd_timer_clear_callbacks(timer, &timer->ack_list_head);
826 guard(spinlock_irqsave)(&timer->lock);
828 /* remember the current resolution */
829 resolution = snd_timer_hw_resolution(timer);
831 /* loop for all active instances
832 * Here we cannot use list_for_each_entry because the active_list of a
833 * processed instance is relinked to done_list_head before the callback
836 list_for_each_entry_safe(ti, tmp, &timer->active_list_head,
838 if (ti->flags & SNDRV_TIMER_IFLG_DEAD)
840 if (!(ti->flags & SNDRV_TIMER_IFLG_RUNNING))
842 ti->pticks += ticks_left;
843 ti->resolution = resolution;
844 if (ti->cticks < ticks_left)
847 ti->cticks -= ticks_left;
848 if (ti->cticks) /* not expired */
850 if (ti->flags & SNDRV_TIMER_IFLG_AUTO) {
851 ti->cticks = ti->ticks;
853 ti->flags &= ~SNDRV_TIMER_IFLG_RUNNING;
855 list_del_init(&ti->active_list);
857 if ((timer->hw.flags & SNDRV_TIMER_HW_WORK) ||
858 (ti->flags & SNDRV_TIMER_IFLG_FAST))
859 ack_list_head = &timer->ack_list_head;
861 ack_list_head = &timer->sack_list_head;
862 if (list_empty(&ti->ack_list))
863 list_add_tail(&ti->ack_list, ack_list_head);
864 list_for_each_entry(ts, &ti->slave_active_head, active_list) {
865 ts->pticks = ti->pticks;
866 ts->resolution = resolution;
867 if (list_empty(&ts->ack_list))
868 list_add_tail(&ts->ack_list, ack_list_head);
871 if (timer->flags & SNDRV_TIMER_FLG_RESCHED)
872 snd_timer_reschedule(timer, timer->sticks);
873 if (timer->running) {
874 if (timer->hw.flags & SNDRV_TIMER_HW_STOP) {
875 timer->hw.stop(timer);
876 timer->flags |= SNDRV_TIMER_FLG_CHANGE;
878 if (!(timer->hw.flags & SNDRV_TIMER_HW_AUTO) ||
879 (timer->flags & SNDRV_TIMER_FLG_CHANGE)) {
881 timer->flags &= ~SNDRV_TIMER_FLG_CHANGE;
882 timer->hw.start(timer);
885 timer->hw.stop(timer);
888 /* now process all fast callbacks */
889 snd_timer_process_callbacks(timer, &timer->ack_list_head);
891 /* do we have any slow callbacks? */
892 if (!list_empty(&timer->sack_list_head))
893 queue_work(system_highpri_wq, &timer->task_work);
895 EXPORT_SYMBOL(snd_timer_interrupt);
901 int snd_timer_new(struct snd_card *card, char *id, struct snd_timer_id *tid,
902 struct snd_timer **rtimer)
904 struct snd_timer *timer;
906 static const struct snd_device_ops ops = {
907 .dev_free = snd_timer_dev_free,
908 .dev_register = snd_timer_dev_register,
909 .dev_disconnect = snd_timer_dev_disconnect,
912 if (snd_BUG_ON(!tid))
914 if (tid->dev_class == SNDRV_TIMER_CLASS_CARD ||
915 tid->dev_class == SNDRV_TIMER_CLASS_PCM) {
921 timer = kzalloc(sizeof(*timer), GFP_KERNEL);
924 timer->tmr_class = tid->dev_class;
926 timer->tmr_device = tid->device;
927 timer->tmr_subdevice = tid->subdevice;
929 strscpy(timer->id, id, sizeof(timer->id));
931 INIT_LIST_HEAD(&timer->device_list);
932 INIT_LIST_HEAD(&timer->open_list_head);
933 INIT_LIST_HEAD(&timer->active_list_head);
934 INIT_LIST_HEAD(&timer->ack_list_head);
935 INIT_LIST_HEAD(&timer->sack_list_head);
936 spin_lock_init(&timer->lock);
937 INIT_WORK(&timer->task_work, snd_timer_work);
938 timer->max_instances = 1000; /* default limit per timer */
940 timer->module = card->module;
941 err = snd_device_new(card, SNDRV_DEV_TIMER, timer, &ops);
943 snd_timer_free(timer);
951 EXPORT_SYMBOL(snd_timer_new);
953 static int snd_timer_free(struct snd_timer *timer)
958 guard(mutex)(®ister_mutex);
959 if (! list_empty(&timer->open_list_head)) {
960 struct list_head *p, *n;
961 struct snd_timer_instance *ti;
962 pr_warn("ALSA: timer %p is busy?\n", timer);
963 list_for_each_safe(p, n, &timer->open_list_head) {
965 ti = list_entry(p, struct snd_timer_instance, open_list);
969 list_del(&timer->device_list);
971 if (timer->private_free)
972 timer->private_free(timer);
977 static int snd_timer_dev_free(struct snd_device *device)
979 struct snd_timer *timer = device->device_data;
980 return snd_timer_free(timer);
983 static int snd_timer_dev_register(struct snd_device *dev)
985 struct snd_timer *timer = dev->device_data;
986 struct snd_timer *timer1;
988 if (snd_BUG_ON(!timer || !timer->hw.start || !timer->hw.stop))
990 if (!(timer->hw.flags & SNDRV_TIMER_HW_SLAVE) &&
991 !timer->hw.resolution && timer->hw.c_resolution == NULL)
994 guard(mutex)(®ister_mutex);
995 list_for_each_entry(timer1, &snd_timer_list, device_list) {
996 if (timer1->tmr_class > timer->tmr_class)
998 if (timer1->tmr_class < timer->tmr_class)
1000 if (timer1->card && timer->card) {
1001 if (timer1->card->number > timer->card->number)
1003 if (timer1->card->number < timer->card->number)
1006 if (timer1->tmr_device > timer->tmr_device)
1008 if (timer1->tmr_device < timer->tmr_device)
1010 if (timer1->tmr_subdevice > timer->tmr_subdevice)
1012 if (timer1->tmr_subdevice < timer->tmr_subdevice)
1017 list_add_tail(&timer->device_list, &timer1->device_list);
1021 static int snd_timer_dev_disconnect(struct snd_device *device)
1023 struct snd_timer *timer = device->device_data;
1024 struct snd_timer_instance *ti;
1026 guard(mutex)(®ister_mutex);
1027 list_del_init(&timer->device_list);
1028 /* wake up pending sleepers */
1029 list_for_each_entry(ti, &timer->open_list_head, open_list) {
1036 void snd_timer_notify(struct snd_timer *timer, int event, struct timespec64 *tstamp)
1038 unsigned long resolution = 0;
1039 struct snd_timer_instance *ti, *ts;
1041 if (timer->card && timer->card->shutdown)
1043 if (! (timer->hw.flags & SNDRV_TIMER_HW_SLAVE))
1045 if (snd_BUG_ON(event < SNDRV_TIMER_EVENT_MSTART ||
1046 event > SNDRV_TIMER_EVENT_MRESUME))
1048 guard(spinlock_irqsave)(&timer->lock);
1049 if (event == SNDRV_TIMER_EVENT_MSTART ||
1050 event == SNDRV_TIMER_EVENT_MCONTINUE ||
1051 event == SNDRV_TIMER_EVENT_MRESUME)
1052 resolution = snd_timer_hw_resolution(timer);
1053 list_for_each_entry(ti, &timer->active_list_head, active_list) {
1055 ti->ccallback(ti, event, tstamp, resolution);
1056 list_for_each_entry(ts, &ti->slave_active_head, active_list)
1058 ts->ccallback(ts, event, tstamp, resolution);
1061 EXPORT_SYMBOL(snd_timer_notify);
1064 * exported functions for global timers
1066 int snd_timer_global_new(char *id, int device, struct snd_timer **rtimer)
1068 struct snd_timer_id tid;
1070 tid.dev_class = SNDRV_TIMER_CLASS_GLOBAL;
1071 tid.dev_sclass = SNDRV_TIMER_SCLASS_NONE;
1073 tid.device = device;
1075 return snd_timer_new(NULL, id, &tid, rtimer);
1077 EXPORT_SYMBOL(snd_timer_global_new);
1079 int snd_timer_global_free(struct snd_timer *timer)
1081 return snd_timer_free(timer);
1083 EXPORT_SYMBOL(snd_timer_global_free);
1085 int snd_timer_global_register(struct snd_timer *timer)
1087 struct snd_device dev;
1089 memset(&dev, 0, sizeof(dev));
1090 dev.device_data = timer;
1091 return snd_timer_dev_register(&dev);
1093 EXPORT_SYMBOL(snd_timer_global_register);
1099 struct snd_timer_system_private {
1100 struct timer_list tlist;
1101 struct snd_timer *snd_timer;
1102 unsigned long last_expires;
1103 unsigned long last_jiffies;
1104 unsigned long correction;
1107 static void snd_timer_s_function(struct timer_list *t)
1109 struct snd_timer_system_private *priv = from_timer(priv, t,
1111 struct snd_timer *timer = priv->snd_timer;
1112 unsigned long jiff = jiffies;
1113 if (time_after(jiff, priv->last_expires))
1114 priv->correction += (long)jiff - (long)priv->last_expires;
1115 snd_timer_interrupt(timer, (long)jiff - (long)priv->last_jiffies);
1118 static int snd_timer_s_start(struct snd_timer * timer)
1120 struct snd_timer_system_private *priv;
1121 unsigned long njiff;
1123 priv = (struct snd_timer_system_private *) timer->private_data;
1124 njiff = (priv->last_jiffies = jiffies);
1125 if (priv->correction > timer->sticks - 1) {
1126 priv->correction -= timer->sticks - 1;
1129 njiff += timer->sticks - priv->correction;
1130 priv->correction = 0;
1132 priv->last_expires = njiff;
1133 mod_timer(&priv->tlist, njiff);
1137 static int snd_timer_s_stop(struct snd_timer * timer)
1139 struct snd_timer_system_private *priv;
1142 priv = (struct snd_timer_system_private *) timer->private_data;
1143 del_timer(&priv->tlist);
1145 if (time_before(jiff, priv->last_expires))
1146 timer->sticks = priv->last_expires - jiff;
1149 priv->correction = 0;
1153 static int snd_timer_s_close(struct snd_timer *timer)
1155 struct snd_timer_system_private *priv;
1157 priv = (struct snd_timer_system_private *)timer->private_data;
1158 del_timer_sync(&priv->tlist);
1162 static const struct snd_timer_hardware snd_timer_system =
1164 .flags = SNDRV_TIMER_HW_FIRST | SNDRV_TIMER_HW_WORK,
1165 .resolution = 1000000000L / HZ,
1167 .close = snd_timer_s_close,
1168 .start = snd_timer_s_start,
1169 .stop = snd_timer_s_stop
1172 static void snd_timer_free_system(struct snd_timer *timer)
1174 kfree(timer->private_data);
1177 static int snd_timer_register_system(void)
1179 struct snd_timer *timer;
1180 struct snd_timer_system_private *priv;
1183 err = snd_timer_global_new("system", SNDRV_TIMER_GLOBAL_SYSTEM, &timer);
1186 strcpy(timer->name, "system timer");
1187 timer->hw = snd_timer_system;
1188 priv = kzalloc(sizeof(*priv), GFP_KERNEL);
1190 snd_timer_free(timer);
1193 priv->snd_timer = timer;
1194 timer_setup(&priv->tlist, snd_timer_s_function, 0);
1195 timer->private_data = priv;
1196 timer->private_free = snd_timer_free_system;
1197 return snd_timer_global_register(timer);
1200 #ifdef CONFIG_SND_PROC_FS
1205 static void snd_timer_proc_read(struct snd_info_entry *entry,
1206 struct snd_info_buffer *buffer)
1208 struct snd_timer *timer;
1209 struct snd_timer_instance *ti;
1210 unsigned long resolution;
1212 guard(mutex)(®ister_mutex);
1213 list_for_each_entry(timer, &snd_timer_list, device_list) {
1214 if (timer->card && timer->card->shutdown)
1216 switch (timer->tmr_class) {
1217 case SNDRV_TIMER_CLASS_GLOBAL:
1218 snd_iprintf(buffer, "G%i: ", timer->tmr_device);
1220 case SNDRV_TIMER_CLASS_CARD:
1221 snd_iprintf(buffer, "C%i-%i: ",
1222 timer->card->number, timer->tmr_device);
1224 case SNDRV_TIMER_CLASS_PCM:
1225 snd_iprintf(buffer, "P%i-%i-%i: ", timer->card->number,
1226 timer->tmr_device, timer->tmr_subdevice);
1229 snd_iprintf(buffer, "?%i-%i-%i-%i: ", timer->tmr_class,
1230 timer->card ? timer->card->number : -1,
1231 timer->tmr_device, timer->tmr_subdevice);
1233 snd_iprintf(buffer, "%s :", timer->name);
1234 scoped_guard(spinlock_irq, &timer->lock)
1235 resolution = snd_timer_hw_resolution(timer);
1237 snd_iprintf(buffer, " %lu.%03luus (%lu ticks)",
1241 if (timer->hw.flags & SNDRV_TIMER_HW_SLAVE)
1242 snd_iprintf(buffer, " SLAVE");
1243 snd_iprintf(buffer, "\n");
1244 list_for_each_entry(ti, &timer->open_list_head, open_list)
1245 snd_iprintf(buffer, " Client %s : %s\n",
1246 ti->owner ? ti->owner : "unknown",
1247 (ti->flags & (SNDRV_TIMER_IFLG_START |
1248 SNDRV_TIMER_IFLG_RUNNING))
1249 ? "running" : "stopped");
1253 static struct snd_info_entry *snd_timer_proc_entry;
1255 static void __init snd_timer_proc_init(void)
1257 struct snd_info_entry *entry;
1259 entry = snd_info_create_module_entry(THIS_MODULE, "timers", NULL);
1260 if (entry != NULL) {
1261 entry->c.text.read = snd_timer_proc_read;
1262 if (snd_info_register(entry) < 0) {
1263 snd_info_free_entry(entry);
1267 snd_timer_proc_entry = entry;
1270 static void __exit snd_timer_proc_done(void)
1272 snd_info_free_entry(snd_timer_proc_entry);
1274 #else /* !CONFIG_SND_PROC_FS */
1275 #define snd_timer_proc_init()
1276 #define snd_timer_proc_done()
1280 * USER SPACE interface
1283 static void snd_timer_user_interrupt(struct snd_timer_instance *timeri,
1284 unsigned long resolution,
1285 unsigned long ticks)
1287 struct snd_timer_user *tu = timeri->callback_data;
1288 struct snd_timer_read *r;
1291 guard(spinlock)(&tu->qlock);
1292 if (tu->qused > 0) {
1293 prev = tu->qtail == 0 ? tu->queue_size - 1 : tu->qtail - 1;
1294 r = &tu->queue[prev];
1295 if (r->resolution == resolution) {
1300 if (tu->qused >= tu->queue_size) {
1303 r = &tu->queue[tu->qtail++];
1304 tu->qtail %= tu->queue_size;
1305 r->resolution = resolution;
1310 snd_kill_fasync(tu->fasync, SIGIO, POLL_IN);
1311 wake_up(&tu->qchange_sleep);
1314 static void snd_timer_user_append_to_tqueue(struct snd_timer_user *tu,
1315 struct snd_timer_tread64 *tread)
1317 if (tu->qused >= tu->queue_size) {
1320 memcpy(&tu->tqueue[tu->qtail++], tread, sizeof(*tread));
1321 tu->qtail %= tu->queue_size;
1326 static void snd_timer_user_ccallback(struct snd_timer_instance *timeri,
1328 struct timespec64 *tstamp,
1329 unsigned long resolution)
1331 struct snd_timer_user *tu = timeri->callback_data;
1332 struct snd_timer_tread64 r1;
1334 if (event >= SNDRV_TIMER_EVENT_START &&
1335 event <= SNDRV_TIMER_EVENT_PAUSE)
1336 tu->tstamp = *tstamp;
1337 if ((tu->filter & (1 << event)) == 0 || !tu->tread)
1339 memset(&r1, 0, sizeof(r1));
1341 r1.tstamp_sec = tstamp->tv_sec;
1342 r1.tstamp_nsec = tstamp->tv_nsec;
1343 r1.val = resolution;
1344 scoped_guard(spinlock_irqsave, &tu->qlock)
1345 snd_timer_user_append_to_tqueue(tu, &r1);
1346 snd_kill_fasync(tu->fasync, SIGIO, POLL_IN);
1347 wake_up(&tu->qchange_sleep);
1350 static void snd_timer_user_disconnect(struct snd_timer_instance *timeri)
1352 struct snd_timer_user *tu = timeri->callback_data;
1354 tu->disconnected = true;
1355 wake_up(&tu->qchange_sleep);
1358 static void snd_timer_user_tinterrupt(struct snd_timer_instance *timeri,
1359 unsigned long resolution,
1360 unsigned long ticks)
1362 struct snd_timer_user *tu = timeri->callback_data;
1363 struct snd_timer_tread64 *r, r1;
1364 struct timespec64 tstamp;
1365 int prev, append = 0;
1367 memset(&r1, 0, sizeof(r1));
1368 memset(&tstamp, 0, sizeof(tstamp));
1369 scoped_guard(spinlock, &tu->qlock) {
1370 if ((tu->filter & ((1 << SNDRV_TIMER_EVENT_RESOLUTION) |
1371 (1 << SNDRV_TIMER_EVENT_TICK))) == 0)
1373 if (tu->last_resolution != resolution || ticks > 0) {
1374 if (timer_tstamp_monotonic)
1375 ktime_get_ts64(&tstamp);
1377 ktime_get_real_ts64(&tstamp);
1379 if ((tu->filter & (1 << SNDRV_TIMER_EVENT_RESOLUTION)) &&
1380 tu->last_resolution != resolution) {
1381 r1.event = SNDRV_TIMER_EVENT_RESOLUTION;
1382 r1.tstamp_sec = tstamp.tv_sec;
1383 r1.tstamp_nsec = tstamp.tv_nsec;
1384 r1.val = resolution;
1385 snd_timer_user_append_to_tqueue(tu, &r1);
1386 tu->last_resolution = resolution;
1389 if ((tu->filter & (1 << SNDRV_TIMER_EVENT_TICK)) == 0)
1393 if (tu->qused > 0) {
1394 prev = tu->qtail == 0 ? tu->queue_size - 1 : tu->qtail - 1;
1395 r = &tu->tqueue[prev];
1396 if (r->event == SNDRV_TIMER_EVENT_TICK) {
1397 r->tstamp_sec = tstamp.tv_sec;
1398 r->tstamp_nsec = tstamp.tv_nsec;
1404 r1.event = SNDRV_TIMER_EVENT_TICK;
1405 r1.tstamp_sec = tstamp.tv_sec;
1406 r1.tstamp_nsec = tstamp.tv_nsec;
1408 snd_timer_user_append_to_tqueue(tu, &r1);
1413 snd_kill_fasync(tu->fasync, SIGIO, POLL_IN);
1414 wake_up(&tu->qchange_sleep);
1417 static int realloc_user_queue(struct snd_timer_user *tu, int size)
1419 struct snd_timer_read *queue = NULL;
1420 struct snd_timer_tread64 *tqueue = NULL;
1423 tqueue = kcalloc(size, sizeof(*tqueue), GFP_KERNEL);
1427 queue = kcalloc(size, sizeof(*queue), GFP_KERNEL);
1432 guard(spinlock_irq)(&tu->qlock);
1435 tu->queue_size = size;
1437 tu->tqueue = tqueue;
1438 tu->qhead = tu->qtail = tu->qused = 0;
1443 static int snd_timer_user_open(struct inode *inode, struct file *file)
1445 struct snd_timer_user *tu;
1448 err = stream_open(inode, file);
1452 tu = kzalloc(sizeof(*tu), GFP_KERNEL);
1455 spin_lock_init(&tu->qlock);
1456 init_waitqueue_head(&tu->qchange_sleep);
1457 mutex_init(&tu->ioctl_lock);
1459 if (realloc_user_queue(tu, 128) < 0) {
1463 file->private_data = tu;
1467 static int snd_timer_user_release(struct inode *inode, struct file *file)
1469 struct snd_timer_user *tu;
1471 if (file->private_data) {
1472 tu = file->private_data;
1473 file->private_data = NULL;
1474 scoped_guard(mutex, &tu->ioctl_lock) {
1476 snd_timer_close(tu->timeri);
1477 snd_timer_instance_free(tu->timeri);
1480 snd_fasync_free(tu->fasync);
1488 static void snd_timer_user_zero_id(struct snd_timer_id *id)
1490 id->dev_class = SNDRV_TIMER_CLASS_NONE;
1491 id->dev_sclass = SNDRV_TIMER_SCLASS_NONE;
1497 static void snd_timer_user_copy_id(struct snd_timer_id *id, struct snd_timer *timer)
1499 id->dev_class = timer->tmr_class;
1500 id->dev_sclass = SNDRV_TIMER_SCLASS_NONE;
1501 id->card = timer->card ? timer->card->number : -1;
1502 id->device = timer->tmr_device;
1503 id->subdevice = timer->tmr_subdevice;
1506 static int snd_timer_user_next_device(struct snd_timer_id __user *_tid)
1508 struct snd_timer_id id;
1509 struct snd_timer *timer;
1510 struct list_head *p;
1512 if (copy_from_user(&id, _tid, sizeof(id)))
1514 guard(mutex)(®ister_mutex);
1515 if (id.dev_class < 0) { /* first item */
1516 if (list_empty(&snd_timer_list))
1517 snd_timer_user_zero_id(&id);
1519 timer = list_entry(snd_timer_list.next,
1520 struct snd_timer, device_list);
1521 snd_timer_user_copy_id(&id, timer);
1524 switch (id.dev_class) {
1525 case SNDRV_TIMER_CLASS_GLOBAL:
1526 id.device = id.device < 0 ? 0 : id.device + 1;
1527 list_for_each(p, &snd_timer_list) {
1528 timer = list_entry(p, struct snd_timer, device_list);
1529 if (timer->tmr_class > SNDRV_TIMER_CLASS_GLOBAL) {
1530 snd_timer_user_copy_id(&id, timer);
1533 if (timer->tmr_device >= id.device) {
1534 snd_timer_user_copy_id(&id, timer);
1538 if (p == &snd_timer_list)
1539 snd_timer_user_zero_id(&id);
1541 case SNDRV_TIMER_CLASS_CARD:
1542 case SNDRV_TIMER_CLASS_PCM:
1546 if (id.device < 0) {
1549 if (id.subdevice < 0)
1551 else if (id.subdevice < INT_MAX)
1555 list_for_each(p, &snd_timer_list) {
1556 timer = list_entry(p, struct snd_timer, device_list);
1557 if (timer->tmr_class > id.dev_class) {
1558 snd_timer_user_copy_id(&id, timer);
1561 if (timer->tmr_class < id.dev_class)
1563 if (timer->card->number > id.card) {
1564 snd_timer_user_copy_id(&id, timer);
1567 if (timer->card->number < id.card)
1569 if (timer->tmr_device > id.device) {
1570 snd_timer_user_copy_id(&id, timer);
1573 if (timer->tmr_device < id.device)
1575 if (timer->tmr_subdevice > id.subdevice) {
1576 snd_timer_user_copy_id(&id, timer);
1579 if (timer->tmr_subdevice < id.subdevice)
1581 snd_timer_user_copy_id(&id, timer);
1584 if (p == &snd_timer_list)
1585 snd_timer_user_zero_id(&id);
1588 snd_timer_user_zero_id(&id);
1591 if (copy_to_user(_tid, &id, sizeof(*_tid)))
1596 static int snd_timer_user_ginfo(struct file *file,
1597 struct snd_timer_ginfo __user *_ginfo)
1599 struct snd_timer_ginfo *ginfo __free(kfree) = NULL;
1600 struct snd_timer_id tid;
1601 struct snd_timer *t;
1602 struct list_head *p;
1604 ginfo = memdup_user(_ginfo, sizeof(*ginfo));
1606 return PTR_ERR(no_free_ptr(ginfo));
1609 memset(ginfo, 0, sizeof(*ginfo));
1611 guard(mutex)(®ister_mutex);
1612 t = snd_timer_find(&tid);
1615 ginfo->card = t->card ? t->card->number : -1;
1616 if (t->hw.flags & SNDRV_TIMER_HW_SLAVE)
1617 ginfo->flags |= SNDRV_TIMER_FLG_SLAVE;
1618 strscpy(ginfo->id, t->id, sizeof(ginfo->id));
1619 strscpy(ginfo->name, t->name, sizeof(ginfo->name));
1620 scoped_guard(spinlock_irq, &t->lock)
1621 ginfo->resolution = snd_timer_hw_resolution(t);
1622 if (t->hw.resolution_min > 0) {
1623 ginfo->resolution_min = t->hw.resolution_min;
1624 ginfo->resolution_max = t->hw.resolution_max;
1626 list_for_each(p, &t->open_list_head) {
1629 if (copy_to_user(_ginfo, ginfo, sizeof(*ginfo)))
1634 static int timer_set_gparams(struct snd_timer_gparams *gparams)
1636 struct snd_timer *t;
1638 guard(mutex)(®ister_mutex);
1639 t = snd_timer_find(&gparams->tid);
1642 if (!list_empty(&t->open_list_head))
1644 if (!t->hw.set_period)
1646 return t->hw.set_period(t, gparams->period_num, gparams->period_den);
1649 static int snd_timer_user_gparams(struct file *file,
1650 struct snd_timer_gparams __user *_gparams)
1652 struct snd_timer_gparams gparams;
1654 if (copy_from_user(&gparams, _gparams, sizeof(gparams)))
1656 return timer_set_gparams(&gparams);
1659 static int snd_timer_user_gstatus(struct file *file,
1660 struct snd_timer_gstatus __user *_gstatus)
1662 struct snd_timer_gstatus gstatus;
1663 struct snd_timer_id tid;
1664 struct snd_timer *t;
1667 if (copy_from_user(&gstatus, _gstatus, sizeof(gstatus)))
1670 memset(&gstatus, 0, sizeof(gstatus));
1672 guard(mutex)(®ister_mutex);
1673 t = snd_timer_find(&tid);
1675 guard(spinlock_irq)(&t->lock);
1676 gstatus.resolution = snd_timer_hw_resolution(t);
1677 if (t->hw.precise_resolution) {
1678 t->hw.precise_resolution(t, &gstatus.resolution_num,
1679 &gstatus.resolution_den);
1681 gstatus.resolution_num = gstatus.resolution;
1682 gstatus.resolution_den = 1000000000uL;
1687 if (err >= 0 && copy_to_user(_gstatus, &gstatus, sizeof(gstatus)))
1692 static int snd_timer_user_tselect(struct file *file,
1693 struct snd_timer_select __user *_tselect)
1695 struct snd_timer_user *tu;
1696 struct snd_timer_select tselect;
1700 tu = file->private_data;
1702 snd_timer_close(tu->timeri);
1703 snd_timer_instance_free(tu->timeri);
1706 if (copy_from_user(&tselect, _tselect, sizeof(tselect))) {
1710 sprintf(str, "application %i", current->pid);
1711 if (tselect.id.dev_class != SNDRV_TIMER_CLASS_SLAVE)
1712 tselect.id.dev_sclass = SNDRV_TIMER_SCLASS_APPLICATION;
1713 tu->timeri = snd_timer_instance_new(str);
1719 tu->timeri->flags |= SNDRV_TIMER_IFLG_FAST;
1720 tu->timeri->callback = tu->tread
1721 ? snd_timer_user_tinterrupt : snd_timer_user_interrupt;
1722 tu->timeri->ccallback = snd_timer_user_ccallback;
1723 tu->timeri->callback_data = (void *)tu;
1724 tu->timeri->disconnect = snd_timer_user_disconnect;
1726 err = snd_timer_open(tu->timeri, &tselect.id, current->pid);
1728 snd_timer_instance_free(tu->timeri);
1736 static int snd_timer_user_info(struct file *file,
1737 struct snd_timer_info __user *_info)
1739 struct snd_timer_user *tu;
1740 struct snd_timer_info *info __free(kfree) = NULL;
1741 struct snd_timer *t;
1743 tu = file->private_data;
1746 t = tu->timeri->timer;
1750 info = kzalloc(sizeof(*info), GFP_KERNEL);
1753 info->card = t->card ? t->card->number : -1;
1754 if (t->hw.flags & SNDRV_TIMER_HW_SLAVE)
1755 info->flags |= SNDRV_TIMER_FLG_SLAVE;
1756 strscpy(info->id, t->id, sizeof(info->id));
1757 strscpy(info->name, t->name, sizeof(info->name));
1758 scoped_guard(spinlock_irq, &t->lock)
1759 info->resolution = snd_timer_hw_resolution(t);
1760 if (copy_to_user(_info, info, sizeof(*_info)))
1765 static int snd_timer_user_params(struct file *file,
1766 struct snd_timer_params __user *_params)
1768 struct snd_timer_user *tu;
1769 struct snd_timer_params params;
1770 struct snd_timer *t;
1773 tu = file->private_data;
1776 t = tu->timeri->timer;
1779 if (copy_from_user(¶ms, _params, sizeof(params)))
1781 if (!(t->hw.flags & SNDRV_TIMER_HW_SLAVE)) {
1784 if (params.ticks < 1) {
1789 /* Don't allow resolution less than 1ms */
1790 resolution = snd_timer_resolution(tu->timeri);
1791 resolution *= params.ticks;
1792 if (resolution < 1000000) {
1797 if (params.queue_size > 0 &&
1798 (params.queue_size < 32 || params.queue_size > 1024)) {
1802 if (params.filter & ~((1<<SNDRV_TIMER_EVENT_RESOLUTION)|
1803 (1<<SNDRV_TIMER_EVENT_TICK)|
1804 (1<<SNDRV_TIMER_EVENT_START)|
1805 (1<<SNDRV_TIMER_EVENT_STOP)|
1806 (1<<SNDRV_TIMER_EVENT_CONTINUE)|
1807 (1<<SNDRV_TIMER_EVENT_PAUSE)|
1808 (1<<SNDRV_TIMER_EVENT_SUSPEND)|
1809 (1<<SNDRV_TIMER_EVENT_RESUME)|
1810 (1<<SNDRV_TIMER_EVENT_MSTART)|
1811 (1<<SNDRV_TIMER_EVENT_MSTOP)|
1812 (1<<SNDRV_TIMER_EVENT_MCONTINUE)|
1813 (1<<SNDRV_TIMER_EVENT_MPAUSE)|
1814 (1<<SNDRV_TIMER_EVENT_MSUSPEND)|
1815 (1<<SNDRV_TIMER_EVENT_MRESUME))) {
1819 snd_timer_stop(tu->timeri);
1820 scoped_guard(spinlock_irq, &t->lock) {
1821 tu->timeri->flags &= ~(SNDRV_TIMER_IFLG_AUTO|
1822 SNDRV_TIMER_IFLG_EXCLUSIVE|
1823 SNDRV_TIMER_IFLG_EARLY_EVENT);
1824 if (params.flags & SNDRV_TIMER_PSFLG_AUTO)
1825 tu->timeri->flags |= SNDRV_TIMER_IFLG_AUTO;
1826 if (params.flags & SNDRV_TIMER_PSFLG_EXCLUSIVE)
1827 tu->timeri->flags |= SNDRV_TIMER_IFLG_EXCLUSIVE;
1828 if (params.flags & SNDRV_TIMER_PSFLG_EARLY_EVENT)
1829 tu->timeri->flags |= SNDRV_TIMER_IFLG_EARLY_EVENT;
1831 if (params.queue_size > 0 &&
1832 (unsigned int)tu->queue_size != params.queue_size) {
1833 err = realloc_user_queue(tu, params.queue_size);
1837 scoped_guard(spinlock_irq, &tu->qlock) {
1838 tu->qhead = tu->qtail = tu->qused = 0;
1839 if (tu->timeri->flags & SNDRV_TIMER_IFLG_EARLY_EVENT) {
1841 struct snd_timer_tread64 tread;
1843 memset(&tread, 0, sizeof(tread));
1844 tread.event = SNDRV_TIMER_EVENT_EARLY;
1845 tread.tstamp_sec = 0;
1846 tread.tstamp_nsec = 0;
1848 snd_timer_user_append_to_tqueue(tu, &tread);
1850 struct snd_timer_read *r = &tu->queue[0];
1858 tu->filter = params.filter;
1859 tu->ticks = params.ticks;
1863 if (copy_to_user(_params, ¶ms, sizeof(params)))
1868 static int snd_timer_user_status32(struct file *file,
1869 struct snd_timer_status32 __user *_status)
1871 struct snd_timer_user *tu;
1872 struct snd_timer_status32 status;
1874 tu = file->private_data;
1877 memset(&status, 0, sizeof(status));
1878 status.tstamp_sec = tu->tstamp.tv_sec;
1879 status.tstamp_nsec = tu->tstamp.tv_nsec;
1880 status.resolution = snd_timer_resolution(tu->timeri);
1881 status.lost = tu->timeri->lost;
1882 status.overrun = tu->overrun;
1883 scoped_guard(spinlock_irq, &tu->qlock)
1884 status.queue = tu->qused;
1885 if (copy_to_user(_status, &status, sizeof(status)))
1890 static int snd_timer_user_status64(struct file *file,
1891 struct snd_timer_status64 __user *_status)
1893 struct snd_timer_user *tu;
1894 struct snd_timer_status64 status;
1896 tu = file->private_data;
1899 memset(&status, 0, sizeof(status));
1900 status.tstamp_sec = tu->tstamp.tv_sec;
1901 status.tstamp_nsec = tu->tstamp.tv_nsec;
1902 status.resolution = snd_timer_resolution(tu->timeri);
1903 status.lost = tu->timeri->lost;
1904 status.overrun = tu->overrun;
1905 scoped_guard(spinlock_irq, &tu->qlock)
1906 status.queue = tu->qused;
1907 if (copy_to_user(_status, &status, sizeof(status)))
1912 static int snd_timer_user_start(struct file *file)
1915 struct snd_timer_user *tu;
1917 tu = file->private_data;
1920 snd_timer_stop(tu->timeri);
1921 tu->timeri->lost = 0;
1922 tu->last_resolution = 0;
1923 err = snd_timer_start(tu->timeri, tu->ticks);
1929 static int snd_timer_user_stop(struct file *file)
1932 struct snd_timer_user *tu;
1934 tu = file->private_data;
1937 err = snd_timer_stop(tu->timeri);
1943 static int snd_timer_user_continue(struct file *file)
1946 struct snd_timer_user *tu;
1948 tu = file->private_data;
1951 /* start timer instead of continue if it's not used before */
1952 if (!(tu->timeri->flags & SNDRV_TIMER_IFLG_PAUSED))
1953 return snd_timer_user_start(file);
1954 tu->timeri->lost = 0;
1955 err = snd_timer_continue(tu->timeri);
1961 static int snd_timer_user_pause(struct file *file)
1964 struct snd_timer_user *tu;
1966 tu = file->private_data;
1969 err = snd_timer_pause(tu->timeri);
1975 static int snd_timer_user_tread(void __user *argp, struct snd_timer_user *tu,
1976 unsigned int cmd, bool compat)
1978 int __user *p = argp;
1979 int xarg, old_tread;
1981 if (tu->timeri) /* too late */
1983 if (get_user(xarg, p))
1986 old_tread = tu->tread;
1989 tu->tread = TREAD_FORMAT_NONE;
1990 else if (cmd == SNDRV_TIMER_IOCTL_TREAD64 ||
1991 (IS_ENABLED(CONFIG_64BIT) && !compat))
1992 tu->tread = TREAD_FORMAT_TIME64;
1994 tu->tread = TREAD_FORMAT_TIME32;
1996 if (tu->tread != old_tread &&
1997 realloc_user_queue(tu, tu->queue_size) < 0) {
1998 tu->tread = old_tread;
2006 SNDRV_TIMER_IOCTL_START_OLD = _IO('T', 0x20),
2007 SNDRV_TIMER_IOCTL_STOP_OLD = _IO('T', 0x21),
2008 SNDRV_TIMER_IOCTL_CONTINUE_OLD = _IO('T', 0x22),
2009 SNDRV_TIMER_IOCTL_PAUSE_OLD = _IO('T', 0x23),
2012 static long __snd_timer_user_ioctl(struct file *file, unsigned int cmd,
2013 unsigned long arg, bool compat)
2015 struct snd_timer_user *tu;
2016 void __user *argp = (void __user *)arg;
2017 int __user *p = argp;
2019 tu = file->private_data;
2021 case SNDRV_TIMER_IOCTL_PVERSION:
2022 return put_user(SNDRV_TIMER_VERSION, p) ? -EFAULT : 0;
2023 case SNDRV_TIMER_IOCTL_NEXT_DEVICE:
2024 return snd_timer_user_next_device(argp);
2025 case SNDRV_TIMER_IOCTL_TREAD_OLD:
2026 case SNDRV_TIMER_IOCTL_TREAD64:
2027 return snd_timer_user_tread(argp, tu, cmd, compat);
2028 case SNDRV_TIMER_IOCTL_GINFO:
2029 return snd_timer_user_ginfo(file, argp);
2030 case SNDRV_TIMER_IOCTL_GPARAMS:
2031 return snd_timer_user_gparams(file, argp);
2032 case SNDRV_TIMER_IOCTL_GSTATUS:
2033 return snd_timer_user_gstatus(file, argp);
2034 case SNDRV_TIMER_IOCTL_SELECT:
2035 return snd_timer_user_tselect(file, argp);
2036 case SNDRV_TIMER_IOCTL_INFO:
2037 return snd_timer_user_info(file, argp);
2038 case SNDRV_TIMER_IOCTL_PARAMS:
2039 return snd_timer_user_params(file, argp);
2040 case SNDRV_TIMER_IOCTL_STATUS32:
2041 return snd_timer_user_status32(file, argp);
2042 case SNDRV_TIMER_IOCTL_STATUS64:
2043 return snd_timer_user_status64(file, argp);
2044 case SNDRV_TIMER_IOCTL_START:
2045 case SNDRV_TIMER_IOCTL_START_OLD:
2046 return snd_timer_user_start(file);
2047 case SNDRV_TIMER_IOCTL_STOP:
2048 case SNDRV_TIMER_IOCTL_STOP_OLD:
2049 return snd_timer_user_stop(file);
2050 case SNDRV_TIMER_IOCTL_CONTINUE:
2051 case SNDRV_TIMER_IOCTL_CONTINUE_OLD:
2052 return snd_timer_user_continue(file);
2053 case SNDRV_TIMER_IOCTL_PAUSE:
2054 case SNDRV_TIMER_IOCTL_PAUSE_OLD:
2055 return snd_timer_user_pause(file);
2060 static long snd_timer_user_ioctl(struct file *file, unsigned int cmd,
2063 struct snd_timer_user *tu = file->private_data;
2065 guard(mutex)(&tu->ioctl_lock);
2066 return __snd_timer_user_ioctl(file, cmd, arg, false);
2069 static int snd_timer_user_fasync(int fd, struct file * file, int on)
2071 struct snd_timer_user *tu;
2073 tu = file->private_data;
2074 return snd_fasync_helper(fd, file, on, &tu->fasync);
2077 static ssize_t snd_timer_user_read(struct file *file, char __user *buffer,
2078 size_t count, loff_t *offset)
2080 struct snd_timer_tread64 *tread;
2081 struct snd_timer_tread32 tread32;
2082 struct snd_timer_user *tu;
2083 long result = 0, unit;
2087 tu = file->private_data;
2088 switch (tu->tread) {
2089 case TREAD_FORMAT_TIME64:
2090 unit = sizeof(struct snd_timer_tread64);
2092 case TREAD_FORMAT_TIME32:
2093 unit = sizeof(struct snd_timer_tread32);
2095 case TREAD_FORMAT_NONE:
2096 unit = sizeof(struct snd_timer_read);
2099 WARN_ONCE(1, "Corrupt snd_timer_user\n");
2103 mutex_lock(&tu->ioctl_lock);
2104 spin_lock_irq(&tu->qlock);
2105 while ((long)count - result >= unit) {
2106 while (!tu->qused) {
2107 wait_queue_entry_t wait;
2109 if ((file->f_flags & O_NONBLOCK) != 0 || result > 0) {
2114 set_current_state(TASK_INTERRUPTIBLE);
2115 init_waitqueue_entry(&wait, current);
2116 add_wait_queue(&tu->qchange_sleep, &wait);
2118 spin_unlock_irq(&tu->qlock);
2119 mutex_unlock(&tu->ioctl_lock);
2121 mutex_lock(&tu->ioctl_lock);
2122 spin_lock_irq(&tu->qlock);
2124 remove_wait_queue(&tu->qchange_sleep, &wait);
2126 if (tu->disconnected) {
2130 if (signal_pending(current)) {
2136 qhead = tu->qhead++;
2137 tu->qhead %= tu->queue_size;
2139 spin_unlock_irq(&tu->qlock);
2141 tread = &tu->tqueue[qhead];
2143 switch (tu->tread) {
2144 case TREAD_FORMAT_TIME64:
2145 if (copy_to_user(buffer, tread,
2146 sizeof(struct snd_timer_tread64)))
2149 case TREAD_FORMAT_TIME32:
2150 memset(&tread32, 0, sizeof(tread32));
2151 tread32 = (struct snd_timer_tread32) {
2152 .event = tread->event,
2153 .tstamp_sec = tread->tstamp_sec,
2154 .tstamp_nsec = tread->tstamp_nsec,
2158 if (copy_to_user(buffer, &tread32, sizeof(tread32)))
2161 case TREAD_FORMAT_NONE:
2162 if (copy_to_user(buffer, &tu->queue[qhead],
2163 sizeof(struct snd_timer_read)))
2171 spin_lock_irq(&tu->qlock);
2178 spin_unlock_irq(&tu->qlock);
2179 mutex_unlock(&tu->ioctl_lock);
2180 return result > 0 ? result : err;
2183 static __poll_t snd_timer_user_poll(struct file *file, poll_table * wait)
2186 struct snd_timer_user *tu;
2188 tu = file->private_data;
2190 poll_wait(file, &tu->qchange_sleep, wait);
2193 guard(spinlock_irq)(&tu->qlock);
2195 mask |= EPOLLIN | EPOLLRDNORM;
2196 if (tu->disconnected)
2202 #ifdef CONFIG_COMPAT
2203 #include "timer_compat.c"
2205 #define snd_timer_user_ioctl_compat NULL
2208 static const struct file_operations snd_timer_f_ops =
2210 .owner = THIS_MODULE,
2211 .read = snd_timer_user_read,
2212 .open = snd_timer_user_open,
2213 .release = snd_timer_user_release,
2214 .llseek = no_llseek,
2215 .poll = snd_timer_user_poll,
2216 .unlocked_ioctl = snd_timer_user_ioctl,
2217 .compat_ioctl = snd_timer_user_ioctl_compat,
2218 .fasync = snd_timer_user_fasync,
2221 /* unregister the system timer */
2222 static void snd_timer_free_all(void)
2224 struct snd_timer *timer, *n;
2226 list_for_each_entry_safe(timer, n, &snd_timer_list, device_list)
2227 snd_timer_free(timer);
2230 static struct device *timer_dev;
2236 static int __init alsa_timer_init(void)
2240 err = snd_device_alloc(&timer_dev, NULL);
2243 dev_set_name(timer_dev, "timer");
2245 #ifdef SNDRV_OSS_INFO_DEV_TIMERS
2246 snd_oss_info_register(SNDRV_OSS_INFO_DEV_TIMERS, SNDRV_CARDS - 1,
2250 err = snd_timer_register_system();
2252 pr_err("ALSA: unable to register system timer (%i)\n", err);
2256 err = snd_register_device(SNDRV_DEVICE_TYPE_TIMER, NULL, 0,
2257 &snd_timer_f_ops, NULL, timer_dev);
2259 pr_err("ALSA: unable to register timer device (%i)\n", err);
2260 snd_timer_free_all();
2264 snd_timer_proc_init();
2268 put_device(timer_dev);
2272 static void __exit alsa_timer_exit(void)
2274 snd_unregister_device(timer_dev);
2275 snd_timer_free_all();
2276 put_device(timer_dev);
2277 snd_timer_proc_done();
2278 #ifdef SNDRV_OSS_INFO_DEV_TIMERS
2279 snd_oss_info_unregister(SNDRV_OSS_INFO_DEV_TIMERS, SNDRV_CARDS - 1);
2283 module_init(alsa_timer_init)
2284 module_exit(alsa_timer_exit)