1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * ALSA sequencer Client Manager 4 * Copyright (c) 1998-1999 by Frank van de Pol <fvdpol@coil.demon.nl> 5 */ 6 #ifndef __SND_SEQ_CLIENTMGR_H 7 #define __SND_SEQ_CLIENTMGR_H 8 9 #include <sound/seq_kernel.h> 10 #include <linux/bitops.h> 11 #include "seq_fifo.h" 12 #include "seq_ports.h" 13 #include "seq_lock.h" 14 15 /* client manager */ 16 17 struct snd_seq_user_client { 18 struct file *file; /* file struct of client */ 19 /* ... */ 20 struct pid *owner; 21 22 /* fifo */ 23 struct snd_seq_fifo *fifo; /* queue for incoming events */ 24 int fifo_pool_size; 25 }; 26 27 struct snd_seq_kernel_client { 28 /* ... */ 29 struct snd_card *card; 30 }; 31 32 33 struct snd_seq_client { 34 snd_seq_client_type_t type; 35 unsigned int accept_input: 1, 36 accept_output: 1; 37 unsigned int midi_version; 38 unsigned int user_pversion; 39 char name[64]; /* client name */ 40 int number; /* client number */ 41 unsigned int filter; /* filter flags */ 42 DECLARE_BITMAP(event_filter, 256); 43 unsigned short group_filter; 44 snd_use_lock_t use_lock; 45 int event_lost; 46 /* ports */ 47 int num_ports; /* number of ports */ 48 struct list_head ports_list_head; 49 rwlock_t ports_lock; 50 struct mutex ports_mutex; 51 struct mutex ioctl_mutex; 52 int convert32; /* convert 32->64bit */ 53 int ump_endpoint_port; 54 55 /* output pool */ 56 struct snd_seq_pool *pool; /* memory pool for this client */ 57 58 union { 59 struct snd_seq_user_client user; 60 struct snd_seq_kernel_client kernel; 61 } data; 62 63 /* for UMP */ 64 void **ump_info; 65 }; 66 67 /* usage statistics */ 68 struct snd_seq_usage { 69 int cur; 70 int peak; 71 }; 72 73 74 int client_init_data(void); 75 int snd_sequencer_device_init(void); 76 void snd_sequencer_device_done(void); 77 78 /* get locked pointer to client */ 79 struct snd_seq_client *snd_seq_client_use_ptr(int clientid); 80 81 /* unlock pointer to client */ 82 #define snd_seq_client_unlock(client) snd_use_lock_free(&(client)->use_lock) 83 84 /* dispatch event to client(s) */ 85 int snd_seq_dispatch_event(struct snd_seq_event_cell *cell, int atomic, int hop); 86 87 int snd_seq_kernel_client_write_poll(int clientid, struct file *file, poll_table *wait); 88 int snd_seq_client_notify_subscription(int client, int port, 89 struct snd_seq_port_subscribe *info, int evtype); 90 91 int __snd_seq_deliver_single_event(struct snd_seq_client *dest, 92 struct snd_seq_client_port *dest_port, 93 struct snd_seq_event *event, 94 int atomic, int hop); 95 96 /* only for OSS sequencer */ 97 bool snd_seq_client_ioctl_lock(int clientid); 98 void snd_seq_client_ioctl_unlock(int clientid); 99 100 extern int seq_client_load[15]; 101 102 /* for internal use between kernel sequencer clients */ 103 struct snd_seq_client *snd_seq_kernel_client_get(int client); 104 void snd_seq_kernel_client_put(struct snd_seq_client *cptr); 105 106 static inline bool snd_seq_client_is_ump(struct snd_seq_client *c) 107 { 108 return c->midi_version != SNDRV_SEQ_CLIENT_LEGACY_MIDI; 109 } 110 111 static inline bool snd_seq_client_is_midi2(struct snd_seq_client *c) 112 { 113 return c->midi_version == SNDRV_SEQ_CLIENT_UMP_MIDI_2_0; 114 } 115 116 #endif 117