mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-27 06:50:37 +00:00
35cff7af75
There is a warning in the kerneldoc documentation of container_of() that constness of its ptr argument is lost. While this is a valid suggestion container_of_const() should be used instead, the vast majority of new code still uses container_of(): $ git diff v6.13 v6.14|grep container_of\(|wc -l 646 $ git diff v6.13 v6.14|grep container_of_const|wc -l 9 Make an explicit recommendation to use container_of_const(). Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com> Link: https://lore.kernel.org/r/20250520103437.468691-1-sakari.ailus@linux.intel.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
42 lines
1.4 KiB
C
42 lines
1.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef _LINUX_CONTAINER_OF_H
|
|
#define _LINUX_CONTAINER_OF_H
|
|
|
|
#include <linux/build_bug.h>
|
|
#include <linux/stddef.h>
|
|
|
|
#define typeof_member(T, m) typeof(((T*)0)->m)
|
|
|
|
/**
|
|
* container_of - cast a member of a structure out to the containing structure
|
|
* @ptr: the pointer to the member.
|
|
* @type: the type of the container struct this is embedded in.
|
|
* @member: the name of the member within the struct.
|
|
*
|
|
* WARNING: any const qualifier of @ptr is lost.
|
|
* Do not use container_of() in new code.
|
|
*/
|
|
#define container_of(ptr, type, member) ({ \
|
|
void *__mptr = (void *)(ptr); \
|
|
static_assert(__same_type(*(ptr), ((type *)0)->member) || \
|
|
__same_type(*(ptr), void), \
|
|
"pointer type mismatch in container_of()"); \
|
|
((type *)(__mptr - offsetof(type, member))); })
|
|
|
|
/**
|
|
* container_of_const - cast a member of a structure out to the containing
|
|
* structure and preserve the const-ness of the pointer
|
|
* @ptr: the pointer to the member
|
|
* @type: the type of the container struct this is embedded in.
|
|
* @member: the name of the member within the struct.
|
|
*
|
|
* Always prefer container_of_const() instead of container_of() in new code.
|
|
*/
|
|
#define container_of_const(ptr, type, member) \
|
|
_Generic(ptr, \
|
|
const typeof(*(ptr)) *: ((const type *)container_of(ptr, type, member)),\
|
|
default: ((type *)container_of(ptr, type, member)) \
|
|
)
|
|
|
|
#endif /* _LINUX_CONTAINER_OF_H */
|