thp: comment reminder in destroy_compound_page
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / sound / oss / soundcard.c
blobfcb14a09982262d473842aeb55f365b031ebeb70
1 /*
2 * linux/sound/oss/soundcard.c
4 * Sound card driver for Linux
7 * Copyright (C) by Hannu Savolainen 1993-1997
9 * OSS/Free for Linux is distributed under the GNU GENERAL PUBLIC LICENSE (GPL)
10 * Version 2 (June 1991). See the "COPYING" file distributed with this software
11 * for more info.
14 * Thomas Sailer : ioctl code reworked (vmalloc/vfree removed)
15 * integrated sound_switch.c
16 * Stefan Reinauer : integrated /proc/sound (equals to /dev/sndstat,
17 * which should disappear in the near future)
18 * Eric Dumas : devfs support (22-Jan-98) <dumas@linux.eu.org> with
19 * fixups by C. Scott Ananian <cananian@alumni.princeton.edu>
20 * Richard Gooch : moved common (non OSS-specific) devices to sound_core.c
21 * Rob Riggs : Added persistent DMA buffers support (1998/10/17)
22 * Christoph Hellwig : Some cleanup work (2000/03/01)
26 #include "sound_config.h"
27 #include <linux/init.h>
28 #include <linux/types.h>
29 #include <linux/errno.h>
30 #include <linux/signal.h>
31 #include <linux/fcntl.h>
32 #include <linux/ctype.h>
33 #include <linux/stddef.h>
34 #include <linux/kmod.h>
35 #include <linux/kernel.h>
36 #include <asm/dma.h>
37 #include <asm/io.h>
38 #include <linux/wait.h>
39 #include <linux/ioport.h>
40 #include <linux/major.h>
41 #include <linux/delay.h>
42 #include <linux/proc_fs.h>
43 #include <linux/mutex.h>
44 #include <linux/module.h>
45 #include <linux/mm.h>
46 #include <linux/device.h>
49 * This ought to be moved into include/asm/dma.h
51 #ifndef valid_dma
52 #define valid_dma(n) ((n) >= 0 && (n) < MAX_DMA_CHANNELS && (n) != 4)
53 #endif
56 * Table for permanently allocated memory (used when unloading the module)
58 void * sound_mem_blocks[MAX_MEM_BLOCKS];
59 static DEFINE_MUTEX(soundcard_mutex);
60 int sound_nblocks = 0;
62 /* Persistent DMA buffers */
63 #ifdef CONFIG_SOUND_DMAP
64 int sound_dmap_flag = 1;
65 #else
66 int sound_dmap_flag = 0;
67 #endif
69 static char dma_alloc_map[MAX_DMA_CHANNELS];
71 #define DMA_MAP_UNAVAIL 0
72 #define DMA_MAP_FREE 1
73 #define DMA_MAP_BUSY 2
76 unsigned long seq_time = 0; /* Time for /dev/sequencer */
77 extern struct class *sound_class;
80 * Table for configurable mixer volume handling
82 static mixer_vol_table mixer_vols[MAX_MIXER_DEV];
83 static int num_mixer_volumes;
85 int *load_mixer_volumes(char *name, int *levels, int present)
87 int i, n;
89 for (i = 0; i < num_mixer_volumes; i++) {
90 if (strncmp(name, mixer_vols[i].name, 32) == 0) {
91 if (present)
92 mixer_vols[i].num = i;
93 return mixer_vols[i].levels;
96 if (num_mixer_volumes >= MAX_MIXER_DEV) {
97 printk(KERN_ERR "Sound: Too many mixers (%s)\n", name);
98 return levels;
100 n = num_mixer_volumes++;
102 strncpy(mixer_vols[n].name, name, 32);
104 if (present)
105 mixer_vols[n].num = n;
106 else
107 mixer_vols[n].num = -1;
109 for (i = 0; i < 32; i++)
110 mixer_vols[n].levels[i] = levels[i];
111 return mixer_vols[n].levels;
113 EXPORT_SYMBOL(load_mixer_volumes);
115 static int set_mixer_levels(void __user * arg)
117 /* mixer_vol_table is 174 bytes, so IMHO no reason to not allocate it on the stack */
118 mixer_vol_table buf;
120 if (__copy_from_user(&buf, arg, sizeof(buf)))
121 return -EFAULT;
122 load_mixer_volumes(buf.name, buf.levels, 0);
123 if (__copy_to_user(arg, &buf, sizeof(buf)))
124 return -EFAULT;
125 return 0;
128 static int get_mixer_levels(void __user * arg)
130 int n;
132 if (__get_user(n, (int __user *)(&(((mixer_vol_table __user *)arg)->num))))
133 return -EFAULT;
134 if (n < 0 || n >= num_mixer_volumes)
135 return -EINVAL;
136 if (__copy_to_user(arg, &mixer_vols[n], sizeof(mixer_vol_table)))
137 return -EFAULT;
138 return 0;
141 /* 4K page size but our output routines use some slack for overruns */
142 #define PROC_BLOCK_SIZE (3*1024)
144 static ssize_t sound_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
146 int dev = iminor(file->f_path.dentry->d_inode);
147 int ret = -EINVAL;
150 * The OSS drivers aren't remotely happy without this locking,
151 * and unless someone fixes them when they are about to bite the
152 * big one anyway, we might as well bandage here..
155 mutex_lock(&soundcard_mutex);
157 DEB(printk("sound_read(dev=%d, count=%d)\n", dev, count));
158 switch (dev & 0x0f) {
159 case SND_DEV_DSP:
160 case SND_DEV_DSP16:
161 case SND_DEV_AUDIO:
162 ret = audio_read(dev, file, buf, count);
163 break;
165 case SND_DEV_SEQ:
166 case SND_DEV_SEQ2:
167 ret = sequencer_read(dev, file, buf, count);
168 break;
170 case SND_DEV_MIDIN:
171 ret = MIDIbuf_read(dev, file, buf, count);
173 mutex_unlock(&soundcard_mutex);
174 return ret;
177 static ssize_t sound_write(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
179 int dev = iminor(file->f_path.dentry->d_inode);
180 int ret = -EINVAL;
182 mutex_lock(&soundcard_mutex);
183 DEB(printk("sound_write(dev=%d, count=%d)\n", dev, count));
184 switch (dev & 0x0f) {
185 case SND_DEV_SEQ:
186 case SND_DEV_SEQ2:
187 ret = sequencer_write(dev, file, buf, count);
188 break;
190 case SND_DEV_DSP:
191 case SND_DEV_DSP16:
192 case SND_DEV_AUDIO:
193 ret = audio_write(dev, file, buf, count);
194 break;
196 case SND_DEV_MIDIN:
197 ret = MIDIbuf_write(dev, file, buf, count);
198 break;
200 mutex_unlock(&soundcard_mutex);
201 return ret;
204 static int sound_open(struct inode *inode, struct file *file)
206 int dev = iminor(inode);
207 int retval;
209 DEB(printk("sound_open(dev=%d)\n", dev));
210 if ((dev >= SND_NDEVS) || (dev < 0)) {
211 printk(KERN_ERR "Invalid minor device %d\n", dev);
212 return -ENXIO;
214 mutex_lock(&soundcard_mutex);
215 switch (dev & 0x0f) {
216 case SND_DEV_CTL:
217 dev >>= 4;
218 if (dev >= 0 && dev < MAX_MIXER_DEV && mixer_devs[dev] == NULL) {
219 request_module("mixer%d", dev);
221 retval = -ENXIO;
222 if (dev && (dev >= num_mixers || mixer_devs[dev] == NULL))
223 break;
225 if (!try_module_get(mixer_devs[dev]->owner))
226 break;
228 retval = 0;
229 break;
231 case SND_DEV_SEQ:
232 case SND_DEV_SEQ2:
233 retval = sequencer_open(dev, file);
234 break;
236 case SND_DEV_MIDIN:
237 retval = MIDIbuf_open(dev, file);
238 break;
240 case SND_DEV_DSP:
241 case SND_DEV_DSP16:
242 case SND_DEV_AUDIO:
243 retval = audio_open(dev, file);
244 break;
246 default:
247 printk(KERN_ERR "Invalid minor device %d\n", dev);
248 retval = -ENXIO;
251 mutex_unlock(&soundcard_mutex);
252 return retval;
255 static int sound_release(struct inode *inode, struct file *file)
257 int dev = iminor(inode);
259 mutex_lock(&soundcard_mutex);
260 DEB(printk("sound_release(dev=%d)\n", dev));
261 switch (dev & 0x0f) {
262 case SND_DEV_CTL:
263 module_put(mixer_devs[dev >> 4]->owner);
264 break;
266 case SND_DEV_SEQ:
267 case SND_DEV_SEQ2:
268 sequencer_release(dev, file);
269 break;
271 case SND_DEV_MIDIN:
272 MIDIbuf_release(dev, file);
273 break;
275 case SND_DEV_DSP:
276 case SND_DEV_DSP16:
277 case SND_DEV_AUDIO:
278 audio_release(dev, file);
279 break;
281 default:
282 printk(KERN_ERR "Sound error: Releasing unknown device 0x%02x\n", dev);
284 mutex_unlock(&soundcard_mutex);
286 return 0;
289 static int get_mixer_info(int dev, void __user *arg)
291 mixer_info info;
292 memset(&info, 0, sizeof(info));
293 strlcpy(info.id, mixer_devs[dev]->id, sizeof(info.id));
294 strlcpy(info.name, mixer_devs[dev]->name, sizeof(info.name));
295 info.modify_counter = mixer_devs[dev]->modify_counter;
296 if (__copy_to_user(arg, &info, sizeof(info)))
297 return -EFAULT;
298 return 0;
301 static int get_old_mixer_info(int dev, void __user *arg)
303 _old_mixer_info info;
304 memset(&info, 0, sizeof(info));
305 strlcpy(info.id, mixer_devs[dev]->id, sizeof(info.id));
306 strlcpy(info.name, mixer_devs[dev]->name, sizeof(info.name));
307 if (copy_to_user(arg, &info, sizeof(info)))
308 return -EFAULT;
309 return 0;
312 static int sound_mixer_ioctl(int mixdev, unsigned int cmd, void __user *arg)
314 if (mixdev < 0 || mixdev >= MAX_MIXER_DEV)
315 return -ENXIO;
316 /* Try to load the mixer... */
317 if (mixer_devs[mixdev] == NULL) {
318 request_module("mixer%d", mixdev);
320 if (mixdev >= num_mixers || !mixer_devs[mixdev])
321 return -ENXIO;
322 if (cmd == SOUND_MIXER_INFO)
323 return get_mixer_info(mixdev, arg);
324 if (cmd == SOUND_OLD_MIXER_INFO)
325 return get_old_mixer_info(mixdev, arg);
326 if (_SIOC_DIR(cmd) & _SIOC_WRITE)
327 mixer_devs[mixdev]->modify_counter++;
328 if (!mixer_devs[mixdev]->ioctl)
329 return -EINVAL;
330 return mixer_devs[mixdev]->ioctl(mixdev, cmd, arg);
333 static long sound_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
335 int len = 0, dtype;
336 int dev = iminor(file->f_dentry->d_inode);
337 long ret = -EINVAL;
338 void __user *p = (void __user *)arg;
340 if (_SIOC_DIR(cmd) != _SIOC_NONE && _SIOC_DIR(cmd) != 0) {
342 * Have to validate the address given by the process.
344 len = _SIOC_SIZE(cmd);
345 if (len < 1 || len > 65536 || !p)
346 return -EFAULT;
347 if (_SIOC_DIR(cmd) & _SIOC_WRITE)
348 if (!access_ok(VERIFY_READ, p, len))
349 return -EFAULT;
350 if (_SIOC_DIR(cmd) & _SIOC_READ)
351 if (!access_ok(VERIFY_WRITE, p, len))
352 return -EFAULT;
354 DEB(printk("sound_ioctl(dev=%d, cmd=0x%x, arg=0x%x)\n", dev, cmd, arg));
355 if (cmd == OSS_GETVERSION)
356 return __put_user(SOUND_VERSION, (int __user *)p);
358 mutex_lock(&soundcard_mutex);
359 if (_IOC_TYPE(cmd) == 'M' && num_mixers > 0 && /* Mixer ioctl */
360 (dev & 0x0f) != SND_DEV_CTL) {
361 dtype = dev & 0x0f;
362 switch (dtype) {
363 case SND_DEV_DSP:
364 case SND_DEV_DSP16:
365 case SND_DEV_AUDIO:
366 ret = sound_mixer_ioctl(audio_devs[dev >> 4]->mixer_dev,
367 cmd, p);
368 break;
369 default:
370 ret = sound_mixer_ioctl(dev >> 4, cmd, p);
371 break;
373 mutex_unlock(&soundcard_mutex);
374 return ret;
377 switch (dev & 0x0f) {
378 case SND_DEV_CTL:
379 if (cmd == SOUND_MIXER_GETLEVELS)
380 ret = get_mixer_levels(p);
381 else if (cmd == SOUND_MIXER_SETLEVELS)
382 ret = set_mixer_levels(p);
383 else
384 ret = sound_mixer_ioctl(dev >> 4, cmd, p);
385 break;
387 case SND_DEV_SEQ:
388 case SND_DEV_SEQ2:
389 ret = sequencer_ioctl(dev, file, cmd, p);
390 break;
392 case SND_DEV_DSP:
393 case SND_DEV_DSP16:
394 case SND_DEV_AUDIO:
395 ret = audio_ioctl(dev, file, cmd, p);
396 break;
398 case SND_DEV_MIDIN:
399 ret = MIDIbuf_ioctl(dev, file, cmd, p);
400 break;
403 mutex_unlock(&soundcard_mutex);
404 return ret;
407 static unsigned int sound_poll(struct file *file, poll_table * wait)
409 struct inode *inode = file->f_path.dentry->d_inode;
410 int dev = iminor(inode);
412 DEB(printk("sound_poll(dev=%d)\n", dev));
413 switch (dev & 0x0f) {
414 case SND_DEV_SEQ:
415 case SND_DEV_SEQ2:
416 return sequencer_poll(dev, file, wait);
418 case SND_DEV_MIDIN:
419 return MIDIbuf_poll(dev, file, wait);
421 case SND_DEV_DSP:
422 case SND_DEV_DSP16:
423 case SND_DEV_AUDIO:
424 return DMAbuf_poll(file, dev >> 4, wait);
426 return 0;
429 static int sound_mmap(struct file *file, struct vm_area_struct *vma)
431 int dev_class;
432 unsigned long size;
433 struct dma_buffparms *dmap = NULL;
434 int dev = iminor(file->f_path.dentry->d_inode);
436 dev_class = dev & 0x0f;
437 dev >>= 4;
439 if (dev_class != SND_DEV_DSP && dev_class != SND_DEV_DSP16 && dev_class != SND_DEV_AUDIO) {
440 printk(KERN_ERR "Sound: mmap() not supported for other than audio devices\n");
441 return -EINVAL;
443 mutex_lock(&soundcard_mutex);
444 if (vma->vm_flags & VM_WRITE) /* Map write and read/write to the output buf */
445 dmap = audio_devs[dev]->dmap_out;
446 else if (vma->vm_flags & VM_READ)
447 dmap = audio_devs[dev]->dmap_in;
448 else {
449 printk(KERN_ERR "Sound: Undefined mmap() access\n");
450 mutex_unlock(&soundcard_mutex);
451 return -EINVAL;
454 if (dmap == NULL) {
455 printk(KERN_ERR "Sound: mmap() error. dmap == NULL\n");
456 mutex_unlock(&soundcard_mutex);
457 return -EIO;
459 if (dmap->raw_buf == NULL) {
460 printk(KERN_ERR "Sound: mmap() called when raw_buf == NULL\n");
461 mutex_unlock(&soundcard_mutex);
462 return -EIO;
464 if (dmap->mapping_flags) {
465 printk(KERN_ERR "Sound: mmap() called twice for the same DMA buffer\n");
466 mutex_unlock(&soundcard_mutex);
467 return -EIO;
469 if (vma->vm_pgoff != 0) {
470 printk(KERN_ERR "Sound: mmap() offset must be 0.\n");
471 mutex_unlock(&soundcard_mutex);
472 return -EINVAL;
474 size = vma->vm_end - vma->vm_start;
476 if (size != dmap->bytes_in_use) {
477 printk(KERN_WARNING "Sound: mmap() size = %ld. Should be %d\n", size, dmap->bytes_in_use);
479 if (remap_pfn_range(vma, vma->vm_start,
480 virt_to_phys(dmap->raw_buf) >> PAGE_SHIFT,
481 vma->vm_end - vma->vm_start, vma->vm_page_prot)) {
482 mutex_unlock(&soundcard_mutex);
483 return -EAGAIN;
486 dmap->mapping_flags |= DMA_MAP_MAPPED;
488 if( audio_devs[dev]->d->mmap)
489 audio_devs[dev]->d->mmap(dev);
491 memset(dmap->raw_buf,
492 dmap->neutral_byte,
493 dmap->bytes_in_use);
494 mutex_unlock(&soundcard_mutex);
495 return 0;
498 const struct file_operations oss_sound_fops = {
499 .owner = THIS_MODULE,
500 .llseek = no_llseek,
501 .read = sound_read,
502 .write = sound_write,
503 .poll = sound_poll,
504 .unlocked_ioctl = sound_ioctl,
505 .mmap = sound_mmap,
506 .open = sound_open,
507 .release = sound_release,
511 * Create the required special subdevices
514 static int create_special_devices(void)
516 int seq1,seq2;
517 seq1=register_sound_special(&oss_sound_fops, 1);
518 if(seq1==-1)
519 goto bad;
520 seq2=register_sound_special(&oss_sound_fops, 8);
521 if(seq2!=-1)
522 return 0;
523 unregister_sound_special(1);
524 bad:
525 return -1;
529 /* These device names follow the official Linux device list,
530 * Documentation/devices.txt. Let us know if there are other
531 * common names we should support for compatibility.
532 * Only those devices not created by the generic code in sound_core.c are
533 * registered here.
535 static const struct {
536 unsigned short minor;
537 char *name;
538 umode_t mode;
539 int *num;
540 } dev_list[] = { /* list of minor devices */
541 /* seems to be some confusion here -- this device is not in the device list */
542 {SND_DEV_DSP16, "dspW", S_IWUGO | S_IRUSR | S_IRGRP,
543 &num_audiodevs},
544 {SND_DEV_AUDIO, "audio", S_IWUGO | S_IRUSR | S_IRGRP,
545 &num_audiodevs},
548 static int dmabuf;
549 static int dmabug;
551 module_param(dmabuf, int, 0444);
552 module_param(dmabug, int, 0444);
554 static int __init oss_init(void)
556 int err;
557 int i, j;
559 #ifdef CONFIG_PCI
560 if(dmabug)
561 isa_dma_bridge_buggy = dmabug;
562 #endif
564 err = create_special_devices();
565 if (err) {
566 printk(KERN_ERR "sound: driver already loaded/included in kernel\n");
567 return err;
570 /* Protecting the innocent */
571 sound_dmap_flag = (dmabuf > 0 ? 1 : 0);
573 for (i = 0; i < ARRAY_SIZE(dev_list); i++) {
574 device_create(sound_class, NULL,
575 MKDEV(SOUND_MAJOR, dev_list[i].minor), NULL,
576 "%s", dev_list[i].name);
578 if (!dev_list[i].num)
579 continue;
581 for (j = 1; j < *dev_list[i].num; j++)
582 device_create(sound_class, NULL,
583 MKDEV(SOUND_MAJOR,
584 dev_list[i].minor + (j*0x10)),
585 NULL, "%s%d", dev_list[i].name, j);
588 if (sound_nblocks >= MAX_MEM_BLOCKS - 1)
589 printk(KERN_ERR "Sound warning: Deallocation table was too small.\n");
591 return 0;
594 static void __exit oss_cleanup(void)
596 int i, j;
598 for (i = 0; i < ARRAY_SIZE(dev_list); i++) {
599 device_destroy(sound_class, MKDEV(SOUND_MAJOR, dev_list[i].minor));
600 if (!dev_list[i].num)
601 continue;
602 for (j = 1; j < *dev_list[i].num; j++)
603 device_destroy(sound_class, MKDEV(SOUND_MAJOR, dev_list[i].minor + (j*0x10)));
606 unregister_sound_special(1);
607 unregister_sound_special(8);
609 sound_stop_timer();
611 sequencer_unload();
613 for (i = 0; i < MAX_DMA_CHANNELS; i++)
614 if (dma_alloc_map[i] != DMA_MAP_UNAVAIL) {
615 printk(KERN_ERR "Sound: Hmm, DMA%d was left allocated - fixed\n", i);
616 sound_free_dma(i);
619 for (i = 0; i < sound_nblocks; i++)
620 vfree(sound_mem_blocks[i]);
624 module_init(oss_init);
625 module_exit(oss_cleanup);
626 MODULE_LICENSE("GPL");
627 MODULE_DESCRIPTION("OSS Sound subsystem");
628 MODULE_AUTHOR("Hannu Savolainen, et al.");
631 int sound_alloc_dma(int chn, char *deviceID)
633 int err;
635 if ((err = request_dma(chn, deviceID)) != 0)
636 return err;
638 dma_alloc_map[chn] = DMA_MAP_FREE;
640 return 0;
642 EXPORT_SYMBOL(sound_alloc_dma);
644 int sound_open_dma(int chn, char *deviceID)
646 if (!valid_dma(chn)) {
647 printk(KERN_ERR "sound_open_dma: Invalid DMA channel %d\n", chn);
648 return 1;
651 if (dma_alloc_map[chn] != DMA_MAP_FREE) {
652 printk("sound_open_dma: DMA channel %d busy or not allocated (%d)\n", chn, dma_alloc_map[chn]);
653 return 1;
655 dma_alloc_map[chn] = DMA_MAP_BUSY;
656 return 0;
658 EXPORT_SYMBOL(sound_open_dma);
660 void sound_free_dma(int chn)
662 if (dma_alloc_map[chn] == DMA_MAP_UNAVAIL) {
663 /* printk( "sound_free_dma: Bad access to DMA channel %d\n", chn); */
664 return;
666 free_dma(chn);
667 dma_alloc_map[chn] = DMA_MAP_UNAVAIL;
669 EXPORT_SYMBOL(sound_free_dma);
671 void sound_close_dma(int chn)
673 if (dma_alloc_map[chn] != DMA_MAP_BUSY) {
674 printk(KERN_ERR "sound_close_dma: Bad access to DMA channel %d\n", chn);
675 return;
677 dma_alloc_map[chn] = DMA_MAP_FREE;
679 EXPORT_SYMBOL(sound_close_dma);
681 static void do_sequencer_timer(unsigned long dummy)
683 sequencer_timer(0);
687 static DEFINE_TIMER(seq_timer, do_sequencer_timer, 0, 0);
689 void request_sound_timer(int count)
691 extern unsigned long seq_time;
693 if (count < 0) {
694 seq_timer.expires = (-count) + jiffies;
695 add_timer(&seq_timer);
696 return;
698 count += seq_time;
700 count -= jiffies;
702 if (count < 1)
703 count = 1;
705 seq_timer.expires = (count) + jiffies;
706 add_timer(&seq_timer);
709 void sound_stop_timer(void)
711 del_timer(&seq_timer);
714 void conf_printf(char *name, struct address_info *hw_config)
716 #ifndef CONFIG_SOUND_TRACEINIT
717 return;
718 #else
719 printk("<%s> at 0x%03x", name, hw_config->io_base);
721 if (hw_config->irq)
722 printk(" irq %d", (hw_config->irq > 0) ? hw_config->irq : -hw_config->irq);
724 if (hw_config->dma != -1 || hw_config->dma2 != -1)
726 printk(" dma %d", hw_config->dma);
727 if (hw_config->dma2 != -1)
728 printk(",%d", hw_config->dma2);
730 printk("\n");
731 #endif
733 EXPORT_SYMBOL(conf_printf);
735 void conf_printf2(char *name, int base, int irq, int dma, int dma2)
737 #ifndef CONFIG_SOUND_TRACEINIT
738 return;
739 #else
740 printk("<%s> at 0x%03x", name, base);
742 if (irq)
743 printk(" irq %d", (irq > 0) ? irq : -irq);
745 if (dma != -1 || dma2 != -1)
747 printk(" dma %d", dma);
748 if (dma2 != -1)
749 printk(",%d", dma2);
751 printk("\n");
752 #endif
754 EXPORT_SYMBOL(conf_printf2);