1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * ALSA sequencer Client Manager
9 #include <linux/init.h>
10 #include <linux/export.h>
11 #include <linux/slab.h>
12 #include <sound/core.h>
13 #include <sound/minors.h>
14 #include <linux/kmod.h>
16 #include <sound/seq_kernel.h>
17 #include "seq_clientmgr.h"
18 #include "seq_memory.h"
19 #include "seq_queue.h"
20 #include "seq_timer.h"
22 #include "seq_system.h"
23 #include <sound/seq_device.h>
25 #include <linux/compat.h>
30 * this module handles the connections of userland and kernel clients
35 * There are four ranges of client numbers (last two shared):
36 * 0..15: global clients
37 * 16..127: statically allocated client numbers for cards 0..27
38 * 128..191: dynamically allocated client numbers for cards 28..31
39 * 128..191: dynamically allocated client numbers for applications
42 /* number of kernel non-card clients */
43 #define SNDRV_SEQ_GLOBAL_CLIENTS 16
44 /* clients per cards, for static clients */
45 #define SNDRV_SEQ_CLIENTS_PER_CARD 4
46 /* dynamically allocated client numbers (both kernel drivers and user space) */
47 #define SNDRV_SEQ_DYNAMIC_CLIENTS_BEGIN 128
49 #define SNDRV_SEQ_LFLG_INPUT 0x0001
50 #define SNDRV_SEQ_LFLG_OUTPUT 0x0002
51 #define SNDRV_SEQ_LFLG_OPEN (SNDRV_SEQ_LFLG_INPUT|SNDRV_SEQ_LFLG_OUTPUT)
53 static DEFINE_SPINLOCK(clients_lock);
54 static DEFINE_MUTEX(register_mutex);
59 static char clienttablock[SNDRV_SEQ_MAX_CLIENTS];
60 static struct snd_seq_client *clienttab[SNDRV_SEQ_MAX_CLIENTS];
61 static struct snd_seq_usage client_usage;
66 static int bounce_error_event(struct snd_seq_client *client,
67 struct snd_seq_event *event,
68 int err, int atomic, int hop);
69 static int snd_seq_deliver_single_event(struct snd_seq_client *client,
70 struct snd_seq_event *event,
71 int filter, int atomic, int hop);
75 static inline unsigned short snd_seq_file_flags(struct file *file)
77 switch (file->f_mode & (FMODE_READ | FMODE_WRITE)) {
79 return SNDRV_SEQ_LFLG_OUTPUT;
81 return SNDRV_SEQ_LFLG_INPUT;
83 return SNDRV_SEQ_LFLG_OPEN;
87 static inline int snd_seq_write_pool_allocated(struct snd_seq_client *client)
89 return snd_seq_total_cells(client->pool) > 0;
92 /* return pointer to client structure for specified id */
93 static struct snd_seq_client *clientptr(int clientid)
95 if (clientid < 0 || clientid >= SNDRV_SEQ_MAX_CLIENTS) {
96 pr_debug("ALSA: seq: oops. Trying to get pointer to client %d\n",
100 return clienttab[clientid];
103 struct snd_seq_client *snd_seq_client_use_ptr(int clientid)
106 struct snd_seq_client *client;
108 if (clientid < 0 || clientid >= SNDRV_SEQ_MAX_CLIENTS) {
109 pr_debug("ALSA: seq: oops. Trying to get pointer to client %d\n",
113 spin_lock_irqsave(&clients_lock, flags);
114 client = clientptr(clientid);
117 if (clienttablock[clientid]) {
118 spin_unlock_irqrestore(&clients_lock, flags);
121 spin_unlock_irqrestore(&clients_lock, flags);
122 #ifdef CONFIG_MODULES
123 if (!in_interrupt()) {
124 static char client_requested[SNDRV_SEQ_GLOBAL_CLIENTS];
125 static char card_requested[SNDRV_CARDS];
126 if (clientid < SNDRV_SEQ_GLOBAL_CLIENTS) {
129 if (!client_requested[clientid]) {
130 client_requested[clientid] = 1;
131 for (idx = 0; idx < 15; idx++) {
132 if (seq_client_load[idx] < 0)
134 if (seq_client_load[idx] == clientid) {
135 request_module("snd-seq-client-%i",
141 } else if (clientid < SNDRV_SEQ_DYNAMIC_CLIENTS_BEGIN) {
142 int card = (clientid - SNDRV_SEQ_GLOBAL_CLIENTS) /
143 SNDRV_SEQ_CLIENTS_PER_CARD;
144 if (card < snd_ecards_limit) {
145 if (! card_requested[card]) {
146 card_requested[card] = 1;
147 snd_request_card(card);
149 snd_seq_device_load_drivers();
152 spin_lock_irqsave(&clients_lock, flags);
153 client = clientptr(clientid);
156 spin_unlock_irqrestore(&clients_lock, flags);
162 snd_use_lock_use(&client->use_lock);
163 spin_unlock_irqrestore(&clients_lock, flags);
167 /* Take refcount and perform ioctl_mutex lock on the given client;
168 * used only for OSS sequencer
169 * Unlock via snd_seq_client_ioctl_unlock() below
171 bool snd_seq_client_ioctl_lock(int clientid)
173 struct snd_seq_client *client;
175 client = snd_seq_client_use_ptr(clientid);
178 mutex_lock(&client->ioctl_mutex);
179 /* The client isn't unrefed here; see snd_seq_client_ioctl_unlock() */
182 EXPORT_SYMBOL_GPL(snd_seq_client_ioctl_lock);
184 /* Unlock and unref the given client; for OSS sequencer use only */
185 void snd_seq_client_ioctl_unlock(int clientid)
187 struct snd_seq_client *client;
189 client = snd_seq_client_use_ptr(clientid);
190 if (WARN_ON(!client))
192 mutex_unlock(&client->ioctl_mutex);
193 /* The doubly unrefs below are intentional; the first one releases the
194 * leftover from snd_seq_client_ioctl_lock() above, and the second one
195 * is for releasing snd_seq_client_use_ptr() in this function
197 snd_seq_client_unlock(client);
198 snd_seq_client_unlock(client);
200 EXPORT_SYMBOL_GPL(snd_seq_client_ioctl_unlock);
202 static void usage_alloc(struct snd_seq_usage *res, int num)
205 if (res->cur > res->peak)
206 res->peak = res->cur;
209 static void usage_free(struct snd_seq_usage *res, int num)
214 /* initialise data structures */
215 int __init client_init_data(void)
217 /* zap out the client table */
218 memset(&clienttablock, 0, sizeof(clienttablock));
219 memset(&clienttab, 0, sizeof(clienttab));
224 static struct snd_seq_client *seq_create_client1(int client_index, int poolsize)
227 struct snd_seq_client *client;
229 /* init client data */
230 client = kzalloc(sizeof(*client), GFP_KERNEL);
233 client->pool = snd_seq_pool_new(poolsize);
234 if (client->pool == NULL) {
238 client->type = NO_CLIENT;
239 snd_use_lock_init(&client->use_lock);
240 rwlock_init(&client->ports_lock);
241 mutex_init(&client->ports_mutex);
242 INIT_LIST_HEAD(&client->ports_list_head);
243 mutex_init(&client->ioctl_mutex);
245 /* find free slot in the client table */
246 spin_lock_irq(&clients_lock);
247 if (client_index < 0) {
248 for (c = SNDRV_SEQ_DYNAMIC_CLIENTS_BEGIN;
249 c < SNDRV_SEQ_MAX_CLIENTS;
251 if (clienttab[c] || clienttablock[c])
253 clienttab[client->number = c] = client;
254 spin_unlock_irq(&clients_lock);
258 if (clienttab[client_index] == NULL && !clienttablock[client_index]) {
259 clienttab[client->number = client_index] = client;
260 spin_unlock_irq(&clients_lock);
264 spin_unlock_irq(&clients_lock);
265 snd_seq_pool_delete(&client->pool);
267 return NULL; /* no free slot found or busy, return failure code */
271 static int seq_free_client1(struct snd_seq_client *client)
275 spin_lock_irq(&clients_lock);
276 clienttablock[client->number] = 1;
277 clienttab[client->number] = NULL;
278 spin_unlock_irq(&clients_lock);
279 snd_seq_delete_all_ports(client);
280 snd_seq_queue_client_leave(client->number);
281 snd_use_lock_sync(&client->use_lock);
283 snd_seq_pool_delete(&client->pool);
284 spin_lock_irq(&clients_lock);
285 clienttablock[client->number] = 0;
286 spin_unlock_irq(&clients_lock);
291 static void seq_free_client(struct snd_seq_client * client)
293 mutex_lock(®ister_mutex);
294 switch (client->type) {
296 pr_warn("ALSA: seq: Trying to free unused client %d\n",
301 seq_free_client1(client);
302 usage_free(&client_usage, 1);
306 pr_err("ALSA: seq: Trying to free client %d with undefined type = %d\n",
307 client->number, client->type);
309 mutex_unlock(®ister_mutex);
311 snd_seq_system_client_ev_client_exit(client->number);
316 /* -------------------------------------------------------- */
318 /* create a user client */
319 static int snd_seq_open(struct inode *inode, struct file *file)
321 int c, mode; /* client id */
322 struct snd_seq_client *client;
323 struct snd_seq_user_client *user;
326 err = stream_open(inode, file);
330 mutex_lock(®ister_mutex);
331 client = seq_create_client1(-1, SNDRV_SEQ_DEFAULT_EVENTS);
333 mutex_unlock(®ister_mutex);
334 return -ENOMEM; /* failure code */
337 mode = snd_seq_file_flags(file);
338 if (mode & SNDRV_SEQ_LFLG_INPUT)
339 client->accept_input = 1;
340 if (mode & SNDRV_SEQ_LFLG_OUTPUT)
341 client->accept_output = 1;
343 user = &client->data.user;
345 user->fifo_pool_size = 0;
347 if (mode & SNDRV_SEQ_LFLG_INPUT) {
348 user->fifo_pool_size = SNDRV_SEQ_DEFAULT_CLIENT_EVENTS;
349 user->fifo = snd_seq_fifo_new(user->fifo_pool_size);
350 if (user->fifo == NULL) {
351 seq_free_client1(client);
353 mutex_unlock(®ister_mutex);
358 usage_alloc(&client_usage, 1);
359 client->type = USER_CLIENT;
360 mutex_unlock(®ister_mutex);
363 file->private_data = client;
365 /* fill client data */
367 sprintf(client->name, "Client-%d", c);
368 client->data.user.owner = get_pid(task_pid(current));
370 /* make others aware this new client */
371 snd_seq_system_client_ev_client_start(c);
376 /* delete a user client */
377 static int snd_seq_release(struct inode *inode, struct file *file)
379 struct snd_seq_client *client = file->private_data;
382 seq_free_client(client);
383 if (client->data.user.fifo)
384 snd_seq_fifo_delete(&client->data.user.fifo);
385 put_pid(client->data.user.owner);
393 /* handle client read() */
394 /* possible error values:
395 * -ENXIO invalid client or file open mode
396 * -ENOSPC FIFO overflow (the flag is cleared after this error report)
397 * -EINVAL no enough user-space buffer to write the whole event
398 * -EFAULT seg. fault during copy to user space
400 static ssize_t snd_seq_read(struct file *file, char __user *buf, size_t count,
403 struct snd_seq_client *client = file->private_data;
404 struct snd_seq_fifo *fifo;
407 struct snd_seq_event_cell *cell;
409 if (!(snd_seq_file_flags(file) & SNDRV_SEQ_LFLG_INPUT))
412 if (!access_ok(buf, count))
415 /* check client structures are in place */
416 if (snd_BUG_ON(!client))
419 if (!client->accept_input)
421 fifo = client->data.user.fifo;
425 if (atomic_read(&fifo->overflow) > 0) {
426 /* buffer overflow is detected */
427 snd_seq_fifo_clear(fifo);
428 /* return error code */
434 snd_seq_fifo_lock(fifo);
436 /* while data available in queue */
437 while (count >= sizeof(struct snd_seq_event)) {
440 nonblock = (file->f_flags & O_NONBLOCK) || result > 0;
441 err = snd_seq_fifo_cell_out(fifo, &cell, nonblock);
444 if (snd_seq_ev_is_variable(&cell->event)) {
445 struct snd_seq_event tmpev;
447 tmpev.data.ext.len &= ~SNDRV_SEQ_EXT_MASK;
448 if (copy_to_user(buf, &tmpev, sizeof(struct snd_seq_event))) {
452 count -= sizeof(struct snd_seq_event);
453 buf += sizeof(struct snd_seq_event);
454 err = snd_seq_expand_var_event(&cell->event, count,
455 (char __force *)buf, 0,
456 sizeof(struct snd_seq_event));
463 if (copy_to_user(buf, &cell->event, sizeof(struct snd_seq_event))) {
467 count -= sizeof(struct snd_seq_event);
468 buf += sizeof(struct snd_seq_event);
470 snd_seq_cell_free(cell);
471 cell = NULL; /* to be sure */
472 result += sizeof(struct snd_seq_event);
477 snd_seq_fifo_cell_putback(fifo, cell);
478 if (err == -EAGAIN && result > 0)
481 snd_seq_fifo_unlock(fifo);
483 return (err < 0) ? err : result;
488 * check access permission to the port
490 static int check_port_perm(struct snd_seq_client_port *port, unsigned int flags)
492 if ((port->capability & flags) != flags)
498 * check if the destination client is available, and return the pointer
499 * if filter is non-zero, client filter bitmap is tested.
501 static struct snd_seq_client *get_event_dest_client(struct snd_seq_event *event,
504 struct snd_seq_client *dest;
506 dest = snd_seq_client_use_ptr(event->dest.client);
509 if (! dest->accept_input)
511 if ((dest->filter & SNDRV_SEQ_FILTER_USE_EVENT) &&
512 ! test_bit(event->type, dest->event_filter))
514 if (filter && !(dest->filter & filter))
517 return dest; /* ok - accessible */
519 snd_seq_client_unlock(dest);
525 * Return the error event.
527 * If the receiver client is a user client, the original event is
528 * encapsulated in SNDRV_SEQ_EVENT_BOUNCE as variable length event. If
529 * the original event is also variable length, the external data is
530 * copied after the event record.
531 * If the receiver client is a kernel client, the original event is
532 * quoted in SNDRV_SEQ_EVENT_KERNEL_ERROR, since this requires no extra
535 static int bounce_error_event(struct snd_seq_client *client,
536 struct snd_seq_event *event,
537 int err, int atomic, int hop)
539 struct snd_seq_event bounce_ev;
542 if (client == NULL ||
543 ! (client->filter & SNDRV_SEQ_FILTER_BOUNCE) ||
544 ! client->accept_input)
545 return 0; /* ignored */
547 /* set up quoted error */
548 memset(&bounce_ev, 0, sizeof(bounce_ev));
549 bounce_ev.type = SNDRV_SEQ_EVENT_KERNEL_ERROR;
550 bounce_ev.flags = SNDRV_SEQ_EVENT_LENGTH_FIXED;
551 bounce_ev.queue = SNDRV_SEQ_QUEUE_DIRECT;
552 bounce_ev.source.client = SNDRV_SEQ_CLIENT_SYSTEM;
553 bounce_ev.source.port = SNDRV_SEQ_PORT_SYSTEM_ANNOUNCE;
554 bounce_ev.dest.client = client->number;
555 bounce_ev.dest.port = event->source.port;
556 bounce_ev.data.quote.origin = event->dest;
557 bounce_ev.data.quote.event = event;
558 bounce_ev.data.quote.value = -err; /* use positive value */
559 result = snd_seq_deliver_single_event(NULL, &bounce_ev, 0, atomic, hop + 1);
561 client->event_lost++;
570 * rewrite the time-stamp of the event record with the curren time
571 * of the given queue.
572 * return non-zero if updated.
574 static int update_timestamp_of_queue(struct snd_seq_event *event,
575 int queue, int real_time)
577 struct snd_seq_queue *q;
582 event->queue = queue;
583 event->flags &= ~SNDRV_SEQ_TIME_STAMP_MASK;
585 event->time.time = snd_seq_timer_get_cur_time(q->timer, true);
586 event->flags |= SNDRV_SEQ_TIME_STAMP_REAL;
588 event->time.tick = snd_seq_timer_get_cur_tick(q->timer);
589 event->flags |= SNDRV_SEQ_TIME_STAMP_TICK;
597 * deliver an event to the specified destination.
598 * if filter is non-zero, client filter bitmap is tested.
600 * RETURN VALUE: 0 : if succeeded
603 static int snd_seq_deliver_single_event(struct snd_seq_client *client,
604 struct snd_seq_event *event,
605 int filter, int atomic, int hop)
607 struct snd_seq_client *dest = NULL;
608 struct snd_seq_client_port *dest_port = NULL;
609 int result = -ENOENT;
612 direct = snd_seq_ev_is_direct(event);
614 dest = get_event_dest_client(event, filter);
617 dest_port = snd_seq_port_use_ptr(dest, event->dest.port);
618 if (dest_port == NULL)
621 /* check permission */
622 if (! check_port_perm(dest_port, SNDRV_SEQ_PORT_CAP_WRITE)) {
627 if (dest_port->timestamping)
628 update_timestamp_of_queue(event, dest_port->time_queue,
629 dest_port->time_real);
631 switch (dest->type) {
633 if (dest->data.user.fifo)
634 result = snd_seq_fifo_event_in(dest->data.user.fifo, event);
638 if (dest_port->event_input == NULL)
640 result = dest_port->event_input(event, direct,
641 dest_port->private_data,
650 snd_seq_port_unlock(dest_port);
652 snd_seq_client_unlock(dest);
654 if (result < 0 && !direct) {
655 result = bounce_error_event(client, event, result, atomic, hop);
662 * send the event to all subscribers:
664 static int deliver_to_subscribers(struct snd_seq_client *client,
665 struct snd_seq_event *event,
668 struct snd_seq_subscribers *subs;
669 int err, result = 0, num_ev = 0;
670 struct snd_seq_event event_saved;
671 struct snd_seq_client_port *src_port;
672 struct snd_seq_port_subs_info *grp;
674 src_port = snd_seq_port_use_ptr(client, event->source.port);
675 if (src_port == NULL)
676 return -EINVAL; /* invalid source port */
677 /* save original event record */
678 event_saved = *event;
679 grp = &src_port->c_src;
683 read_lock(&grp->list_lock);
685 down_read_nested(&grp->list_mutex, hop);
686 list_for_each_entry(subs, &grp->list_head, src_list) {
687 /* both ports ready? */
688 if (atomic_read(&subs->ref_count) != 2)
690 event->dest = subs->info.dest;
691 if (subs->info.flags & SNDRV_SEQ_PORT_SUBS_TIMESTAMP)
692 /* convert time according to flag with subscription */
693 update_timestamp_of_queue(event, subs->info.queue,
694 subs->info.flags & SNDRV_SEQ_PORT_SUBS_TIME_REAL);
695 err = snd_seq_deliver_single_event(client, event,
698 /* save first error that occurs and continue */
704 /* restore original event record */
705 *event = event_saved;
708 read_unlock(&grp->list_lock);
710 up_read(&grp->list_mutex);
711 *event = event_saved; /* restore */
712 snd_seq_port_unlock(src_port);
713 return (result < 0) ? result : num_ev;
717 #ifdef SUPPORT_BROADCAST
719 * broadcast to all ports:
721 static int port_broadcast_event(struct snd_seq_client *client,
722 struct snd_seq_event *event,
725 int num_ev = 0, err, result = 0;
726 struct snd_seq_client *dest_client;
727 struct snd_seq_client_port *port;
729 dest_client = get_event_dest_client(event, SNDRV_SEQ_FILTER_BROADCAST);
730 if (dest_client == NULL)
731 return 0; /* no matching destination */
733 read_lock(&dest_client->ports_lock);
734 list_for_each_entry(port, &dest_client->ports_list_head, list) {
735 event->dest.port = port->addr.port;
736 /* pass NULL as source client to avoid error bounce */
737 err = snd_seq_deliver_single_event(NULL, event,
738 SNDRV_SEQ_FILTER_BROADCAST,
741 /* save first error that occurs and continue */
748 read_unlock(&dest_client->ports_lock);
749 snd_seq_client_unlock(dest_client);
750 event->dest.port = SNDRV_SEQ_ADDRESS_BROADCAST; /* restore */
751 return (result < 0) ? result : num_ev;
755 * send the event to all clients:
756 * if destination port is also ADDRESS_BROADCAST, deliver to all ports.
758 static int broadcast_event(struct snd_seq_client *client,
759 struct snd_seq_event *event, int atomic, int hop)
761 int err, result = 0, num_ev = 0;
763 struct snd_seq_addr addr;
765 addr = event->dest; /* save */
767 for (dest = 0; dest < SNDRV_SEQ_MAX_CLIENTS; dest++) {
768 /* don't send to itself */
769 if (dest == client->number)
771 event->dest.client = dest;
772 event->dest.port = addr.port;
773 if (addr.port == SNDRV_SEQ_ADDRESS_BROADCAST)
774 err = port_broadcast_event(client, event, atomic, hop);
776 /* pass NULL as source client to avoid error bounce */
777 err = snd_seq_deliver_single_event(NULL, event,
778 SNDRV_SEQ_FILTER_BROADCAST,
781 /* save first error that occurs and continue */
788 event->dest = addr; /* restore */
789 return (result < 0) ? result : num_ev;
793 /* multicast - not supported yet */
794 static int multicast_event(struct snd_seq_client *client, struct snd_seq_event *event,
797 pr_debug("ALSA: seq: multicast not supported yet.\n");
798 return 0; /* ignored */
800 #endif /* SUPPORT_BROADCAST */
803 /* deliver an event to the destination port(s).
804 * if the event is to subscribers or broadcast, the event is dispatched
805 * to multiple targets.
807 * RETURN VALUE: n > 0 : the number of delivered events.
808 * n == 0 : the event was not passed to any client.
809 * n < 0 : error - event was not processed.
811 static int snd_seq_deliver_event(struct snd_seq_client *client, struct snd_seq_event *event,
817 if (hop >= SNDRV_SEQ_MAX_HOPS) {
818 pr_debug("ALSA: seq: too long delivery path (%d:%d->%d:%d)\n",
819 event->source.client, event->source.port,
820 event->dest.client, event->dest.port);
824 if (snd_seq_ev_is_variable(event) &&
825 snd_BUG_ON(atomic && (event->data.ext.len & SNDRV_SEQ_EXT_USRPTR)))
828 if (event->queue == SNDRV_SEQ_ADDRESS_SUBSCRIBERS ||
829 event->dest.client == SNDRV_SEQ_ADDRESS_SUBSCRIBERS)
830 result = deliver_to_subscribers(client, event, atomic, hop);
831 #ifdef SUPPORT_BROADCAST
832 else if (event->queue == SNDRV_SEQ_ADDRESS_BROADCAST ||
833 event->dest.client == SNDRV_SEQ_ADDRESS_BROADCAST)
834 result = broadcast_event(client, event, atomic, hop);
835 else if (event->dest.client >= SNDRV_SEQ_MAX_CLIENTS)
836 result = multicast_event(client, event, atomic, hop);
837 else if (event->dest.port == SNDRV_SEQ_ADDRESS_BROADCAST)
838 result = port_broadcast_event(client, event, atomic, hop);
841 result = snd_seq_deliver_single_event(client, event, 0, atomic, hop);
847 * dispatch an event cell:
848 * This function is called only from queue check routines in timer
849 * interrupts or after enqueued.
850 * The event cell shall be released or re-queued in this function.
852 * RETURN VALUE: n > 0 : the number of delivered events.
853 * n == 0 : the event was not passed to any client.
854 * n < 0 : error - event was not processed.
856 int snd_seq_dispatch_event(struct snd_seq_event_cell *cell, int atomic, int hop)
858 struct snd_seq_client *client;
861 if (snd_BUG_ON(!cell))
864 client = snd_seq_client_use_ptr(cell->event.source.client);
865 if (client == NULL) {
866 snd_seq_cell_free(cell); /* release this cell */
870 if (cell->event.type == SNDRV_SEQ_EVENT_NOTE) {
872 * the event cell is re-used as a NOTE-OFF event and
875 struct snd_seq_event tmpev, *ev;
877 /* reserve this event to enqueue note-off later */
879 tmpev.type = SNDRV_SEQ_EVENT_NOTEON;
880 result = snd_seq_deliver_event(client, &tmpev, atomic, hop);
883 * This was originally a note event. We now re-use the
884 * cell for the note-off event.
888 ev->type = SNDRV_SEQ_EVENT_NOTEOFF;
889 ev->flags |= SNDRV_SEQ_PRIORITY_HIGH;
891 /* add the duration time */
892 switch (ev->flags & SNDRV_SEQ_TIME_STAMP_MASK) {
893 case SNDRV_SEQ_TIME_STAMP_TICK:
894 ev->time.tick += ev->data.note.duration;
896 case SNDRV_SEQ_TIME_STAMP_REAL:
897 /* unit for duration is ms */
898 ev->time.time.tv_nsec += 1000000 * (ev->data.note.duration % 1000);
899 ev->time.time.tv_sec += ev->data.note.duration / 1000 +
900 ev->time.time.tv_nsec / 1000000000;
901 ev->time.time.tv_nsec %= 1000000000;
904 ev->data.note.velocity = ev->data.note.off_velocity;
906 /* Now queue this cell as the note off event */
907 if (snd_seq_enqueue_event(cell, atomic, hop) < 0)
908 snd_seq_cell_free(cell); /* release this cell */
912 * event cell is freed after processing the event
915 result = snd_seq_deliver_event(client, &cell->event, atomic, hop);
916 snd_seq_cell_free(cell);
919 snd_seq_client_unlock(client);
924 /* Allocate a cell from client pool and enqueue it to queue:
925 * if pool is empty and blocking is TRUE, sleep until a new cell is
928 static int snd_seq_client_enqueue_event(struct snd_seq_client *client,
929 struct snd_seq_event *event,
930 struct file *file, int blocking,
932 struct mutex *mutexp)
934 struct snd_seq_event_cell *cell;
937 /* special queue values - force direct passing */
938 if (event->queue == SNDRV_SEQ_ADDRESS_SUBSCRIBERS) {
939 event->dest.client = SNDRV_SEQ_ADDRESS_SUBSCRIBERS;
940 event->queue = SNDRV_SEQ_QUEUE_DIRECT;
942 #ifdef SUPPORT_BROADCAST
943 if (event->queue == SNDRV_SEQ_ADDRESS_BROADCAST) {
944 event->dest.client = SNDRV_SEQ_ADDRESS_BROADCAST;
945 event->queue = SNDRV_SEQ_QUEUE_DIRECT;
948 if (event->dest.client == SNDRV_SEQ_ADDRESS_SUBSCRIBERS) {
949 /* check presence of source port */
950 struct snd_seq_client_port *src_port = snd_seq_port_use_ptr(client, event->source.port);
951 if (src_port == NULL)
953 snd_seq_port_unlock(src_port);
956 /* direct event processing without enqueued */
957 if (snd_seq_ev_is_direct(event)) {
958 if (event->type == SNDRV_SEQ_EVENT_NOTE)
959 return -EINVAL; /* this event must be enqueued! */
960 return snd_seq_deliver_event(client, event, atomic, hop);
963 /* Not direct, normal queuing */
964 if (snd_seq_queue_is_used(event->queue, client->number) <= 0)
965 return -EINVAL; /* invalid queue */
966 if (! snd_seq_write_pool_allocated(client))
967 return -ENXIO; /* queue is not allocated */
969 /* allocate an event cell */
970 err = snd_seq_event_dup(client->pool, event, &cell, !blocking || atomic,
975 /* we got a cell. enqueue it. */
976 err = snd_seq_enqueue_event(cell, atomic, hop);
978 snd_seq_cell_free(cell);
987 * check validity of event type and data length.
988 * return non-zero if invalid.
990 static int check_event_type_and_length(struct snd_seq_event *ev)
992 switch (snd_seq_ev_length_type(ev)) {
993 case SNDRV_SEQ_EVENT_LENGTH_FIXED:
994 if (snd_seq_ev_is_variable_type(ev))
997 case SNDRV_SEQ_EVENT_LENGTH_VARIABLE:
998 if (! snd_seq_ev_is_variable_type(ev) ||
999 (ev->data.ext.len & ~SNDRV_SEQ_EXT_MASK) >= SNDRV_SEQ_MAX_EVENT_LEN)
1002 case SNDRV_SEQ_EVENT_LENGTH_VARUSR:
1003 if (! snd_seq_ev_is_direct(ev))
1011 /* handle write() */
1012 /* possible error values:
1013 * -ENXIO invalid client or file open mode
1014 * -ENOMEM malloc failed
1015 * -EFAULT seg. fault during copy from user space
1016 * -EINVAL invalid event
1017 * -EAGAIN no space in output pool
1018 * -EINTR interrupts while sleep
1019 * -EMLINK too many hops
1020 * others depends on return value from driver callback
1022 static ssize_t snd_seq_write(struct file *file, const char __user *buf,
1023 size_t count, loff_t *offset)
1025 struct snd_seq_client *client = file->private_data;
1026 int written = 0, len;
1028 struct snd_seq_event event;
1030 if (!(snd_seq_file_flags(file) & SNDRV_SEQ_LFLG_OUTPUT))
1033 /* check client structures are in place */
1034 if (snd_BUG_ON(!client))
1037 if (!client->accept_output || client->pool == NULL)
1042 /* allocate the pool now if the pool is not allocated yet */
1043 mutex_lock(&client->ioctl_mutex);
1044 if (client->pool->size > 0 && !snd_seq_write_pool_allocated(client)) {
1045 err = snd_seq_pool_init(client->pool);
1050 /* only process whole events */
1052 while (count >= sizeof(struct snd_seq_event)) {
1053 /* Read in the event header from the user */
1054 len = sizeof(event);
1055 if (copy_from_user(&event, buf, len)) {
1059 event.source.client = client->number; /* fill in client number */
1060 /* Check for extension data length */
1061 if (check_event_type_and_length(&event)) {
1066 /* check for special events */
1067 if (event.type == SNDRV_SEQ_EVENT_NONE)
1069 else if (snd_seq_ev_is_reserved(&event)) {
1074 if (snd_seq_ev_is_variable(&event)) {
1075 int extlen = event.data.ext.len & ~SNDRV_SEQ_EXT_MASK;
1076 if ((size_t)(extlen + len) > count) {
1077 /* back out, will get an error this time or next */
1081 /* set user space pointer */
1082 event.data.ext.len = extlen | SNDRV_SEQ_EXT_USRPTR;
1083 event.data.ext.ptr = (char __force *)buf
1084 + sizeof(struct snd_seq_event);
1085 len += extlen; /* increment data length */
1087 #ifdef CONFIG_COMPAT
1088 if (client->convert32 && snd_seq_ev_is_varusr(&event)) {
1089 void *ptr = (void __force *)compat_ptr(event.data.raw32.d[1]);
1090 event.data.ext.ptr = ptr;
1095 /* ok, enqueue it */
1096 err = snd_seq_client_enqueue_event(client, &event, file,
1097 !(file->f_flags & O_NONBLOCK),
1098 0, 0, &client->ioctl_mutex);
1104 /* Update pointers and counts */
1109 /* let's have a coffee break if too many events are queued */
1110 if (++handled >= 200) {
1111 mutex_unlock(&client->ioctl_mutex);
1117 mutex_unlock(&client->ioctl_mutex);
1118 return written ? written : err;
1125 static __poll_t snd_seq_poll(struct file *file, poll_table * wait)
1127 struct snd_seq_client *client = file->private_data;
1130 /* check client structures are in place */
1131 if (snd_BUG_ON(!client))
1134 if ((snd_seq_file_flags(file) & SNDRV_SEQ_LFLG_INPUT) &&
1135 client->data.user.fifo) {
1137 /* check if data is available in the outqueue */
1138 if (snd_seq_fifo_poll_wait(client->data.user.fifo, file, wait))
1139 mask |= EPOLLIN | EPOLLRDNORM;
1142 if (snd_seq_file_flags(file) & SNDRV_SEQ_LFLG_OUTPUT) {
1144 /* check if data is available in the pool */
1145 if (!snd_seq_write_pool_allocated(client) ||
1146 snd_seq_pool_poll_wait(client->pool, file, wait))
1147 mask |= EPOLLOUT | EPOLLWRNORM;
1154 /*-----------------------------------------------------*/
1156 static int snd_seq_ioctl_pversion(struct snd_seq_client *client, void *arg)
1158 int *pversion = arg;
1160 *pversion = SNDRV_SEQ_VERSION;
1164 static int snd_seq_ioctl_client_id(struct snd_seq_client *client, void *arg)
1166 int *client_id = arg;
1168 *client_id = client->number;
1172 /* SYSTEM_INFO ioctl() */
1173 static int snd_seq_ioctl_system_info(struct snd_seq_client *client, void *arg)
1175 struct snd_seq_system_info *info = arg;
1177 memset(info, 0, sizeof(*info));
1178 /* fill the info fields */
1179 info->queues = SNDRV_SEQ_MAX_QUEUES;
1180 info->clients = SNDRV_SEQ_MAX_CLIENTS;
1181 info->ports = SNDRV_SEQ_MAX_PORTS;
1182 info->channels = 256; /* fixed limit */
1183 info->cur_clients = client_usage.cur;
1184 info->cur_queues = snd_seq_queue_get_cur_queues();
1190 /* RUNNING_MODE ioctl() */
1191 static int snd_seq_ioctl_running_mode(struct snd_seq_client *client, void *arg)
1193 struct snd_seq_running_info *info = arg;
1194 struct snd_seq_client *cptr;
1197 /* requested client number */
1198 cptr = snd_seq_client_use_ptr(info->client);
1200 return -ENOENT; /* don't change !!! */
1202 #ifdef SNDRV_BIG_ENDIAN
1203 if (!info->big_endian) {
1208 if (info->big_endian) {
1214 if (info->cpu_mode > sizeof(long)) {
1218 cptr->convert32 = (info->cpu_mode < sizeof(long));
1220 snd_seq_client_unlock(cptr);
1224 /* CLIENT_INFO ioctl() */
1225 static void get_client_info(struct snd_seq_client *cptr,
1226 struct snd_seq_client_info *info)
1228 info->client = cptr->number;
1230 /* fill the info fields */
1231 info->type = cptr->type;
1232 strcpy(info->name, cptr->name);
1233 info->filter = cptr->filter;
1234 info->event_lost = cptr->event_lost;
1235 memcpy(info->event_filter, cptr->event_filter, 32);
1236 info->num_ports = cptr->num_ports;
1238 if (cptr->type == USER_CLIENT)
1239 info->pid = pid_vnr(cptr->data.user.owner);
1243 if (cptr->type == KERNEL_CLIENT)
1244 info->card = cptr->data.kernel.card ? cptr->data.kernel.card->number : -1;
1248 memset(info->reserved, 0, sizeof(info->reserved));
1251 static int snd_seq_ioctl_get_client_info(struct snd_seq_client *client,
1254 struct snd_seq_client_info *client_info = arg;
1255 struct snd_seq_client *cptr;
1257 /* requested client number */
1258 cptr = snd_seq_client_use_ptr(client_info->client);
1260 return -ENOENT; /* don't change !!! */
1262 get_client_info(cptr, client_info);
1263 snd_seq_client_unlock(cptr);
1269 /* CLIENT_INFO ioctl() */
1270 static int snd_seq_ioctl_set_client_info(struct snd_seq_client *client,
1273 struct snd_seq_client_info *client_info = arg;
1275 /* it is not allowed to set the info fields for an another client */
1276 if (client->number != client_info->client)
1278 /* also client type must be set now */
1279 if (client->type != client_info->type)
1282 /* fill the info fields */
1283 if (client_info->name[0])
1284 strscpy(client->name, client_info->name, sizeof(client->name));
1286 client->filter = client_info->filter;
1287 client->event_lost = client_info->event_lost;
1288 memcpy(client->event_filter, client_info->event_filter, 32);
1295 * CREATE PORT ioctl()
1297 static int snd_seq_ioctl_create_port(struct snd_seq_client *client, void *arg)
1299 struct snd_seq_port_info *info = arg;
1300 struct snd_seq_client_port *port;
1301 struct snd_seq_port_callback *callback;
1304 /* it is not allowed to create the port for an another client */
1305 if (info->addr.client != client->number)
1308 port = snd_seq_create_port(client, (info->flags & SNDRV_SEQ_PORT_FLG_GIVEN_PORT) ? info->addr.port : -1);
1312 if (client->type == USER_CLIENT && info->kernel) {
1313 port_idx = port->addr.port;
1314 snd_seq_port_unlock(port);
1315 snd_seq_delete_port(client, port_idx);
1318 if (client->type == KERNEL_CLIENT) {
1319 callback = info->kernel;
1321 if (callback->owner)
1322 port->owner = callback->owner;
1323 port->private_data = callback->private_data;
1324 port->private_free = callback->private_free;
1325 port->event_input = callback->event_input;
1326 port->c_src.open = callback->subscribe;
1327 port->c_src.close = callback->unsubscribe;
1328 port->c_dest.open = callback->use;
1329 port->c_dest.close = callback->unuse;
1333 info->addr = port->addr;
1335 snd_seq_set_port_info(port, info);
1336 snd_seq_system_client_ev_port_start(port->addr.client, port->addr.port);
1337 snd_seq_port_unlock(port);
1343 * DELETE PORT ioctl()
1345 static int snd_seq_ioctl_delete_port(struct snd_seq_client *client, void *arg)
1347 struct snd_seq_port_info *info = arg;
1350 /* it is not allowed to remove the port for an another client */
1351 if (info->addr.client != client->number)
1354 err = snd_seq_delete_port(client, info->addr.port);
1356 snd_seq_system_client_ev_port_exit(client->number, info->addr.port);
1362 * GET_PORT_INFO ioctl() (on any client)
1364 static int snd_seq_ioctl_get_port_info(struct snd_seq_client *client, void *arg)
1366 struct snd_seq_port_info *info = arg;
1367 struct snd_seq_client *cptr;
1368 struct snd_seq_client_port *port;
1370 cptr = snd_seq_client_use_ptr(info->addr.client);
1374 port = snd_seq_port_use_ptr(cptr, info->addr.port);
1376 snd_seq_client_unlock(cptr);
1377 return -ENOENT; /* don't change */
1381 snd_seq_get_port_info(port, info);
1382 snd_seq_port_unlock(port);
1383 snd_seq_client_unlock(cptr);
1390 * SET_PORT_INFO ioctl() (only ports on this/own client)
1392 static int snd_seq_ioctl_set_port_info(struct snd_seq_client *client, void *arg)
1394 struct snd_seq_port_info *info = arg;
1395 struct snd_seq_client_port *port;
1397 if (info->addr.client != client->number) /* only set our own ports ! */
1399 port = snd_seq_port_use_ptr(client, info->addr.port);
1401 snd_seq_set_port_info(port, info);
1402 snd_seq_port_unlock(port);
1409 * port subscription (connection)
1411 #define PERM_RD (SNDRV_SEQ_PORT_CAP_READ|SNDRV_SEQ_PORT_CAP_SUBS_READ)
1412 #define PERM_WR (SNDRV_SEQ_PORT_CAP_WRITE|SNDRV_SEQ_PORT_CAP_SUBS_WRITE)
1414 static int check_subscription_permission(struct snd_seq_client *client,
1415 struct snd_seq_client_port *sport,
1416 struct snd_seq_client_port *dport,
1417 struct snd_seq_port_subscribe *subs)
1419 if (client->number != subs->sender.client &&
1420 client->number != subs->dest.client) {
1421 /* connection by third client - check export permission */
1422 if (check_port_perm(sport, SNDRV_SEQ_PORT_CAP_NO_EXPORT))
1424 if (check_port_perm(dport, SNDRV_SEQ_PORT_CAP_NO_EXPORT))
1428 /* check read permission */
1429 /* if sender or receiver is the subscribing client itself,
1430 * no permission check is necessary
1432 if (client->number != subs->sender.client) {
1433 if (! check_port_perm(sport, PERM_RD))
1436 /* check write permission */
1437 if (client->number != subs->dest.client) {
1438 if (! check_port_perm(dport, PERM_WR))
1445 * send an subscription notify event to user client:
1446 * client must be user client.
1448 int snd_seq_client_notify_subscription(int client, int port,
1449 struct snd_seq_port_subscribe *info,
1452 struct snd_seq_event event;
1454 memset(&event, 0, sizeof(event));
1455 event.type = evtype;
1456 event.data.connect.dest = info->dest;
1457 event.data.connect.sender = info->sender;
1459 return snd_seq_system_notify(client, port, &event); /* non-atomic */
1464 * add to port's subscription list IOCTL interface
1466 static int snd_seq_ioctl_subscribe_port(struct snd_seq_client *client,
1469 struct snd_seq_port_subscribe *subs = arg;
1470 int result = -EINVAL;
1471 struct snd_seq_client *receiver = NULL, *sender = NULL;
1472 struct snd_seq_client_port *sport = NULL, *dport = NULL;
1474 receiver = snd_seq_client_use_ptr(subs->dest.client);
1477 sender = snd_seq_client_use_ptr(subs->sender.client);
1480 sport = snd_seq_port_use_ptr(sender, subs->sender.port);
1483 dport = snd_seq_port_use_ptr(receiver, subs->dest.port);
1487 result = check_subscription_permission(client, sport, dport, subs);
1492 result = snd_seq_port_connect(client, sender, sport, receiver, dport, subs);
1493 if (! result) /* broadcast announce */
1494 snd_seq_client_notify_subscription(SNDRV_SEQ_ADDRESS_SUBSCRIBERS, 0,
1495 subs, SNDRV_SEQ_EVENT_PORT_SUBSCRIBED);
1498 snd_seq_port_unlock(sport);
1500 snd_seq_port_unlock(dport);
1502 snd_seq_client_unlock(sender);
1504 snd_seq_client_unlock(receiver);
1510 * remove from port's subscription list
1512 static int snd_seq_ioctl_unsubscribe_port(struct snd_seq_client *client,
1515 struct snd_seq_port_subscribe *subs = arg;
1516 int result = -ENXIO;
1517 struct snd_seq_client *receiver = NULL, *sender = NULL;
1518 struct snd_seq_client_port *sport = NULL, *dport = NULL;
1520 receiver = snd_seq_client_use_ptr(subs->dest.client);
1523 sender = snd_seq_client_use_ptr(subs->sender.client);
1526 sport = snd_seq_port_use_ptr(sender, subs->sender.port);
1529 dport = snd_seq_port_use_ptr(receiver, subs->dest.port);
1533 result = check_subscription_permission(client, sport, dport, subs);
1537 result = snd_seq_port_disconnect(client, sender, sport, receiver, dport, subs);
1538 if (! result) /* broadcast announce */
1539 snd_seq_client_notify_subscription(SNDRV_SEQ_ADDRESS_SUBSCRIBERS, 0,
1540 subs, SNDRV_SEQ_EVENT_PORT_UNSUBSCRIBED);
1543 snd_seq_port_unlock(sport);
1545 snd_seq_port_unlock(dport);
1547 snd_seq_client_unlock(sender);
1549 snd_seq_client_unlock(receiver);
1554 /* CREATE_QUEUE ioctl() */
1555 static int snd_seq_ioctl_create_queue(struct snd_seq_client *client, void *arg)
1557 struct snd_seq_queue_info *info = arg;
1558 struct snd_seq_queue *q;
1560 q = snd_seq_queue_alloc(client->number, info->locked, info->flags);
1564 info->queue = q->queue;
1565 info->locked = q->locked;
1566 info->owner = q->owner;
1568 /* set queue name */
1570 snprintf(info->name, sizeof(info->name), "Queue-%d", q->queue);
1571 strscpy(q->name, info->name, sizeof(q->name));
1572 snd_use_lock_free(&q->use_lock);
1577 /* DELETE_QUEUE ioctl() */
1578 static int snd_seq_ioctl_delete_queue(struct snd_seq_client *client, void *arg)
1580 struct snd_seq_queue_info *info = arg;
1582 return snd_seq_queue_delete(client->number, info->queue);
1585 /* GET_QUEUE_INFO ioctl() */
1586 static int snd_seq_ioctl_get_queue_info(struct snd_seq_client *client,
1589 struct snd_seq_queue_info *info = arg;
1590 struct snd_seq_queue *q;
1592 q = queueptr(info->queue);
1596 memset(info, 0, sizeof(*info));
1597 info->queue = q->queue;
1598 info->owner = q->owner;
1599 info->locked = q->locked;
1600 strscpy(info->name, q->name, sizeof(info->name));
1606 /* SET_QUEUE_INFO ioctl() */
1607 static int snd_seq_ioctl_set_queue_info(struct snd_seq_client *client,
1610 struct snd_seq_queue_info *info = arg;
1611 struct snd_seq_queue *q;
1613 if (info->owner != client->number)
1616 /* change owner/locked permission */
1617 if (snd_seq_queue_check_access(info->queue, client->number)) {
1618 if (snd_seq_queue_set_owner(info->queue, client->number, info->locked) < 0)
1621 snd_seq_queue_use(info->queue, client->number, 1);
1626 q = queueptr(info->queue);
1629 if (q->owner != client->number) {
1633 strscpy(q->name, info->name, sizeof(q->name));
1639 /* GET_NAMED_QUEUE ioctl() */
1640 static int snd_seq_ioctl_get_named_queue(struct snd_seq_client *client,
1643 struct snd_seq_queue_info *info = arg;
1644 struct snd_seq_queue *q;
1646 q = snd_seq_queue_find_name(info->name);
1649 info->queue = q->queue;
1650 info->owner = q->owner;
1651 info->locked = q->locked;
1657 /* GET_QUEUE_STATUS ioctl() */
1658 static int snd_seq_ioctl_get_queue_status(struct snd_seq_client *client,
1661 struct snd_seq_queue_status *status = arg;
1662 struct snd_seq_queue *queue;
1663 struct snd_seq_timer *tmr;
1665 queue = queueptr(status->queue);
1668 memset(status, 0, sizeof(*status));
1669 status->queue = queue->queue;
1672 status->events = queue->tickq->cells + queue->timeq->cells;
1674 status->time = snd_seq_timer_get_cur_time(tmr, true);
1675 status->tick = snd_seq_timer_get_cur_tick(tmr);
1677 status->running = tmr->running;
1679 status->flags = queue->flags;
1686 /* GET_QUEUE_TEMPO ioctl() */
1687 static int snd_seq_ioctl_get_queue_tempo(struct snd_seq_client *client,
1690 struct snd_seq_queue_tempo *tempo = arg;
1691 struct snd_seq_queue *queue;
1692 struct snd_seq_timer *tmr;
1694 queue = queueptr(tempo->queue);
1697 memset(tempo, 0, sizeof(*tempo));
1698 tempo->queue = queue->queue;
1702 tempo->tempo = tmr->tempo;
1703 tempo->ppq = tmr->ppq;
1704 tempo->skew_value = tmr->skew;
1705 tempo->skew_base = tmr->skew_base;
1712 /* SET_QUEUE_TEMPO ioctl() */
1713 int snd_seq_set_queue_tempo(int client, struct snd_seq_queue_tempo *tempo)
1715 if (!snd_seq_queue_check_access(tempo->queue, client))
1717 return snd_seq_queue_timer_set_tempo(tempo->queue, client, tempo);
1719 EXPORT_SYMBOL(snd_seq_set_queue_tempo);
1721 static int snd_seq_ioctl_set_queue_tempo(struct snd_seq_client *client,
1724 struct snd_seq_queue_tempo *tempo = arg;
1727 result = snd_seq_set_queue_tempo(client->number, tempo);
1728 return result < 0 ? result : 0;
1732 /* GET_QUEUE_TIMER ioctl() */
1733 static int snd_seq_ioctl_get_queue_timer(struct snd_seq_client *client,
1736 struct snd_seq_queue_timer *timer = arg;
1737 struct snd_seq_queue *queue;
1738 struct snd_seq_timer *tmr;
1740 queue = queueptr(timer->queue);
1744 mutex_lock(&queue->timer_mutex);
1746 memset(timer, 0, sizeof(*timer));
1747 timer->queue = queue->queue;
1749 timer->type = tmr->type;
1750 if (tmr->type == SNDRV_SEQ_TIMER_ALSA) {
1751 timer->u.alsa.id = tmr->alsa_id;
1752 timer->u.alsa.resolution = tmr->preferred_resolution;
1754 mutex_unlock(&queue->timer_mutex);
1761 /* SET_QUEUE_TIMER ioctl() */
1762 static int snd_seq_ioctl_set_queue_timer(struct snd_seq_client *client,
1765 struct snd_seq_queue_timer *timer = arg;
1768 if (timer->type != SNDRV_SEQ_TIMER_ALSA)
1771 if (snd_seq_queue_check_access(timer->queue, client->number)) {
1772 struct snd_seq_queue *q;
1773 struct snd_seq_timer *tmr;
1775 q = queueptr(timer->queue);
1778 mutex_lock(&q->timer_mutex);
1780 snd_seq_queue_timer_close(timer->queue);
1781 tmr->type = timer->type;
1782 if (tmr->type == SNDRV_SEQ_TIMER_ALSA) {
1783 tmr->alsa_id = timer->u.alsa.id;
1784 tmr->preferred_resolution = timer->u.alsa.resolution;
1786 result = snd_seq_queue_timer_open(timer->queue);
1787 mutex_unlock(&q->timer_mutex);
1797 /* GET_QUEUE_CLIENT ioctl() */
1798 static int snd_seq_ioctl_get_queue_client(struct snd_seq_client *client,
1801 struct snd_seq_queue_client *info = arg;
1804 used = snd_seq_queue_is_used(info->queue, client->number);
1808 info->client = client->number;
1814 /* SET_QUEUE_CLIENT ioctl() */
1815 static int snd_seq_ioctl_set_queue_client(struct snd_seq_client *client,
1818 struct snd_seq_queue_client *info = arg;
1821 if (info->used >= 0) {
1822 err = snd_seq_queue_use(info->queue, client->number, info->used);
1827 return snd_seq_ioctl_get_queue_client(client, arg);
1831 /* GET_CLIENT_POOL ioctl() */
1832 static int snd_seq_ioctl_get_client_pool(struct snd_seq_client *client,
1835 struct snd_seq_client_pool *info = arg;
1836 struct snd_seq_client *cptr;
1838 cptr = snd_seq_client_use_ptr(info->client);
1841 memset(info, 0, sizeof(*info));
1842 info->client = cptr->number;
1843 info->output_pool = cptr->pool->size;
1844 info->output_room = cptr->pool->room;
1845 info->output_free = info->output_pool;
1846 info->output_free = snd_seq_unused_cells(cptr->pool);
1847 if (cptr->type == USER_CLIENT) {
1848 info->input_pool = cptr->data.user.fifo_pool_size;
1849 info->input_free = info->input_pool;
1850 info->input_free = snd_seq_fifo_unused_cells(cptr->data.user.fifo);
1852 info->input_pool = 0;
1853 info->input_free = 0;
1855 snd_seq_client_unlock(cptr);
1860 /* SET_CLIENT_POOL ioctl() */
1861 static int snd_seq_ioctl_set_client_pool(struct snd_seq_client *client,
1864 struct snd_seq_client_pool *info = arg;
1867 if (client->number != info->client)
1868 return -EINVAL; /* can't change other clients */
1870 if (info->output_pool >= 1 && info->output_pool <= SNDRV_SEQ_MAX_EVENTS &&
1871 (! snd_seq_write_pool_allocated(client) ||
1872 info->output_pool != client->pool->size)) {
1873 if (snd_seq_write_pool_allocated(client)) {
1874 /* is the pool in use? */
1875 if (atomic_read(&client->pool->counter))
1877 /* remove all existing cells */
1878 snd_seq_pool_mark_closing(client->pool);
1879 snd_seq_pool_done(client->pool);
1881 client->pool->size = info->output_pool;
1882 rc = snd_seq_pool_init(client->pool);
1886 if (client->type == USER_CLIENT && client->data.user.fifo != NULL &&
1887 info->input_pool >= 1 &&
1888 info->input_pool <= SNDRV_SEQ_MAX_CLIENT_EVENTS &&
1889 info->input_pool != client->data.user.fifo_pool_size) {
1890 /* change pool size */
1891 rc = snd_seq_fifo_resize(client->data.user.fifo, info->input_pool);
1894 client->data.user.fifo_pool_size = info->input_pool;
1896 if (info->output_room >= 1 &&
1897 info->output_room <= client->pool->size) {
1898 client->pool->room = info->output_room;
1901 return snd_seq_ioctl_get_client_pool(client, arg);
1905 /* REMOVE_EVENTS ioctl() */
1906 static int snd_seq_ioctl_remove_events(struct snd_seq_client *client,
1909 struct snd_seq_remove_events *info = arg;
1912 * Input mostly not implemented XXX.
1914 if (info->remove_mode & SNDRV_SEQ_REMOVE_INPUT) {
1916 * No restrictions so for a user client we can clear
1919 if (client->type == USER_CLIENT && client->data.user.fifo)
1920 snd_seq_fifo_clear(client->data.user.fifo);
1923 if (info->remove_mode & SNDRV_SEQ_REMOVE_OUTPUT)
1924 snd_seq_queue_remove_cells(client->number, info);
1931 * get subscription info
1933 static int snd_seq_ioctl_get_subscription(struct snd_seq_client *client,
1936 struct snd_seq_port_subscribe *subs = arg;
1938 struct snd_seq_client *sender = NULL;
1939 struct snd_seq_client_port *sport = NULL;
1942 sender = snd_seq_client_use_ptr(subs->sender.client);
1945 sport = snd_seq_port_use_ptr(sender, subs->sender.port);
1948 result = snd_seq_port_get_subscription(&sport->c_src, &subs->dest,
1952 snd_seq_port_unlock(sport);
1954 snd_seq_client_unlock(sender);
1961 * get subscription info - check only its presence
1963 static int snd_seq_ioctl_query_subs(struct snd_seq_client *client, void *arg)
1965 struct snd_seq_query_subs *subs = arg;
1966 int result = -ENXIO;
1967 struct snd_seq_client *cptr = NULL;
1968 struct snd_seq_client_port *port = NULL;
1969 struct snd_seq_port_subs_info *group;
1970 struct list_head *p;
1973 cptr = snd_seq_client_use_ptr(subs->root.client);
1976 port = snd_seq_port_use_ptr(cptr, subs->root.port);
1980 switch (subs->type) {
1981 case SNDRV_SEQ_QUERY_SUBS_READ:
1982 group = &port->c_src;
1984 case SNDRV_SEQ_QUERY_SUBS_WRITE:
1985 group = &port->c_dest;
1991 down_read(&group->list_mutex);
1992 /* search for the subscriber */
1993 subs->num_subs = group->count;
1996 list_for_each(p, &group->list_head) {
1997 if (i++ == subs->index) {
1999 struct snd_seq_subscribers *s;
2000 if (subs->type == SNDRV_SEQ_QUERY_SUBS_READ) {
2001 s = list_entry(p, struct snd_seq_subscribers, src_list);
2002 subs->addr = s->info.dest;
2004 s = list_entry(p, struct snd_seq_subscribers, dest_list);
2005 subs->addr = s->info.sender;
2007 subs->flags = s->info.flags;
2008 subs->queue = s->info.queue;
2013 up_read(&group->list_mutex);
2017 snd_seq_port_unlock(port);
2019 snd_seq_client_unlock(cptr);
2028 static int snd_seq_ioctl_query_next_client(struct snd_seq_client *client,
2031 struct snd_seq_client_info *info = arg;
2032 struct snd_seq_client *cptr = NULL;
2034 /* search for next client */
2035 if (info->client < INT_MAX)
2037 if (info->client < 0)
2039 for (; info->client < SNDRV_SEQ_MAX_CLIENTS; info->client++) {
2040 cptr = snd_seq_client_use_ptr(info->client);
2047 get_client_info(cptr, info);
2048 snd_seq_client_unlock(cptr);
2056 static int snd_seq_ioctl_query_next_port(struct snd_seq_client *client,
2059 struct snd_seq_port_info *info = arg;
2060 struct snd_seq_client *cptr;
2061 struct snd_seq_client_port *port = NULL;
2063 cptr = snd_seq_client_use_ptr(info->addr.client);
2067 /* search for next port */
2069 port = snd_seq_port_query_nearest(cptr, info);
2071 snd_seq_client_unlock(cptr);
2076 info->addr = port->addr;
2077 snd_seq_get_port_info(port, info);
2078 snd_seq_port_unlock(port);
2079 snd_seq_client_unlock(cptr);
2084 /* -------------------------------------------------------- */
2086 static const struct ioctl_handler {
2088 int (*func)(struct snd_seq_client *client, void *arg);
2089 } ioctl_handlers[] = {
2090 { SNDRV_SEQ_IOCTL_PVERSION, snd_seq_ioctl_pversion },
2091 { SNDRV_SEQ_IOCTL_CLIENT_ID, snd_seq_ioctl_client_id },
2092 { SNDRV_SEQ_IOCTL_SYSTEM_INFO, snd_seq_ioctl_system_info },
2093 { SNDRV_SEQ_IOCTL_RUNNING_MODE, snd_seq_ioctl_running_mode },
2094 { SNDRV_SEQ_IOCTL_GET_CLIENT_INFO, snd_seq_ioctl_get_client_info },
2095 { SNDRV_SEQ_IOCTL_SET_CLIENT_INFO, snd_seq_ioctl_set_client_info },
2096 { SNDRV_SEQ_IOCTL_CREATE_PORT, snd_seq_ioctl_create_port },
2097 { SNDRV_SEQ_IOCTL_DELETE_PORT, snd_seq_ioctl_delete_port },
2098 { SNDRV_SEQ_IOCTL_GET_PORT_INFO, snd_seq_ioctl_get_port_info },
2099 { SNDRV_SEQ_IOCTL_SET_PORT_INFO, snd_seq_ioctl_set_port_info },
2100 { SNDRV_SEQ_IOCTL_SUBSCRIBE_PORT, snd_seq_ioctl_subscribe_port },
2101 { SNDRV_SEQ_IOCTL_UNSUBSCRIBE_PORT, snd_seq_ioctl_unsubscribe_port },
2102 { SNDRV_SEQ_IOCTL_CREATE_QUEUE, snd_seq_ioctl_create_queue },
2103 { SNDRV_SEQ_IOCTL_DELETE_QUEUE, snd_seq_ioctl_delete_queue },
2104 { SNDRV_SEQ_IOCTL_GET_QUEUE_INFO, snd_seq_ioctl_get_queue_info },
2105 { SNDRV_SEQ_IOCTL_SET_QUEUE_INFO, snd_seq_ioctl_set_queue_info },
2106 { SNDRV_SEQ_IOCTL_GET_NAMED_QUEUE, snd_seq_ioctl_get_named_queue },
2107 { SNDRV_SEQ_IOCTL_GET_QUEUE_STATUS, snd_seq_ioctl_get_queue_status },
2108 { SNDRV_SEQ_IOCTL_GET_QUEUE_TEMPO, snd_seq_ioctl_get_queue_tempo },
2109 { SNDRV_SEQ_IOCTL_SET_QUEUE_TEMPO, snd_seq_ioctl_set_queue_tempo },
2110 { SNDRV_SEQ_IOCTL_GET_QUEUE_TIMER, snd_seq_ioctl_get_queue_timer },
2111 { SNDRV_SEQ_IOCTL_SET_QUEUE_TIMER, snd_seq_ioctl_set_queue_timer },
2112 { SNDRV_SEQ_IOCTL_GET_QUEUE_CLIENT, snd_seq_ioctl_get_queue_client },
2113 { SNDRV_SEQ_IOCTL_SET_QUEUE_CLIENT, snd_seq_ioctl_set_queue_client },
2114 { SNDRV_SEQ_IOCTL_GET_CLIENT_POOL, snd_seq_ioctl_get_client_pool },
2115 { SNDRV_SEQ_IOCTL_SET_CLIENT_POOL, snd_seq_ioctl_set_client_pool },
2116 { SNDRV_SEQ_IOCTL_GET_SUBSCRIPTION, snd_seq_ioctl_get_subscription },
2117 { SNDRV_SEQ_IOCTL_QUERY_NEXT_CLIENT, snd_seq_ioctl_query_next_client },
2118 { SNDRV_SEQ_IOCTL_QUERY_NEXT_PORT, snd_seq_ioctl_query_next_port },
2119 { SNDRV_SEQ_IOCTL_REMOVE_EVENTS, snd_seq_ioctl_remove_events },
2120 { SNDRV_SEQ_IOCTL_QUERY_SUBS, snd_seq_ioctl_query_subs },
2124 static long snd_seq_ioctl(struct file *file, unsigned int cmd,
2127 struct snd_seq_client *client = file->private_data;
2128 /* To use kernel stack for ioctl data. */
2132 struct snd_seq_system_info system_info;
2133 struct snd_seq_running_info running_info;
2134 struct snd_seq_client_info client_info;
2135 struct snd_seq_port_info port_info;
2136 struct snd_seq_port_subscribe port_subscribe;
2137 struct snd_seq_queue_info queue_info;
2138 struct snd_seq_queue_status queue_status;
2139 struct snd_seq_queue_tempo tempo;
2140 struct snd_seq_queue_timer queue_timer;
2141 struct snd_seq_queue_client queue_client;
2142 struct snd_seq_client_pool client_pool;
2143 struct snd_seq_remove_events remove_events;
2144 struct snd_seq_query_subs query_subs;
2146 const struct ioctl_handler *handler;
2150 if (snd_BUG_ON(!client))
2153 for (handler = ioctl_handlers; handler->cmd > 0; ++handler) {
2154 if (handler->cmd == cmd)
2157 if (handler->cmd == 0)
2160 memset(&buf, 0, sizeof(buf));
2163 * All of ioctl commands for ALSA sequencer get an argument of size
2164 * within 13 bits. We can safely pick up the size from the command.
2166 size = _IOC_SIZE(handler->cmd);
2167 if (handler->cmd & IOC_IN) {
2168 if (copy_from_user(&buf, (const void __user *)arg, size))
2172 mutex_lock(&client->ioctl_mutex);
2173 err = handler->func(client, &buf);
2174 mutex_unlock(&client->ioctl_mutex);
2176 /* Some commands includes a bug in 'dir' field. */
2177 if (handler->cmd == SNDRV_SEQ_IOCTL_SET_QUEUE_CLIENT ||
2178 handler->cmd == SNDRV_SEQ_IOCTL_SET_CLIENT_POOL ||
2179 (handler->cmd & IOC_OUT))
2180 if (copy_to_user((void __user *)arg, &buf, size))
2187 #ifdef CONFIG_COMPAT
2188 #include "seq_compat.c"
2190 #define snd_seq_ioctl_compat NULL
2193 /* -------------------------------------------------------- */
2196 /* exported to kernel modules */
2197 int snd_seq_create_kernel_client(struct snd_card *card, int client_index,
2198 const char *name_fmt, ...)
2200 struct snd_seq_client *client;
2203 if (snd_BUG_ON(in_interrupt()))
2206 if (card && client_index >= SNDRV_SEQ_CLIENTS_PER_CARD)
2208 if (card == NULL && client_index >= SNDRV_SEQ_GLOBAL_CLIENTS)
2211 mutex_lock(®ister_mutex);
2214 client_index += SNDRV_SEQ_GLOBAL_CLIENTS
2215 + card->number * SNDRV_SEQ_CLIENTS_PER_CARD;
2216 if (client_index >= SNDRV_SEQ_DYNAMIC_CLIENTS_BEGIN)
2220 /* empty write queue as default */
2221 client = seq_create_client1(client_index, 0);
2222 if (client == NULL) {
2223 mutex_unlock(®ister_mutex);
2224 return -EBUSY; /* failure code */
2226 usage_alloc(&client_usage, 1);
2228 client->accept_input = 1;
2229 client->accept_output = 1;
2230 client->data.kernel.card = card;
2232 va_start(args, name_fmt);
2233 vsnprintf(client->name, sizeof(client->name), name_fmt, args);
2236 client->type = KERNEL_CLIENT;
2237 mutex_unlock(®ister_mutex);
2239 /* make others aware this new client */
2240 snd_seq_system_client_ev_client_start(client->number);
2242 /* return client number to caller */
2243 return client->number;
2245 EXPORT_SYMBOL(snd_seq_create_kernel_client);
2247 /* exported to kernel modules */
2248 int snd_seq_delete_kernel_client(int client)
2250 struct snd_seq_client *ptr;
2252 if (snd_BUG_ON(in_interrupt()))
2255 ptr = clientptr(client);
2259 seq_free_client(ptr);
2263 EXPORT_SYMBOL(snd_seq_delete_kernel_client);
2266 * exported, called by kernel clients to enqueue events (w/o blocking)
2268 * RETURN VALUE: zero if succeed, negative if error
2270 int snd_seq_kernel_client_enqueue(int client, struct snd_seq_event *ev,
2271 struct file *file, bool blocking)
2273 struct snd_seq_client *cptr;
2276 if (snd_BUG_ON(!ev))
2279 if (ev->type == SNDRV_SEQ_EVENT_NONE)
2280 return 0; /* ignore this */
2281 if (ev->type == SNDRV_SEQ_EVENT_KERNEL_ERROR)
2282 return -EINVAL; /* quoted events can't be enqueued */
2284 /* fill in client number */
2285 ev->source.client = client;
2287 if (check_event_type_and_length(ev))
2290 cptr = snd_seq_client_use_ptr(client);
2294 if (!cptr->accept_output) {
2296 } else { /* send it */
2297 mutex_lock(&cptr->ioctl_mutex);
2298 result = snd_seq_client_enqueue_event(cptr, ev, file, blocking,
2300 &cptr->ioctl_mutex);
2301 mutex_unlock(&cptr->ioctl_mutex);
2304 snd_seq_client_unlock(cptr);
2307 EXPORT_SYMBOL(snd_seq_kernel_client_enqueue);
2310 * exported, called by kernel clients to dispatch events directly to other
2311 * clients, bypassing the queues. Event time-stamp will be updated.
2313 * RETURN VALUE: negative = delivery failed,
2314 * zero, or positive: the number of delivered events
2316 int snd_seq_kernel_client_dispatch(int client, struct snd_seq_event * ev,
2317 int atomic, int hop)
2319 struct snd_seq_client *cptr;
2322 if (snd_BUG_ON(!ev))
2325 /* fill in client number */
2326 ev->queue = SNDRV_SEQ_QUEUE_DIRECT;
2327 ev->source.client = client;
2329 if (check_event_type_and_length(ev))
2332 cptr = snd_seq_client_use_ptr(client);
2336 if (!cptr->accept_output)
2339 result = snd_seq_deliver_event(cptr, ev, atomic, hop);
2341 snd_seq_client_unlock(cptr);
2344 EXPORT_SYMBOL(snd_seq_kernel_client_dispatch);
2347 * snd_seq_kernel_client_ctl - operate a command for a client with data in
2349 * @clientid: A numerical ID for a client.
2350 * @cmd: An ioctl(2) command for ALSA sequencer operation.
2351 * @arg: A pointer to data in kernel space.
2353 * Against its name, both kernel/application client can be handled by this
2354 * kernel API. A pointer of 'arg' argument should be in kernel space.
2356 * Return: 0 at success. Negative error code at failure.
2358 int snd_seq_kernel_client_ctl(int clientid, unsigned int cmd, void *arg)
2360 const struct ioctl_handler *handler;
2361 struct snd_seq_client *client;
2363 client = clientptr(clientid);
2367 for (handler = ioctl_handlers; handler->cmd > 0; ++handler) {
2368 if (handler->cmd == cmd)
2369 return handler->func(client, arg);
2372 pr_debug("ALSA: seq unknown ioctl() 0x%x (type='%c', number=0x%02x)\n",
2373 cmd, _IOC_TYPE(cmd), _IOC_NR(cmd));
2376 EXPORT_SYMBOL(snd_seq_kernel_client_ctl);
2378 /* exported (for OSS emulator) */
2379 int snd_seq_kernel_client_write_poll(int clientid, struct file *file, poll_table *wait)
2381 struct snd_seq_client *client;
2383 client = clientptr(clientid);
2387 if (! snd_seq_write_pool_allocated(client))
2389 if (snd_seq_pool_poll_wait(client->pool, file, wait))
2393 EXPORT_SYMBOL(snd_seq_kernel_client_write_poll);
2395 /*---------------------------------------------------------------------------*/
2397 #ifdef CONFIG_SND_PROC_FS
2401 static void snd_seq_info_dump_subscribers(struct snd_info_buffer *buffer,
2402 struct snd_seq_port_subs_info *group,
2403 int is_src, char *msg)
2405 struct list_head *p;
2406 struct snd_seq_subscribers *s;
2409 down_read(&group->list_mutex);
2410 if (list_empty(&group->list_head)) {
2411 up_read(&group->list_mutex);
2414 snd_iprintf(buffer, msg);
2415 list_for_each(p, &group->list_head) {
2417 s = list_entry(p, struct snd_seq_subscribers, src_list);
2419 s = list_entry(p, struct snd_seq_subscribers, dest_list);
2421 snd_iprintf(buffer, ", ");
2422 snd_iprintf(buffer, "%d:%d",
2423 is_src ? s->info.dest.client : s->info.sender.client,
2424 is_src ? s->info.dest.port : s->info.sender.port);
2425 if (s->info.flags & SNDRV_SEQ_PORT_SUBS_TIMESTAMP)
2426 snd_iprintf(buffer, "[%c:%d]", ((s->info.flags & SNDRV_SEQ_PORT_SUBS_TIME_REAL) ? 'r' : 't'), s->info.queue);
2427 if (group->exclusive)
2428 snd_iprintf(buffer, "[ex]");
2430 up_read(&group->list_mutex);
2431 snd_iprintf(buffer, "\n");
2434 #define FLAG_PERM_RD(perm) ((perm) & SNDRV_SEQ_PORT_CAP_READ ? ((perm) & SNDRV_SEQ_PORT_CAP_SUBS_READ ? 'R' : 'r') : '-')
2435 #define FLAG_PERM_WR(perm) ((perm) & SNDRV_SEQ_PORT_CAP_WRITE ? ((perm) & SNDRV_SEQ_PORT_CAP_SUBS_WRITE ? 'W' : 'w') : '-')
2436 #define FLAG_PERM_EX(perm) ((perm) & SNDRV_SEQ_PORT_CAP_NO_EXPORT ? '-' : 'e')
2438 #define FLAG_PERM_DUPLEX(perm) ((perm) & SNDRV_SEQ_PORT_CAP_DUPLEX ? 'X' : '-')
2440 static void snd_seq_info_dump_ports(struct snd_info_buffer *buffer,
2441 struct snd_seq_client *client)
2443 struct snd_seq_client_port *p;
2445 mutex_lock(&client->ports_mutex);
2446 list_for_each_entry(p, &client->ports_list_head, list) {
2447 snd_iprintf(buffer, " Port %3d : \"%s\" (%c%c%c%c)\n",
2448 p->addr.port, p->name,
2449 FLAG_PERM_RD(p->capability),
2450 FLAG_PERM_WR(p->capability),
2451 FLAG_PERM_EX(p->capability),
2452 FLAG_PERM_DUPLEX(p->capability));
2453 snd_seq_info_dump_subscribers(buffer, &p->c_src, 1, " Connecting To: ");
2454 snd_seq_info_dump_subscribers(buffer, &p->c_dest, 0, " Connected From: ");
2456 mutex_unlock(&client->ports_mutex);
2460 /* exported to seq_info.c */
2461 void snd_seq_info_clients_read(struct snd_info_entry *entry,
2462 struct snd_info_buffer *buffer)
2465 struct snd_seq_client *client;
2467 snd_iprintf(buffer, "Client info\n");
2468 snd_iprintf(buffer, " cur clients : %d\n", client_usage.cur);
2469 snd_iprintf(buffer, " peak clients : %d\n", client_usage.peak);
2470 snd_iprintf(buffer, " max clients : %d\n", SNDRV_SEQ_MAX_CLIENTS);
2471 snd_iprintf(buffer, "\n");
2473 /* list the client table */
2474 for (c = 0; c < SNDRV_SEQ_MAX_CLIENTS; c++) {
2475 client = snd_seq_client_use_ptr(c);
2478 if (client->type == NO_CLIENT) {
2479 snd_seq_client_unlock(client);
2483 snd_iprintf(buffer, "Client %3d : \"%s\" [%s]\n",
2485 client->type == USER_CLIENT ? "User" : "Kernel");
2486 snd_seq_info_dump_ports(buffer, client);
2487 if (snd_seq_write_pool_allocated(client)) {
2488 snd_iprintf(buffer, " Output pool :\n");
2489 snd_seq_info_pool(buffer, client->pool, " ");
2491 if (client->type == USER_CLIENT && client->data.user.fifo &&
2492 client->data.user.fifo->pool) {
2493 snd_iprintf(buffer, " Input pool :\n");
2494 snd_seq_info_pool(buffer, client->data.user.fifo->pool, " ");
2496 snd_seq_client_unlock(client);
2499 #endif /* CONFIG_SND_PROC_FS */
2501 /*---------------------------------------------------------------------------*/
2508 static const struct file_operations snd_seq_f_ops =
2510 .owner = THIS_MODULE,
2511 .read = snd_seq_read,
2512 .write = snd_seq_write,
2513 .open = snd_seq_open,
2514 .release = snd_seq_release,
2515 .llseek = no_llseek,
2516 .poll = snd_seq_poll,
2517 .unlocked_ioctl = snd_seq_ioctl,
2518 .compat_ioctl = snd_seq_ioctl_compat,
2521 static struct device seq_dev;
2524 * register sequencer device
2526 int __init snd_sequencer_device_init(void)
2530 snd_device_initialize(&seq_dev, NULL);
2531 dev_set_name(&seq_dev, "seq");
2533 mutex_lock(®ister_mutex);
2534 err = snd_register_device(SNDRV_DEVICE_TYPE_SEQUENCER, NULL, 0,
2535 &snd_seq_f_ops, NULL, &seq_dev);
2536 mutex_unlock(®ister_mutex);
2538 put_device(&seq_dev);
2548 * unregister sequencer device
2550 void snd_sequencer_device_done(void)
2552 snd_unregister_device(&seq_dev);
2553 put_device(&seq_dev);