Release 4.14 include/linux/dma-contiguous.h
#ifndef __LINUX_CMA_H
#define __LINUX_CMA_H
/*
* Contiguous Memory Allocator for DMA mapping framework
* Copyright (c) 2010-2011 by Samsung Electronics.
* Written by:
* Marek Szyprowski <m.szyprowski@samsung.com>
* Michal Nazarewicz <mina86@mina86.com>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License or (at your optional) any later version of the license.
*/
/*
* Contiguous Memory Allocator
*
* The Contiguous Memory Allocator (CMA) makes it possible to
* allocate big contiguous chunks of memory after the system has
* booted.
*
* Why is it needed?
*
* Various devices on embedded systems have no scatter-getter and/or
* IO map support and require contiguous blocks of memory to
* operate. They include devices such as cameras, hardware video
* coders, etc.
*
* Such devices often require big memory buffers (a full HD frame
* is, for instance, more then 2 mega pixels large, i.e. more than 6
* MB of memory), which makes mechanisms such as kmalloc() or
* alloc_page() ineffective.
*
* At the same time, a solution where a big memory region is
* reserved for a device is suboptimal since often more memory is
* reserved then strictly required and, moreover, the memory is
* inaccessible to page system even if device drivers don't use it.
*
* CMA tries to solve this issue by operating on memory regions
* where only movable pages can be allocated from. This way, kernel
* can use the memory for pagecache and when device driver requests
* it, allocated pages can be migrated.
*
* Driver usage
*
* CMA should not be used by the device drivers directly. It is
* only a helper framework for dma-mapping subsystem.
*
* For more information, see kernel-docs in drivers/base/dma-contiguous.c
*/
#ifdef __KERNEL__
#include <linux/device.h>
struct cma;
struct page;
#ifdef CONFIG_DMA_CMA
extern struct cma *dma_contiguous_default_area;
static inline struct cma *dev_get_cma_area(struct device *dev)
{
if (dev && dev->cma_area)
return dev->cma_area;
return dma_contiguous_default_area;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 30 | 100.00% | 1 | 100.00% |
| Total | 30 | 100.00% | 1 | 100.00% |
static inline void dev_set_cma_area(struct device *dev, struct cma *cma)
{
if (dev)
dev->cma_area = cma;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 27 | 100.00% | 1 | 100.00% |
| Total | 27 | 100.00% | 1 | 100.00% |
static inline void dma_contiguous_set_default(struct cma *cma)
{
dma_contiguous_default_area = cma;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 16 | 100.00% | 1 | 100.00% |
| Total | 16 | 100.00% | 1 | 100.00% |
void dma_contiguous_reserve(phys_addr_t addr_limit);
int __init dma_contiguous_reserve_area(phys_addr_t size, phys_addr_t base,
phys_addr_t limit, struct cma **res_cma,
bool fixed);
/**
* dma_declare_contiguous() - reserve area for contiguous memory handling
* for particular device
* @dev: Pointer to device structure.
* @size: Size of the reserved memory.
* @base: Start address of the reserved memory (optional, 0 for any).
* @limit: End address of the reserved memory (optional, 0 for any).
*
* This function reserves memory for specified device. It should be
* called by board specific code when early allocator (memblock or bootmem)
* is still activate.
*/
static inline int dma_declare_contiguous(struct device *dev, phys_addr_t size,
phys_addr_t base, phys_addr_t limit)
{
struct cma *cma;
int ret;
ret = dma_contiguous_reserve_area(size, base, limit, &cma, true);
if (ret == 0)
dev_set_cma_area(dev, cma);
return ret;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 58 | 95.08% | 2 | 50.00% |
| Akinobu Mita | 2 | 3.28% | 1 | 25.00% |
| Vitaly Andrianov | 1 | 1.64% | 1 | 25.00% |
| Total | 61 | 100.00% | 4 | 100.00% |
struct page *dma_alloc_from_contiguous(struct device *dev, size_t count,
unsigned int order, gfp_t gfp_mask);
bool dma_release_from_contiguous(struct device *dev, struct page *pages,
int count);
#else
static inline struct cma *dev_get_cma_area(struct device *dev)
{
return NULL;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 17 | 100.00% | 1 | 100.00% |
| Total | 17 | 100.00% | 1 | 100.00% |
static inline void dev_set_cma_area(struct device *dev, struct cma *cma) { }
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 16 | 100.00% | 1 | 100.00% |
| Total | 16 | 100.00% | 1 | 100.00% |
static inline void dma_contiguous_set_default(struct cma *cma) { }
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 11 | 100.00% | 1 | 100.00% |
| Total | 11 | 100.00% | 1 | 100.00% |
static inline void dma_contiguous_reserve(phys_addr_t limit) { }
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 9 | 100.00% | 1 | 100.00% |
| Total | 9 | 100.00% | 1 | 100.00% |
static inline int dma_contiguous_reserve_area(phys_addr_t size, phys_addr_t base,
phys_addr_t limit, struct cma **res_cma,
bool fixed)
{
return -ENOSYS;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 26 | 89.66% | 1 | 50.00% |
| Akinobu Mita | 3 | 10.34% | 1 | 50.00% |
| Total | 29 | 100.00% | 2 | 100.00% |
static inline
int dma_declare_contiguous(struct device *dev, phys_addr_t size,
phys_addr_t base, phys_addr_t limit)
{
return -ENOSYS;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 24 | 96.00% | 1 | 50.00% |
| Vitaly Andrianov | 1 | 4.00% | 1 | 50.00% |
| Total | 25 | 100.00% | 2 | 100.00% |
static inline
struct page *dma_alloc_from_contiguous(struct device *dev, size_t count,
unsigned int order, gfp_t gfp_mask)
{
return NULL;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 23 | 85.19% | 1 | 33.33% |
| Lucas Stach | 3 | 11.11% | 1 | 33.33% |
| Rohit Vaswani | 1 | 3.70% | 1 | 33.33% |
| Total | 27 | 100.00% | 3 | 100.00% |
static inline
bool dma_release_from_contiguous(struct device *dev, struct page *pages,
int count)
{
return false;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 23 | 100.00% | 1 | 100.00% |
| Total | 23 | 100.00% | 1 | 100.00% |
#endif
#endif
#endif
Overall Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| Marek Szyprowski | 375 | 94.46% | 2 | 25.00% |
| Akinobu Mita | 8 | 2.02% | 1 | 12.50% |
| Lucas Stach | 6 | 1.51% | 1 | 12.50% |
| JoonSoo Kim | 3 | 0.76% | 1 | 12.50% |
| Vitaly Andrianov | 2 | 0.50% | 1 | 12.50% |
| Rohit Vaswani | 2 | 0.50% | 1 | 12.50% |
| Aneesh Kumar K.V | 1 | 0.25% | 1 | 12.50% |
| Total | 397 | 100.00% | 8 | 100.00% |
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.