qiurui
/
Centos-kernel-stream-9
mirror of https://gitlab.com/redhat/centos-stream/src/kernel/centos-stream-9.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Centos-kernel-stream-9/lib/kunit/device-impl.h

20 lines
484 B
C
Raw Normal View History

kunit: Add APIs for managing devices JIRA: https://issues.redhat.com/browse/RHEL-24101 Upstream Status: v6.8-rc1 Conflicts: lib/kunit/kunit-test.c commit d03c720e03bd9bf0b784d80b5d3ede7e2daf3b6e Author: davidgow@google.com <davidgow@google.com> AuthorDate: Fri Dec 15 15:39:08 2023 +0800 Commit: Shuah Khan <skhan@linuxfoundation.org> CommitDate: Mon Dec 18 13:28:08 2023 -0700 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> Signed-off-by: Dave Airlie <airlied@redhat.com>
2024-04-03 06:55:03 +00:00
/* SPDX-License-Identifier: GPL-2.0 */
/*
* KUnit internal header for device helpers
*
* Header for KUnit-internal driver / bus management.
*
* Copyright (C) 2023, Google LLC.
* Author: David Gow <davidgow@google.com>
*/
#ifndef _KUNIT_DEVICE_IMPL_H
#define _KUNIT_DEVICE_IMPL_H
// For internal use only -- registers the kunit_bus.
int kunit_bus_init(void);
kunit: device: Unregister the kunit_bus on shutdown JIRA: https://issues.redhat.com/browse/RHEL-24101 Upstream Status: v6.8-rc5 commit 829388b725f8d266ccec32a2f446717d8693eaba Author: David Gow <davidgow@google.com> AuthorDate: Thu Feb 1 14:04:36 2024 +0800 Commit: Shuah Khan <skhan@linuxfoundation.org> CommitDate: Tue Feb 6 17:07:37 2024 -0700 If KUnit is built as a module, and it's unloaded, the kunit_bus is not unregistered. This causes an error if it's then re-loaded later, as we try to re-register the bus. Unregister the bus and root_device on shutdown, if it looks valid. In addition, be more specific about the value of kunit_bus_device. It is: - a valid struct device* if the kunit_bus initialised correctly. - an ERR_PTR if it failed to initialise. - NULL before initialisation and after shutdown. Fixes: d03c720e03bd ("kunit: Add APIs for managing devices") Signed-off-by: David Gow <davidgow@google.com> Reviewed-by: Rae Moar <rmoar@google.com> Signed-off-by: Shuah Khan <skhan@linuxfoundation.org> Signed-off-by: Dave Airlie <airlied@redhat.com>
2024-04-03 06:55:30 +00:00
// For internal use only -- unregisters the kunit_bus.
void kunit_bus_shutdown(void);
kunit: Add APIs for managing devices JIRA: https://issues.redhat.com/browse/RHEL-24101 Upstream Status: v6.8-rc1 Conflicts: lib/kunit/kunit-test.c commit d03c720e03bd9bf0b784d80b5d3ede7e2daf3b6e Author: davidgow@google.com <davidgow@google.com> AuthorDate: Fri Dec 15 15:39:08 2023 +0800 Commit: Shuah Khan <skhan@linuxfoundation.org> CommitDate: Mon Dec 18 13:28:08 2023 -0700 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> Signed-off-by: Dave Airlie <airlied@redhat.com>
2024-04-03 06:55:03 +00:00
#endif //_KUNIT_DEVICE_IMPL_H