3dc56c75d2
Adds various macros to create reserved data fields in kernel data structures before the freeze and to use reserved data fields to backport upstream changes after the freeze. Bug: 233387627 Change-Id: Ifbf8444861fa805593ce9b4837cd2653b7b7a0b0 Signed-off-by: Veerendranath Jakkam <quic_vjakkam@quicinc.com>
89 lines
3.0 KiB
C
89 lines
3.0 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* android_vendor.h - Android vendor data
|
|
*
|
|
* Copyright 2020 Google LLC
|
|
*
|
|
* These macros are to be used to reserve space in kernel data structures
|
|
* for use by vendor modules.
|
|
*
|
|
* These macros should be used before the kernel abi is "frozen".
|
|
* Fields can be added to various kernel structures that need space
|
|
* for functionality implemented in vendor modules. The use of
|
|
* these fields is vendor specific.
|
|
*/
|
|
#ifndef _ANDROID_VENDOR_H
|
|
#define _ANDROID_VENDOR_H
|
|
|
|
#include "android_kabi.h"
|
|
|
|
#define _ANDROID_BACKPORT_RESERVED(n) u64 android_backport_reserved##n
|
|
|
|
/*
|
|
* ANDROID_VENDOR_DATA
|
|
* Reserve some "padding" in a structure for potential future use.
|
|
* This normally placed at the end of a structure.
|
|
* number: the "number" of the padding variable in the structure. Start with
|
|
* 1 and go up.
|
|
*
|
|
* ANDROID_VENDOR_DATA_ARRAY
|
|
* Same as ANDROID_VENDOR_DATA but allocates an array of u64 with
|
|
* the specified size
|
|
*
|
|
* ANDROID_BACKPORT_RESERVED
|
|
* Reserve some "padding" in a structure for potential future use while
|
|
* backporting upstream changes. This normally placed at the end of a
|
|
* structure.
|
|
* number: the "number" of the padding variable in the structure. Start with
|
|
* 1 and go up.
|
|
*/
|
|
#ifdef CONFIG_ANDROID_VENDOR_OEM_DATA
|
|
#define ANDROID_VENDOR_DATA(n) u64 android_vendor_data##n
|
|
#define ANDROID_VENDOR_DATA_ARRAY(n, s) u64 android_vendor_data##n[s]
|
|
|
|
#define ANDROID_OEM_DATA(n) u64 android_oem_data##n
|
|
#define ANDROID_OEM_DATA_ARRAY(n, s) u64 android_oem_data##n[s]
|
|
#define ANDROID_BACKPORT_RESERVED(n) _ANDROID_BACKPORT_RESERVED(n)
|
|
|
|
#define android_init_vendor_data(p, n) \
|
|
memset(&p->android_vendor_data##n, 0, sizeof(p->android_vendor_data##n))
|
|
#define android_init_oem_data(p, n) \
|
|
memset(&p->android_oem_data##n, 0, sizeof(p->android_oem_data##n))
|
|
#else
|
|
#define ANDROID_VENDOR_DATA(n)
|
|
#define ANDROID_VENDOR_DATA_ARRAY(n, s)
|
|
#define ANDROID_OEM_DATA(n)
|
|
#define ANDROID_OEM_DATA_ARRAY(n, s)
|
|
#define ANDROID_BACKPORT_RESERVED(n)
|
|
|
|
#define android_init_vendor_data(p, n)
|
|
#define android_init_oem_data(p, n)
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Macros to use _after_ the ABI is frozen
|
|
*/
|
|
|
|
/*
|
|
* ANDROID_BACKPORT_RESERVED_USE(number, _new)
|
|
* Use a previous padding entry that was defined with
|
|
* ANDROID_BACKPORT_RESERVED
|
|
* number: the previous "number" of the padding variable
|
|
* _new: the variable to use now instead of the padding variable
|
|
*/
|
|
#define ANDROID_BACKPORT_RESERVED_USE(number, _new) \
|
|
_ANDROID_KABI_REPLACE(_ANDROID_BACKPORT_RESERVED(number), _new)
|
|
|
|
/*
|
|
* ANDROID_BACKPORT_RESERVED_USE2(number, _new1, _new2)
|
|
* Use a previous padding entry that was defined with
|
|
* ANDROID_BACKPORT_RESERVED for two new variables that fit into 64 bits.
|
|
* This is good for when you do not want to "burn" a 64bit padding variable
|
|
* for a smaller variable size if not needed.
|
|
*/
|
|
#define ANDROID_BACKPORT_RESERVED_USE2(number, _new1, _new2) \
|
|
_ANDROID_KABI_REPLACE(_ANDROID_BACKPORT_RESERVED(number), struct{ _new1; _new2; })
|
|
|
|
#endif /* _ANDROID_VENDOR_H */
|