kunit: Add APIs for managing devices
authordavidgow@google.com <davidgow@google.com>
Fri, 15 Dec 2023 07:39:08 +0000 (15:39 +0800)
committerShuah Khan <skhan@linuxfoundation.org>
Mon, 18 Dec 2023 20:28:08 +0000 (13:28 -0700)
commitd03c720e03bd9bf0b784d80b5d3ede7e2daf3b6e
tree283ce85c21b45fd4ba3782367727f85afdc6dc4a
parente9f0e21ceb65ea5e450ede7c9b9a5bfc90a403ae
kunit: Add APIs for managing devices

Tests for drivers often require a struct device to pass to other
functions. While it's possible to create these with
root_device_register(), or to use something like a platform device, this
is both a misuse of those APIs, and can be difficult to clean up after,
for example, a failed assertion.

Add some KUnit-specific functions for registering and unregistering a
struct device:
- kunit_device_register()
- kunit_device_register_with_driver()
- kunit_device_unregister()

These helpers allocate a on a 'kunit' bus which will either probe the
driver passed in (kunit_device_register_with_driver), or will create a
stub driver (kunit_device_register) which is cleaned up on test shutdown.

Devices are automatically unregistered on test shutdown, but can be
manually unregistered earlier with kunit_device_unregister() in order
to, for example, test device release code.

Reviewed-by: Matti Vaittinen <mazziesaccount@gmail.com>
Reviewed-by: Maxime Ripard <mripard@kernel.org>
Signed-off-by: David Gow <davidgow@google.com>
Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
Documentation/dev-tools/kunit/api/resource.rst
Documentation/dev-tools/kunit/usage.rst
include/kunit/device.h [new file with mode: 0644]
lib/kunit/Makefile
lib/kunit/device-impl.h [new file with mode: 0644]
lib/kunit/device.c [new file with mode: 0644]
lib/kunit/kunit-test.c
lib/kunit/test.c