Commit 9f38abef authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Greg Kroah-Hartman
Browse files

uio: fix some kernel-doc markups 



The definitions for (devm_)uio_register_device should be
at the header file, as the macros are there. The ones
inside uio.c refer, instead, to __(devm_)uio_register_device.

Update them and add new kernel-doc markups for the macros.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/82ab7b68d271aeda7396e369ff8a629491b9d628.1603469755.git.mchehab+huawei@kernel.org


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 7bbd2584

drivers/uio/uio.c

+2 −2
Original line number Diff line number Diff line
@@ -906,7 +906,7 @@ static void uio_device_release(struct device *dev) 
}



/**

 * uio_register_device - register a new userspace IO device

 * __uio_register_device - register a new userspace IO device

 * @owner:	module that creates the new device

 * @parent:	parent device

 * @info:	UIO device capabilities
@@ -1002,7 +1002,7 @@ static void devm_uio_unregister_device(struct device *dev, void *res) 
}



/**

 * devm_uio_register_device - Resource managed uio_register_device()

 * __devm_uio_register_device - Resource managed uio_register_device()

 * @owner:	module that creates the new device

 * @parent:	parent device

 * @info:	UIO device capabilities

include/linux/uio_driver.h

+16 −0
Original line number Diff line number Diff line
@@ -117,6 +117,14 @@ extern int __must_check 
			      struct uio_info *info);



/* use a define to avoid include chaining to get THIS_MODULE */



/**

 * uio_register_device - register a new userspace IO device

 * @parent:	parent device

 * @info:	UIO device capabilities

 *

 * returns zero on success or a negative error code.

 */

#define uio_register_device(parent, info) \

	__uio_register_device(THIS_MODULE, parent, info)
@@ -129,6 +137,14 @@ extern int __must_check 
				   struct uio_info *info);



/* use a define to avoid include chaining to get THIS_MODULE */



/**

 * devm_uio_register_device - Resource managed uio_register_device()

 * @parent:	parent device

 * @info:	UIO device capabilities

 *

 * returns zero on success or a negative error code.

 */

#define devm_uio_register_device(parent, info) \

	__devm_uio_register_device(THIS_MODULE, parent, info)

CRA Git | Maintained and supported by SUSTech CRA and CCSE