hdq: documentation for OMAP HDQ
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / kernel / dma-coherent.c
blobf013a0c2e111b09b2045d600d3d3c9944b3ffe9a
1 /*
2 * Coherent per-device memory handling.
3 * Borrowed from i386
4 */
5 #include <linux/kernel.h>
6 #include <linux/dma-mapping.h>
8 struct dma_coherent_mem {
9 void *virt_base;
10 u32 device_base;
11 int size;
12 int flags;
13 unsigned long *bitmap;
16 int dma_declare_coherent_memory(struct device *dev, dma_addr_t bus_addr,
17 dma_addr_t device_addr, size_t size, int flags)
19 void __iomem *mem_base = NULL;
20 int pages = size >> PAGE_SHIFT;
21 int bitmap_size = BITS_TO_LONGS(pages) * sizeof(long);
23 if ((flags & (DMA_MEMORY_MAP | DMA_MEMORY_IO)) == 0)
24 goto out;
25 if (!size)
26 goto out;
27 if (dev->dma_mem)
28 goto out;
30 /* FIXME: this routine just ignores DMA_MEMORY_INCLUDES_CHILDREN */
32 mem_base = ioremap(bus_addr, size);
33 if (!mem_base)
34 goto out;
36 dev->dma_mem = kzalloc(sizeof(struct dma_coherent_mem), GFP_KERNEL);
37 if (!dev->dma_mem)
38 goto out;
39 dev->dma_mem->bitmap = kzalloc(bitmap_size, GFP_KERNEL);
40 if (!dev->dma_mem->bitmap)
41 goto free1_out;
43 dev->dma_mem->virt_base = mem_base;
44 dev->dma_mem->device_base = device_addr;
45 dev->dma_mem->size = pages;
46 dev->dma_mem->flags = flags;
48 if (flags & DMA_MEMORY_MAP)
49 return DMA_MEMORY_MAP;
51 return DMA_MEMORY_IO;
53 free1_out:
54 kfree(dev->dma_mem);
55 out:
56 if (mem_base)
57 iounmap(mem_base);
58 return 0;
60 EXPORT_SYMBOL(dma_declare_coherent_memory);
62 void dma_release_declared_memory(struct device *dev)
64 struct dma_coherent_mem *mem = dev->dma_mem;
66 if (!mem)
67 return;
68 dev->dma_mem = NULL;
69 iounmap(mem->virt_base);
70 kfree(mem->bitmap);
71 kfree(mem);
73 EXPORT_SYMBOL(dma_release_declared_memory);
75 void *dma_mark_declared_memory_occupied(struct device *dev,
76 dma_addr_t device_addr, size_t size)
78 struct dma_coherent_mem *mem = dev->dma_mem;
79 int pos, err;
81 size += device_addr & ~PAGE_MASK;
83 if (!mem)
84 return ERR_PTR(-EINVAL);
86 pos = (device_addr - mem->device_base) >> PAGE_SHIFT;
87 err = bitmap_allocate_region(mem->bitmap, pos, get_order(size));
88 if (err != 0)
89 return ERR_PTR(err);
90 return mem->virt_base + (pos << PAGE_SHIFT);
92 EXPORT_SYMBOL(dma_mark_declared_memory_occupied);
94 /**
95 * dma_alloc_from_coherent() - try to allocate memory from the per-device coherent area
97 * @dev: device from which we allocate memory
98 * @size: size of requested memory area
99 * @dma_handle: This will be filled with the correct dma handle
100 * @ret: This pointer will be filled with the virtual address
101 * to allocated area.
103 * This function should be only called from per-arch dma_alloc_coherent()
104 * to support allocation from per-device coherent memory pools.
106 * Returns 0 if dma_alloc_coherent should continue with allocating from
107 * generic memory areas, or !0 if dma_alloc_coherent should return @ret.
109 int dma_alloc_from_coherent(struct device *dev, ssize_t size,
110 dma_addr_t *dma_handle, void **ret)
112 struct dma_coherent_mem *mem = dev ? dev->dma_mem : NULL;
113 int order = get_order(size);
115 if (mem) {
116 int page = bitmap_find_free_region(mem->bitmap, mem->size,
117 order);
118 if (page >= 0) {
119 *dma_handle = mem->device_base + (page << PAGE_SHIFT);
120 *ret = mem->virt_base + (page << PAGE_SHIFT);
121 memset(*ret, 0, size);
122 } else if (mem->flags & DMA_MEMORY_EXCLUSIVE)
123 *ret = NULL;
125 return (mem != NULL);
127 EXPORT_SYMBOL(dma_alloc_from_coherent);
130 * dma_release_from_coherent() - try to free the memory allocated from per-device coherent memory pool
131 * @dev: device from which the memory was allocated
132 * @order: the order of pages allocated
133 * @vaddr: virtual address of allocated pages
135 * This checks whether the memory was allocated from the per-device
136 * coherent memory pool and if so, releases that memory.
138 * Returns 1 if we correctly released the memory, or 0 if
139 * dma_release_coherent() should proceed with releasing memory from
140 * generic pools.
142 int dma_release_from_coherent(struct device *dev, int order, void *vaddr)
144 struct dma_coherent_mem *mem = dev ? dev->dma_mem : NULL;
146 if (mem && vaddr >= mem->virt_base && vaddr <
147 (mem->virt_base + (mem->size << PAGE_SHIFT))) {
148 int page = (vaddr - mem->virt_base) >> PAGE_SHIFT;
150 bitmap_release_region(mem->bitmap, page, order);
151 return 1;
153 return 0;
155 EXPORT_SYMBOL(dma_release_from_coherent);