Commit 4515d08a authored Dec 21, 2023 by Marco Pagani Committed by Luis Chamberlain Dec 21, 2023

kernel/module: improve documentation for try_module_get()



The sentence "this call will fail if the module is already being
removed" is potentially confusing and may contradict the rest of the
documentation. If one tries to get a module that has already been
removed using a stale pointer, the kernel will crash.

Signed-off-by: Marco Pagani <marpagan@redhat.com>
Signed-off-by: Luis Chamberlain <mcgrof@kernel.org>

parent f17f2c13

include/linux/module.h

+1 −1

Original line number	Diff line number	Diff line
		@@ -668,7 +668,7 @@ extern void __module_get(struct module *module);
		* @module: the module we should check for
		*
		* Only try to get a module reference count if the module is not being removed.
		* This call will fail if the module is already being removed.
		* This call will fail if the module is in the process of being removed.
		*
		* Care must also be taken to ensure the module exists and is alive prior to
		* usage of this call. This can be gauranteed through two means: