144 lines
3.8 KiB
C
144 lines
3.8 KiB
C
/*
|
|
* ion.h
|
|
*
|
|
* Copyright (C) 2011 Google, Inc.
|
|
*
|
|
* This software is licensed under the terms of the GNU General Public
|
|
* License version 2, as published by the Free Software Foundation, and
|
|
* may be copied, distributed, and modified under those terms.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
*/
|
|
|
|
/* This file is copied from drivers/staging/android/uapi/ion.h
|
|
* This local copy is required for the selftest to pass, when build
|
|
* outside the kernel source tree.
|
|
* Please keep this file in sync with its original file until the
|
|
* ion driver is moved outside the staging tree.
|
|
*/
|
|
|
|
#ifndef _UAPI_LINUX_ION_H
|
|
#define _UAPI_LINUX_ION_H
|
|
|
|
#include <linux/ioctl.h>
|
|
#include <linux/types.h>
|
|
|
|
/**
|
|
* enum ion_heap_types - list of all possible types of heaps
|
|
* @ION_HEAP_TYPE_SYSTEM: memory allocated via vmalloc
|
|
* @ION_HEAP_TYPE_SYSTEM_CONTIG: memory allocated via kmalloc
|
|
* @ION_HEAP_TYPE_CARVEOUT: memory allocated from a prereserved
|
|
* carveout heap, allocations are physically
|
|
* contiguous
|
|
* @ION_HEAP_TYPE_DMA: memory allocated via DMA API
|
|
* @ION_NUM_HEAPS: helper for iterating over heaps, a bit mask
|
|
* is used to identify the heaps, so only 32
|
|
* total heap types are supported
|
|
*/
|
|
enum ion_heap_type {
|
|
ION_HEAP_TYPE_SYSTEM,
|
|
ION_HEAP_TYPE_SYSTEM_CONTIG,
|
|
ION_HEAP_TYPE_CARVEOUT,
|
|
ION_HEAP_TYPE_CHUNK,
|
|
ION_HEAP_TYPE_DMA,
|
|
ION_HEAP_TYPE_CUSTOM, /*
|
|
* must be last so device specific heaps always
|
|
* are at the end of this enum
|
|
*/
|
|
};
|
|
|
|
#define ION_NUM_HEAP_IDS (sizeof(unsigned int) * 8)
|
|
|
|
/**
|
|
* allocation flags - the lower 16 bits are used by core ion, the upper 16
|
|
* bits are reserved for use by the heaps themselves.
|
|
*/
|
|
|
|
/*
|
|
* mappings of this buffer should be cached, ion will do cache maintenance
|
|
* when the buffer is mapped for dma
|
|
*/
|
|
#define ION_FLAG_CACHED 1
|
|
|
|
/**
|
|
* DOC: Ion Userspace API
|
|
*
|
|
* create a client by opening /dev/ion
|
|
* most operations handled via following ioctls
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* struct ion_allocation_data - metadata passed from userspace for allocations
|
|
* @len: size of the allocation
|
|
* @heap_id_mask: mask of heap ids to allocate from
|
|
* @flags: flags passed to heap
|
|
* @handle: pointer that will be populated with a cookie to use to
|
|
* refer to this allocation
|
|
*
|
|
* Provided by userspace as an argument to the ioctl
|
|
*/
|
|
struct ion_allocation_data {
|
|
__u64 len;
|
|
__u32 heap_id_mask;
|
|
__u32 flags;
|
|
__u32 fd;
|
|
__u32 unused;
|
|
};
|
|
|
|
#define MAX_HEAP_NAME 32
|
|
|
|
/**
|
|
* struct ion_heap_data - data about a heap
|
|
* @name - first 32 characters of the heap name
|
|
* @type - heap type
|
|
* @heap_id - heap id for the heap
|
|
*/
|
|
struct ion_heap_data {
|
|
char name[MAX_HEAP_NAME];
|
|
__u32 type;
|
|
__u32 heap_id;
|
|
__u32 reserved0;
|
|
__u32 reserved1;
|
|
__u32 reserved2;
|
|
};
|
|
|
|
/**
|
|
* struct ion_heap_query - collection of data about all heaps
|
|
* @cnt - total number of heaps to be copied
|
|
* @heaps - buffer to copy heap data
|
|
*/
|
|
struct ion_heap_query {
|
|
__u32 cnt; /* Total number of heaps to be copied */
|
|
__u32 reserved0; /* align to 64bits */
|
|
__u64 heaps; /* buffer to be populated */
|
|
__u32 reserved1;
|
|
__u32 reserved2;
|
|
};
|
|
|
|
#define ION_IOC_MAGIC 'I'
|
|
|
|
/**
|
|
* DOC: ION_IOC_ALLOC - allocate memory
|
|
*
|
|
* Takes an ion_allocation_data struct and returns it with the handle field
|
|
* populated with the opaque handle for the allocation.
|
|
*/
|
|
#define ION_IOC_ALLOC _IOWR(ION_IOC_MAGIC, 0, \
|
|
struct ion_allocation_data)
|
|
|
|
/**
|
|
* DOC: ION_IOC_HEAP_QUERY - information about available heaps
|
|
*
|
|
* Takes an ion_heap_query structure and populates information about
|
|
* available Ion heaps.
|
|
*/
|
|
#define ION_IOC_HEAP_QUERY _IOWR(ION_IOC_MAGIC, 8, \
|
|
struct ion_heap_query)
|
|
|
|
#endif /* _UAPI_LINUX_ION_H */
|