mirror of
https://github.com/torvalds/linux
synced 2024-10-03 18:00:50 +00:00
394ba10e47
As we gain more tests, boilerplate to allocate an atomic state and free it starts to be there more and more as well. In order to reduce the allocation boilerplate, we can create a helper to create that atomic state, and call an action when the test is done. This will also clean up the exit path. Reviewed-by: Javier Martinez Canillas <javierm@redhat.com> Reviewed-by: Maíra Canal <mairacanal@riseup.net> Link: https://lore.kernel.org/r/20230728-kms-kunit-actions-rework-v3-6-952565ccccfe@kernel.org Signed-off-by: Maxime Ripard <mripard@kernel.org>
99 lines
3.2 KiB
C
99 lines
3.2 KiB
C
// SPDX-License-Identifier: GPL-2.0
|
|
|
|
#ifndef DRM_KUNIT_HELPERS_H_
|
|
#define DRM_KUNIT_HELPERS_H_
|
|
|
|
#include <kunit/test.h>
|
|
|
|
struct drm_device;
|
|
struct kunit;
|
|
|
|
struct device *drm_kunit_helper_alloc_device(struct kunit *test);
|
|
void drm_kunit_helper_free_device(struct kunit *test, struct device *dev);
|
|
|
|
struct drm_device *
|
|
__drm_kunit_helper_alloc_drm_device_with_driver(struct kunit *test,
|
|
struct device *dev,
|
|
size_t size, size_t offset,
|
|
const struct drm_driver *driver);
|
|
|
|
/**
|
|
* drm_kunit_helper_alloc_drm_device_with_driver - Allocates a mock DRM device for KUnit tests
|
|
* @_test: The test context object
|
|
* @_dev: The parent device object
|
|
* @_type: the type of the struct which contains struct &drm_device
|
|
* @_member: the name of the &drm_device within @_type.
|
|
* @_drv: Mocked DRM device driver features
|
|
*
|
|
* This function creates a struct &drm_device from @_dev and @_drv.
|
|
*
|
|
* @_dev should be allocated using drm_kunit_helper_alloc_device().
|
|
*
|
|
* The driver is tied to the @_test context and will get cleaned at the
|
|
* end of the test. The drm_device is allocated through
|
|
* devm_drm_dev_alloc() and will thus be freed through a device-managed
|
|
* resource.
|
|
*
|
|
* Returns:
|
|
* A pointer to the new drm_device, or an ERR_PTR() otherwise.
|
|
*/
|
|
#define drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, _type, _member, _drv) \
|
|
((_type *)__drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, \
|
|
sizeof(_type), \
|
|
offsetof(_type, _member), \
|
|
_drv))
|
|
|
|
static inline struct drm_device *
|
|
__drm_kunit_helper_alloc_drm_device(struct kunit *test,
|
|
struct device *dev,
|
|
size_t size, size_t offset,
|
|
u32 features)
|
|
{
|
|
struct drm_driver *driver;
|
|
|
|
driver = kunit_kzalloc(test, sizeof(*driver), GFP_KERNEL);
|
|
KUNIT_ASSERT_NOT_NULL(test, driver);
|
|
|
|
driver->driver_features = features;
|
|
|
|
return __drm_kunit_helper_alloc_drm_device_with_driver(test, dev,
|
|
size, offset,
|
|
driver);
|
|
}
|
|
|
|
/**
|
|
* drm_kunit_helper_alloc_drm_device - Allocates a mock DRM device for KUnit tests
|
|
* @_test: The test context object
|
|
* @_dev: The parent device object
|
|
* @_type: the type of the struct which contains struct &drm_device
|
|
* @_member: the name of the &drm_device within @_type.
|
|
* @_features: Mocked DRM device driver features
|
|
*
|
|
* This function creates a struct &drm_driver and will create a struct
|
|
* &drm_device from @_dev and that driver.
|
|
*
|
|
* @_dev should be allocated using drm_kunit_helper_alloc_device().
|
|
*
|
|
* The driver is tied to the @_test context and will get cleaned at the
|
|
* end of the test. The drm_device is allocated through
|
|
* devm_drm_dev_alloc() and will thus be freed through a device-managed
|
|
* resource.
|
|
*
|
|
* Returns:
|
|
* A pointer to the new drm_device, or an ERR_PTR() otherwise.
|
|
*/
|
|
#define drm_kunit_helper_alloc_drm_device(_test, _dev, _type, _member, _feat) \
|
|
((_type *)__drm_kunit_helper_alloc_drm_device(_test, _dev, \
|
|
sizeof(_type), \
|
|
offsetof(_type, _member), \
|
|
_feat))
|
|
struct drm_modeset_acquire_ctx *
|
|
drm_kunit_helper_acquire_ctx_alloc(struct kunit *test);
|
|
|
|
struct drm_atomic_state *
|
|
drm_kunit_helper_atomic_state_alloc(struct kunit *test,
|
|
struct drm_device *drm,
|
|
struct drm_modeset_acquire_ctx *ctx);
|
|
|
|
#endif // DRM_KUNIT_HELPERS_H_
|