1cb81a5fed
On kernel versions >= 5.15, ION has been completely deprecated, meaning
that the kernel no longer exposes the ION UAPI. There are versions of
libion on operating systems (e.g. Linux Embedded (LE)) that rely on the
kernel to export the latest ION headers to build properly.
Having LE use the same strategy as Android's libion (i.e. maintaining a
copy of the new UAPI and using that to supplement the legacy linux/ion.h
with the new UAPI definitions) is not feasible. It is not feasible because
LE's libion includes the msm-kernel headers, and certain kernels export
the non-legacy ION UAPI (kernels >= 4.14) as linux/ion.h, which causes
libion to use the kernel header for linux/ion.h instead of the legacy
linux/ion.h. When including a local copy of the updated ION UAPI in the
LE libion project, redefinition errors are observed when building libion
with the kernel headers from a kernel that supports the non-legacy
version of ION, as the local copy will redefine the same structures.
Android's libion does not have this problem, as it doesn't use the
msm-kernel's headers, but only its own, so its linux/ion.h is always the
legacy linux/ion.h.
It is possible to stop including the msm-kernel headers for libion,
which would make using Android's approach feasible. However, this
introduces issues when libdmabufheap tries to include ion_4.12.h for the
new structure definitions of the heap query ioctl, as these definitions
redefine the ones obtained from the msm-kernel's linux/ion.h when
building libdmabufheap. Libdmabufheap must be built with the
msm-kernel's UAPI headers, as it relies on the dma-heap.h UAPI file.
Thus, add the ION UAPI headers as part of the headers that the kernel
will expose as of android12-5.10 commit b4604acd52a6
("UPSTREAM: USB: gadget: detect too-big endpoint 0 requests").
This change should not be carried forward to kernels that will run on LE
versions that do not need libion.
Change-Id: I53831911a9aeebbc70edf421e984bd3b1e2b9c36
Signed-off-by: Isaac J. Manjarres <quic_isaacm@quicinc.com>
150 lines
3.9 KiB
C
150 lines
3.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
/*
|
|
* drivers/staging/android/uapi/ion.h
|
|
*
|
|
* Copyright (C) 2011 Google, Inc.
|
|
*/
|
|
|
|
#ifndef _UAPI_LINUX_ION_H
|
|
#define _UAPI_LINUX_ION_H
|
|
|
|
#include <linux/ioctl.h>
|
|
#include <linux/types.h>
|
|
|
|
/**
|
|
* ion_heap_types - list of all possible types of heaps that Android can use
|
|
*
|
|
* @ION_HEAP_TYPE_SYSTEM: Reserved heap id for ion heap that allocates
|
|
* memory using alloc_page(). Also, supports
|
|
* deferred free and allocation pools.
|
|
* @ION_HEAP_TYPE_DMA: Reserved heap id for ion heap that manages
|
|
* single CMA (contiguous memory allocator)
|
|
* region. Uses standard DMA APIs for
|
|
* managing memory within the CMA region.
|
|
*/
|
|
enum ion_heap_type {
|
|
ION_HEAP_TYPE_SYSTEM = 0,
|
|
ION_HEAP_TYPE_DMA = 2,
|
|
/* reserved range for future standard heap types */
|
|
ION_HEAP_TYPE_CUSTOM = 16,
|
|
ION_HEAP_TYPE_MAX = 31,
|
|
};
|
|
|
|
/**
|
|
* ion_heap_id - list of standard heap ids that Android can use
|
|
*
|
|
* @ION_HEAP_SYSTEM Id for the ION_HEAP_TYPE_SYSTEM
|
|
* @ION_HEAP_DMA_START Start of reserved id range for heaps of type
|
|
* ION_HEAP_TYPE_DMA
|
|
* @ION_HEAP_DMA_END End of reserved id range for heaps of type
|
|
* ION_HEAP_TYPE_DMA
|
|
* @ION_HEAP_CUSTOM_START Start of reserved id range for heaps of custom
|
|
* type
|
|
* @ION_HEAP_CUSTOM_END End of reserved id range for heaps of custom
|
|
* type
|
|
*/
|
|
enum ion_heap_id {
|
|
ION_HEAP_SYSTEM = (1 << ION_HEAP_TYPE_SYSTEM),
|
|
ION_HEAP_DMA_START = (ION_HEAP_SYSTEM << 1),
|
|
ION_HEAP_DMA_END = (ION_HEAP_DMA_START << 7),
|
|
ION_HEAP_CUSTOM_START = (ION_HEAP_DMA_END << 1),
|
|
ION_HEAP_CUSTOM_END = (ION_HEAP_CUSTOM_START << 22),
|
|
};
|
|
|
|
#define ION_NUM_MAX_HEAPS (32)
|
|
|
|
/**
|
|
* 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)
|
|
|
|
/**
|
|
* DOC: ION_IOC_HEAP_ABI_VERSION - return ABI version
|
|
*
|
|
* Returns ABI version for this driver
|
|
*/
|
|
#define ION_IOC_ABI_VERSION _IOR(ION_IOC_MAGIC, 9, \
|
|
__u32)
|
|
#endif /* _UAPI_LINUX_ION_H */
|