123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125 |
- /* SPDX-License-Identifier: MIT */
- #ifndef DRM_MODULE_H
- #define DRM_MODULE_H
- #include <linux/pci.h>
- #include <linux/platform_device.h>
- #include <drm/drm_drv.h>
- /**
- * DOC: overview
- *
- * This library provides helpers registering DRM drivers during module
- * initialization and shutdown. The provided helpers act like bus-specific
- * module helpers, such as module_pci_driver(), but respect additional
- * parameters that control DRM driver registration.
- *
- * Below is an example of initializing a DRM driver for a device on the
- * PCI bus.
- *
- * .. code-block:: c
- *
- * struct pci_driver my_pci_drv = {
- * };
- *
- * drm_module_pci_driver(my_pci_drv);
- *
- * The generated code will test if DRM drivers are enabled and register
- * the PCI driver my_pci_drv. For more complex module initialization, you
- * can still use module_init() and module_exit() in your driver.
- */
- /*
- * PCI drivers
- */
- static inline int __init drm_pci_register_driver(struct pci_driver *pci_drv)
- {
- if (drm_firmware_drivers_only())
- return -ENODEV;
- return pci_register_driver(pci_drv);
- }
- /**
- * drm_module_pci_driver - Register a DRM driver for PCI-based devices
- * @__pci_drv: the PCI driver structure
- *
- * Registers a DRM driver for devices on the PCI bus. The helper
- * macro behaves like module_pci_driver() but tests the state of
- * drm_firmware_drivers_only(). For more complex module initialization,
- * use module_init() and module_exit() directly.
- *
- * Each module may only use this macro once. Calling it replaces
- * module_init() and module_exit().
- */
- #define drm_module_pci_driver(__pci_drv) \
- module_driver(__pci_drv, drm_pci_register_driver, pci_unregister_driver)
- static inline int __init
- drm_pci_register_driver_if_modeset(struct pci_driver *pci_drv, int modeset)
- {
- if (drm_firmware_drivers_only() && modeset == -1)
- return -ENODEV;
- if (modeset == 0)
- return -ENODEV;
- return pci_register_driver(pci_drv);
- }
- static inline void __exit
- drm_pci_unregister_driver_if_modeset(struct pci_driver *pci_drv, int modeset)
- {
- pci_unregister_driver(pci_drv);
- }
- /**
- * drm_module_pci_driver_if_modeset - Register a DRM driver for PCI-based devices
- * @__pci_drv: the PCI driver structure
- * @__modeset: an additional parameter that disables the driver
- *
- * This macro is deprecated and only provided for existing drivers. For
- * new drivers, use drm_module_pci_driver().
- *
- * Registers a DRM driver for devices on the PCI bus. The helper macro
- * behaves like drm_module_pci_driver() with an additional driver-specific
- * flag. If __modeset is 0, the driver has been disabled, if __modeset is
- * -1 the driver state depends on the global DRM state. For all other
- * values, the PCI driver has been enabled. The default should be -1.
- */
- #define drm_module_pci_driver_if_modeset(__pci_drv, __modeset) \
- module_driver(__pci_drv, drm_pci_register_driver_if_modeset, \
- drm_pci_unregister_driver_if_modeset, __modeset)
- /*
- * Platform drivers
- */
- static inline int __init
- drm_platform_driver_register(struct platform_driver *platform_drv)
- {
- if (drm_firmware_drivers_only())
- return -ENODEV;
- return platform_driver_register(platform_drv);
- }
- /**
- * drm_module_platform_driver - Register a DRM driver for platform devices
- * @__platform_drv: the platform driver structure
- *
- * Registers a DRM driver for devices on the platform bus. The helper
- * macro behaves like module_platform_driver() but tests the state of
- * drm_firmware_drivers_only(). For more complex module initialization,
- * use module_init() and module_exit() directly.
- *
- * Each module may only use this macro once. Calling it replaces
- * module_init() and module_exit().
- */
- #define drm_module_platform_driver(__platform_drv) \
- module_driver(__platform_drv, drm_platform_driver_register, \
- platform_driver_unregister)
- #endif
|