Annotation of Gnu-Mach/linux/src/kernel/dma.c, revision 1.1.1.1

1.1       root        1: /* $Id: dma.c,v 1.1 1999/04/26 05:58:29 tb Exp $
                      2:  * linux/kernel/dma.c: A DMA channel allocator. Inspired by linux/kernel/irq.c.
                      3:  *
                      4:  * Written by Hennus Bergman, 1992.
                      5:  *
                      6:  * 1994/12/26: Changes by Alex Nash to fix a minor bug in /proc/dma.
                      7:  *   In the previous version the reported device could end up being wrong,
                      8:  *   if a device requested a DMA channel that was already in use.
                      9:  *   [It also happened to remove the sizeof(char *) == sizeof(int)
                     10:  *   assumption introduced because of those /proc/dma patches. -- Hennus]
                     11:  */
                     12: 
                     13: #include <linux/kernel.h>
                     14: #include <linux/errno.h>
                     15: #include <asm/dma.h>
                     16: #include <asm/system.h>
                     17: 
                     18: 
                     19: /* A note on resource allocation:
                     20:  *
                     21:  * All drivers needing DMA channels, should allocate and release them
                     22:  * through the public routines `request_dma()' and `free_dma()'.
                     23:  *
                     24:  * In order to avoid problems, all processes should allocate resources in
                     25:  * the same sequence and release them in the reverse order.
                     26:  *
                     27:  * So, when allocating DMAs and IRQs, first allocate the IRQ, then the DMA.
                     28:  * When releasing them, first release the DMA, then release the IRQ.
                     29:  * If you don't, you may cause allocation requests to fail unnecessarily.
                     30:  * This doesn't really matter now, but it will once we get real semaphores
                     31:  * in the kernel.
                     32:  */
                     33: 
                     34: 
                     35: 
                     36: /* Channel n is busy iff dma_chan_busy[n].lock != 0.
                     37:  * DMA0 used to be reserved for DRAM refresh, but apparently not any more...
                     38:  * DMA4 is reserved for cascading.
                     39:  */
                     40: 
                     41: struct dma_chan {
                     42:        int  lock;
                     43:        const char *device_id;
                     44: };
                     45: 
                     46: static struct dma_chan dma_chan_busy[MAX_DMA_CHANNELS] = {
                     47:        { 0, 0 },
                     48:        { 0, 0 },
                     49:        { 0, 0 },
                     50:        { 0, 0 },
                     51:        { 1, "cascade" },
                     52:        { 0, 0 },
                     53:        { 0, 0 },
                     54:        { 0, 0 }
                     55: };
                     56: 
                     57: int get_dma_list(char *buf)
                     58: {
                     59:        int i, len = 0;
                     60: 
                     61:        for (i = 0 ; i < MAX_DMA_CHANNELS ; i++) {
                     62:                if (dma_chan_busy[i].lock) {
                     63:                    len += sprintf(buf+len, "%2d: %s\n",
                     64:                                   i,
                     65:                                   dma_chan_busy[i].device_id);
                     66:                }
                     67:        }
                     68:        return len;
                     69: } /* get_dma_list */
                     70: 
                     71: 
                     72: int request_dma(unsigned int dmanr, const char * device_id)
                     73: {
                     74:        if (dmanr >= MAX_DMA_CHANNELS)
                     75:                return -EINVAL;
                     76: 
                     77:        if (xchg(&dma_chan_busy[dmanr].lock, 1) != 0)
                     78:                return -EBUSY;
                     79: 
                     80:        dma_chan_busy[dmanr].device_id = device_id;
                     81: 
                     82:        /* old flag was 0, now contains 1 to indicate busy */
                     83:        return 0;
                     84: } /* request_dma */
                     85: 
                     86: 
                     87: void free_dma(unsigned int dmanr)
                     88: {
                     89:        if (dmanr >= MAX_DMA_CHANNELS) {
                     90:                printk("Trying to free DMA%d\n", dmanr);
                     91:                return;
                     92:        }
                     93: 
                     94:        if (xchg(&dma_chan_busy[dmanr].lock, 0) == 0) {
                     95:                printk("Trying to free free DMA%d\n", dmanr);
                     96:                return;
                     97:        }       
                     98: 
                     99: } /* free_dma */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.