]> www.infradead.org Git - users/jedix/linux-maple.git/commit
container_of: Document container_of() is not to be used in new code
authorSakari Ailus <sakari.ailus@linux.intel.com>
Tue, 20 May 2025 10:34:37 +0000 (13:34 +0300)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 16 Jul 2025 11:56:23 +0000 (13:56 +0200)
commit35cff7af7598b9eb143cc0556e5532e2ded3b61a
treed28ae525e853c38bae3d24c60e96ca9854d8b228
parent6beb4ec0f9fdff4c4c6eb8ed8654fe8396c2b6e0
container_of: Document container_of() is not to be used in new code

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>
include/linux/container_of.h