diff options
author | davidgow@google.com <davidgow@google.com> | 2023-12-15 10:39:08 +0300 |
---|---|---|
committer | Shuah Khan <skhan@linuxfoundation.org> | 2023-12-18 23:28:08 +0300 |
commit | d03c720e03bd9bf0b784d80b5d3ede7e2daf3b6e (patch) | |
tree | 283ce85c21b45fd4ba3782367727f85afdc6dc4a /Documentation/dev-tools/kunit/api | |
parent | e9f0e21ceb65ea5e450ede7c9b9a5bfc90a403ae (diff) | |
download | linux-d03c720e03bd9bf0b784d80b5d3ede7e2daf3b6e.tar.xz |
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>
Diffstat (limited to 'Documentation/dev-tools/kunit/api')
-rw-r--r-- | Documentation/dev-tools/kunit/api/resource.rst | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/Documentation/dev-tools/kunit/api/resource.rst b/Documentation/dev-tools/kunit/api/resource.rst index 0a94f831259e..ec6002a6b0db 100644 --- a/Documentation/dev-tools/kunit/api/resource.rst +++ b/Documentation/dev-tools/kunit/api/resource.rst @@ -11,3 +11,12 @@ state on a per-test basis, register custom cleanup actions, and more. .. kernel-doc:: include/kunit/resource.h :internal: + +Managed Devices +--------------- + +Functions for using KUnit-managed struct device and struct device_driver. +Include ``kunit/device.h`` to use these. + +.. kernel-doc:: include/kunit/device.h + :internal: |