1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * Abstract layer for MIDI v1.0 stream
4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
5 */
6
7#include <sound/core.h>
8#include <linux/major.h>
9#include <linux/init.h>
10#include <linux/sched/signal.h>
11#include <linux/slab.h>
12#include <linux/time.h>
13#include <linux/wait.h>
14#include <linux/mutex.h>
15#include <linux/module.h>
16#include <linux/delay.h>
17#include <linux/mm.h>
18#include <linux/nospec.h>
19#include <sound/rawmidi.h>
20#include <sound/info.h>
21#include <sound/control.h>
22#include <sound/minors.h>
23#include <sound/initval.h>
24#include <sound/ump.h>
25
26MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
27MODULE_DESCRIPTION("Midlevel RawMidi code for ALSA.");
28MODULE_LICENSE("GPL");
29
30#ifdef CONFIG_SND_OSSEMUL
31static int midi_map[SNDRV_CARDS];
32static int amidi_map[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS-1)] = 1};
33module_param_array(midi_map, int, NULL, 0444);
34MODULE_PARM_DESC(midi_map, "Raw MIDI device number assigned to 1st OSS device.");
35module_param_array(amidi_map, int, NULL, 0444);
36MODULE_PARM_DESC(amidi_map, "Raw MIDI device number assigned to 2nd OSS device.");
37#endif /* CONFIG_SND_OSSEMUL */
38
39static int snd_rawmidi_dev_free(struct snd_device *device);
40static int snd_rawmidi_dev_register(struct snd_device *device);
41static int snd_rawmidi_dev_disconnect(struct snd_device *device);
42
43static LIST_HEAD(snd_rawmidi_devices);
44static DEFINE_MUTEX(register_mutex);
45
46#define rmidi_err(rmidi, fmt, args...) \
47 dev_err((rmidi)->dev, fmt, ##args)
48#define rmidi_warn(rmidi, fmt, args...) \
49 dev_warn((rmidi)->dev, fmt, ##args)
50#define rmidi_dbg(rmidi, fmt, args...) \
51 dev_dbg((rmidi)->dev, fmt, ##args)
52
53struct snd_rawmidi_status32 {
54 s32 stream;
55 s32 tstamp_sec; /* Timestamp */
56 s32 tstamp_nsec;
57 u32 avail; /* available bytes */
58 u32 xruns; /* count of overruns since last status (in bytes) */
59 unsigned char reserved[16]; /* reserved for future use */
60};
61
62#define SNDRV_RAWMIDI_IOCTL_STATUS32 _IOWR('W', 0x20, struct snd_rawmidi_status32)
63
64struct snd_rawmidi_status64 {
65 int stream;
66 u8 rsvd[4]; /* alignment */
67 s64 tstamp_sec; /* Timestamp */
68 s64 tstamp_nsec;
69 size_t avail; /* available bytes */
70 size_t xruns; /* count of overruns since last status (in bytes) */
71 unsigned char reserved[16]; /* reserved for future use */
72};
73
74#define SNDRV_RAWMIDI_IOCTL_STATUS64 _IOWR('W', 0x20, struct snd_rawmidi_status64)
75
76#define rawmidi_is_ump(rmidi) \
77 (IS_ENABLED(CONFIG_SND_UMP) && ((rmidi)->info_flags & SNDRV_RAWMIDI_INFO_UMP))
78
79static struct snd_rawmidi *snd_rawmidi_search(struct snd_card *card, int device)
80{
81 struct snd_rawmidi *rawmidi;
82
83 list_for_each_entry(rawmidi, &snd_rawmidi_devices, list)
84 if (rawmidi->card == card && rawmidi->device == device)
85 return rawmidi;
86 return NULL;
87}
88
89static inline unsigned short snd_rawmidi_file_flags(struct file *file)
90{
91 switch (file->f_mode & (FMODE_READ | FMODE_WRITE)) {
92 case FMODE_WRITE:
93 return SNDRV_RAWMIDI_LFLG_OUTPUT;
94 case FMODE_READ:
95 return SNDRV_RAWMIDI_LFLG_INPUT;
96 default:
97 return SNDRV_RAWMIDI_LFLG_OPEN;
98 }
99}
100
101static inline bool __snd_rawmidi_ready(struct snd_rawmidi_runtime *runtime)
102{
103 return runtime->avail >= runtime->avail_min;
104}
105
106static bool snd_rawmidi_ready(struct snd_rawmidi_substream *substream)
107{
108 guard(spinlock_irqsave)(l: &substream->lock);
109 return __snd_rawmidi_ready(runtime: substream->runtime);
110}
111
112static inline int snd_rawmidi_ready_append(struct snd_rawmidi_substream *substream,
113 size_t count)
114{
115 struct snd_rawmidi_runtime *runtime = substream->runtime;
116
117 return runtime->avail >= runtime->avail_min &&
118 (!substream->append || runtime->avail >= count);
119}
120
121static void snd_rawmidi_input_event_work(struct work_struct *work)
122{
123 struct snd_rawmidi_runtime *runtime =
124 container_of(work, struct snd_rawmidi_runtime, event_work);
125
126 if (runtime->event)
127 runtime->event(runtime->substream);
128}
129
130/* buffer refcount management: call with substream->lock held */
131static inline void snd_rawmidi_buffer_ref(struct snd_rawmidi_runtime *runtime)
132{
133 runtime->buffer_ref++;
134}
135
136static inline void snd_rawmidi_buffer_unref(struct snd_rawmidi_runtime *runtime)
137{
138 runtime->buffer_ref--;
139}
140
141static void snd_rawmidi_buffer_ref_sync(struct snd_rawmidi_substream *substream)
142{
143 int loop = HZ;
144
145 spin_lock_irq(lock: &substream->lock);
146 while (substream->runtime->buffer_ref) {
147 spin_unlock_irq(lock: &substream->lock);
148 if (!--loop) {
149 rmidi_err(substream->rmidi, "Buffer ref sync timeout\n");
150 return;
151 }
152 schedule_timeout_uninterruptible(timeout: 1);
153 spin_lock_irq(lock: &substream->lock);
154 }
155 spin_unlock_irq(lock: &substream->lock);
156}
157
158static int snd_rawmidi_runtime_create(struct snd_rawmidi_substream *substream)
159{
160 struct snd_rawmidi_runtime *runtime;
161
162 runtime = kzalloc(size: sizeof(*runtime), GFP_KERNEL);
163 if (!runtime)
164 return -ENOMEM;
165 runtime->substream = substream;
166 init_waitqueue_head(&runtime->sleep);
167 INIT_WORK(&runtime->event_work, snd_rawmidi_input_event_work);
168 runtime->event = NULL;
169 runtime->buffer_size = PAGE_SIZE;
170 runtime->avail_min = 1;
171 if (substream->stream == SNDRV_RAWMIDI_STREAM_INPUT)
172 runtime->avail = 0;
173 else
174 runtime->avail = runtime->buffer_size;
175 runtime->buffer = kvzalloc(size: runtime->buffer_size, GFP_KERNEL);
176 if (!runtime->buffer) {
177 kfree(objp: runtime);
178 return -ENOMEM;
179 }
180 runtime->appl_ptr = runtime->hw_ptr = 0;
181 substream->runtime = runtime;
182 if (rawmidi_is_ump(substream->rmidi))
183 runtime->align = 3;
184 return 0;
185}
186
187/* get the current alignment (either 0 or 3) */
188static inline int get_align(struct snd_rawmidi_runtime *runtime)
189{
190 if (IS_ENABLED(CONFIG_SND_UMP))
191 return runtime->align;
192 else
193 return 0;
194}
195
196/* get the trimmed size with the current alignment */
197#define get_aligned_size(runtime, size) ((size) & ~get_align(runtime))
198
199static int snd_rawmidi_runtime_free(struct snd_rawmidi_substream *substream)
200{
201 struct snd_rawmidi_runtime *runtime = substream->runtime;
202
203 kvfree(addr: runtime->buffer);
204 kfree(objp: runtime);
205 substream->runtime = NULL;
206 return 0;
207}
208
209static inline void snd_rawmidi_output_trigger(struct snd_rawmidi_substream *substream, int up)
210{
211 if (!substream->opened)
212 return;
213 substream->ops->trigger(substream, up);
214}
215
216static void snd_rawmidi_input_trigger(struct snd_rawmidi_substream *substream, int up)
217{
218 if (!substream->opened)
219 return;
220 substream->ops->trigger(substream, up);
221 if (!up)
222 cancel_work_sync(work: &substream->runtime->event_work);
223}
224
225static void __reset_runtime_ptrs(struct snd_rawmidi_runtime *runtime,
226 bool is_input)
227{
228 runtime->drain = 0;
229 runtime->appl_ptr = runtime->hw_ptr = 0;
230 runtime->avail = is_input ? 0 : runtime->buffer_size;
231}
232
233static void reset_runtime_ptrs(struct snd_rawmidi_substream *substream,
234 bool is_input)
235{
236 guard(spinlock_irqsave)(l: &substream->lock);
237 if (substream->opened && substream->runtime)
238 __reset_runtime_ptrs(runtime: substream->runtime, is_input);
239}
240
241int snd_rawmidi_drop_output(struct snd_rawmidi_substream *substream)
242{
243 snd_rawmidi_output_trigger(substream, up: 0);
244 reset_runtime_ptrs(substream, is_input: false);
245 return 0;
246}
247EXPORT_SYMBOL(snd_rawmidi_drop_output);
248
249int snd_rawmidi_drain_output(struct snd_rawmidi_substream *substream)
250{
251 int err = 0;
252 long timeout;
253 struct snd_rawmidi_runtime *runtime;
254
255 scoped_guard(spinlock_irq, &substream->lock) {
256 runtime = substream->runtime;
257 if (!substream->opened || !runtime || !runtime->buffer)
258 return -EINVAL;
259 snd_rawmidi_buffer_ref(runtime);
260 runtime->drain = 1;
261 }
262
263 timeout = wait_event_interruptible_timeout(runtime->sleep,
264 (runtime->avail >= runtime->buffer_size),
265 10*HZ);
266
267 scoped_guard(spinlock_irq, &substream->lock) {
268 if (signal_pending(current))
269 err = -ERESTARTSYS;
270 if (runtime->avail < runtime->buffer_size && !timeout) {
271 rmidi_warn(substream->rmidi,
272 "rawmidi drain error (avail = %li, buffer_size = %li)\n",
273 (long)runtime->avail, (long)runtime->buffer_size);
274 err = -EIO;
275 }
276 runtime->drain = 0;
277 }
278
279 if (err != -ERESTARTSYS) {
280 /* we need wait a while to make sure that Tx FIFOs are empty */
281 if (substream->ops->drain)
282 substream->ops->drain(substream);
283 else
284 msleep(msecs: 50);
285 snd_rawmidi_drop_output(substream);
286 }
287
288 scoped_guard(spinlock_irq, &substream->lock)
289 snd_rawmidi_buffer_unref(runtime);
290
291 return err;
292}
293EXPORT_SYMBOL(snd_rawmidi_drain_output);
294
295int snd_rawmidi_drain_input(struct snd_rawmidi_substream *substream)
296{
297 snd_rawmidi_input_trigger(substream, up: 0);
298 reset_runtime_ptrs(substream, is_input: true);
299 return 0;
300}
301EXPORT_SYMBOL(snd_rawmidi_drain_input);
302
303/* look for an available substream for the given stream direction;
304 * if a specific subdevice is given, try to assign it
305 */
306static int assign_substream(struct snd_rawmidi *rmidi, int subdevice,
307 int stream, int mode,
308 struct snd_rawmidi_substream **sub_ret)
309{
310 struct snd_rawmidi_substream *substream;
311 struct snd_rawmidi_str *s = &rmidi->streams[stream];
312 static const unsigned int info_flags[2] = {
313 [SNDRV_RAWMIDI_STREAM_OUTPUT] = SNDRV_RAWMIDI_INFO_OUTPUT,
314 [SNDRV_RAWMIDI_STREAM_INPUT] = SNDRV_RAWMIDI_INFO_INPUT,
315 };
316
317 if (!(rmidi->info_flags & info_flags[stream]))
318 return -ENXIO;
319 if (subdevice >= 0 && subdevice >= s->substream_count)
320 return -ENODEV;
321
322 list_for_each_entry(substream, &s->substreams, list) {
323 if (substream->opened) {
324 if (stream == SNDRV_RAWMIDI_STREAM_INPUT ||
325 !(mode & SNDRV_RAWMIDI_LFLG_APPEND) ||
326 !substream->append)
327 continue;
328 }
329 if (subdevice < 0 || subdevice == substream->number) {
330 *sub_ret = substream;
331 return 0;
332 }
333 }
334 return -EAGAIN;
335}
336
337/* open and do ref-counting for the given substream */
338static int open_substream(struct snd_rawmidi *rmidi,
339 struct snd_rawmidi_substream *substream,
340 int mode)
341{
342 int err;
343
344 if (substream->use_count == 0) {
345 err = snd_rawmidi_runtime_create(substream);
346 if (err < 0)
347 return err;
348 err = substream->ops->open(substream);
349 if (err < 0) {
350 snd_rawmidi_runtime_free(substream);
351 return err;
352 }
353 guard(spinlock_irq)(l: &substream->lock);
354 substream->opened = 1;
355 substream->active_sensing = 0;
356 if (mode & SNDRV_RAWMIDI_LFLG_APPEND)
357 substream->append = 1;
358 substream->pid = get_pid(pid: task_pid(current));
359 rmidi->streams[substream->stream].substream_opened++;
360 }
361 substream->use_count++;
362 return 0;
363}
364
365static void close_substream(struct snd_rawmidi *rmidi,
366 struct snd_rawmidi_substream *substream,
367 int cleanup);
368
369static int rawmidi_open_priv(struct snd_rawmidi *rmidi, int subdevice, int mode,
370 struct snd_rawmidi_file *rfile)
371{
372 struct snd_rawmidi_substream *sinput = NULL, *soutput = NULL;
373 int err;
374
375 rfile->input = rfile->output = NULL;
376 if (mode & SNDRV_RAWMIDI_LFLG_INPUT) {
377 err = assign_substream(rmidi, subdevice,
378 stream: SNDRV_RAWMIDI_STREAM_INPUT,
379 mode, sub_ret: &sinput);
380 if (err < 0)
381 return err;
382 }
383 if (mode & SNDRV_RAWMIDI_LFLG_OUTPUT) {
384 err = assign_substream(rmidi, subdevice,
385 stream: SNDRV_RAWMIDI_STREAM_OUTPUT,
386 mode, sub_ret: &soutput);
387 if (err < 0)
388 return err;
389 }
390
391 if (sinput) {
392 err = open_substream(rmidi, substream: sinput, mode);
393 if (err < 0)
394 return err;
395 }
396 if (soutput) {
397 err = open_substream(rmidi, substream: soutput, mode);
398 if (err < 0) {
399 if (sinput)
400 close_substream(rmidi, substream: sinput, cleanup: 0);
401 return err;
402 }
403 }
404
405 rfile->rmidi = rmidi;
406 rfile->input = sinput;
407 rfile->output = soutput;
408 return 0;
409}
410
411/* called from sound/core/seq/seq_midi.c */
412int snd_rawmidi_kernel_open(struct snd_rawmidi *rmidi, int subdevice,
413 int mode, struct snd_rawmidi_file *rfile)
414{
415 int err;
416
417 if (snd_BUG_ON(!rfile))
418 return -EINVAL;
419 if (!try_module_get(module: rmidi->card->module))
420 return -ENXIO;
421
422 guard(mutex)(T: &rmidi->open_mutex);
423 err = rawmidi_open_priv(rmidi, subdevice, mode, rfile);
424 if (err < 0)
425 module_put(module: rmidi->card->module);
426 return err;
427}
428EXPORT_SYMBOL(snd_rawmidi_kernel_open);
429
430static int snd_rawmidi_open(struct inode *inode, struct file *file)
431{
432 int maj = imajor(inode);
433 struct snd_card *card;
434 int subdevice;
435 unsigned short fflags;
436 int err;
437 struct snd_rawmidi *rmidi;
438 struct snd_rawmidi_file *rawmidi_file = NULL;
439 wait_queue_entry_t wait;
440
441 if ((file->f_flags & O_APPEND) && !(file->f_flags & O_NONBLOCK))
442 return -EINVAL; /* invalid combination */
443
444 err = stream_open(inode, filp: file);
445 if (err < 0)
446 return err;
447
448 if (maj == snd_major) {
449 rmidi = snd_lookup_minor_data(minor: iminor(inode),
450 type: SNDRV_DEVICE_TYPE_RAWMIDI);
451#ifdef CONFIG_SND_OSSEMUL
452 } else if (maj == SOUND_MAJOR) {
453 rmidi = snd_lookup_oss_minor_data(minor: iminor(inode),
454 SNDRV_OSS_DEVICE_TYPE_MIDI);
455#endif
456 } else
457 return -ENXIO;
458
459 if (rmidi == NULL)
460 return -ENODEV;
461
462 if (!try_module_get(module: rmidi->card->module)) {
463 snd_card_unref(card: rmidi->card);
464 return -ENXIO;
465 }
466
467 mutex_lock(&rmidi->open_mutex);
468 card = rmidi->card;
469 err = snd_card_file_add(card, file);
470 if (err < 0)
471 goto __error_card;
472 fflags = snd_rawmidi_file_flags(file);
473 if ((file->f_flags & O_APPEND) || maj == SOUND_MAJOR) /* OSS emul? */
474 fflags |= SNDRV_RAWMIDI_LFLG_APPEND;
475 rawmidi_file = kmalloc(size: sizeof(*rawmidi_file), GFP_KERNEL);
476 if (rawmidi_file == NULL) {
477 err = -ENOMEM;
478 goto __error;
479 }
480 rawmidi_file->user_pversion = 0;
481 init_waitqueue_entry(wq_entry: &wait, current);
482 add_wait_queue(wq_head: &rmidi->open_wait, wq_entry: &wait);
483 while (1) {
484 subdevice = snd_ctl_get_preferred_subdevice(card, type: SND_CTL_SUBDEV_RAWMIDI);
485 err = rawmidi_open_priv(rmidi, subdevice, mode: fflags, rfile: rawmidi_file);
486 if (err >= 0)
487 break;
488 if (err == -EAGAIN) {
489 if (file->f_flags & O_NONBLOCK) {
490 err = -EBUSY;
491 break;
492 }
493 } else
494 break;
495 set_current_state(TASK_INTERRUPTIBLE);
496 mutex_unlock(lock: &rmidi->open_mutex);
497 schedule();
498 mutex_lock(&rmidi->open_mutex);
499 if (rmidi->card->shutdown) {
500 err = -ENODEV;
501 break;
502 }
503 if (signal_pending(current)) {
504 err = -ERESTARTSYS;
505 break;
506 }
507 }
508 remove_wait_queue(wq_head: &rmidi->open_wait, wq_entry: &wait);
509 if (err < 0) {
510 kfree(objp: rawmidi_file);
511 goto __error;
512 }
513#ifdef CONFIG_SND_OSSEMUL
514 if (rawmidi_file->input && rawmidi_file->input->runtime)
515 rawmidi_file->input->runtime->oss = (maj == SOUND_MAJOR);
516 if (rawmidi_file->output && rawmidi_file->output->runtime)
517 rawmidi_file->output->runtime->oss = (maj == SOUND_MAJOR);
518#endif
519 file->private_data = rawmidi_file;
520 mutex_unlock(lock: &rmidi->open_mutex);
521 snd_card_unref(card: rmidi->card);
522 return 0;
523
524 __error:
525 snd_card_file_remove(card, file);
526 __error_card:
527 mutex_unlock(lock: &rmidi->open_mutex);
528 module_put(module: rmidi->card->module);
529 snd_card_unref(card: rmidi->card);
530 return err;
531}
532
533static void close_substream(struct snd_rawmidi *rmidi,
534 struct snd_rawmidi_substream *substream,
535 int cleanup)
536{
537 if (--substream->use_count)
538 return;
539
540 if (cleanup) {
541 if (substream->stream == SNDRV_RAWMIDI_STREAM_INPUT)
542 snd_rawmidi_input_trigger(substream, up: 0);
543 else {
544 if (substream->active_sensing) {
545 unsigned char buf = 0xfe;
546 /* sending single active sensing message
547 * to shut the device up
548 */
549 snd_rawmidi_kernel_write(substream, buf: &buf, count: 1);
550 }
551 if (snd_rawmidi_drain_output(substream) == -ERESTARTSYS)
552 snd_rawmidi_output_trigger(substream, up: 0);
553 }
554 snd_rawmidi_buffer_ref_sync(substream);
555 }
556 scoped_guard(spinlock_irq, &substream->lock) {
557 substream->opened = 0;
558 substream->append = 0;
559 }
560 substream->ops->close(substream);
561 if (substream->runtime->private_free)
562 substream->runtime->private_free(substream);
563 snd_rawmidi_runtime_free(substream);
564 put_pid(pid: substream->pid);
565 substream->pid = NULL;
566 rmidi->streams[substream->stream].substream_opened--;
567}
568
569static void rawmidi_release_priv(struct snd_rawmidi_file *rfile)
570{
571 struct snd_rawmidi *rmidi;
572
573 rmidi = rfile->rmidi;
574 guard(mutex)(T: &rmidi->open_mutex);
575 if (rfile->input) {
576 close_substream(rmidi, substream: rfile->input, cleanup: 1);
577 rfile->input = NULL;
578 }
579 if (rfile->output) {
580 close_substream(rmidi, substream: rfile->output, cleanup: 1);
581 rfile->output = NULL;
582 }
583 rfile->rmidi = NULL;
584 wake_up(&rmidi->open_wait);
585}
586
587/* called from sound/core/seq/seq_midi.c */
588int snd_rawmidi_kernel_release(struct snd_rawmidi_file *rfile)
589{
590 struct snd_rawmidi *rmidi;
591
592 if (snd_BUG_ON(!rfile))
593 return -ENXIO;
594
595 rmidi = rfile->rmidi;
596 rawmidi_release_priv(rfile);
597 module_put(module: rmidi->card->module);
598 return 0;
599}
600EXPORT_SYMBOL(snd_rawmidi_kernel_release);
601
602static int snd_rawmidi_release(struct inode *inode, struct file *file)
603{
604 struct snd_rawmidi_file *rfile;
605 struct snd_rawmidi *rmidi;
606 struct module *module;
607
608 rfile = file->private_data;
609 rmidi = rfile->rmidi;
610 rawmidi_release_priv(rfile);
611 kfree(objp: rfile);
612 module = rmidi->card->module;
613 snd_card_file_remove(card: rmidi->card, file);
614 module_put(module);
615 return 0;
616}
617
618static int snd_rawmidi_info(struct snd_rawmidi_substream *substream,
619 struct snd_rawmidi_info *info)
620{
621 struct snd_rawmidi *rmidi;
622
623 if (substream == NULL)
624 return -ENODEV;
625 rmidi = substream->rmidi;
626 memset(info, 0, sizeof(*info));
627 info->card = rmidi->card->number;
628 info->device = rmidi->device;
629 info->subdevice = substream->number;
630 info->stream = substream->stream;
631 info->flags = rmidi->info_flags;
632 strcpy(p: info->id, q: rmidi->id);
633 strcpy(p: info->name, q: rmidi->name);
634 strcpy(p: info->subname, q: substream->name);
635 info->subdevices_count = substream->pstr->substream_count;
636 info->subdevices_avail = (substream->pstr->substream_count -
637 substream->pstr->substream_opened);
638 return 0;
639}
640
641static int snd_rawmidi_info_user(struct snd_rawmidi_substream *substream,
642 struct snd_rawmidi_info __user *_info)
643{
644 struct snd_rawmidi_info info;
645 int err;
646
647 err = snd_rawmidi_info(substream, info: &info);
648 if (err < 0)
649 return err;
650 if (copy_to_user(to: _info, from: &info, n: sizeof(struct snd_rawmidi_info)))
651 return -EFAULT;
652 return 0;
653}
654
655static int __snd_rawmidi_info_select(struct snd_card *card,
656 struct snd_rawmidi_info *info)
657{
658 struct snd_rawmidi *rmidi;
659 struct snd_rawmidi_str *pstr;
660 struct snd_rawmidi_substream *substream;
661
662 rmidi = snd_rawmidi_search(card, device: info->device);
663 if (!rmidi)
664 return -ENXIO;
665 if (info->stream < 0 || info->stream > 1)
666 return -EINVAL;
667 info->stream = array_index_nospec(info->stream, 2);
668 pstr = &rmidi->streams[info->stream];
669 if (pstr->substream_count == 0)
670 return -ENOENT;
671 if (info->subdevice >= pstr->substream_count)
672 return -ENXIO;
673 list_for_each_entry(substream, &pstr->substreams, list) {
674 if ((unsigned int)substream->number == info->subdevice)
675 return snd_rawmidi_info(substream, info);
676 }
677 return -ENXIO;
678}
679
680int snd_rawmidi_info_select(struct snd_card *card, struct snd_rawmidi_info *info)
681{
682 guard(mutex)(T: &register_mutex);
683 return __snd_rawmidi_info_select(card, info);
684}
685EXPORT_SYMBOL(snd_rawmidi_info_select);
686
687static int snd_rawmidi_info_select_user(struct snd_card *card,
688 struct snd_rawmidi_info __user *_info)
689{
690 int err;
691 struct snd_rawmidi_info info;
692
693 if (get_user(info.device, &_info->device))
694 return -EFAULT;
695 if (get_user(info.stream, &_info->stream))
696 return -EFAULT;
697 if (get_user(info.subdevice, &_info->subdevice))
698 return -EFAULT;
699 err = snd_rawmidi_info_select(card, &info);
700 if (err < 0)
701 return err;
702 if (copy_to_user(to: _info, from: &info, n: sizeof(struct snd_rawmidi_info)))
703 return -EFAULT;
704 return 0;
705}
706
707static int resize_runtime_buffer(struct snd_rawmidi_substream *substream,
708 struct snd_rawmidi_params *params,
709 bool is_input)
710{
711 struct snd_rawmidi_runtime *runtime = substream->runtime;
712 char *newbuf, *oldbuf;
713 unsigned int framing = params->mode & SNDRV_RAWMIDI_MODE_FRAMING_MASK;
714
715 if (params->buffer_size < 32 || params->buffer_size > 1024L * 1024L)
716 return -EINVAL;
717 if (framing == SNDRV_RAWMIDI_MODE_FRAMING_TSTAMP && (params->buffer_size & 0x1f) != 0)
718 return -EINVAL;
719 if (params->avail_min < 1 || params->avail_min > params->buffer_size)
720 return -EINVAL;
721 if (params->buffer_size & get_align(runtime))
722 return -EINVAL;
723 if (params->buffer_size != runtime->buffer_size) {
724 newbuf = kvzalloc(size: params->buffer_size, GFP_KERNEL);
725 if (!newbuf)
726 return -ENOMEM;
727 guard(spinlock_irq)(l: &substream->lock);
728 if (runtime->buffer_ref) {
729 kvfree(addr: newbuf);
730 return -EBUSY;
731 }
732 oldbuf = runtime->buffer;
733 runtime->buffer = newbuf;
734 runtime->buffer_size = params->buffer_size;
735 __reset_runtime_ptrs(runtime, is_input);
736 kvfree(addr: oldbuf);
737 }
738 runtime->avail_min = params->avail_min;
739 return 0;
740}
741
742int snd_rawmidi_output_params(struct snd_rawmidi_substream *substream,
743 struct snd_rawmidi_params *params)
744{
745 int err;
746
747 snd_rawmidi_drain_output(substream);
748 guard(mutex)(T: &substream->rmidi->open_mutex);
749 if (substream->append && substream->use_count > 1)
750 return -EBUSY;
751 err = resize_runtime_buffer(substream, params, is_input: false);
752 if (!err)
753 substream->active_sensing = !params->no_active_sensing;
754 return err;
755}
756EXPORT_SYMBOL(snd_rawmidi_output_params);
757
758int snd_rawmidi_input_params(struct snd_rawmidi_substream *substream,
759 struct snd_rawmidi_params *params)
760{
761 unsigned int framing = params->mode & SNDRV_RAWMIDI_MODE_FRAMING_MASK;
762 unsigned int clock_type = params->mode & SNDRV_RAWMIDI_MODE_CLOCK_MASK;
763 int err;
764
765 snd_rawmidi_drain_input(substream);
766 guard(mutex)(T: &substream->rmidi->open_mutex);
767 if (framing == SNDRV_RAWMIDI_MODE_FRAMING_NONE && clock_type != SNDRV_RAWMIDI_MODE_CLOCK_NONE)
768 err = -EINVAL;
769 else if (clock_type > SNDRV_RAWMIDI_MODE_CLOCK_MONOTONIC_RAW)
770 err = -EINVAL;
771 else if (framing > SNDRV_RAWMIDI_MODE_FRAMING_TSTAMP)
772 err = -EINVAL;
773 else
774 err = resize_runtime_buffer(substream, params, is_input: true);
775
776 if (!err) {
777 substream->framing = framing;
778 substream->clock_type = clock_type;
779 }
780 return 0;
781}
782EXPORT_SYMBOL(snd_rawmidi_input_params);
783
784static int snd_rawmidi_output_status(struct snd_rawmidi_substream *substream,
785 struct snd_rawmidi_status64 *status)
786{
787 struct snd_rawmidi_runtime *runtime = substream->runtime;
788
789 memset(status, 0, sizeof(*status));
790 status->stream = SNDRV_RAWMIDI_STREAM_OUTPUT;
791 guard(spinlock_irq)(l: &substream->lock);
792 status->avail = runtime->avail;
793 return 0;
794}
795
796static int snd_rawmidi_input_status(struct snd_rawmidi_substream *substream,
797 struct snd_rawmidi_status64 *status)
798{
799 struct snd_rawmidi_runtime *runtime = substream->runtime;
800
801 memset(status, 0, sizeof(*status));
802 status->stream = SNDRV_RAWMIDI_STREAM_INPUT;
803 guard(spinlock_irq)(l: &substream->lock);
804 status->avail = runtime->avail;
805 status->xruns = runtime->xruns;
806 runtime->xruns = 0;
807 return 0;
808}
809
810static int snd_rawmidi_ioctl_status32(struct snd_rawmidi_file *rfile,
811 struct snd_rawmidi_status32 __user *argp)
812{
813 int err = 0;
814 struct snd_rawmidi_status32 __user *status = argp;
815 struct snd_rawmidi_status32 status32;
816 struct snd_rawmidi_status64 status64;
817
818 if (copy_from_user(to: &status32, from: argp,
819 n: sizeof(struct snd_rawmidi_status32)))
820 return -EFAULT;
821
822 switch (status32.stream) {
823 case SNDRV_RAWMIDI_STREAM_OUTPUT:
824 if (rfile->output == NULL)
825 return -EINVAL;
826 err = snd_rawmidi_output_status(substream: rfile->output, status: &status64);
827 break;
828 case SNDRV_RAWMIDI_STREAM_INPUT:
829 if (rfile->input == NULL)
830 return -EINVAL;
831 err = snd_rawmidi_input_status(substream: rfile->input, status: &status64);
832 break;
833 default:
834 return -EINVAL;
835 }
836 if (err < 0)
837 return err;
838
839 status32 = (struct snd_rawmidi_status32) {
840 .stream = status64.stream,
841 .tstamp_sec = status64.tstamp_sec,
842 .tstamp_nsec = status64.tstamp_nsec,
843 .avail = status64.avail,
844 .xruns = status64.xruns,
845 };
846
847 if (copy_to_user(to: status, from: &status32, n: sizeof(*status)))
848 return -EFAULT;
849
850 return 0;
851}
852
853static int snd_rawmidi_ioctl_status64(struct snd_rawmidi_file *rfile,
854 struct snd_rawmidi_status64 __user *argp)
855{
856 int err = 0;
857 struct snd_rawmidi_status64 status;
858
859 if (copy_from_user(to: &status, from: argp, n: sizeof(struct snd_rawmidi_status64)))
860 return -EFAULT;
861
862 switch (status.stream) {
863 case SNDRV_RAWMIDI_STREAM_OUTPUT:
864 if (rfile->output == NULL)
865 return -EINVAL;
866 err = snd_rawmidi_output_status(substream: rfile->output, status: &status);
867 break;
868 case SNDRV_RAWMIDI_STREAM_INPUT:
869 if (rfile->input == NULL)
870 return -EINVAL;
871 err = snd_rawmidi_input_status(substream: rfile->input, status: &status);
872 break;
873 default:
874 return -EINVAL;
875 }
876 if (err < 0)
877 return err;
878 if (copy_to_user(to: argp, from: &status,
879 n: sizeof(struct snd_rawmidi_status64)))
880 return -EFAULT;
881 return 0;
882}
883
884static long snd_rawmidi_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
885{
886 struct snd_rawmidi_file *rfile;
887 struct snd_rawmidi *rmidi;
888 void __user *argp = (void __user *)arg;
889
890 rfile = file->private_data;
891 if (((cmd >> 8) & 0xff) != 'W')
892 return -ENOTTY;
893 switch (cmd) {
894 case SNDRV_RAWMIDI_IOCTL_PVERSION:
895 return put_user(SNDRV_RAWMIDI_VERSION, (int __user *)argp) ? -EFAULT : 0;
896 case SNDRV_RAWMIDI_IOCTL_INFO:
897 {
898 int stream;
899 struct snd_rawmidi_info __user *info = argp;
900
901 if (get_user(stream, &info->stream))
902 return -EFAULT;
903 switch (stream) {
904 case SNDRV_RAWMIDI_STREAM_INPUT:
905 return snd_rawmidi_info_user(substream: rfile->input, info: info);
906 case SNDRV_RAWMIDI_STREAM_OUTPUT:
907 return snd_rawmidi_info_user(substream: rfile->output, info: info);
908 default:
909 return -EINVAL;
910 }
911 }
912 case SNDRV_RAWMIDI_IOCTL_USER_PVERSION:
913 if (get_user(rfile->user_pversion, (unsigned int __user *)arg))
914 return -EFAULT;
915 return 0;
916
917 case SNDRV_RAWMIDI_IOCTL_PARAMS:
918 {
919 struct snd_rawmidi_params params;
920
921 if (copy_from_user(to: &params, from: argp, n: sizeof(struct snd_rawmidi_params)))
922 return -EFAULT;
923 if (rfile->user_pversion < SNDRV_PROTOCOL_VERSION(2, 0, 2)) {
924 params.mode = 0;
925 memset(params.reserved, 0, sizeof(params.reserved));
926 }
927 switch (params.stream) {
928 case SNDRV_RAWMIDI_STREAM_OUTPUT:
929 if (rfile->output == NULL)
930 return -EINVAL;
931 return snd_rawmidi_output_params(rfile->output, &params);
932 case SNDRV_RAWMIDI_STREAM_INPUT:
933 if (rfile->input == NULL)
934 return -EINVAL;
935 return snd_rawmidi_input_params(rfile->input, &params);
936 default:
937 return -EINVAL;
938 }
939 }
940 case SNDRV_RAWMIDI_IOCTL_STATUS32:
941 return snd_rawmidi_ioctl_status32(rfile, argp);
942 case SNDRV_RAWMIDI_IOCTL_STATUS64:
943 return snd_rawmidi_ioctl_status64(rfile, argp);
944 case SNDRV_RAWMIDI_IOCTL_DROP:
945 {
946 int val;
947
948 if (get_user(val, (int __user *) argp))
949 return -EFAULT;
950 switch (val) {
951 case SNDRV_RAWMIDI_STREAM_OUTPUT:
952 if (rfile->output == NULL)
953 return -EINVAL;
954 return snd_rawmidi_drop_output(rfile->output);
955 default:
956 return -EINVAL;
957 }
958 }
959 case SNDRV_RAWMIDI_IOCTL_DRAIN:
960 {
961 int val;
962
963 if (get_user(val, (int __user *) argp))
964 return -EFAULT;
965 switch (val) {
966 case SNDRV_RAWMIDI_STREAM_OUTPUT:
967 if (rfile->output == NULL)
968 return -EINVAL;
969 return snd_rawmidi_drain_output(rfile->output);
970 case SNDRV_RAWMIDI_STREAM_INPUT:
971 if (rfile->input == NULL)
972 return -EINVAL;
973 return snd_rawmidi_drain_input(rfile->input);
974 default:
975 return -EINVAL;
976 }
977 }
978 default:
979 rmidi = rfile->rmidi;
980 if (rmidi->ops && rmidi->ops->ioctl)
981 return rmidi->ops->ioctl(rmidi, cmd, argp);
982 rmidi_dbg(rmidi, "rawmidi: unknown command = 0x%x\n", cmd);
983 }
984 return -ENOTTY;
985}
986
987/* ioctl to find the next device; either legacy or UMP depending on @find_ump */
988static int snd_rawmidi_next_device(struct snd_card *card, int __user *argp,
989 bool find_ump)
990
991{
992 struct snd_rawmidi *rmidi;
993 int device;
994 bool is_ump;
995
996 if (get_user(device, argp))
997 return -EFAULT;
998 if (device >= SNDRV_RAWMIDI_DEVICES) /* next device is -1 */
999 device = SNDRV_RAWMIDI_DEVICES - 1;
1000 scoped_guard(mutex, &register_mutex) {
1001 device = device < 0 ? 0 : device + 1;
1002 for (; device < SNDRV_RAWMIDI_DEVICES; device++) {
1003 rmidi = snd_rawmidi_search(card, device);
1004 if (!rmidi)
1005 continue;
1006 is_ump = rawmidi_is_ump(rmidi);
1007 if (find_ump == is_ump)
1008 break;
1009 }
1010 if (device == SNDRV_RAWMIDI_DEVICES)
1011 device = -1;
1012 }
1013 if (put_user(device, argp))
1014 return -EFAULT;
1015 return 0;
1016}
1017
1018#if IS_ENABLED(CONFIG_SND_UMP)
1019/* inquiry of UMP endpoint and block info via control API */
1020static int snd_rawmidi_call_ump_ioctl(struct snd_card *card, int cmd,
1021 void __user *argp)
1022{
1023 struct snd_ump_endpoint_info __user *info = argp;
1024 struct snd_rawmidi *rmidi;
1025 int device;
1026
1027 if (get_user(device, &info->device))
1028 return -EFAULT;
1029 guard(mutex)(T: &register_mutex);
1030 rmidi = snd_rawmidi_search(card, device);
1031 if (rmidi && rmidi->ops && rmidi->ops->ioctl)
1032 return rmidi->ops->ioctl(rmidi, cmd, argp);
1033 else
1034 return -ENXIO;
1035}
1036#endif
1037
1038static int snd_rawmidi_control_ioctl(struct snd_card *card,
1039 struct snd_ctl_file *control,
1040 unsigned int cmd,
1041 unsigned long arg)
1042{
1043 void __user *argp = (void __user *)arg;
1044
1045 switch (cmd) {
1046 case SNDRV_CTL_IOCTL_RAWMIDI_NEXT_DEVICE:
1047 return snd_rawmidi_next_device(card, argp, find_ump: false);
1048#if IS_ENABLED(CONFIG_SND_UMP)
1049 case SNDRV_CTL_IOCTL_UMP_NEXT_DEVICE:
1050 return snd_rawmidi_next_device(card, argp, find_ump: true);
1051 case SNDRV_CTL_IOCTL_UMP_ENDPOINT_INFO:
1052 return snd_rawmidi_call_ump_ioctl(card, SNDRV_UMP_IOCTL_ENDPOINT_INFO, argp);
1053 case SNDRV_CTL_IOCTL_UMP_BLOCK_INFO:
1054 return snd_rawmidi_call_ump_ioctl(card, SNDRV_UMP_IOCTL_BLOCK_INFO, argp);
1055#endif
1056 case SNDRV_CTL_IOCTL_RAWMIDI_PREFER_SUBDEVICE:
1057 {
1058 int val;
1059
1060 if (get_user(val, (int __user *)argp))
1061 return -EFAULT;
1062 control->preferred_subdevice[SND_CTL_SUBDEV_RAWMIDI] = val;
1063 return 0;
1064 }
1065 case SNDRV_CTL_IOCTL_RAWMIDI_INFO:
1066 return snd_rawmidi_info_select_user(card, info: argp);
1067 }
1068 return -ENOIOCTLCMD;
1069}
1070
1071static int receive_with_tstamp_framing(struct snd_rawmidi_substream *substream,
1072 const unsigned char *buffer, int src_count, const struct timespec64 *tstamp)
1073{
1074 struct snd_rawmidi_runtime *runtime = substream->runtime;
1075 struct snd_rawmidi_framing_tstamp *dest_ptr;
1076 struct snd_rawmidi_framing_tstamp frame = { .tv_sec = tstamp->tv_sec, .tv_nsec = tstamp->tv_nsec };
1077 int orig_count = src_count;
1078 int frame_size = sizeof(struct snd_rawmidi_framing_tstamp);
1079 int align = get_align(runtime);
1080
1081 BUILD_BUG_ON(frame_size != 0x20);
1082 if (snd_BUG_ON((runtime->hw_ptr & 0x1f) != 0))
1083 return -EINVAL;
1084
1085 while (src_count > align) {
1086 if ((int)(runtime->buffer_size - runtime->avail) < frame_size) {
1087 runtime->xruns += src_count;
1088 break;
1089 }
1090 if (src_count >= SNDRV_RAWMIDI_FRAMING_DATA_LENGTH)
1091 frame.length = SNDRV_RAWMIDI_FRAMING_DATA_LENGTH;
1092 else {
1093 frame.length = get_aligned_size(runtime, src_count);
1094 if (!frame.length)
1095 break;
1096 memset(frame.data, 0, SNDRV_RAWMIDI_FRAMING_DATA_LENGTH);
1097 }
1098 memcpy(frame.data, buffer, frame.length);
1099 buffer += frame.length;
1100 src_count -= frame.length;
1101 dest_ptr = (struct snd_rawmidi_framing_tstamp *) (runtime->buffer + runtime->hw_ptr);
1102 *dest_ptr = frame;
1103 runtime->avail += frame_size;
1104 runtime->hw_ptr += frame_size;
1105 runtime->hw_ptr %= runtime->buffer_size;
1106 }
1107 return orig_count - src_count;
1108}
1109
1110static struct timespec64 get_framing_tstamp(struct snd_rawmidi_substream *substream)
1111{
1112 struct timespec64 ts64 = {0, 0};
1113
1114 switch (substream->clock_type) {
1115 case SNDRV_RAWMIDI_MODE_CLOCK_MONOTONIC_RAW:
1116 ktime_get_raw_ts64(ts: &ts64);
1117 break;
1118 case SNDRV_RAWMIDI_MODE_CLOCK_MONOTONIC:
1119 ktime_get_ts64(ts: &ts64);
1120 break;
1121 case SNDRV_RAWMIDI_MODE_CLOCK_REALTIME:
1122 ktime_get_real_ts64(tv: &ts64);
1123 break;
1124 }
1125 return ts64;
1126}
1127
1128/**
1129 * snd_rawmidi_receive - receive the input data from the device
1130 * @substream: the rawmidi substream
1131 * @buffer: the buffer pointer
1132 * @count: the data size to read
1133 *
1134 * Reads the data from the internal buffer.
1135 *
1136 * Return: The size of read data, or a negative error code on failure.
1137 */
1138int snd_rawmidi_receive(struct snd_rawmidi_substream *substream,
1139 const unsigned char *buffer, int count)
1140{
1141 struct timespec64 ts64 = get_framing_tstamp(substream);
1142 int result = 0, count1;
1143 struct snd_rawmidi_runtime *runtime;
1144
1145 guard(spinlock_irqsave)(l: &substream->lock);
1146 if (!substream->opened)
1147 return -EBADFD;
1148 runtime = substream->runtime;
1149 if (!runtime || !runtime->buffer) {
1150 rmidi_dbg(substream->rmidi,
1151 "snd_rawmidi_receive: input is not active!!!\n");
1152 return -EINVAL;
1153 }
1154
1155 count = get_aligned_size(runtime, count);
1156 if (!count)
1157 return result;
1158
1159 if (substream->framing == SNDRV_RAWMIDI_MODE_FRAMING_TSTAMP) {
1160 result = receive_with_tstamp_framing(substream, buffer, src_count: count, tstamp: &ts64);
1161 } else if (count == 1) { /* special case, faster code */
1162 substream->bytes++;
1163 if (runtime->avail < runtime->buffer_size) {
1164 runtime->buffer[runtime->hw_ptr++] = buffer[0];
1165 runtime->hw_ptr %= runtime->buffer_size;
1166 runtime->avail++;
1167 result++;
1168 } else {
1169 runtime->xruns++;
1170 }
1171 } else {
1172 substream->bytes += count;
1173 count1 = runtime->buffer_size - runtime->hw_ptr;
1174 if (count1 > count)
1175 count1 = count;
1176 if (count1 > (int)(runtime->buffer_size - runtime->avail))
1177 count1 = runtime->buffer_size - runtime->avail;
1178 count1 = get_aligned_size(runtime, count1);
1179 if (!count1)
1180 return result;
1181 memcpy(runtime->buffer + runtime->hw_ptr, buffer, count1);
1182 runtime->hw_ptr += count1;
1183 runtime->hw_ptr %= runtime->buffer_size;
1184 runtime->avail += count1;
1185 count -= count1;
1186 result += count1;
1187 if (count > 0) {
1188 buffer += count1;
1189 count1 = count;
1190 if (count1 > (int)(runtime->buffer_size - runtime->avail)) {
1191 count1 = runtime->buffer_size - runtime->avail;
1192 runtime->xruns += count - count1;
1193 }
1194 if (count1 > 0) {
1195 memcpy(runtime->buffer, buffer, count1);
1196 runtime->hw_ptr = count1;
1197 runtime->avail += count1;
1198 result += count1;
1199 }
1200 }
1201 }
1202 if (result > 0) {
1203 if (runtime->event)
1204 schedule_work(work: &runtime->event_work);
1205 else if (__snd_rawmidi_ready(runtime))
1206 wake_up(&runtime->sleep);
1207 }
1208 return result;
1209}
1210EXPORT_SYMBOL(snd_rawmidi_receive);
1211
1212static long snd_rawmidi_kernel_read1(struct snd_rawmidi_substream *substream,
1213 unsigned char __user *userbuf,
1214 unsigned char *kernelbuf, long count)
1215{
1216 unsigned long flags;
1217 long result = 0, count1;
1218 struct snd_rawmidi_runtime *runtime = substream->runtime;
1219 unsigned long appl_ptr;
1220 int err = 0;
1221
1222 spin_lock_irqsave(&substream->lock, flags);
1223 snd_rawmidi_buffer_ref(runtime);
1224 while (count > 0 && runtime->avail) {
1225 count1 = runtime->buffer_size - runtime->appl_ptr;
1226 if (count1 > count)
1227 count1 = count;
1228 if (count1 > (int)runtime->avail)
1229 count1 = runtime->avail;
1230
1231 /* update runtime->appl_ptr before unlocking for userbuf */
1232 appl_ptr = runtime->appl_ptr;
1233 runtime->appl_ptr += count1;
1234 runtime->appl_ptr %= runtime->buffer_size;
1235 runtime->avail -= count1;
1236
1237 if (kernelbuf)
1238 memcpy(kernelbuf + result, runtime->buffer + appl_ptr, count1);
1239 if (userbuf) {
1240 spin_unlock_irqrestore(lock: &substream->lock, flags);
1241 if (copy_to_user(to: userbuf + result,
1242 from: runtime->buffer + appl_ptr, n: count1))
1243 err = -EFAULT;
1244 spin_lock_irqsave(&substream->lock, flags);
1245 if (err)
1246 goto out;
1247 }
1248 result += count1;
1249 count -= count1;
1250 }
1251 out:
1252 snd_rawmidi_buffer_unref(runtime);
1253 spin_unlock_irqrestore(lock: &substream->lock, flags);
1254 return result > 0 ? result : err;
1255}
1256
1257long snd_rawmidi_kernel_read(struct snd_rawmidi_substream *substream,
1258 unsigned char *buf, long count)
1259{
1260 snd_rawmidi_input_trigger(substream, up: 1);
1261 return snd_rawmidi_kernel_read1(substream, NULL/*userbuf*/, kernelbuf: buf, count);
1262}
1263EXPORT_SYMBOL(snd_rawmidi_kernel_read);
1264
1265static ssize_t snd_rawmidi_read(struct file *file, char __user *buf, size_t count,
1266 loff_t *offset)
1267{
1268 long result;
1269 int count1;
1270 struct snd_rawmidi_file *rfile;
1271 struct snd_rawmidi_substream *substream;
1272 struct snd_rawmidi_runtime *runtime;
1273
1274 rfile = file->private_data;
1275 substream = rfile->input;
1276 if (substream == NULL)
1277 return -EIO;
1278 runtime = substream->runtime;
1279 snd_rawmidi_input_trigger(substream, up: 1);
1280 result = 0;
1281 while (count > 0) {
1282 spin_lock_irq(lock: &substream->lock);
1283 while (!__snd_rawmidi_ready(runtime)) {
1284 wait_queue_entry_t wait;
1285
1286 if ((file->f_flags & O_NONBLOCK) != 0 || result > 0) {
1287 spin_unlock_irq(lock: &substream->lock);
1288 return result > 0 ? result : -EAGAIN;
1289 }
1290 init_waitqueue_entry(wq_entry: &wait, current);
1291 add_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1292 set_current_state(TASK_INTERRUPTIBLE);
1293 spin_unlock_irq(lock: &substream->lock);
1294 schedule();
1295 remove_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1296 if (rfile->rmidi->card->shutdown)
1297 return -ENODEV;
1298 if (signal_pending(current))
1299 return result > 0 ? result : -ERESTARTSYS;
1300 spin_lock_irq(lock: &substream->lock);
1301 if (!runtime->avail) {
1302 spin_unlock_irq(lock: &substream->lock);
1303 return result > 0 ? result : -EIO;
1304 }
1305 }
1306 spin_unlock_irq(lock: &substream->lock);
1307 count1 = snd_rawmidi_kernel_read1(substream,
1308 userbuf: (unsigned char __user *)buf,
1309 NULL/*kernelbuf*/,
1310 count);
1311 if (count1 < 0)
1312 return result > 0 ? result : count1;
1313 result += count1;
1314 buf += count1;
1315 count -= count1;
1316 }
1317 return result;
1318}
1319
1320/**
1321 * snd_rawmidi_transmit_empty - check whether the output buffer is empty
1322 * @substream: the rawmidi substream
1323 *
1324 * Return: 1 if the internal output buffer is empty, 0 if not.
1325 */
1326int snd_rawmidi_transmit_empty(struct snd_rawmidi_substream *substream)
1327{
1328 struct snd_rawmidi_runtime *runtime;
1329
1330 guard(spinlock_irqsave)(l: &substream->lock);
1331 runtime = substream->runtime;
1332 if (!substream->opened || !runtime || !runtime->buffer) {
1333 rmidi_dbg(substream->rmidi,
1334 "snd_rawmidi_transmit_empty: output is not active!!!\n");
1335 return 1;
1336 }
1337 return (runtime->avail >= runtime->buffer_size);
1338}
1339EXPORT_SYMBOL(snd_rawmidi_transmit_empty);
1340
1341/*
1342 * __snd_rawmidi_transmit_peek - copy data from the internal buffer
1343 * @substream: the rawmidi substream
1344 * @buffer: the buffer pointer
1345 * @count: data size to transfer
1346 *
1347 * This is a variant of snd_rawmidi_transmit_peek() without spinlock.
1348 */
1349static int __snd_rawmidi_transmit_peek(struct snd_rawmidi_substream *substream,
1350 unsigned char *buffer, int count)
1351{
1352 int result, count1;
1353 struct snd_rawmidi_runtime *runtime = substream->runtime;
1354
1355 if (runtime->buffer == NULL) {
1356 rmidi_dbg(substream->rmidi,
1357 "snd_rawmidi_transmit_peek: output is not active!!!\n");
1358 return -EINVAL;
1359 }
1360 result = 0;
1361 if (runtime->avail >= runtime->buffer_size) {
1362 /* warning: lowlevel layer MUST trigger down the hardware */
1363 goto __skip;
1364 }
1365 if (count == 1) { /* special case, faster code */
1366 *buffer = runtime->buffer[runtime->hw_ptr];
1367 result++;
1368 } else {
1369 count1 = runtime->buffer_size - runtime->hw_ptr;
1370 if (count1 > count)
1371 count1 = count;
1372 if (count1 > (int)(runtime->buffer_size - runtime->avail))
1373 count1 = runtime->buffer_size - runtime->avail;
1374 count1 = get_aligned_size(runtime, count1);
1375 if (!count1)
1376 goto __skip;
1377 memcpy(buffer, runtime->buffer + runtime->hw_ptr, count1);
1378 count -= count1;
1379 result += count1;
1380 if (count > 0) {
1381 if (count > (int)(runtime->buffer_size - runtime->avail - count1))
1382 count = runtime->buffer_size - runtime->avail - count1;
1383 count = get_aligned_size(runtime, count);
1384 if (!count)
1385 goto __skip;
1386 memcpy(buffer + count1, runtime->buffer, count);
1387 result += count;
1388 }
1389 }
1390 __skip:
1391 return result;
1392}
1393
1394/**
1395 * snd_rawmidi_transmit_peek - copy data from the internal buffer
1396 * @substream: the rawmidi substream
1397 * @buffer: the buffer pointer
1398 * @count: data size to transfer
1399 *
1400 * Copies data from the internal output buffer to the given buffer.
1401 *
1402 * Call this in the interrupt handler when the midi output is ready,
1403 * and call snd_rawmidi_transmit_ack() after the transmission is
1404 * finished.
1405 *
1406 * Return: The size of copied data, or a negative error code on failure.
1407 */
1408int snd_rawmidi_transmit_peek(struct snd_rawmidi_substream *substream,
1409 unsigned char *buffer, int count)
1410{
1411 guard(spinlock_irqsave)(l: &substream->lock);
1412 if (!substream->opened || !substream->runtime)
1413 return -EBADFD;
1414 return __snd_rawmidi_transmit_peek(substream, buffer, count);
1415}
1416EXPORT_SYMBOL(snd_rawmidi_transmit_peek);
1417
1418/*
1419 * __snd_rawmidi_transmit_ack - acknowledge the transmission
1420 * @substream: the rawmidi substream
1421 * @count: the transferred count
1422 *
1423 * This is a variant of __snd_rawmidi_transmit_ack() without spinlock.
1424 */
1425static int __snd_rawmidi_transmit_ack(struct snd_rawmidi_substream *substream,
1426 int count)
1427{
1428 struct snd_rawmidi_runtime *runtime = substream->runtime;
1429
1430 if (runtime->buffer == NULL) {
1431 rmidi_dbg(substream->rmidi,
1432 "snd_rawmidi_transmit_ack: output is not active!!!\n");
1433 return -EINVAL;
1434 }
1435 snd_BUG_ON(runtime->avail + count > runtime->buffer_size);
1436 count = get_aligned_size(runtime, count);
1437 runtime->hw_ptr += count;
1438 runtime->hw_ptr %= runtime->buffer_size;
1439 runtime->avail += count;
1440 substream->bytes += count;
1441 if (count > 0) {
1442 if (runtime->drain || __snd_rawmidi_ready(runtime))
1443 wake_up(&runtime->sleep);
1444 }
1445 return count;
1446}
1447
1448/**
1449 * snd_rawmidi_transmit_ack - acknowledge the transmission
1450 * @substream: the rawmidi substream
1451 * @count: the transferred count
1452 *
1453 * Advances the hardware pointer for the internal output buffer with
1454 * the given size and updates the condition.
1455 * Call after the transmission is finished.
1456 *
1457 * Return: The advanced size if successful, or a negative error code on failure.
1458 */
1459int snd_rawmidi_transmit_ack(struct snd_rawmidi_substream *substream, int count)
1460{
1461 guard(spinlock_irqsave)(l: &substream->lock);
1462 if (!substream->opened || !substream->runtime)
1463 return -EBADFD;
1464 return __snd_rawmidi_transmit_ack(substream, count);
1465}
1466EXPORT_SYMBOL(snd_rawmidi_transmit_ack);
1467
1468/**
1469 * snd_rawmidi_transmit - copy from the buffer to the device
1470 * @substream: the rawmidi substream
1471 * @buffer: the buffer pointer
1472 * @count: the data size to transfer
1473 *
1474 * Copies data from the buffer to the device and advances the pointer.
1475 *
1476 * Return: The copied size if successful, or a negative error code on failure.
1477 */
1478int snd_rawmidi_transmit(struct snd_rawmidi_substream *substream,
1479 unsigned char *buffer, int count)
1480{
1481 guard(spinlock_irqsave)(l: &substream->lock);
1482 if (!substream->opened)
1483 return -EBADFD;
1484 count = __snd_rawmidi_transmit_peek(substream, buffer, count);
1485 if (count <= 0)
1486 return count;
1487 return __snd_rawmidi_transmit_ack(substream, count);
1488}
1489EXPORT_SYMBOL(snd_rawmidi_transmit);
1490
1491/**
1492 * snd_rawmidi_proceed - Discard the all pending bytes and proceed
1493 * @substream: rawmidi substream
1494 *
1495 * Return: the number of discarded bytes
1496 */
1497int snd_rawmidi_proceed(struct snd_rawmidi_substream *substream)
1498{
1499 struct snd_rawmidi_runtime *runtime;
1500 int count = 0;
1501
1502 guard(spinlock_irqsave)(l: &substream->lock);
1503 runtime = substream->runtime;
1504 if (substream->opened && runtime &&
1505 runtime->avail < runtime->buffer_size) {
1506 count = runtime->buffer_size - runtime->avail;
1507 __snd_rawmidi_transmit_ack(substream, count);
1508 }
1509 return count;
1510}
1511EXPORT_SYMBOL(snd_rawmidi_proceed);
1512
1513static long snd_rawmidi_kernel_write1(struct snd_rawmidi_substream *substream,
1514 const unsigned char __user *userbuf,
1515 const unsigned char *kernelbuf,
1516 long count)
1517{
1518 unsigned long flags;
1519 long count1, result;
1520 struct snd_rawmidi_runtime *runtime = substream->runtime;
1521 unsigned long appl_ptr;
1522
1523 if (!kernelbuf && !userbuf)
1524 return -EINVAL;
1525 if (snd_BUG_ON(!runtime->buffer))
1526 return -EINVAL;
1527
1528 result = 0;
1529 spin_lock_irqsave(&substream->lock, flags);
1530 if (substream->append) {
1531 if ((long)runtime->avail < count) {
1532 spin_unlock_irqrestore(lock: &substream->lock, flags);
1533 return -EAGAIN;
1534 }
1535 }
1536 snd_rawmidi_buffer_ref(runtime);
1537 while (count > 0 && runtime->avail > 0) {
1538 count1 = runtime->buffer_size - runtime->appl_ptr;
1539 if (count1 > count)
1540 count1 = count;
1541 if (count1 > (long)runtime->avail)
1542 count1 = runtime->avail;
1543
1544 /* update runtime->appl_ptr before unlocking for userbuf */
1545 appl_ptr = runtime->appl_ptr;
1546 runtime->appl_ptr += count1;
1547 runtime->appl_ptr %= runtime->buffer_size;
1548 runtime->avail -= count1;
1549
1550 if (kernelbuf)
1551 memcpy(runtime->buffer + appl_ptr,
1552 kernelbuf + result, count1);
1553 else if (userbuf) {
1554 spin_unlock_irqrestore(lock: &substream->lock, flags);
1555 if (copy_from_user(to: runtime->buffer + appl_ptr,
1556 from: userbuf + result, n: count1)) {
1557 spin_lock_irqsave(&substream->lock, flags);
1558 result = result > 0 ? result : -EFAULT;
1559 goto __end;
1560 }
1561 spin_lock_irqsave(&substream->lock, flags);
1562 }
1563 result += count1;
1564 count -= count1;
1565 }
1566 __end:
1567 count1 = runtime->avail < runtime->buffer_size;
1568 snd_rawmidi_buffer_unref(runtime);
1569 spin_unlock_irqrestore(lock: &substream->lock, flags);
1570 if (count1)
1571 snd_rawmidi_output_trigger(substream, up: 1);
1572 return result;
1573}
1574
1575long snd_rawmidi_kernel_write(struct snd_rawmidi_substream *substream,
1576 const unsigned char *buf, long count)
1577{
1578 return snd_rawmidi_kernel_write1(substream, NULL, kernelbuf: buf, count);
1579}
1580EXPORT_SYMBOL(snd_rawmidi_kernel_write);
1581
1582static ssize_t snd_rawmidi_write(struct file *file, const char __user *buf,
1583 size_t count, loff_t *offset)
1584{
1585 long result, timeout;
1586 int count1;
1587 struct snd_rawmidi_file *rfile;
1588 struct snd_rawmidi_runtime *runtime;
1589 struct snd_rawmidi_substream *substream;
1590
1591 rfile = file->private_data;
1592 substream = rfile->output;
1593 runtime = substream->runtime;
1594 /* we cannot put an atomic message to our buffer */
1595 if (substream->append && count > runtime->buffer_size)
1596 return -EIO;
1597 result = 0;
1598 while (count > 0) {
1599 spin_lock_irq(lock: &substream->lock);
1600 while (!snd_rawmidi_ready_append(substream, count)) {
1601 wait_queue_entry_t wait;
1602
1603 if (file->f_flags & O_NONBLOCK) {
1604 spin_unlock_irq(lock: &substream->lock);
1605 return result > 0 ? result : -EAGAIN;
1606 }
1607 init_waitqueue_entry(wq_entry: &wait, current);
1608 add_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1609 set_current_state(TASK_INTERRUPTIBLE);
1610 spin_unlock_irq(lock: &substream->lock);
1611 timeout = schedule_timeout(timeout: 30 * HZ);
1612 remove_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1613 if (rfile->rmidi->card->shutdown)
1614 return -ENODEV;
1615 if (signal_pending(current))
1616 return result > 0 ? result : -ERESTARTSYS;
1617 spin_lock_irq(lock: &substream->lock);
1618 if (!runtime->avail && !timeout) {
1619 spin_unlock_irq(lock: &substream->lock);
1620 return result > 0 ? result : -EIO;
1621 }
1622 }
1623 spin_unlock_irq(lock: &substream->lock);
1624 count1 = snd_rawmidi_kernel_write1(substream, userbuf: buf, NULL, count);
1625 if (count1 < 0)
1626 return result > 0 ? result : count1;
1627 result += count1;
1628 buf += count1;
1629 if ((size_t)count1 < count && (file->f_flags & O_NONBLOCK))
1630 break;
1631 count -= count1;
1632 }
1633 if (file->f_flags & O_DSYNC) {
1634 spin_lock_irq(lock: &substream->lock);
1635 while (runtime->avail != runtime->buffer_size) {
1636 wait_queue_entry_t wait;
1637 unsigned int last_avail = runtime->avail;
1638
1639 init_waitqueue_entry(wq_entry: &wait, current);
1640 add_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1641 set_current_state(TASK_INTERRUPTIBLE);
1642 spin_unlock_irq(lock: &substream->lock);
1643 timeout = schedule_timeout(timeout: 30 * HZ);
1644 remove_wait_queue(wq_head: &runtime->sleep, wq_entry: &wait);
1645 if (signal_pending(current))
1646 return result > 0 ? result : -ERESTARTSYS;
1647 if (runtime->avail == last_avail && !timeout)
1648 return result > 0 ? result : -EIO;
1649 spin_lock_irq(lock: &substream->lock);
1650 }
1651 spin_unlock_irq(lock: &substream->lock);
1652 }
1653 return result;
1654}
1655
1656static __poll_t snd_rawmidi_poll(struct file *file, poll_table *wait)
1657{
1658 struct snd_rawmidi_file *rfile;
1659 struct snd_rawmidi_runtime *runtime;
1660 __poll_t mask;
1661
1662 rfile = file->private_data;
1663 if (rfile->input != NULL) {
1664 runtime = rfile->input->runtime;
1665 snd_rawmidi_input_trigger(substream: rfile->input, up: 1);
1666 poll_wait(filp: file, wait_address: &runtime->sleep, p: wait);
1667 }
1668 if (rfile->output != NULL) {
1669 runtime = rfile->output->runtime;
1670 poll_wait(filp: file, wait_address: &runtime->sleep, p: wait);
1671 }
1672 mask = 0;
1673 if (rfile->input != NULL) {
1674 if (snd_rawmidi_ready(substream: rfile->input))
1675 mask |= EPOLLIN | EPOLLRDNORM;
1676 }
1677 if (rfile->output != NULL) {
1678 if (snd_rawmidi_ready(substream: rfile->output))
1679 mask |= EPOLLOUT | EPOLLWRNORM;
1680 }
1681 return mask;
1682}
1683
1684/*
1685 */
1686#ifdef CONFIG_COMPAT
1687#include "rawmidi_compat.c"
1688#else
1689#define snd_rawmidi_ioctl_compat NULL
1690#endif
1691
1692/*
1693 */
1694
1695static void snd_rawmidi_proc_info_read(struct snd_info_entry *entry,
1696 struct snd_info_buffer *buffer)
1697{
1698 struct snd_rawmidi *rmidi;
1699 struct snd_rawmidi_substream *substream;
1700 struct snd_rawmidi_runtime *runtime;
1701 unsigned long buffer_size, avail, xruns;
1702 unsigned int clock_type;
1703 static const char *clock_names[4] = { "none", "realtime", "monotonic", "monotonic raw" };
1704
1705 rmidi = entry->private_data;
1706 snd_iprintf(buffer, "%s\n\n", rmidi->name);
1707 if (IS_ENABLED(CONFIG_SND_UMP))
1708 snd_iprintf(buffer, "Type: %s\n",
1709 rawmidi_is_ump(rmidi) ? "UMP" : "Legacy");
1710 if (rmidi->ops && rmidi->ops->proc_read)
1711 rmidi->ops->proc_read(entry, buffer);
1712 guard(mutex)(T: &rmidi->open_mutex);
1713 if (rmidi->info_flags & SNDRV_RAWMIDI_INFO_OUTPUT) {
1714 list_for_each_entry(substream,
1715 &rmidi->streams[SNDRV_RAWMIDI_STREAM_OUTPUT].substreams,
1716 list) {
1717 snd_iprintf(buffer,
1718 "Output %d\n"
1719 " Tx bytes : %lu\n",
1720 substream->number,
1721 (unsigned long) substream->bytes);
1722 if (substream->opened) {
1723 snd_iprintf(buffer,
1724 " Owner PID : %d\n",
1725 pid_vnr(substream->pid));
1726 runtime = substream->runtime;
1727 scoped_guard(spinlock_irq, &substream->lock) {
1728 buffer_size = runtime->buffer_size;
1729 avail = runtime->avail;
1730 }
1731 snd_iprintf(buffer,
1732 " Mode : %s\n"
1733 " Buffer size : %lu\n"
1734 " Avail : %lu\n",
1735 runtime->oss ? "OSS compatible" : "native",
1736 buffer_size, avail);
1737 }
1738 }
1739 }
1740 if (rmidi->info_flags & SNDRV_RAWMIDI_INFO_INPUT) {
1741 list_for_each_entry(substream,
1742 &rmidi->streams[SNDRV_RAWMIDI_STREAM_INPUT].substreams,
1743 list) {
1744 snd_iprintf(buffer,
1745 "Input %d\n"
1746 " Rx bytes : %lu\n",
1747 substream->number,
1748 (unsigned long) substream->bytes);
1749 if (substream->opened) {
1750 snd_iprintf(buffer,
1751 " Owner PID : %d\n",
1752 pid_vnr(substream->pid));
1753 runtime = substream->runtime;
1754 scoped_guard(spinlock_irq, &substream->lock) {
1755 buffer_size = runtime->buffer_size;
1756 avail = runtime->avail;
1757 xruns = runtime->xruns;
1758 }
1759 snd_iprintf(buffer,
1760 " Buffer size : %lu\n"
1761 " Avail : %lu\n"
1762 " Overruns : %lu\n",
1763 buffer_size, avail, xruns);
1764 if (substream->framing == SNDRV_RAWMIDI_MODE_FRAMING_TSTAMP) {
1765 clock_type = substream->clock_type >> SNDRV_RAWMIDI_MODE_CLOCK_SHIFT;
1766 if (!snd_BUG_ON(clock_type >= ARRAY_SIZE(clock_names)))
1767 snd_iprintf(buffer,
1768 " Framing : tstamp\n"
1769 " Clock type : %s\n",
1770 clock_names[clock_type]);
1771 }
1772 }
1773 }
1774 }
1775}
1776
1777/*
1778 * Register functions
1779 */
1780
1781static const struct file_operations snd_rawmidi_f_ops = {
1782 .owner = THIS_MODULE,
1783 .read = snd_rawmidi_read,
1784 .write = snd_rawmidi_write,
1785 .open = snd_rawmidi_open,
1786 .release = snd_rawmidi_release,
1787 .llseek = no_llseek,
1788 .poll = snd_rawmidi_poll,
1789 .unlocked_ioctl = snd_rawmidi_ioctl,
1790 .compat_ioctl = snd_rawmidi_ioctl_compat,
1791};
1792
1793static int snd_rawmidi_alloc_substreams(struct snd_rawmidi *rmidi,
1794 struct snd_rawmidi_str *stream,
1795 int direction,
1796 int count)
1797{
1798 struct snd_rawmidi_substream *substream;
1799 int idx;
1800
1801 for (idx = 0; idx < count; idx++) {
1802 substream = kzalloc(size: sizeof(*substream), GFP_KERNEL);
1803 if (!substream)
1804 return -ENOMEM;
1805 substream->stream = direction;
1806 substream->number = idx;
1807 substream->rmidi = rmidi;
1808 substream->pstr = stream;
1809 spin_lock_init(&substream->lock);
1810 list_add_tail(new: &substream->list, head: &stream->substreams);
1811 stream->substream_count++;
1812 }
1813 return 0;
1814}
1815
1816/* used for both rawmidi and ump */
1817int snd_rawmidi_init(struct snd_rawmidi *rmidi,
1818 struct snd_card *card, char *id, int device,
1819 int output_count, int input_count,
1820 unsigned int info_flags)
1821{
1822 int err;
1823 static const struct snd_device_ops ops = {
1824 .dev_free = snd_rawmidi_dev_free,
1825 .dev_register = snd_rawmidi_dev_register,
1826 .dev_disconnect = snd_rawmidi_dev_disconnect,
1827 };
1828
1829 rmidi->card = card;
1830 rmidi->device = device;
1831 mutex_init(&rmidi->open_mutex);
1832 init_waitqueue_head(&rmidi->open_wait);
1833 INIT_LIST_HEAD(list: &rmidi->streams[SNDRV_RAWMIDI_STREAM_INPUT].substreams);
1834 INIT_LIST_HEAD(list: &rmidi->streams[SNDRV_RAWMIDI_STREAM_OUTPUT].substreams);
1835 rmidi->info_flags = info_flags;
1836
1837 if (id != NULL)
1838 strscpy(rmidi->id, id, sizeof(rmidi->id));
1839
1840 err = snd_device_alloc(dev_p: &rmidi->dev, card);
1841 if (err < 0)
1842 return err;
1843 if (rawmidi_is_ump(rmidi))
1844 dev_set_name(dev: rmidi->dev, name: "umpC%iD%i", card->number, device);
1845 else
1846 dev_set_name(dev: rmidi->dev, name: "midiC%iD%i", card->number, device);
1847
1848 err = snd_rawmidi_alloc_substreams(rmidi,
1849 stream: &rmidi->streams[SNDRV_RAWMIDI_STREAM_INPUT],
1850 direction: SNDRV_RAWMIDI_STREAM_INPUT,
1851 count: input_count);
1852 if (err < 0)
1853 return err;
1854 err = snd_rawmidi_alloc_substreams(rmidi,
1855 stream: &rmidi->streams[SNDRV_RAWMIDI_STREAM_OUTPUT],
1856 direction: SNDRV_RAWMIDI_STREAM_OUTPUT,
1857 count: output_count);
1858 if (err < 0)
1859 return err;
1860 err = snd_device_new(card, type: SNDRV_DEV_RAWMIDI, device_data: rmidi, ops: &ops);
1861 if (err < 0)
1862 return err;
1863 return 0;
1864}
1865EXPORT_SYMBOL_GPL(snd_rawmidi_init);
1866
1867/**
1868 * snd_rawmidi_new - create a rawmidi instance
1869 * @card: the card instance
1870 * @id: the id string
1871 * @device: the device index
1872 * @output_count: the number of output streams
1873 * @input_count: the number of input streams
1874 * @rrawmidi: the pointer to store the new rawmidi instance
1875 *
1876 * Creates a new rawmidi instance.
1877 * Use snd_rawmidi_set_ops() to set the operators to the new instance.
1878 *
1879 * Return: Zero if successful, or a negative error code on failure.
1880 */
1881int snd_rawmidi_new(struct snd_card *card, char *id, int device,
1882 int output_count, int input_count,
1883 struct snd_rawmidi **rrawmidi)
1884{
1885 struct snd_rawmidi *rmidi;
1886 int err;
1887
1888 if (rrawmidi)
1889 *rrawmidi = NULL;
1890 rmidi = kzalloc(size: sizeof(*rmidi), GFP_KERNEL);
1891 if (!rmidi)
1892 return -ENOMEM;
1893 err = snd_rawmidi_init(rmidi, card, id, device,
1894 output_count, input_count, 0);
1895 if (err < 0) {
1896 snd_rawmidi_free(rmidi);
1897 return err;
1898 }
1899 if (rrawmidi)
1900 *rrawmidi = rmidi;
1901 return 0;
1902}
1903EXPORT_SYMBOL(snd_rawmidi_new);
1904
1905static void snd_rawmidi_free_substreams(struct snd_rawmidi_str *stream)
1906{
1907 struct snd_rawmidi_substream *substream;
1908
1909 while (!list_empty(head: &stream->substreams)) {
1910 substream = list_entry(stream->substreams.next, struct snd_rawmidi_substream, list);
1911 list_del(entry: &substream->list);
1912 kfree(objp: substream);
1913 }
1914}
1915
1916/* called from ump.c, too */
1917int snd_rawmidi_free(struct snd_rawmidi *rmidi)
1918{
1919 if (!rmidi)
1920 return 0;
1921
1922 snd_info_free_entry(entry: rmidi->proc_entry);
1923 rmidi->proc_entry = NULL;
1924 if (rmidi->ops && rmidi->ops->dev_unregister)
1925 rmidi->ops->dev_unregister(rmidi);
1926
1927 snd_rawmidi_free_substreams(stream: &rmidi->streams[SNDRV_RAWMIDI_STREAM_INPUT]);
1928 snd_rawmidi_free_substreams(stream: &rmidi->streams[SNDRV_RAWMIDI_STREAM_OUTPUT]);
1929 if (rmidi->private_free)
1930 rmidi->private_free(rmidi);
1931 put_device(dev: rmidi->dev);
1932 kfree(objp: rmidi);
1933 return 0;
1934}
1935EXPORT_SYMBOL_GPL(snd_rawmidi_free);
1936
1937static int snd_rawmidi_dev_free(struct snd_device *device)
1938{
1939 struct snd_rawmidi *rmidi = device->device_data;
1940
1941 return snd_rawmidi_free(rmidi);
1942}
1943
1944#if IS_ENABLED(CONFIG_SND_SEQUENCER)
1945static void snd_rawmidi_dev_seq_free(struct snd_seq_device *device)
1946{
1947 struct snd_rawmidi *rmidi = device->private_data;
1948
1949 rmidi->seq_dev = NULL;
1950}
1951#endif
1952
1953static int snd_rawmidi_dev_register(struct snd_device *device)
1954{
1955 int err;
1956 struct snd_info_entry *entry;
1957 char name[16];
1958 struct snd_rawmidi *rmidi = device->device_data;
1959
1960 if (rmidi->device >= SNDRV_RAWMIDI_DEVICES)
1961 return -ENOMEM;
1962 err = 0;
1963 scoped_guard(mutex, &register_mutex) {
1964 if (snd_rawmidi_search(card: rmidi->card, device: rmidi->device))
1965 err = -EBUSY;
1966 else
1967 list_add_tail(new: &rmidi->list, head: &snd_rawmidi_devices);
1968 }
1969 if (err < 0)
1970 return err;
1971
1972 err = snd_register_device(type: SNDRV_DEVICE_TYPE_RAWMIDI,
1973 card: rmidi->card, dev: rmidi->device,
1974 f_ops: &snd_rawmidi_f_ops, private_data: rmidi, device: rmidi->dev);
1975 if (err < 0) {
1976 rmidi_err(rmidi, "unable to register\n");
1977 goto error;
1978 }
1979 if (rmidi->ops && rmidi->ops->dev_register) {
1980 err = rmidi->ops->dev_register(rmidi);
1981 if (err < 0)
1982 goto error_unregister;
1983 }
1984#ifdef CONFIG_SND_OSSEMUL
1985 rmidi->ossreg = 0;
1986 if (!rawmidi_is_ump(rmidi) &&
1987 (int)rmidi->device == midi_map[rmidi->card->number]) {
1988 if (snd_register_oss_device(SNDRV_OSS_DEVICE_TYPE_MIDI,
1989 card: rmidi->card, dev: 0, f_ops: &snd_rawmidi_f_ops,
1990 private_data: rmidi) < 0) {
1991 rmidi_err(rmidi,
1992 "unable to register OSS rawmidi device %i:%i\n",
1993 rmidi->card->number, 0);
1994 } else {
1995 rmidi->ossreg++;
1996#ifdef SNDRV_OSS_INFO_DEV_MIDI
1997 snd_oss_info_register(SNDRV_OSS_INFO_DEV_MIDI, num: rmidi->card->number, string: rmidi->name);
1998#endif
1999 }
2000 }
2001 if (!rawmidi_is_ump(rmidi) &&
2002 (int)rmidi->device == amidi_map[rmidi->card->number]) {
2003 if (snd_register_oss_device(SNDRV_OSS_DEVICE_TYPE_MIDI,
2004 card: rmidi->card, dev: 1, f_ops: &snd_rawmidi_f_ops,
2005 private_data: rmidi) < 0) {
2006 rmidi_err(rmidi,
2007 "unable to register OSS rawmidi device %i:%i\n",
2008 rmidi->card->number, 1);
2009 } else {
2010 rmidi->ossreg++;
2011 }
2012 }
2013#endif /* CONFIG_SND_OSSEMUL */
2014 sprintf(buf: name, fmt: "midi%d", rmidi->device);
2015 entry = snd_info_create_card_entry(card: rmidi->card, name, parent: rmidi->card->proc_root);
2016 if (entry) {
2017 entry->private_data = rmidi;
2018 entry->c.text.read = snd_rawmidi_proc_info_read;
2019 if (snd_info_register(entry) < 0) {
2020 snd_info_free_entry(entry);
2021 entry = NULL;
2022 }
2023 }
2024 rmidi->proc_entry = entry;
2025#if IS_ENABLED(CONFIG_SND_SEQUENCER)
2026 /* no own registration mechanism? */
2027 if (!rmidi->ops || !rmidi->ops->dev_register) {
2028 if (snd_seq_device_new(card: rmidi->card, device: rmidi->device, SNDRV_SEQ_DEV_ID_MIDISYNTH, argsize: 0, result: &rmidi->seq_dev) >= 0) {
2029 rmidi->seq_dev->private_data = rmidi;
2030 rmidi->seq_dev->private_free = snd_rawmidi_dev_seq_free;
2031 sprintf(buf: rmidi->seq_dev->name, fmt: "MIDI %d-%d", rmidi->card->number, rmidi->device);
2032 snd_device_register(card: rmidi->card, device_data: rmidi->seq_dev);
2033 }
2034 }
2035#endif
2036 return 0;
2037
2038 error_unregister:
2039 snd_unregister_device(dev: rmidi->dev);
2040 error:
2041 scoped_guard(mutex, &register_mutex)
2042 list_del(entry: &rmidi->list);
2043 return err;
2044}
2045
2046static int snd_rawmidi_dev_disconnect(struct snd_device *device)
2047{
2048 struct snd_rawmidi *rmidi = device->device_data;
2049 int dir;
2050
2051 guard(mutex)(T: &register_mutex);
2052 guard(mutex)(T: &rmidi->open_mutex);
2053 wake_up(&rmidi->open_wait);
2054 list_del_init(entry: &rmidi->list);
2055 for (dir = 0; dir < 2; dir++) {
2056 struct snd_rawmidi_substream *s;
2057
2058 list_for_each_entry(s, &rmidi->streams[dir].substreams, list) {
2059 if (s->runtime)
2060 wake_up(&s->runtime->sleep);
2061 }
2062 }
2063
2064#ifdef CONFIG_SND_OSSEMUL
2065 if (rmidi->ossreg) {
2066 if ((int)rmidi->device == midi_map[rmidi->card->number]) {
2067 snd_unregister_oss_device(SNDRV_OSS_DEVICE_TYPE_MIDI, card: rmidi->card, dev: 0);
2068#ifdef SNDRV_OSS_INFO_DEV_MIDI
2069 snd_oss_info_unregister(SNDRV_OSS_INFO_DEV_MIDI, rmidi->card->number);
2070#endif
2071 }
2072 if ((int)rmidi->device == amidi_map[rmidi->card->number])
2073 snd_unregister_oss_device(SNDRV_OSS_DEVICE_TYPE_MIDI, card: rmidi->card, dev: 1);
2074 rmidi->ossreg = 0;
2075 }
2076#endif /* CONFIG_SND_OSSEMUL */
2077 snd_unregister_device(dev: rmidi->dev);
2078 return 0;
2079}
2080
2081/**
2082 * snd_rawmidi_set_ops - set the rawmidi operators
2083 * @rmidi: the rawmidi instance
2084 * @stream: the stream direction, SNDRV_RAWMIDI_STREAM_XXX
2085 * @ops: the operator table
2086 *
2087 * Sets the rawmidi operators for the given stream direction.
2088 */
2089void snd_rawmidi_set_ops(struct snd_rawmidi *rmidi, int stream,
2090 const struct snd_rawmidi_ops *ops)
2091{
2092 struct snd_rawmidi_substream *substream;
2093
2094 list_for_each_entry(substream, &rmidi->streams[stream].substreams, list)
2095 substream->ops = ops;
2096}
2097EXPORT_SYMBOL(snd_rawmidi_set_ops);
2098
2099/*
2100 * ENTRY functions
2101 */
2102
2103static int __init alsa_rawmidi_init(void)
2104{
2105
2106 snd_ctl_register_ioctl(fcn: snd_rawmidi_control_ioctl);
2107 snd_ctl_register_ioctl_compat(fcn: snd_rawmidi_control_ioctl);
2108#ifdef CONFIG_SND_OSSEMUL
2109 { int i;
2110 /* check device map table */
2111 for (i = 0; i < SNDRV_CARDS; i++) {
2112 if (midi_map[i] < 0 || midi_map[i] >= SNDRV_RAWMIDI_DEVICES) {
2113 pr_err("ALSA: rawmidi: invalid midi_map[%d] = %d\n",
2114 i, midi_map[i]);
2115 midi_map[i] = 0;
2116 }
2117 if (amidi_map[i] < 0 || amidi_map[i] >= SNDRV_RAWMIDI_DEVICES) {
2118 pr_err("ALSA: rawmidi: invalid amidi_map[%d] = %d\n",
2119 i, amidi_map[i]);
2120 amidi_map[i] = 1;
2121 }
2122 }
2123 }
2124#endif /* CONFIG_SND_OSSEMUL */
2125 return 0;
2126}
2127
2128static void __exit alsa_rawmidi_exit(void)
2129{
2130 snd_ctl_unregister_ioctl(fcn: snd_rawmidi_control_ioctl);
2131 snd_ctl_unregister_ioctl_compat(fcn: snd_rawmidi_control_ioctl);
2132}
2133
2134module_init(alsa_rawmidi_init)
2135module_exit(alsa_rawmidi_exit)
2136

source code of linux/sound/core/rawmidi.c