Ssphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget%/translations/zh_CN/gpu/drm-internalsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/zh_TW/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/it_IT/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ja_JP/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ko_KR/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/pt_BR/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/sp_SP/gpu/drm-internalsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h DRM Internalsh]h DRM Internals}(hhhhhNhNubah}(h]h ]h"]h$]h&]refidid1uh1hhhhhh?/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals.rsthKubh paragraph)}(hThis chapter documents DRM internals relevant to driver authors and developers working to add support for the latest features to existing drivers.h]hThis chapter documents DRM internals relevant to driver authors and developers working to add support for the latest features to existing drivers.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXFirst, we go over some typical driver initialization requirements, like setting up command buffers, creating an initial output configuration, and initializing core services. Subsequent sections cover core internals in more detail, providing implementation notes and examples.h]hXFirst, we go over some typical driver initialization requirements, like setting up command buffers, creating an initial output configuration, and initializing core services. Subsequent sections cover core internals in more detail, providing implementation notes and examples.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hXdThe DRM layer provides several services to graphics drivers, many of them driven by the application interfaces it provides through libdrm, the library that wraps most of the DRM ioctls. These include vblank event handling, memory management, output management, framebuffer management, command submission & fencing, suspend/resume support, and DMA services.h]hXdThe DRM layer provides several services to graphics drivers, many of them driven by the application interfaces it provides through libdrm, the library that wraps most of the DRM ioctls. These include vblank event handling, memory management, output management, framebuffer management, command submission & fencing, suspend/resume support, and DMA services.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhtopic)}(h Contents h](h)}(hContentsh]hContents}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh bullet_list)}(hhh]h list_item)}(hhh](h)}(hhh]h reference)}(hhh]h DRM Internals}(hjhhhNhNubah}(h]hah ]h"]h$]h&]refid drm-internalsuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubj)}(hhh](j)}(hhh](h)}(hhh]j)}(hhh]hDriver Initialization}(hj:hhhNhNubah}(h]id2ah ]h"]h$]h&]refiddriver-initializationuh1jhj7ubah}(h]h ]h"]h$]h&]uh1hhj4ubj)}(hhh](j)}(hhh](h)}(hhh]j)}(hhh]hDriver Information}(hjYhhhNhNubah}(h]id3ah ]h"]h$]h&]refiddriver-informationuh1jhjVubah}(h]h ]h"]h$]h&]uh1hhjSubj)}(hhh](j)}(hhh]h)}(hhh]j)}(hhh]hMajor, Minor and Patchlevel}(hjxhhhNhNubah}(h]id4ah ]h"]h$]h&]refidmajor-minor-and-patchleveluh1jhjuubah}(h]h ]h"]h$]h&]uh1hhjrubah}(h]h ]h"]h$]h&]uh1jhjoubj)}(hhh]h)}(hhh]j)}(hhh]hName and Description}(hjhhhNhNubah}(h]id5ah ]h"]h$]h&]refidname-and-descriptionuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1j hjSubeh}(h]h ]h"]h$]h&]uh1jhjPubj)}(hhh]h)}(hhh]j)}(hhh]hModule Initialization}(hjhhhNhNubah}(h]id6ah ]h"]h$]h&]refidmodule-initializationuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjPubj)}(hhh](h)}(hhh]j)}(hhh]h#Device Instance and Driver Handling}(hjhhhNhNubah}(h]id7ah ]h"]h$]h&]refid#device-instance-and-driver-handlinguh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubj)}(hhh]j)}(hhh]h)}(hhh]j)}(hhh]hDisplay driver example}(hj hhhNhNubah}(h]id8ah ]h"]h$]h&]refiddisplay-driver-exampleuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjPubj)}(hhh](h)}(hhh]j)}(hhh]h Driver Load}(hj7hhhNhNubah}(h]id9ah ]h"]h$]h&]refid driver-loaduh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhj1ubj)}(hhh](j)}(hhh]h)}(hhh]j)}(hhh]hComponent Helper Usage}(hjVhhhNhNubah}(h]id10ah ]h"]h$]h&]refidcomponent-helper-usageuh1jhjSubah}(h]h ]h"]h$]h&]uh1hhjPubah}(h]h ]h"]h$]h&]uh1jhjMubj)}(hhh]h)}(hhh]j)}(hhh]hMemory Manager Initialization}(hjxhhhNhNubah}(h]id11ah ]h"]h$]h&]refidmemory-manager-initializationuh1jhjuubah}(h]h ]h"]h$]h&]uh1hhjrubah}(h]h ]h"]h$]h&]uh1jhjMubj)}(hhh]h)}(hhh]j)}(hhh]h"Miscellaneous Device Configuration}(hjhhhNhNubah}(h]id12ah ]h"]h$]h&]refid"miscellaneous-device-configurationuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1j hj1ubeh}(h]h ]h"]h$]h&]uh1jhjPubj)}(hhh]h)}(hhh]j)}(hhh]hManaged Resources}(hjhhhNhNubah}(h]id13ah ]h"]h$]h&]refidmanaged-resourcesuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1j hj4ubeh}(h]h ]h"]h$]h&]uh1jhj1ubj)}(hhh](h)}(hhh]j)}(hhh]h&Open/Close, File Operations and IOCTLs}(hjhhhNhNubah}(h]id14ah ]h"]h$]h&]refid%open-close-file-operations-and-ioctlsuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubj)}(hhh]j)}(hhh]h)}(hhh]j)}(hhh]hFile Operations}(hjhhhNhNubah}(h]id15ah ]h"]h$]h&]refidfile-operationsuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhj1ubj)}(hhh](h)}(hhh]j)}(hhh]hMisc Utilities}(hjChhhNhNubah}(h]id16ah ]h"]h$]h&]refidmisc-utilitiesuh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhj=ubj)}(hhh](j)}(hhh]h)}(hhh]j)}(hhh]hPrinter}(hjbhhhNhNubah}(h]id17ah ]h"]h$]h&]refidprinteruh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhj\ubah}(h]h ]h"]h$]h&]uh1jhjYubj)}(hhh]h)}(hhh]j)}(hhh]h Utilities}(hjhhhNhNubah}(h]id18ah ]h"]h$]h&]refid utilitiesuh1jhjubah}(h]h ]h"]h$]h&]uh1hhj~ubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1j hj=ubeh}(h]h ]h"]h$]h&]uh1jhj1ubj)}(hhh](h)}(hhh]j)}(hhh]h Unit testing}(hjhhhNhNubah}(h]id19ah ]h"]h$]h&]refid unit-testinguh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubj)}(hhh]j)}(hhh](h)}(hhh]j)}(hhh]hKUnit}(hjhhhNhNubah}(h]id20ah ]h"]h$]h&]refidkunituh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubj)}(hhh](j)}(hhh]h)}(hhh]j)}(hhh]hHow to run the tests?}(hjhhhNhNubah}(h]id21ah ]h"]h$]h&]refidhow-to-run-the-testsuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hhh]j)}(hhh]hKUnit Coverage Rules}(hjhhhNhNubah}(h]id22ah ]h"]h$]h&]refidkunit-coverage-rulesuh1jhjubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhj1ubj)}(hhh](h)}(hhh]j)}(hhh]hLegacy Support Code}(hjLhhhNhNubah}(h]id23ah ]h"]h$]h&]refidlegacy-support-codeuh1jhjIubah}(h]h ]h"]h$]h&]uh1hhjFubj)}(hhh](j)}(hhh]h)}(hhh]j)}(hhh]hLegacy Suspend/Resume}(hjkhhhNhNubah}(h]id24ah ]h"]h$]h&]refidlegacy-suspend-resumeuh1jhjhubah}(h]h ]h"]h$]h&]uh1hhjeubah}(h]h ]h"]h$]h&]uh1jhjbubj)}(hhh]h)}(hhh]j)}(hhh]hLegacy DMA Services}(hjhhhNhNubah}(h]id25ah ]h"]h$]h&]refidlegacy-dma-servicesuh1jhjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1j hjFubeh}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j hhhhhNhNubeh}(h]contentsah ]contentsah"]contentsah$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hDriver Initializationh]hDriver Initialization}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjCuh1hhjhhhhhKubh)}(hXdAt the core of every DRM driver is a :c:type:`struct drm_driver ` structure. Drivers typically statically initialize a drm_driver structure, and then pass it to drm_dev_alloc() to allocate a device instance. After the device instance is fully initialized it can be registered (which makes it accessible from userspace) using drm_dev_register().h](h%At the core of every DRM driver is a }(hjhhhNhNubh)}(h(:c:type:`struct drm_driver `h]hliteral)}(hjh]hstruct drm_driver}(hjhhhNhNubah}(h]h ](xrefcc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocgpu/drm-internals refdomainjreftypetype refexplicitrefwarn reftarget drm_driveruh1hhhhKhjubhX structure. Drivers typically statically initialize a drm_driver structure, and then pass it to drm_dev_alloc() to allocate a device instance. After the device instance is fully initialized it can be registered (which makes it accessible from userspace) using drm_dev_register().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXThe :c:type:`struct drm_driver ` structure contains static information that describes the driver and features it supports, and pointers to methods that the DRM core will call to implement the DRM API. We will first go through the :c:type:`struct drm_driver ` static information fields, and will then describe individual operations in details as they get used in later sections.h](hThe }(hjhhhNhNubh)}(h(:c:type:`struct drm_driver `h]j)}(hj"h]hstruct drm_driver}(hj$hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_driveruh1hhhhK!hjubh structure contains static information that describes the driver and features it supports, and pointers to methods that the DRM core will call to implement the DRM API. We will first go through the }(hjhhhNhNubh)}(h(:c:type:`struct drm_driver `h]j)}(hjEh]hstruct drm_driver}(hjGhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_driveruh1hhhhK!hjubhw static information fields, and will then describe individual operations in details as they get used in later sections.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK!hjhhubh)}(hhh](h)}(hDriver Informationh]hDriver Information}(hjohhhNhNubah}(h]h ]h"]h$]h&]hjbuh1hhjlhhhhhK*ubh)}(hhh](h)}(hMajor, Minor and Patchlevelh]hMajor, Minor and Patchlevel}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj}hhhhhK-ubh)}(hint major; int minor; int patchlevel; The DRM core identifies driver versions by a major, minor and patch level triplet. The information is printed to the kernel log at initialization time and passed to userspace through the DRM_IOCTL_VERSION ioctl.h]hint major; int minor; int patchlevel; The DRM core identifies driver versions by a major, minor and patch level triplet. The information is printed to the kernel log at initialization time and passed to userspace through the DRM_IOCTL_VERSION ioctl.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj}hhubh)}(hXThe major and minor numbers are also used to verify the requested driver API version passed to DRM_IOCTL_SET_VERSION. When the driver API changes between minor versions, applications can call DRM_IOCTL_SET_VERSION to select a specific version of the API. If the requested major isn't equal to the driver major, or the requested minor is larger than the driver minor, the DRM_IOCTL_SET_VERSION call will return an error. Otherwise the driver's set_version() method will be called with the requested version.h]hXThe major and minor numbers are also used to verify the requested driver API version passed to DRM_IOCTL_SET_VERSION. When the driver API changes between minor versions, applications can call DRM_IOCTL_SET_VERSION to select a specific version of the API. If the requested major isn’t equal to the driver major, or the requested minor is larger than the driver minor, the DRM_IOCTL_SET_VERSION call will return an error. Otherwise the driver’s set_version() method will be called with the requested version.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hj}hhubeh}(h]jah ]h"]major, minor and patchlevelah$]h&]uh1hhjlhhhhhK-ubh)}(hhh](h)}(hName and Descriptionh]hName and Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhK?ubh)}(hchar \*name; char \*desc; char \*date; The driver name is printed to the kernel log at initialization time, used for IRQ registration and passed to userspace through DRM_IOCTL_VERSION.h]hchar *name; char *desc; char *date; The driver name is printed to the kernel log at initialization time, used for IRQ registration and passed to userspace through DRM_IOCTL_VERSION.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjhhubh)}(hThe driver description is a purely informative string passed to userspace through the DRM_IOCTL_VERSION ioctl and otherwise unused by the kernel.h]hThe driver description is a purely informative string passed to userspace through the DRM_IOCTL_VERSION ioctl and otherwise unused by the kernel.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubeh}(h]jah ]h"]name and descriptionah$]h&]uh1hhjlhhhhhK?ubeh}(h]jhah ]h"]driver informationah$]h&]uh1hhjhhhhhK*ubh)}(hhh](h)}(hModule Initializationh]hModule Initialization}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKKubh)}(hXThis 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.h]hXThis 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:77: ./include/drm/drm_module.hhK hjhhubh)}(hMBelow is an example of initializing a DRM driver for a device on the PCI bus.h]hMBelow is an example of initializing a DRM driver for a device on the PCI bus.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:77: ./include/drm/drm_module.hhKhjhhubh literal_block)}(hGstruct pci_driver my_pci_drv = { }; drm_module_pci_driver(my_pci_drv);h]hGstruct pci_driver my_pci_drv = { }; drm_module_pci_driver(my_pci_drv);}hjsbah}(h]h ]h"]h$]h&] xml:spacepreserveforcelanguagejhighlight_args}uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:77: ./include/drm/drm_module.hhKhjhhubh)}(hThe 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.h]hThe 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.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:77: ./include/drm/drm_module.hhKhjhhubeh}(h]jah ]h"]module initializationah$]h&]uh1hhjhhhhhKKubh)}(hhh](h)}(h#Device Instance and Driver Handlingh]h#Device Instance and Driver Handling}(hjKhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjHhhhhhKQubh)}(hXTA device instance for a drm driver is represented by :c:type:`struct drm_device `. This is allocated and initialized with devm_drm_dev_alloc(), usually from bus-specific ->probe() callbacks implemented by the driver. The driver then needs to initialize all the various subsystems for the drm device like memory management, vblank handling, modesetting support and initial output configuration plus obviously initialize all the corresponding hardware bits. Finally when everything is up and running and ready for userspace the device instance can be published using drm_dev_register().h](h5A device instance for a drm driver is represented by }(hjYhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjch]hstruct drm_device}(hjehhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_deviceuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chM hjYubhX. This is allocated and initialized with devm_drm_dev_alloc(), usually from bus-specific ->probe() callbacks implemented by the driver. The driver then needs to initialize all the various subsystems for the drm device like memory management, vblank handling, modesetting support and initial output configuration plus obviously initialize all the corresponding hardware bits. Finally when everything is up and running and ready for userspace the device instance can be published using drm_dev_register().}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM hjHhhubh)}(hXThere is also deprecated support for initializing device instances using bus-specific helpers and the :c:type:`drm_driver.load ` callback. But due to backwards-compatibility needs the device instance have to be published too early, which requires unpretty global locking to make safe and is therefore only support for existing drivers not yet converted to the new scheme.h](hfThere is also deprecated support for initializing device instances using bus-specific helpers and the }(hjhhhNhNubh)}(h&:c:type:`drm_driver.load `h]j)}(hjh]hdrm_driver.load}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_driveruh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chMhjubh callback. But due to backwards-compatibility needs the device instance have to be published too early, which requires unpretty global locking to make safe and is therefore only support for existing drivers not yet converted to the new scheme.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjHhhubh)}(hXWhen cleaning up a device instance everything needs to be done in reverse: First unpublish the device instance with drm_dev_unregister(). Then clean up any other resources allocated at device initialization and drop the driver's reference to :c:type:`drm_device` using drm_dev_put().h](hWhen cleaning up a device instance everything needs to be done in reverse: First unpublish the device instance with drm_dev_unregister(). Then clean up any other resources allocated at device initialization and drop the driver’s reference to }(hjhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjh]h drm_device}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_deviceuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chMhjubh using drm_dev_put().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjHhhubh)}(hXJNote that any allocation or resource which is visible to userspace must be released only when the final drm_dev_put() is called, and not when the driver is unbound from the underlying physical struct :c:type:`device`. Best to use :c:type:`drm_device` managed resources with drmm_add_action(), drmm_kmalloc() and related functions.h](hNote that any allocation or resource which is visible to userspace must be released only when the final drm_dev_put() is called, and not when the driver is unbound from the underlying physical struct }(hjhhhNhNubh)}(h:c:type:`device`h]j)}(hjh]hdevice}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj deviceuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chMhjubh. Best to use }(hjhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjh]h drm_device}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj  drm_deviceuh1hhjhMhjubhP managed resources with drmm_add_action(), drmm_kmalloc() and related functions.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjHhhubh)}(hdevres managed resources like devm_kmalloc() can only be used for resources directly related to the underlying hardware device, and only used in code paths fully protected by drm_dev_enter() and drm_dev_exit().h]hdevres managed resources like devm_kmalloc() can only be used for resources directly related to the underlying hardware device, and only used in code paths fully protected by drm_dev_enter() and drm_dev_exit().}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chM$hjHhhubh)}(hhh](h)}(hDisplay driver exampleh]hDisplay driver example}(hjVhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjShNhNubh)}(hThe following example shows a typical structure of a DRM display driver. The example focus on the probe() function and the other functions that is almost always present and serves as a demonstration of devm_drm_dev_alloc().h]hThe following example shows a typical structure of a DRM display driver. The example focus on the probe() function and the other functions that is almost always present and serves as a demonstration of devm_drm_dev_alloc().}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chM+hjSubj)}(hXT struct driver_device { struct drm_device drm; void *userspace_facing; struct clk *pclk; }; static const struct drm_driver driver_drm_driver = { [...] }; static int driver_probe(struct platform_device *pdev) { struct driver_device *priv; struct drm_device *drm; int ret; priv = devm_drm_dev_alloc(&pdev->dev, &driver_drm_driver, struct driver_device, drm); if (IS_ERR(priv)) return PTR_ERR(priv); drm = &priv->drm; ret = drmm_mode_config_init(drm); if (ret) return ret; priv->userspace_facing = drmm_kzalloc(..., GFP_KERNEL); if (!priv->userspace_facing) return -ENOMEM; priv->pclk = devm_clk_get(dev, "PCLK"); if (IS_ERR(priv->pclk)) return PTR_ERR(priv->pclk); // Further setup, display pipeline etc platform_set_drvdata(pdev, drm); ret = drm_mode_config_create_initial_state(drm); if (ret) return ret; ret = drm_dev_register(drm); if (ret) return ret; drm_fbdev_{...}_setup(drm, 32); return 0; } // This function is called before the devm_ resources are released static int driver_remove(struct platform_device *pdev) { struct drm_device *drm = platform_get_drvdata(pdev); drm_dev_unregister(drm); drm_atomic_helper_shutdown(drm) return 0; } // This function is called on kernel restart and shutdown static void driver_shutdown(struct platform_device *pdev) { drm_atomic_helper_shutdown(platform_get_drvdata(pdev)); } static int __maybe_unused driver_pm_suspend(struct device *dev) { return drm_mode_config_helper_suspend(dev_get_drvdata(dev)); } static int __maybe_unused driver_pm_resume(struct device *dev) { drm_mode_config_helper_resume(dev_get_drvdata(dev)); return 0; } static const struct dev_pm_ops driver_pm_ops = { SET_SYSTEM_SLEEP_PM_OPS(driver_pm_suspend, driver_pm_resume) }; static struct platform_driver driver_driver = { .driver = { [...] .pm = &driver_pm_ops, }, .probe = driver_probe, .remove = driver_remove, .shutdown = driver_shutdown, }; module_platform_driver(driver_driver);h]hXT struct driver_device { struct drm_device drm; void *userspace_facing; struct clk *pclk; }; static const struct drm_driver driver_drm_driver = { [...] }; static int driver_probe(struct platform_device *pdev) { struct driver_device *priv; struct drm_device *drm; int ret; priv = devm_drm_dev_alloc(&pdev->dev, &driver_drm_driver, struct driver_device, drm); if (IS_ERR(priv)) return PTR_ERR(priv); drm = &priv->drm; ret = drmm_mode_config_init(drm); if (ret) return ret; priv->userspace_facing = drmm_kzalloc(..., GFP_KERNEL); if (!priv->userspace_facing) return -ENOMEM; priv->pclk = devm_clk_get(dev, "PCLK"); if (IS_ERR(priv->pclk)) return PTR_ERR(priv->pclk); // Further setup, display pipeline etc platform_set_drvdata(pdev, drm); ret = drm_mode_config_create_initial_state(drm); if (ret) return ret; ret = drm_dev_register(drm); if (ret) return ret; drm_fbdev_{...}_setup(drm, 32); return 0; } // This function is called before the devm_ resources are released static int driver_remove(struct platform_device *pdev) { struct drm_device *drm = platform_get_drvdata(pdev); drm_dev_unregister(drm); drm_atomic_helper_shutdown(drm) return 0; } // This function is called on kernel restart and shutdown static void driver_shutdown(struct platform_device *pdev) { drm_atomic_helper_shutdown(platform_get_drvdata(pdev)); } static int __maybe_unused driver_pm_suspend(struct device *dev) { return drm_mode_config_helper_suspend(dev_get_drvdata(dev)); } static int __maybe_unused driver_pm_resume(struct device *dev) { drm_mode_config_helper_resume(dev_get_drvdata(dev)); return 0; } static const struct dev_pm_ops driver_pm_ops = { SET_SYSTEM_SLEEP_PM_OPS(driver_pm_suspend, driver_pm_resume) }; static struct platform_driver driver_driver = { .driver = { [...] .pm = &driver_pm_ops, }, .probe = driver_probe, .remove = driver_remove, .shutdown = driver_shutdown, }; module_platform_driver(driver_driver);}hjssbah}(h]h ]h"]h$]h&]j+j,j-j.jj/}uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chM/hjSubh)}(hX<Drivers that want to support device unplugging (USB, DT overlay unload) should use drm_dev_unplug() instead of drm_dev_unregister(). The driver must protect regions that is accessing device resources to prevent use after they're released. This is done using drm_dev_enter() and drm_dev_exit(). There is one shortcoming however, drm_dev_unplug() marks the drm_device as unplugged before drm_atomic_helper_shutdown() is called. This means that if the disable code paths are protected, they will not run on regular driver module unload, possibly leaving the hardware enabled.h]hX>Drivers that want to support device unplugging (USB, DT overlay unload) should use drm_dev_unplug() instead of drm_dev_unregister(). The driver must protect regions that is accessing device resources to prevent use after they’re released. This is done using drm_dev_enter() and drm_dev_exit(). There is one shortcoming however, drm_dev_unplug() marks the drm_device as unplugged before drm_atomic_helper_shutdown() is called. This means that if the disable code paths are protected, they will not run on regular driver module unload, possibly leaving the hardware enabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:83: ./drivers/gpu/drm/drm_drv.chMhjSubeh}(h]jah ]h"]display driver exampleah$]h&]uh1hhjHhhhNhNubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singledrm_wedge_task_info (C struct)c.drm_wedge_task_infohNtauh1jhjHhhhNhNubhdesc)}(hhh](hdesc_signature)}(hdrm_wedge_task_infoh]hdesc_signature_line)}(hstruct drm_wedge_task_infoh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(hdrm_wedge_task_infoh]h desc_sig_name)}(hjh]hdrm_wedge_task_info}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]j+j,uh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]j+j, add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(h0information about the guilty task of a wedge devh]h0information about the guilty task of a wedge dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK*hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jstructeh"]h$]h&]domainjobjtypej-desctypej-noindex noindexentrynocontentsentryuh1jhhhjHhNhNubh container)}(h**Definition**:: struct drm_wedge_task_info { pid_t pid; char comm[TASK_COMM_LEN]; }; **Members** ``pid`` pid of the task ``comm`` command name of the taskh](h)}(h**Definition**::h](hstrong)}(h**Definition**h]h Definition}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj=ubh:}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK.hj9ubj)}(hLstruct drm_wedge_task_info { pid_t pid; char comm[TASK_COMM_LEN]; };h]hLstruct drm_wedge_task_info { pid_t pid; char comm[TASK_COMM_LEN]; };}hj\sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK0hj9ubh)}(h **Members**h]jB)}(hjmh]hMembers}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjkubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK5hj9ubhdefinition_list)}(hhh](hdefinition_list_item)}(h``pid`` pid of the task h](hterm)}(h``pid``h]j)}(hjh]hpid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK.hjubh definition)}(hhh]h)}(hpid of the taskh]hpid of the task}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK.hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK.hjubj)}(h!``comm`` command name of the taskh](j)}(h``comm``h]j)}(hjh]hcomm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK/hjubj)}(hhh]h)}(hcommand name of the taskh]hcommand name of the task}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK/hjubeh}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jswitch_power_state (C enum)c.switch_power_statehNtauh1jhjHhhhNhNubj)}(hhh](j)}(hswitch_power_stateh]j)}(henum switch_power_stateh](j)}(henumh]henum}(hj' hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj# hhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK6ubj)}(h h]h }(hj6 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj# hhhj5 hK6ubj)}(hswitch_power_stateh]j)}(hj! h]hswitch_power_state}(hjH hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjD ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj# hhhj5 hK6ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj hhhj5 hK6ubah}(h]j ah ](jj eh"]h$]h&]j j)jhuh1jhj5 hK6hj hhubj)}(hhh]h)}(hpower state of drm deviceh]hpower state of drm device}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK4hjg hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj5 hK6ubeh}(h]h ](jenumeh"]h$]h&]j1jj2j j3j j4j5j6uh1jhhhjHhNhNubj8)}(h**Constants** ``DRM_SWITCH_POWER_ON`` Power state is ON ``DRM_SWITCH_POWER_OFF`` Power state is OFF ``DRM_SWITCH_POWER_CHANGING`` Power state is changing ``DRM_SWITCH_POWER_DYNAMIC_OFF`` Suspendedh](h)}(h **Constants**h]jB)}(hj h]h Constants}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK8hj ubj)}(hhh](j)}(h*``DRM_SWITCH_POWER_ON`` Power state is ON h](j)}(h``DRM_SWITCH_POWER_ON``h]j)}(hj h]hDRM_SWITCH_POWER_ON}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK;hj ubj)}(hhh]h)}(hPower state is ONh]hPower state is ON}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK;hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hK;hj ubj)}(h,``DRM_SWITCH_POWER_OFF`` Power state is OFF h](j)}(h``DRM_SWITCH_POWER_OFF``h]j)}(hj h]hDRM_SWITCH_POWER_OFF}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK>hj ubj)}(hhh]h)}(hPower state is OFFh]hPower state is OFF}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK>hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hK>hj ubj)}(h6``DRM_SWITCH_POWER_CHANGING`` Power state is changing h](j)}(h``DRM_SWITCH_POWER_CHANGING``h]j)}(hj h]hDRM_SWITCH_POWER_CHANGING}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKAhj ubj)}(hhh]h)}(hPower state is changingh]hPower state is changing}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2 hKAhj3 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj2 hKAhj ubj)}(h*``DRM_SWITCH_POWER_DYNAMIC_OFF`` Suspendedh](j)}(h ``DRM_SWITCH_POWER_DYNAMIC_OFF``h]j)}(hjV h]hDRM_SWITCH_POWER_DYNAMIC_OFF}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKChjP ubj)}(hhh]h)}(h Suspendedh]h Suspended}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKDhjl ubah}(h]h ]h"]h$]h&]uh1jhjP ubeh}(h]h ]h"]h$]h&]uh1jhjk hKChj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_device (C struct) c.drm_devicehNtauh1jhjHhhhNhNubj)}(hhh](j)}(h drm_deviceh]j)}(hstruct drm_deviceh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKIubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hKIubj)}(h drm_deviceh]j)}(hj h]h drm_device}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj hhhj hKIubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj hhhj hKIubah}(h]j ah ](jj eh"]h$]h&]j j)jhuh1jhj hKIhj hhubj)}(hhh]h)}(hDRM device structureh]hDRM device structure}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKFhj hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hKIubeh}(h]h ](jstructeh"]h$]h&]j1jj2j j3j j4j5j6uh1jhhhjHhNhNubj8)}(hXB**Definition**:: struct drm_device { int if_version; struct kref ref; struct device *dev; struct device *dma_dev; struct { struct list_head resources; void *final_kfree; spinlock_t lock; } managed; const struct drm_driver *driver; void *dev_private; struct drm_minor *primary; struct drm_minor *render; struct drm_minor *accel; bool registered; struct drm_master *master; #ifdef CONFIG_TRANSPARENT_HUGEPAGE; struct vfsmount *huge_mnt; #endif; u32 driver_features; bool unplugged; struct inode *anon_inode; char *unique; struct mutex master_mutex; atomic_t open_count; struct mutex filelist_mutex; struct list_head filelist; struct list_head filelist_internal; struct mutex clientlist_mutex; struct list_head clientlist; struct list_head client_sysrq_list; bool vblank_disable_immediate; struct drm_vblank_crtc *vblank; spinlock_t vblank_time_lock; spinlock_t vbl_lock; u32 max_vblank_count; struct list_head vblank_event_list; spinlock_t event_lock; unsigned int num_crtcs; struct drm_mode_config mode_config; struct mutex object_name_lock; struct idr object_name_idr; struct drm_vma_offset_manager *vma_offset_manager; struct drm_vram_mm *vram_mm; enum switch_power_state switch_power_state; struct drm_fb_helper *fb_helper; struct dentry *debugfs_root; struct mutex gem_lru_mutex; }; **Members** ``if_version`` Highest interface version set ``ref`` Object ref-count ``dev`` Device structure of bus-device ``dma_dev`` Device for DMA operations. Only required if the device **dev** cannot perform DMA by itself. Should be NULL otherwise. Call drm_dev_dma_dev() to get the DMA device instead of using this field directly. Call drm_dev_set_dma_dev() to set this field. DRM devices are sometimes bound to virtual devices that cannot perform DMA by themselves. Drivers should set this field to the respective DMA controller. Devices on USB and other peripheral busses also cannot perform DMA by themselves. The **dma_dev** field should point the bus controller that does DMA on behalve of such a device. Required for importing buffers via dma-buf. If set, the DRM core automatically releases the reference on the device. ``managed`` Managed resources linked to the lifetime of this :c:type:`drm_device` as tracked by **ref**. ``managed.resources`` managed resources list ``managed.final_kfree`` pointer for final kfree() call ``managed.lock`` protects **managed.resources** ``driver`` DRM driver managing the device ``dev_private`` DRM driver private data. This is deprecated and should be left set to NULL. Instead of using this pointer it is recommended that drivers use devm_drm_dev_alloc() and embed struct :c:type:`drm_device` in their larger per-device structure. ``primary`` Primary node. Drivers should not interact with this directly. debugfs interfaces can be registered with drm_debugfs_add_file(), and sysfs should be directly added on the hardware (and not character device node) struct device **dev**. ``render`` Render node. Drivers should not interact with this directly ever. Drivers should not expose any additional interfaces in debugfs or sysfs on this node. ``accel`` Compute Acceleration node ``registered`` Internally used by drm_dev_register() and drm_connector_register(). ``master`` Currently active master for this device. Protected by :c:type:`master_mutex` ``huge_mnt`` Huge tmpfs mountpoint used at GEM object initialization drm_gem_object_init(). Drivers can call drm_gem_huge_mnt_create() to create, mount and use it. The default tmpfs mountpoint (`shm_mnt`) is used if NULL. ``driver_features`` per-device driver features Drivers can clear specific flags here to disallow certain features on a per-device basis while still sharing a single :c:type:`struct drm_driver ` instance across all devices. ``unplugged`` Flag to tell if the device has been unplugged. See drm_dev_enter() and drm_dev_is_unplugged(). ``anon_inode`` inode for private address-space ``unique`` Unique name of the device ``master_mutex`` Lock for :c:type:`drm_minor.master ` and :c:type:`drm_file.is_master ` ``open_count`` Usage counter for outstanding files open, protected by drm_global_mutex ``filelist_mutex`` Protects **filelist**. ``filelist`` List of userspace clients, linked through :c:type:`drm_file.lhead `. ``filelist_internal`` List of open DRM files for in-kernel clients. Protected by :c:type:`filelist_mutex`. ``clientlist_mutex`` Protects :c:type:`clientlist` access. ``clientlist`` List of in-kernel clients. Protected by :c:type:`clientlist_mutex`. ``client_sysrq_list`` Entry into list of devices registered for sysrq. Allows in-kernel clients on this device to handle sysrq keys. ``vblank_disable_immediate`` If true, vblank interrupt will be disabled immediately when the refcount drops to zero, as opposed to via the vblank disable timer. This can be set to true it the hardware has a working vblank counter with high-precision timestamping (otherwise there are races) and the driver uses drm_crtc_vblank_on() and drm_crtc_vblank_off() appropriately. Also, see **max_vblank_count**, :c:type:`drm_crtc_funcs.get_vblank_counter ` and :c:type:`drm_vblank_crtc_config.disable_immediate `. ``vblank`` Array of vblank tracking structures, one per :c:type:`struct drm_crtc `. For historical reasons (vblank support predates kernel modesetting) this is free-standing and not part of :c:type:`struct drm_crtc ` itself. It must be initialized explicitly by calling drm_vblank_init(). ``vblank_time_lock`` Protects vblank count and time updates during vblank enable/disable ``vbl_lock`` Top-level vblank references lock, wraps the low-level **vblank_time_lock**. ``max_vblank_count`` Maximum value of the vblank registers. This value +1 will result in a wrap-around of the vblank register. It is used by the vblank core to handle wrap-arounds. If set to zero the vblank core will try to guess the elapsed vblanks between times when the vblank interrupt is disabled through high-precision timestamps. That approach is suffering from small races and imprecision over longer time periods, hence exposing a hardware vblank counter is always recommended. This is the statically configured device wide maximum. The driver can instead choose to use a runtime configurable per-crtc value :c:type:`drm_vblank_crtc.max_vblank_count `, in which case **max_vblank_count** must be left at zero. See drm_crtc_set_max_vblank_count() on how to use the per-crtc value. If non-zero, :c:type:`drm_crtc_funcs.get_vblank_counter ` must be set. ``vblank_event_list`` List of vblank events ``event_lock`` Protects **vblank_event_list** and event delivery in general. See drm_send_event() and drm_send_event_locked(). ``num_crtcs`` Number of CRTCs on this device ``mode_config`` Current mode config ``object_name_lock`` GEM information ``object_name_idr`` GEM information ``vma_offset_manager`` GEM information ``vram_mm`` VRAM MM memory manager ``switch_power_state`` Power state of the client. Used by drivers supporting the switcheroo driver. The state is maintained in the :c:type:`vga_switcheroo_client_ops.set_gpu_state ` callback ``fb_helper`` Pointer to the fbdev emulation structure. Set by drm_fb_helper_init() and cleared by drm_fb_helper_fini(). ``debugfs_root`` Root directory for debugfs files. ``gem_lru_mutex`` Lock protecting movement of GEM objects between LRUs.h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKJhj ubj)}(hXstruct drm_device { int if_version; struct kref ref; struct device *dev; struct device *dma_dev; struct { struct list_head resources; void *final_kfree; spinlock_t lock; } managed; const struct drm_driver *driver; void *dev_private; struct drm_minor *primary; struct drm_minor *render; struct drm_minor *accel; bool registered; struct drm_master *master; #ifdef CONFIG_TRANSPARENT_HUGEPAGE; struct vfsmount *huge_mnt; #endif; u32 driver_features; bool unplugged; struct inode *anon_inode; char *unique; struct mutex master_mutex; atomic_t open_count; struct mutex filelist_mutex; struct list_head filelist; struct list_head filelist_internal; struct mutex clientlist_mutex; struct list_head clientlist; struct list_head client_sysrq_list; bool vblank_disable_immediate; struct drm_vblank_crtc *vblank; spinlock_t vblank_time_lock; spinlock_t vbl_lock; u32 max_vblank_count; struct list_head vblank_event_list; spinlock_t event_lock; unsigned int num_crtcs; struct drm_mode_config mode_config; struct mutex object_name_lock; struct idr object_name_idr; struct drm_vma_offset_manager *vma_offset_manager; struct drm_vram_mm *vram_mm; enum switch_power_state switch_power_state; struct drm_fb_helper *fb_helper; struct dentry *debugfs_root; struct mutex gem_lru_mutex; };h]hXstruct drm_device { int if_version; struct kref ref; struct device *dev; struct device *dma_dev; struct { struct list_head resources; void *final_kfree; spinlock_t lock; } managed; const struct drm_driver *driver; void *dev_private; struct drm_minor *primary; struct drm_minor *render; struct drm_minor *accel; bool registered; struct drm_master *master; #ifdef CONFIG_TRANSPARENT_HUGEPAGE; struct vfsmount *huge_mnt; #endif; u32 driver_features; bool unplugged; struct inode *anon_inode; char *unique; struct mutex master_mutex; atomic_t open_count; struct mutex filelist_mutex; struct list_head filelist; struct list_head filelist_internal; struct mutex clientlist_mutex; struct list_head clientlist; struct list_head client_sysrq_list; bool vblank_disable_immediate; struct drm_vblank_crtc *vblank; spinlock_t vblank_time_lock; spinlock_t vbl_lock; u32 max_vblank_count; struct list_head vblank_event_list; spinlock_t event_lock; unsigned int num_crtcs; struct drm_mode_config mode_config; struct mutex object_name_lock; struct idr object_name_idr; struct drm_vma_offset_manager *vma_offset_manager; struct drm_vram_mm *vram_mm; enum switch_power_state switch_power_state; struct drm_fb_helper *fb_helper; struct dentry *debugfs_root; struct mutex gem_lru_mutex; };}hj/ sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKLhj ubh)}(h **Members**h]jB)}(hj@ h]hMembers}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj> ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj ubj)}(hhh](j)}(h-``if_version`` Highest interface version set h](j)}(h``if_version``h]j)}(hj_ h]h if_version}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj] ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKMhjY ubj)}(hhh]h)}(hHighest interface version seth]hHighest interface version set}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt hKMhju ubah}(h]h ]h"]h$]h&]uh1jhjY ubeh}(h]h ]h"]h$]h&]uh1jhjt hKMhjV ubj)}(h``ref`` Object ref-count h](j)}(h``ref``h]j)}(hj h]href}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKPhj ubj)}(hhh]h)}(hObject ref-counth]hObject ref-count}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKPhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKPhjV ubj)}(h'``dev`` Device structure of bus-device h](j)}(h``dev``h]j)}(hj h]hdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKShj ubj)}(hhh]h)}(hDevice structure of bus-deviceh]hDevice structure of bus-device}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKShj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKShjV ubj)}(hX``dma_dev`` Device for DMA operations. Only required if the device **dev** cannot perform DMA by itself. Should be NULL otherwise. Call drm_dev_dma_dev() to get the DMA device instead of using this field directly. Call drm_dev_set_dma_dev() to set this field. DRM devices are sometimes bound to virtual devices that cannot perform DMA by themselves. Drivers should set this field to the respective DMA controller. Devices on USB and other peripheral busses also cannot perform DMA by themselves. The **dma_dev** field should point the bus controller that does DMA on behalve of such a device. Required for importing buffers via dma-buf. If set, the DRM core automatically releases the reference on the device. h](j)}(h ``dma_dev``h]j)}(hj h]hdma_dev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKfhj ubj)}(hhh](h)}(hDevice for DMA operations. Only required if the device **dev** cannot perform DMA by itself. Should be NULL otherwise. Call drm_dev_dma_dev() to get the DMA device instead of using this field directly. Call drm_dev_set_dma_dev() to set this field.h](h7Device for DMA operations. Only required if the device }(hj# hhhNhNubjB)}(h**dev**h]hdev}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj# ubh cannot perform DMA by itself. Should be NULL otherwise. Call drm_dev_dma_dev() to get the DMA device instead of using this field directly. Call drm_dev_set_dma_dev() to set this field.}(hj# hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKWhj ubh)}(hDRM devices are sometimes bound to virtual devices that cannot perform DMA by themselves. Drivers should set this field to the respective DMA controller.h]hDRM devices are sometimes bound to virtual devices that cannot perform DMA by themselves. Drivers should set this field to the respective DMA controller.}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK\hj ubh)}(hDevices on USB and other peripheral busses also cannot perform DMA by themselves. The **dma_dev** field should point the bus controller that does DMA on behalve of such a device. Required for importing buffers via dma-buf.h](hVDevices on USB and other peripheral busses also cannot perform DMA by themselves. The }(hjS hhhNhNubjB)}(h **dma_dev**h]hdma_dev}(hj[ hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjS ubh} field should point the bus controller that does DMA on behalve of such a device. Required for importing buffers via dma-buf.}(hjS hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK`hj ubh)}(hHIf set, the DRM core automatically releases the reference on the device.h]hHIf set, the DRM core automatically releases the reference on the device.}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKehj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKfhjV ubj)}(hi``managed`` Managed resources linked to the lifetime of this :c:type:`drm_device` as tracked by **ref**. h](j)}(h ``managed``h]j)}(hj h]hmanaged}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKnhj ubj)}(hhh]h)}(h\Managed resources linked to the lifetime of this :c:type:`drm_device` as tracked by **ref**.h](h1Managed resources linked to the lifetime of this }(hj hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj h]h drm_device}(hj hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarn c:parent_keysphinx.domains.c LookupKey)}data]sbj  drm_deviceuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKmhj ubh as tracked by }(hj hhhNhNubjB)}(h**ref**h]href}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hKmhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKnhjV ubj)}(h-``managed.resources`` managed resources list h](j)}(h``managed.resources``h]j)}(hj h]hmanaged.resources}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKshj ubj)}(hhh]h)}(hmanaged resources listh]hmanaged resources list}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj! hKshj" ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj! hKshjV ubj)}(h7``managed.final_kfree`` pointer for final kfree() call h](j)}(h``managed.final_kfree``h]j)}(hjE h]hmanaged.final_kfree}(hjG hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKuhj? ubj)}(hhh]h)}(hpointer for final kfree() callh]hpointer for final kfree() call}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZ hKuhj[ ubah}(h]h ]h"]h$]h&]uh1jhj? ubeh}(h]h ]h"]h$]h&]uh1jhjZ hKuhjV ubj)}(h0``managed.lock`` protects **managed.resources** h](j)}(h``managed.lock``h]j)}(hj~ h]h managed.lock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj| ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKwhjx ubj)}(hhh]h)}(hprotects **managed.resources**h](h protects }(hj hhhNhNubjB)}(h**managed.resources**h]hmanaged.resources}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubeh}(h]h ]h"]h$]h&]uh1hhj hKwhj ubah}(h]h ]h"]h$]h&]uh1jhjx ubeh}(h]h ]h"]h$]h&]uh1jhj hKwhjV ubj)}(h*``driver`` DRM driver managing the device h](j)}(h ``driver``h]j)}(hj h]hdriver}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhK{hj ubj)}(hhh]h)}(hDRM driver managing the deviceh]hDRM driver managing the device}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK{hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hK{hjV ubj)}(h``dev_private`` DRM driver private data. This is deprecated and should be left set to NULL. Instead of using this pointer it is recommended that drivers use devm_drm_dev_alloc() and embed struct :c:type:`drm_device` in their larger per-device structure. h](j)}(h``dev_private``h]j)}(hj h]h dev_private}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.h<hKhj ubj)}(hhh](h)}(hKDRM driver private data. This is deprecated and should be left set to NULL.h]hKDRM driver private data. This is deprecated and should be left set to NULL.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubh)}(hInstead of using this pointer it is recommended that drivers use devm_drm_dev_alloc() and embed struct :c:type:`drm_device` in their larger per-device structure.h](hgInstead of using this pointer it is recommended that drivers use devm_drm_dev_alloc() and embed struct }(hj&hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj0h]h drm_device}(hj2hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj&ubh& in their larger per-device structure.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjMhKhjubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h``primary`` Primary node. Drivers should not interact with this directly. debugfs interfaces can be registered with drm_debugfs_add_file(), and sysfs should be directly added on the hardware (and not character device node) struct device **dev**. h](j)}(h ``primary``h]j)}(hjjh]hprimary}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjdubj)}(hhh]h)}(hPrimary node. Drivers should not interact with this directly. debugfs interfaces can be registered with drm_debugfs_add_file(), and sysfs should be directly added on the hardware (and not character device node) struct device **dev**.h](hPrimary node. Drivers should not interact with this directly. debugfs interfaces can be registered with drm_debugfs_add_file(), and sysfs should be directly added on the hardware (and not character device node) struct device }(hjhhhNhNubjB)}(h**dev**h]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h``render`` Render node. Drivers should not interact with this directly ever. Drivers should not expose any additional interfaces in debugfs or sysfs on this node. h](j)}(h ``render``h]j)}(hjh]hrender}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hRender node. Drivers should not interact with this directly ever. Drivers should not expose any additional interfaces in debugfs or sysfs on this node.h]hRender node. Drivers should not interact with this directly ever. Drivers should not expose any additional interfaces in debugfs or sysfs on this node.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h$``accel`` Compute Acceleration node h](j)}(h ``accel``h]j)}(hjh]haccel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hCompute Acceleration nodeh]hCompute Acceleration node}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(hS``registered`` Internally used by drm_dev_register() and drm_connector_register(). h](j)}(h``registered``h]j)}(hj)h]h registered}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj#ubj)}(hhh]h)}(hCInternally used by drm_dev_register() and drm_connector_register().h]hCInternally used by drm_dev_register() and drm_connector_register().}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hKhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hKhjV ubj)}(hX``master`` Currently active master for this device. Protected by :c:type:`master_mutex` h](j)}(h ``master``h]j)}(hjbh]hmaster}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj\ubj)}(hhh]h)}(hLCurrently active master for this device. Protected by :c:type:`master_mutex`h](h6Currently active master for this device. Protected by }(hj{hhhNhNubh)}(h:c:type:`master_mutex`h]j)}(hjh]h master_mutex}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  master_mutexuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj{ubeh}(h]h ]h"]h$]h&]uh1hhjhKhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjwhKhjV ubj)}(h``huge_mnt`` Huge tmpfs mountpoint used at GEM object initialization drm_gem_object_init(). Drivers can call drm_gem_huge_mnt_create() to create, mount and use it. The default tmpfs mountpoint (`shm_mnt`) is used if NULL. h](j)}(h ``huge_mnt``h]j)}(hjh]hhuge_mnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hHuge tmpfs mountpoint used at GEM object initialization drm_gem_object_init(). Drivers can call drm_gem_huge_mnt_create() to create, mount and use it. The default tmpfs mountpoint (`shm_mnt`) is used if NULL.h](hHuge tmpfs mountpoint used at GEM object initialization drm_gem_object_init(). Drivers can call drm_gem_huge_mnt_create() to create, mount and use it. The default tmpfs mountpoint (}(hjhhhNhNubhtitle_reference)}(h `shm_mnt`h]hshm_mnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh) is used if NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h``driver_features`` per-device driver features Drivers can clear specific flags here to disallow certain features on a per-device basis while still sharing a single :c:type:`struct drm_driver ` instance across all devices. h](j)}(h``driver_features``h]j)}(hj h]hdriver_features}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh](h)}(hper-device driver featuresh]hper-device driver features}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubh)}(hDrivers can clear specific flags here to disallow certain features on a per-device basis while still sharing a single :c:type:`struct drm_driver ` instance across all devices.h](hvDrivers can clear specific flags here to disallow certain features on a per-device basis while still sharing a single }(hj1hhhNhNubh)}(h(:c:type:`struct drm_driver `h]j)}(hj;h]hstruct drm_driver}(hj=hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj1ubh instance across all devices.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjXhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(hm``unplugged`` Flag to tell if the device has been unplugged. See drm_dev_enter() and drm_dev_is_unplugged(). h](j)}(h ``unplugged``h]j)}(hjuh]h unplugged}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjoubj)}(hhh]h)}(h^Flag to tell if the device has been unplugged. See drm_dev_enter() and drm_dev_is_unplugged().h]h^Flag to tell if the device has been unplugged. See drm_dev_enter() and drm_dev_is_unplugged().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h/``anon_inode`` inode for private address-space h](j)}(h``anon_inode``h]j)}(hjh]h anon_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hinode for private address-spaceh]hinode for private address-space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h%``unique`` Unique name of the device h](j)}(h ``unique``h]j)}(hjh]hunique}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hUnique name of the deviceh]hUnique name of the device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(hm``master_mutex`` Lock for :c:type:`drm_minor.master ` and :c:type:`drm_file.is_master ` h](j)}(h``master_mutex``h]j)}(hj!h]h master_mutex}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(h[Lock for :c:type:`drm_minor.master ` and :c:type:`drm_file.is_master `h](h Lock for }(hj:hhhNhNubh)}(h&:c:type:`drm_minor.master `h]j)}(hjDh]hdrm_minor.master}(hjFhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_minoruh1hhj6hKhj:ubh and }(hj:hhhNhNubh)}(h':c:type:`drm_file.is_master `h]j)}(hjgh]hdrm_file.is_master}(hjihhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhj6hKhj:ubeh}(h]h ]h"]h$]h&]uh1hhj6hKhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hKhjV ubj)}(hW``open_count`` Usage counter for outstanding files open, protected by drm_global_mutex h](j)}(h``open_count``h]j)}(hjh]h open_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hGUsage counter for outstanding files open, protected by drm_global_mutexh]hGUsage counter for outstanding files open, protected by drm_global_mutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h*``filelist_mutex`` Protects **filelist**. h](j)}(h``filelist_mutex``h]j)}(hjh]hfilelist_mutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hProtects **filelist**.h](h Protects }(hjhhhNhNubjB)}(h **filelist**h]hfilelist}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h\``filelist`` List of userspace clients, linked through :c:type:`drm_file.lhead `. h](j)}(h ``filelist``h]j)}(hj!h]hfilelist}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(hNList of userspace clients, linked through :c:type:`drm_file.lhead `.h](h*List of userspace clients, linked through }(hj:hhhNhNubh)}(h#:c:type:`drm_file.lhead `h]j)}(hjDh]hdrm_file.lhead}(hjFhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhj6hKhj:ubh.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj6hKhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hKhjV ubj)}(hk``filelist_internal`` List of open DRM files for in-kernel clients. Protected by :c:type:`filelist_mutex`. h](j)}(h``filelist_internal``h]j)}(hj}h]hfilelist_internal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjwubj)}(hhh]h)}(hTList of open DRM files for in-kernel clients. Protected by :c:type:`filelist_mutex`.h](h;List of open DRM files for in-kernel clients. Protected by }(hjhhhNhNubh)}(h:c:type:`filelist_mutex`h]j)}(hjh]hfilelist_mutex}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j filelist_mutexuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(h;``clientlist_mutex`` Protects :c:type:`clientlist` access. h](j)}(h``clientlist_mutex``h]j)}(hjh]hclientlist_mutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhjubj)}(hhh]h)}(h%Protects :c:type:`clientlist` access.h](h Protects }(hjhhhNhNubh)}(h:c:type:`clientlist`h]j)}(hjh]h clientlist}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  clientlistuh1hhjhKhjubh access.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjV ubj)}(hS``clientlist`` List of in-kernel clients. Protected by :c:type:`clientlist_mutex`. h](j)}(h``clientlist``h]j)}(hj6h]h clientlist}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKhj0ubj)}(hhh]h)}(hCList of in-kernel clients. Protected by :c:type:`clientlist_mutex`.h](h(List of in-kernel clients. Protected by }(hjOhhhNhNubh)}(h:c:type:`clientlist_mutex`h]j)}(hjYh]hclientlist_mutex}(hj[hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j clientlist_mutexuh1hhjKhKhjOubh.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjKhKhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhKhjV ubj)}(h``client_sysrq_list`` Entry into list of devices registered for sysrq. Allows in-kernel clients on this device to handle sysrq keys. h](j)}(h``client_sysrq_list``h]j)}(hjh]hclient_sysrq_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubj)}(hhh]h)}(hnEntry into list of devices registered for sysrq. Allows in-kernel clients on this device to handle sysrq keys.h]hnEntry into list of devices registered for sysrq. Allows in-kernel clients on this device to handle sysrq keys.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjV ubj)}(hX$``vblank_disable_immediate`` If true, vblank interrupt will be disabled immediately when the refcount drops to zero, as opposed to via the vblank disable timer. This can be set to true it the hardware has a working vblank counter with high-precision timestamping (otherwise there are races) and the driver uses drm_crtc_vblank_on() and drm_crtc_vblank_off() appropriately. Also, see **max_vblank_count**, :c:type:`drm_crtc_funcs.get_vblank_counter ` and :c:type:`drm_vblank_crtc_config.disable_immediate `. h](j)}(h``vblank_disable_immediate``h]j)}(hjh]hvblank_disable_immediate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubj)}(hhh](h)}(hIf true, vblank interrupt will be disabled immediately when the refcount drops to zero, as opposed to via the vblank disable timer.h]hIf true, vblank interrupt will be disabled immediately when the refcount drops to zero, as opposed to via the vblank disable timer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM hjubh)}(hXThis can be set to true it the hardware has a working vblank counter with high-precision timestamping (otherwise there are races) and the driver uses drm_crtc_vblank_on() and drm_crtc_vblank_off() appropriately. Also, see **max_vblank_count**, :c:type:`drm_crtc_funcs.get_vblank_counter ` and :c:type:`drm_vblank_crtc_config.disable_immediate `.h](hThis can be set to true it the hardware has a working vblank counter with high-precision timestamping (otherwise there are races) and the driver uses drm_crtc_vblank_on() and drm_crtc_vblank_off() appropriately. Also, see }(hjhhhNhNubjB)}(h**max_vblank_count**h]hmax_vblank_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh, }(hjhhhNhNubh)}(h<:c:type:`drm_crtc_funcs.get_vblank_counter `h]j)}(hjh]h!drm_crtc_funcs.get_vblank_counter}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_crtc_funcsuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubh and }(hjhhhNhNubh)}(hK:c:type:`drm_vblank_crtc_config.disable_immediate `h]j)}(hj4h]h(drm_vblank_crtc_config.disable_immediate}(hj6hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_vblank_crtc_configuh1hhj-hMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj-hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjV ubj)}(hX5``vblank`` Array of vblank tracking structures, one per :c:type:`struct drm_crtc `. For historical reasons (vblank support predates kernel modesetting) this is free-standing and not part of :c:type:`struct drm_crtc ` itself. It must be initialized explicitly by calling drm_vblank_init(). h](j)}(h ``vblank``h]j)}(hjmh]hvblank}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjgubj)}(hhh]h)}(hX)Array of vblank tracking structures, one per :c:type:`struct drm_crtc `. For historical reasons (vblank support predates kernel modesetting) this is free-standing and not part of :c:type:`struct drm_crtc ` itself. It must be initialized explicitly by calling drm_vblank_init().h](h-Array of vblank tracking structures, one per }(hjhhhNhNubh)}(h$:c:type:`struct drm_crtc `h]j)}(hjh]hstruct drm_crtc}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_crtcuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubhl. For historical reasons (vblank support predates kernel modesetting) this is free-standing and not part of }(hjhhhNhNubh)}(h$:c:type:`struct drm_crtc `h]j)}(hjh]hstruct drm_crtc}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_crtcuh1hhjhMhjubhH itself. It must be initialized explicitly by calling drm_vblank_init().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhjV ubj)}(hY``vblank_time_lock`` Protects vblank count and time updates during vblank enable/disable h](j)}(h``vblank_time_lock``h]j)}(hjh]hvblank_time_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM$hjubj)}(hhh]h)}(hCProtects vblank count and time updates during vblank enable/disableh]hCProtects vblank count and time updates during vblank enable/disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$hjV ubj)}(hY``vbl_lock`` Top-level vblank references lock, wraps the low-level **vblank_time_lock**. h](j)}(h ``vbl_lock``h]j)}(hj&h]hvbl_lock}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM+hj ubj)}(hhh]h)}(hKTop-level vblank references lock, wraps the low-level **vblank_time_lock**.h](h6Top-level vblank references lock, wraps the low-level }(hj?hhhNhNubjB)}(h**vblank_time_lock**h]hvblank_time_lock}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj?ubh.}(hj?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM*hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hM+hjV ubj)}(hX``max_vblank_count`` Maximum value of the vblank registers. This value +1 will result in a wrap-around of the vblank register. It is used by the vblank core to handle wrap-arounds. If set to zero the vblank core will try to guess the elapsed vblanks between times when the vblank interrupt is disabled through high-precision timestamps. That approach is suffering from small races and imprecision over longer time periods, hence exposing a hardware vblank counter is always recommended. This is the statically configured device wide maximum. The driver can instead choose to use a runtime configurable per-crtc value :c:type:`drm_vblank_crtc.max_vblank_count `, in which case **max_vblank_count** must be left at zero. See drm_crtc_set_max_vblank_count() on how to use the per-crtc value. If non-zero, :c:type:`drm_crtc_funcs.get_vblank_counter ` must be set. h](j)}(h``max_vblank_count``h]j)}(hjrh]hmax_vblank_count}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM@hjlubj)}(hhh](h)}(hMaximum value of the vblank registers. This value +1 will result in a wrap-around of the vblank register. It is used by the vblank core to handle wrap-arounds.h]hMaximum value of the vblank registers. This value +1 will result in a wrap-around of the vblank register. It is used by the vblank core to handle wrap-arounds.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM0hjubh)}(hX1If set to zero the vblank core will try to guess the elapsed vblanks between times when the vblank interrupt is disabled through high-precision timestamps. That approach is suffering from small races and imprecision over longer time periods, hence exposing a hardware vblank counter is always recommended.h]hX1If set to zero the vblank core will try to guess the elapsed vblanks between times when the vblank interrupt is disabled through high-precision timestamps. That approach is suffering from small races and imprecision over longer time periods, hence exposing a hardware vblank counter is always recommended.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM4hjubh)}(hX>This is the statically configured device wide maximum. The driver can instead choose to use a runtime configurable per-crtc value :c:type:`drm_vblank_crtc.max_vblank_count `, in which case **max_vblank_count** must be left at zero. See drm_crtc_set_max_vblank_count() on how to use the per-crtc value.h](hThis is the statically configured device wide maximum. The driver can instead choose to use a runtime configurable per-crtc value }(hjhhhNhNubh)}(h<:c:type:`drm_vblank_crtc.max_vblank_count `h]j)}(hjh]h drm_vblank_crtc.max_vblank_count}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_vblank_crtcuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM:hjubh, in which case }(hjhhhNhNubjB)}(h**max_vblank_count**h]hmax_vblank_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh\ must be left at zero. See drm_crtc_set_max_vblank_count() on how to use the per-crtc value.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM:hjubh)}(hVIf non-zero, :c:type:`drm_crtc_funcs.get_vblank_counter ` must be set.h](h If non-zero, }(hjhhhNhNubh)}(h<:c:type:`drm_crtc_funcs.get_vblank_counter `h]j)}(hjh]h!drm_crtc_funcs.get_vblank_counter}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_crtc_funcsuh1hhjhM@hjubh must be set.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM@hjubeh}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjV ubj)}(h,``vblank_event_list`` List of vblank events h](j)}(h``vblank_event_list``h]j)}(hj0h]hvblank_event_list}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMFhj*ubj)}(hhh]h)}(hList of vblank eventsh]hList of vblank events}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhMFhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMFhjV ubj)}(h``event_lock`` Protects **vblank_event_list** and event delivery in general. See drm_send_event() and drm_send_event_locked(). h](j)}(h``event_lock``h]j)}(hjih]h event_lock}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMKhjcubj)}(hhh]h)}(hoProtects **vblank_event_list** and event delivery in general. See drm_send_event() and drm_send_event_locked().h](h Protects }(hjhhhNhNubjB)}(h**vblank_event_list**h]hvblank_event_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubhQ and event delivery in general. See drm_send_event() and drm_send_event_locked().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMJhjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhj~hMKhjV ubj)}(h-``num_crtcs`` Number of CRTCs on this device h](j)}(h ``num_crtcs``h]j)}(hjh]h num_crtcs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMQhjubj)}(hhh]h)}(hNumber of CRTCs on this deviceh]hNumber of CRTCs on this device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMQhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMQhjV ubj)}(h$``mode_config`` Current mode config h](j)}(h``mode_config``h]j)}(hjh]h mode_config}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMThjubj)}(hhh]h)}(hCurrent mode configh]hCurrent mode config}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMThjV ubj)}(h%``object_name_lock`` GEM information h](j)}(h``object_name_lock``h]j)}(hj'h]hobject_name_lock}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMWhj!ubj)}(hhh]h)}(hGEM informationh]hGEM information}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMWhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMWhjV ubj)}(h$``object_name_idr`` GEM information h](j)}(h``object_name_idr``h]j)}(hj`h]hobject_name_idr}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMZhjZubj)}(hhh]h)}(hGEM informationh]hGEM information}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMZhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMZhjV ubj)}(h'``vma_offset_manager`` GEM information h](j)}(h``vma_offset_manager``h]j)}(hjh]hvma_offset_manager}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM]hjubj)}(hhh]h)}(hGEM informationh]hGEM information}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjV ubj)}(h#``vram_mm`` VRAM MM memory manager h](j)}(h ``vram_mm``h]j)}(hjh]hvram_mm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM`hjubj)}(hhh]h)}(hVRAM MM memory managerh]hVRAM MM memory manager}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM`hjV ubj)}(h``switch_power_state`` Power state of the client. Used by drivers supporting the switcheroo driver. The state is maintained in the :c:type:`vga_switcheroo_client_ops.set_gpu_state ` callback h](j)}(h``switch_power_state``h]j)}(hj h]hswitch_power_state}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMghjubj)}(hhh]h)}(hPower state of the client. Used by drivers supporting the switcheroo driver. The state is maintained in the :c:type:`vga_switcheroo_client_ops.set_gpu_state ` callbackh](hlPower state of the client. Used by drivers supporting the switcheroo driver. The state is maintained in the }(hj$hhhNhNubh)}(hM:c:type:`vga_switcheroo_client_ops.set_gpu_state `h]j)}(hj.h]h'vga_switcheroo_client_ops.set_gpu_state}(hj0hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j vga_switcheroo_client_opsuh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMdhj$ubh callback}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjKhMdhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMghjV ubj)}(hy``fb_helper`` Pointer to the fbdev emulation structure. Set by drm_fb_helper_init() and cleared by drm_fb_helper_fini(). h](j)}(h ``fb_helper``h]j)}(hjhh]h fb_helper}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMohjbubj)}(hhh]h)}(hjPointer to the fbdev emulation structure. Set by drm_fb_helper_init() and cleared by drm_fb_helper_fini().h]hjPointer to the fbdev emulation structure. Set by drm_fb_helper_init() and cleared by drm_fb_helper_fini().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMnhj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hMohjV ubj)}(h3``debugfs_root`` Root directory for debugfs files. h](j)}(h``debugfs_root``h]j)}(hjh]h debugfs_root}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMvhjubj)}(hhh]h)}(h!Root directory for debugfs files.h]h!Root directory for debugfs files.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMvhjV ubj)}(hG``gem_lru_mutex`` Lock protecting movement of GEM objects between LRUs.h](j)}(h``gem_lru_mutex``h]j)}(hjh]h gem_lru_mutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM|hjubj)}(hhh]h)}(h5Lock protecting movement of GEM objects between LRUs.h]h5Lock protecting movement of GEM objects between LRUs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhM}hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hjV ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubh)}(h**Description**h]jB)}(hjh]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjHhhubh)}(hIThis structure represent a complete card that may contain multiple heads.h]hIThis structure represent a complete card that may contain multiple heads.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhKGhjHhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dev_dma_dev (C function)c.drm_dev_dma_devhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h8struct device * drm_dev_dma_dev (struct drm_device *dev)h]j)}(h6struct device *drm_dev_dma_dev(struct drm_device *dev)h](j)}(hjh]hstruct}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjihMubh)}(hhh]j)}(hdeviceh]hdevice}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&] refdomainjreftype identifier reftargetj}modnameN classnameNj j )}j ]j ASTIdentifier)}jdrm_dev_dma_devsbc.drm_dev_dma_devasbuh1hhjXhhhjihMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjihMubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjXhhhjihMubj)}(hdrm_dev_dma_devh]j)}(hjh]hdrm_dev_dma_dev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjXhhhjihMubhdesc_parameterlist)}(h(struct drm_device *dev)h]hdesc_parameter)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_dev_dma_devasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdevh]hdev}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubah}(h]h ]h"]h$]h&]j+j,uh1jhjXhhhjihMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjThhhjihMubah}(h]jOah ](jj eh"]h$]h&]j j)jhuh1jhjihMhjQhhubj)}(hhh]h)}(h'returns the DMA device for a DRM deviceh]h'returns the DMA device for a DRM device}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj_hhubah}(h]h ]h"]h$]h&]uh1jhjQhhhjihMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jzj3jzj4j5j6uh1jhhhjHhNhNubj8)}(h**Parameters** ``struct drm_device *dev`` DRM device **Description** Returns the DMA device of the given DRM device. By default, this the DRM device's parent. See drm_dev_set_dma_dev(). **Return** A DMA-capable device for the DRM device.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj~ubj)}(hhh]j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjh]hstruct drm_device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhjubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj~ubh)}(htReturns the DMA device of the given DRM device. By default, this the DRM device's parent. See drm_dev_set_dma_dev().h]hvReturns the DMA device of the given DRM device. By default, this the DRM device’s parent. See drm_dev_set_dma_dev().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj~ubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj~ubh)}(h(A DMA-capable device for the DRM device.h]h(A DMA-capable device for the DRM device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:86: ./include/drm/drm_device.hhMhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_driver_feature (C enum)c.drm_driver_featurehNtauh1jhjHhhhNhNubj)}(hhh](j)}(hdrm_driver_featureh]j)}(henum drm_driver_featureh](j)}(hj) h]henum}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhjWhKubj)}(hdrm_driver_featureh]j)}(hjDh]hdrm_driver_feature}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjFhhhjWhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjBhhhjWhKubah}(h]j=ah ](jj eh"]h$]h&]j j)jhuh1jhjWhKhj?hhubj)}(hhh]h)}(h feature flagsh]h feature flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK5hjhhubah}(h]h ]h"]h$]h&]uh1jhj?hhhjWhKubeh}(h]h ](jenumeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjHhNhNubj8)}(hXt**Constants** ``DRIVER_GEM`` Driver use the GEM memory manager. This should be set for all modern drivers. ``DRIVER_MODESET`` Driver supports mode setting interfaces (KMS). ``DRIVER_RENDER`` Driver supports dedicated render nodes. See also the :ref:`section on render nodes ` for details. ``DRIVER_ATOMIC`` Driver supports the full atomic modesetting userspace API. Drivers which only use atomic internally, but do not support the full userspace API (e.g. not all properties converted to atomic, or multi-plane updates are not guaranteed to be tear-free) should not set this flag. ``DRIVER_SYNCOBJ`` Driver supports :c:type:`drm_syncobj` for explicit synchronization of command submission. ``DRIVER_SYNCOBJ_TIMELINE`` Driver supports the timeline flavor of :c:type:`drm_syncobj` for explicit synchronization of command submission. ``DRIVER_COMPUTE_ACCEL`` Driver supports compute acceleration devices. This flag is mutually exclusive with **DRIVER_RENDER** and **DRIVER_MODESET**. Devices that support both graphics and compute acceleration should be handled by two drivers that are connected using auxiliary bus. ``DRIVER_CURSOR_HOTSPOT`` Driver supports and requires cursor hotspot information in the cursor plane (e.g. cursor plane has to actually track the mouse cursor and the clients are required to set hotspot in order for the cursor planes to work correctly). ``DRIVER_USE_AGP`` Set up DRM AGP support, see drm_agp_init(), the DRM core will manage AGP resources. New drivers don't need this. ``DRIVER_LEGACY`` Denote a legacy driver using shadow attach. Do not use. ``DRIVER_PCI_DMA`` Driver is capable of PCI DMA, mapping of PCI DMA buffers to userspace will be enabled. Only for legacy drivers. Do not use. ``DRIVER_SG`` Driver can perform scatter/gather DMA, allocation and mapping of scatter/gather buffers will be enabled. Only for legacy drivers. Do not use. ``DRIVER_HAVE_DMA`` Driver supports DMA, the userspace DMA API will be supported. Only for legacy drivers. Do not use. ``DRIVER_HAVE_IRQ`` Legacy irq support. Only for legacy drivers. Do not use.h](h)}(h **Constants**h]jB)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK9hjubj)}(hhh](j)}(h]``DRIVER_GEM`` Driver use the GEM memory manager. This should be set for all modern drivers. h](j)}(h``DRIVER_GEM``h]j)}(hjh]h DRIVER_GEM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK=hjubj)}(hhh]h)}(hMDriver use the GEM memory manager. This should be set for all modern drivers.h]hMDriver use the GEM memory manager. This should be set for all modern drivers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK` for details. h](j)}(h``DRIVER_RENDER``h]j)}(hj@h]h DRIVER_RENDER}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKDhj:ubj)}(hhh]h)}(hrDriver supports dedicated render nodes. See also the :ref:`section on render nodes ` for details.h](h5Driver supports dedicated render nodes. See also the }(hjYhhhNhNubh)}(h0:ref:`section on render nodes `h]hinline)}(hjch]hsection on render nodes}(hjghhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjaubah}(h]h ]h"]h$]h&]refdocj refdomainjqreftyperef refexplicitrefwarnj drm_render_nodeuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKChjYubh for details.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKChjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhKDhjubj)}(hX$``DRIVER_ATOMIC`` Driver supports the full atomic modesetting userspace API. Drivers which only use atomic internally, but do not support the full userspace API (e.g. not all properties converted to atomic, or multi-plane updates are not guaranteed to be tear-free) should not set this flag. h](j)}(h``DRIVER_ATOMIC``h]j)}(hjh]h DRIVER_ATOMIC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKKhjubj)}(hhh]h)}(hXDriver supports the full atomic modesetting userspace API. Drivers which only use atomic internally, but do not support the full userspace API (e.g. not all properties converted to atomic, or multi-plane updates are not guaranteed to be tear-free) should not set this flag.h]hXDriver supports the full atomic modesetting userspace API. Drivers which only use atomic internally, but do not support the full userspace API (e.g. not all properties converted to atomic, or multi-plane updates are not guaranteed to be tear-free) should not set this flag.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKKhjubj)}(hm``DRIVER_SYNCOBJ`` Driver supports :c:type:`drm_syncobj` for explicit synchronization of command submission. h](j)}(h``DRIVER_SYNCOBJ``h]j)}(hjh]hDRIVER_SYNCOBJ}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKOhjubj)}(hhh]h)}(hYDriver supports :c:type:`drm_syncobj` for explicit synchronization of command submission.h](hDriver supports }(hjhhhNhNubh)}(h:c:type:`drm_syncobj`h]j)}(hjh]h drm_syncobj}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_syncobjuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKNhjubh4 for explicit synchronization of command submission.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKOhjubj)}(h``DRIVER_SYNCOBJ_TIMELINE`` Driver supports the timeline flavor of :c:type:`drm_syncobj` for explicit synchronization of command submission. h](j)}(h``DRIVER_SYNCOBJ_TIMELINE``h]j)}(hj7h]hDRIVER_SYNCOBJ_TIMELINE}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKShj1ubj)}(hhh]h)}(hpDriver supports the timeline flavor of :c:type:`drm_syncobj` for explicit synchronization of command submission.h](h'Driver supports the timeline flavor of }(hjPhhhNhNubh)}(h:c:type:`drm_syncobj`h]j)}(hjZh]h drm_syncobj}(hj\hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_syncobjuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKRhjPubh4 for explicit synchronization of command submission.}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjwhKRhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhKShjubj)}(hX``DRIVER_COMPUTE_ACCEL`` Driver supports compute acceleration devices. This flag is mutually exclusive with **DRIVER_RENDER** and **DRIVER_MODESET**. Devices that support both graphics and compute acceleration should be handled by two drivers that are connected using auxiliary bus. h](j)}(h``DRIVER_COMPUTE_ACCEL``h]j)}(hjh]hDRIVER_COMPUTE_ACCEL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKXhjubj)}(hhh]h)}(hXDriver supports compute acceleration devices. This flag is mutually exclusive with **DRIVER_RENDER** and **DRIVER_MODESET**. Devices that support both graphics and compute acceleration should be handled by two drivers that are connected using auxiliary bus.h](hSDriver supports compute acceleration devices. This flag is mutually exclusive with }(hjhhhNhNubjB)}(h**DRIVER_RENDER**h]h DRIVER_RENDER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh and }(hjhhhNhNubjB)}(h**DRIVER_MODESET**h]hDRIVER_MODESET}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh. Devices that support both graphics and compute acceleration should be handled by two drivers that are connected using auxiliary bus.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKVhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKXhjubj)}(h``DRIVER_CURSOR_HOTSPOT`` Driver supports and requires cursor hotspot information in the cursor plane (e.g. cursor plane has to actually track the mouse cursor and the clients are required to set hotspot in order for the cursor planes to work correctly). h](j)}(h``DRIVER_CURSOR_HOTSPOT``h]j)}(hjh]hDRIVER_CURSOR_HOTSPOT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK^hjubj)}(hhh]h)}(hDriver supports and requires cursor hotspot information in the cursor plane (e.g. cursor plane has to actually track the mouse cursor and the clients are required to set hotspot in order for the cursor planes to work correctly).h]hDriver supports and requires cursor hotspot information in the cursor plane (e.g. cursor plane has to actually track the mouse cursor and the clients are required to set hotspot in order for the cursor planes to work correctly).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK^hjubj)}(h``DRIVER_USE_AGP`` Set up DRM AGP support, see drm_agp_init(), the DRM core will manage AGP resources. New drivers don't need this. h](j)}(h``DRIVER_USE_AGP``h]j)}(hj,h]hDRIVER_USE_AGP}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKbhj&ubj)}(hhh]h)}(hpSet up DRM AGP support, see drm_agp_init(), the DRM core will manage AGP resources. New drivers don't need this.h]hrSet up DRM AGP support, see drm_agp_init(), the DRM core will manage AGP resources. New drivers don’t need this.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKahjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhKbhjubj)}(hJ``DRIVER_LEGACY`` Denote a legacy driver using shadow attach. Do not use. h](j)}(h``DRIVER_LEGACY``h]j)}(hjfh]h DRIVER_LEGACY}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKehj`ubj)}(hhh]h)}(h7Denote a legacy driver using shadow attach. Do not use.h]h7Denote a legacy driver using shadow attach. Do not use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hKehj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hKehjubj)}(h``DRIVER_PCI_DMA`` Driver is capable of PCI DMA, mapping of PCI DMA buffers to userspace will be enabled. Only for legacy drivers. Do not use. h](j)}(h``DRIVER_PCI_DMA``h]j)}(hjh]hDRIVER_PCI_DMA}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKihjubj)}(hhh]h)}(h{Driver is capable of PCI DMA, mapping of PCI DMA buffers to userspace will be enabled. Only for legacy drivers. Do not use.h]h{Driver is capable of PCI DMA, mapping of PCI DMA buffers to userspace will be enabled. Only for legacy drivers. Do not use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKihjubj)}(h``DRIVER_SG`` Driver can perform scatter/gather DMA, allocation and mapping of scatter/gather buffers will be enabled. Only for legacy drivers. Do not use. h](j)}(h ``DRIVER_SG``h]j)}(hjh]h DRIVER_SG}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKnhjubj)}(hhh]h)}(hDriver can perform scatter/gather DMA, allocation and mapping of scatter/gather buffers will be enabled. Only for legacy drivers. Do not use.h]hDriver can perform scatter/gather DMA, allocation and mapping of scatter/gather buffers will be enabled. Only for legacy drivers. Do not use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKlhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKnhjubj)}(hw``DRIVER_HAVE_DMA`` Driver supports DMA, the userspace DMA API will be supported. Only for legacy drivers. Do not use. h](j)}(h``DRIVER_HAVE_DMA``h]j)}(hjh]hDRIVER_HAVE_DMA}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKrhj ubj)}(hhh]h)}(hbDriver supports DMA, the userspace DMA API will be supported. Only for legacy drivers. Do not use.4h]hbDriver supports DMA, the userspace DMA API will be supported. Only for legacy drivers. Do not use.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKqhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hKrhjubj)}(hL``DRIVER_HAVE_IRQ`` Legacy irq support. Only for legacy drivers. Do not use.h](j)}(h``DRIVER_HAVE_IRQ``h]j)}(hjMh]hDRIVER_HAVE_IRQ}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKthjGubj)}(hhh]h)}(h8Legacy irq support. Only for legacy drivers. Do not use.h]h8Legacy irq support. Only for legacy drivers. Do not use.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKuhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhKthjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKwhjHhhubh)}(hoSee :c:type:`drm_driver.driver_features `, drm_device.driver_features and drm_core_check_feature().h](hSee }(hjhhhNhNubh)}(h1:c:type:`drm_driver.driver_features `h]j)}(hjh]hdrm_driver.driver_features}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK6hjubh:, drm_device.driver_features and drm_core_check_feature().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK6hjHhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_driver (C struct) c.drm_driverhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h drm_driverh]j)}(hstruct drm_driverh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhK`. This is deprecated, do not use! Returns: Zero on success, non-zero value on failure. ``open`` Driver callback when a new :c:type:`struct drm_file ` is opened. Useful for setting up driver-private data structures like buffer allocators, execution contexts or similar things. Such driver-private resources must be released again in **postclose**. Since the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to set up any modeset related resources in this callback. Doing so would be a driver design bug. Returns: 0 on success, a negative error code on failure, which will be promoted to userspace as the result of the open() system call. ``postclose`` One of the driver callbacks when a new :c:type:`struct drm_file ` is closed. Useful for tearing down driver-private data structures allocated in **open** like buffer allocators, execution contexts or similar things. Since the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to tear down any modeset related resources in this callback. Doing so would be a driver design bug. ``unload`` Reverse the effects of the driver load callback. Ideally, the clean up performed by the driver should happen in the reverse order of the initialization. Similarly to the load hook, this handler is deprecated and its usage should be dropped in favor of an open-coded teardown function at the driver layer. See drm_dev_unregister() and drm_dev_put() for the proper way to remove a :c:type:`struct drm_device `. The unload() hook is called right after unregistering the device. ``release`` Optional callback for destroying device data after the final reference is released, i.e. the device is being destroyed. This is deprecated, clean up all memory allocations associated with a :c:type:`drm_device` using drmm_add_action(), drmm_kmalloc() and related managed resources functions. ``master_set`` Called whenever the minor master is set. Only used by vmwgfx. ``master_drop`` Called whenever the minor master is dropped. Only used by vmwgfx. ``debugfs_init`` Allows drivers to create driver-specific debugfs files. ``gem_create_object`` constructor for gem objects Hook for allocating the GEM object struct, for use by the CMA and SHMEM GEM helpers. Returns a GEM object on success, or an ERR_PTR()-encoded error code otherwise. ``prime_handle_to_fd`` PRIME export function. Only used by vmwgfx. ``prime_fd_to_handle`` PRIME import function. Only used by vmwgfx. ``gem_prime_import`` Import hook for GEM drivers. This defaults to drm_gem_prime_import() if not set. ``gem_prime_import_sg_table`` Optional hook used by the PRIME helper functions drm_gem_prime_import() respectively drm_gem_prime_import_dev(). ``dumb_create`` This creates a new dumb buffer in the driver's backing storage manager (GEM, TTM or something else entirely) and returns the resulting buffer handle. This handle can then be wrapped up into a framebuffer modeset object. Note that userspace is not allowed to use such objects for render acceleration - drivers must create their own private ioctls for such a use case. Width, height and depth are specified in the :c:type:`drm_mode_create_dumb` argument. The callback needs to fill the handle, pitch and size for the created buffer. Called by the user via ioctl. Returns: Zero on success, negative errno on failure. ``dumb_map_offset`` Allocate an offset in the drm device node's address space to be able to memory map a dumb buffer. The default implementation is drm_gem_create_mmap_offset(). GEM based drivers must not overwrite this. Called by the user via ioctl. Returns: Zero on success, negative errno on failure. ``fbdev_probe`` Allocates and initialize the fb_info structure for fbdev emulation. Furthermore it also needs to allocate the DRM framebuffer used to back the fbdev. This callback is mandatory for fbdev support. Returns: 0 on success ot a negative error code otherwise. ``show_fdinfo`` Print device specific fdinfo. See Documentation/gpu/drm-usage-stats.rst. ``major`` driver major number ``minor`` driver minor number ``patchlevel`` driver patch level ``name`` driver name ``desc`` driver description ``driver_features`` Driver features, see :c:type:`enum drm_driver_feature `. Drivers can disable some features on a per-instance basis using :c:type:`drm_device.driver_features `. ``ioctls`` Array of driver-private IOCTL description entries. See the chapter on :ref:`IOCTL support in the userland interfaces chapter` for the full details. ``num_ioctls`` Number of entries in **ioctls**. ``fops`` File operations for the DRM device node. See the discussion in :ref:`file operations` for in-depth coverage and some examples.h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hjW hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjS ubh:}(hjS hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjO ubj)}(hXstruct drm_driver { int (*load) (struct drm_device *, unsigned long flags); int (*open) (struct drm_device *, struct drm_file *); void (*postclose) (struct drm_device *, struct drm_file *); void (*unload) (struct drm_device *); void (*release) (struct drm_device *); void (*master_set)(struct drm_device *dev, struct drm_file *file_priv, bool from_open); void (*master_drop)(struct drm_device *dev, struct drm_file *file_priv); void (*debugfs_init)(struct drm_minor *minor); struct drm_gem_object *(*gem_create_object)(struct drm_device *dev, size_t size); int (*prime_handle_to_fd)(struct drm_device *dev, struct drm_file *file_priv, uint32_t handle, uint32_t flags, int *prime_fd); int (*prime_fd_to_handle)(struct drm_device *dev, struct drm_file *file_priv, int prime_fd, uint32_t *handle); struct drm_gem_object * (*gem_prime_import)(struct drm_device *dev, struct dma_buf *dma_buf); struct drm_gem_object *(*gem_prime_import_sg_table)( struct drm_device *dev, struct dma_buf_attachment *attach, struct sg_table *sgt); int (*dumb_create)(struct drm_file *file_priv, struct drm_device *dev, struct drm_mode_create_dumb *args); int (*dumb_map_offset)(struct drm_file *file_priv, struct drm_device *dev, uint32_t handle, uint64_t *offset); int (*fbdev_probe)(struct drm_fb_helper *fbdev_helper, struct drm_fb_helper_surface_size *sizes); void (*show_fdinfo)(struct drm_printer *p, struct drm_file *f); int major; int minor; int patchlevel; char *name; char *desc; u32 driver_features; const struct drm_ioctl_desc *ioctls; int num_ioctls; const struct file_operations *fops; };h]hXstruct drm_driver { int (*load) (struct drm_device *, unsigned long flags); int (*open) (struct drm_device *, struct drm_file *); void (*postclose) (struct drm_device *, struct drm_file *); void (*unload) (struct drm_device *); void (*release) (struct drm_device *); void (*master_set)(struct drm_device *dev, struct drm_file *file_priv, bool from_open); void (*master_drop)(struct drm_device *dev, struct drm_file *file_priv); void (*debugfs_init)(struct drm_minor *minor); struct drm_gem_object *(*gem_create_object)(struct drm_device *dev, size_t size); int (*prime_handle_to_fd)(struct drm_device *dev, struct drm_file *file_priv, uint32_t handle, uint32_t flags, int *prime_fd); int (*prime_fd_to_handle)(struct drm_device *dev, struct drm_file *file_priv, int prime_fd, uint32_t *handle); struct drm_gem_object * (*gem_prime_import)(struct drm_device *dev, struct dma_buf *dma_buf); struct drm_gem_object *(*gem_prime_import_sg_table)( struct drm_device *dev, struct dma_buf_attachment *attach, struct sg_table *sgt); int (*dumb_create)(struct drm_file *file_priv, struct drm_device *dev, struct drm_mode_create_dumb *args); int (*dumb_map_offset)(struct drm_file *file_priv, struct drm_device *dev, uint32_t handle, uint64_t *offset); int (*fbdev_probe)(struct drm_fb_helper *fbdev_helper, struct drm_fb_helper_surface_size *sizes); void (*show_fdinfo)(struct drm_printer *p, struct drm_file *f); int major; int minor; int patchlevel; char *name; char *desc; u32 driver_features; const struct drm_ioctl_desc *ioctls; int num_ioctls; const struct file_operations *fops; };}hjp sbah}(h]h ]h"]h$]h&]j+j,uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjO ubh)}(h **Members**h]jB)}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjO ubj)}(hhh](j)}(hX``load`` Backward-compatible driver callback to complete initialization steps after the driver is registered. For this reason, may suffer from race conditions and its use is deprecated for new drivers. It is therefore only supported for existing drivers not yet converted to the new scheme. See devm_drm_dev_alloc() and drm_dev_register() for proper and race-free way to set up a :c:type:`struct drm_device `. This is deprecated, do not use! Returns: Zero on success, non-zero value on failure. h](j)}(h``load``h]j)}(hj h]hload}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj ubj)}(hhh](h)}(hXBackward-compatible driver callback to complete initialization steps after the driver is registered. For this reason, may suffer from race conditions and its use is deprecated for new drivers. It is therefore only supported for existing drivers not yet converted to the new scheme. See devm_drm_dev_alloc() and drm_dev_register() for proper and race-free way to set up a :c:type:`struct drm_device `.h](hXvBackward-compatible driver callback to complete initialization steps after the driver is registered. For this reason, may suffer from race conditions and its use is deprecated for new drivers. It is therefore only supported for existing drivers not yet converted to the new scheme. See devm_drm_dev_alloc() and drm_dev_register() for proper and race-free way to set up a }(hj hhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hj h]hstruct drm_device}(hj hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hKhj ubh)}(hThis is deprecated, do not use!h]hThis is deprecated, do not use!}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj ubh)}(hReturns:h]hReturns:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj ubh)}(h+Zero on success, non-zero value on failure.h]h+Zero on success, non-zero value on failure.}(hj !hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(hX``open`` Driver callback when a new :c:type:`struct drm_file ` is opened. Useful for setting up driver-private data structures like buffer allocators, execution contexts or similar things. Such driver-private resources must be released again in **postclose**. Since the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to set up any modeset related resources in this callback. Doing so would be a driver design bug. Returns: 0 on success, a negative error code on failure, which will be promoted to userspace as the result of the open() system call. h](j)}(h``open``h]j)}(hj)!h]hopen}(hj+!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj#!ubj)}(hhh](h)}(hXDriver callback when a new :c:type:`struct drm_file ` is opened. Useful for setting up driver-private data structures like buffer allocators, execution contexts or similar things. Such driver-private resources must be released again in **postclose**.h](hDriver callback when a new }(hjB!hhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hjL!h]hstruct drm_file}(hjN!hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjJ!ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjB!ubh is opened. Useful for setting up driver-private data structures like buffer allocators, execution contexts or similar things. Such driver-private resources must be released again in }(hjB!hhhNhNubjB)}(h **postclose**h]h postclose}(hjn!hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjB!ubh.}(hjB!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhji!hKhj?!ubh)}(hXDSince the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to set up any modeset related resources in this callback. Doing so would be a driver design bug.h](hGSince the display/modeset side of DRM can only be owned by exactly one }(hj!hhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hj!h]hstruct drm_file}(hj!hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj!ubh (see }(hj!hhhNhNubh)}(h':c:type:`drm_file.is_master `h]j)}(hj!h]hdrm_file.is_master}(hj!hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhj!hKhj!ubh and }(hj!hhhNhNubh)}(h(:c:type:`drm_device.master `h]j)}(hj!h]hdrm_device.master}(hj!hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj!hKhj!ubh) there should never be a need to set up any modeset related resources in this callback. Doing so would be a driver design bug.}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj!hKhj?!ubh)}(hReturns:h]hReturns:}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj?!ubh)}(h|0 on success, a negative error code on failure, which will be promoted to userspace as the result of the open() system call.h]h|0 on success, a negative error code on failure, which will be promoted to userspace as the result of the open() system call.}(hj "hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj?!ubeh}(h]h ]h"]h$]h&]uh1jhj#!ubeh}(h]h ]h"]h$]h&]uh1jhj>!hKhj ubj)}(hX9``postclose`` One of the driver callbacks when a new :c:type:`struct drm_file ` is closed. Useful for tearing down driver-private data structures allocated in **open** like buffer allocators, execution contexts or similar things. Since the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to tear down any modeset related resources in this callback. Doing so would be a driver design bug. h](j)}(h ``postclose``h]j)}(hj."h]h postclose}(hj0"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,"ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj("ubj)}(hhh](h)}(hOne of the driver callbacks when a new :c:type:`struct drm_file ` is closed. Useful for tearing down driver-private data structures allocated in **open** like buffer allocators, execution contexts or similar things.h](h'One of the driver callbacks when a new }(hjG"hhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hjQ"h]hstruct drm_file}(hjS"hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjO"ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjG"ubhP is closed. Useful for tearing down driver-private data structures allocated in }(hjG"hhhNhNubjB)}(h**open**h]hopen}(hjs"hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjG"ubh> like buffer allocators, execution contexts or similar things.}(hjG"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjn"hKhjD"ubh)}(hXGSince the display/modeset side of DRM can only be owned by exactly one :c:type:`struct drm_file ` (see :c:type:`drm_file.is_master ` and :c:type:`drm_device.master `) there should never be a need to tear down any modeset related resources in this callback. Doing so would be a driver design bug.h](hGSince the display/modeset side of DRM can only be owned by exactly one }(hj"hhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hj"h]hstruct drm_file}(hj"hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj"ubh (see }(hj"hhhNhNubh)}(h':c:type:`drm_file.is_master `h]j)}(hj"h]hdrm_file.is_master}(hj"hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhj"hKhj"ubh and }(hj"hhhNhNubh)}(h(:c:type:`drm_device.master `h]j)}(hj"h]hdrm_device.master}(hj"hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj"hKhj"ubh) there should never be a need to tear down any modeset related resources in this callback. Doing so would be a driver design bug.}(hj"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj"hKhjD"ubeh}(h]h ]h"]h$]h&]uh1jhj("ubeh}(h]h ]h"]h$]h&]uh1jhjC"hKhj ubj)}(hX``unload`` Reverse the effects of the driver load callback. Ideally, the clean up performed by the driver should happen in the reverse order of the initialization. Similarly to the load hook, this handler is deprecated and its usage should be dropped in favor of an open-coded teardown function at the driver layer. See drm_dev_unregister() and drm_dev_put() for the proper way to remove a :c:type:`struct drm_device `. The unload() hook is called right after unregistering the device. h](j)}(h ``unload``h]j)}(hj#h]hunload}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj#ubj)}(hhh](h)}(hXReverse the effects of the driver load callback. Ideally, the clean up performed by the driver should happen in the reverse order of the initialization. Similarly to the load hook, this handler is deprecated and its usage should be dropped in favor of an open-coded teardown function at the driver layer. See drm_dev_unregister() and drm_dev_put() for the proper way to remove a :c:type:`struct drm_device `.h](hX~Reverse the effects of the driver load callback. Ideally, the clean up performed by the driver should happen in the reverse order of the initialization. Similarly to the load hook, this handler is deprecated and its usage should be dropped in favor of an open-coded teardown function at the driver layer. See drm_dev_unregister() and drm_dev_put() for the proper way to remove a }(hj.#hhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hj8#h]hstruct drm_device}(hj:#hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj6#ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj.#ubh.}(hj.#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjU#hKhj+#ubh)}(hAThe unload() hook is called right after unregistering the device.h]hAThe unload() hook is called right after unregistering the device.}(hj`#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj+#ubeh}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj*#hKhj ubj)}(hX1``release`` Optional callback for destroying device data after the final reference is released, i.e. the device is being destroyed. This is deprecated, clean up all memory allocations associated with a :c:type:`drm_device` using drmm_add_action(), drmm_kmalloc() and related managed resources functions. h](j)}(h ``release``h]j)}(hj#h]hrelease}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj{#ubj)}(hhh](h)}(hwOptional callback for destroying device data after the final reference is released, i.e. the device is being destroyed.h]hwOptional callback for destroying device data after the final reference is released, i.e. the device is being destroyed.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj#ubh)}(hThis is deprecated, clean up all memory allocations associated with a :c:type:`drm_device` using drmm_add_action(), drmm_kmalloc() and related managed resources functions.h](hFThis is deprecated, clean up all memory allocations associated with a }(hj#hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj#h]h drm_device}(hj#hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhj#ubhQ using drmm_add_action(), drmm_kmalloc() and related managed resources functions.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj#hKhj#ubeh}(h]h ]h"]h$]h&]uh1jhj{#ubeh}(h]h ]h"]h$]h&]uh1jhj#hKhj ubj)}(hM``master_set`` Called whenever the minor master is set. Only used by vmwgfx. h](j)}(h``master_set``h]j)}(hj#h]h master_set}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj#ubj)}(hhh]h)}(h=Called whenever the minor master is set. Only used by vmwgfx.h]h=Called whenever the minor master is set. Only used by vmwgfx.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hMhj$ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj ubj)}(hR``master_drop`` Called whenever the minor master is dropped. Only used by vmwgfx. h](j)}(h``master_drop``h]j)}(hj&$h]h master_drop}(hj($hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM hj $ubj)}(hhh]h)}(hACalled whenever the minor master is dropped. Only used by vmwgfx.h]hACalled whenever the minor master is dropped. Only used by vmwgfx.}(hj?$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;$hM hj<$ubah}(h]h ]h"]h$]h&]uh1jhj $ubeh}(h]h ]h"]h$]h&]uh1jhj;$hM hj ubj)}(hI``debugfs_init`` Allows drivers to create driver-specific debugfs files. h](j)}(h``debugfs_init``h]j)}(hj_$h]h debugfs_init}(hja$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjY$ubj)}(hhh]h)}(h7Allows drivers to create driver-specific debugfs files.h]h7Allows drivers to create driver-specific debugfs files.}(hjx$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt$hMhju$ubah}(h]h ]h"]h$]h&]uh1jhjY$ubeh}(h]h ]h"]h$]h&]uh1jhjt$hMhj ubj)}(h``gem_create_object`` constructor for gem objects Hook for allocating the GEM object struct, for use by the CMA and SHMEM GEM helpers. Returns a GEM object on success, or an ERR_PTR()-encoded error code otherwise. h](j)}(h``gem_create_object``h]j)}(hj$h]hgem_create_object}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj$ubj)}(hhh](h)}(hconstructor for gem objectsh]hconstructor for gem objects}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj$ubh)}(hHook for allocating the GEM object struct, for use by the CMA and SHMEM GEM helpers. Returns a GEM object on success, or an ERR_PTR()-encoded error code otherwise.h]hHook for allocating the GEM object struct, for use by the CMA and SHMEM GEM helpers. Returns a GEM object on success, or an ERR_PTR()-encoded error code otherwise.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hMhj ubj)}(hC``prime_handle_to_fd`` PRIME export function. Only used by vmwgfx. h](j)}(h``prime_handle_to_fd``h]j)}(hj$h]hprime_handle_to_fd}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM#hj$ubj)}(hhh]h)}(h+PRIME export function. Only used by vmwgfx.h]h+PRIME export function. Only used by vmwgfx.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hM#hj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM#hj ubj)}(hC``prime_fd_to_handle`` PRIME import function. Only used by vmwgfx. h](j)}(h``prime_fd_to_handle``h]j)}(hj%h]hprime_fd_to_handle}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM*hj%ubj)}(hhh]h)}(h+PRIME import function. Only used by vmwgfx.h]h+PRIME import function. Only used by vmwgfx.}(hj3%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/%hM*hj0%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj/%hM*hj ubj)}(hg``gem_prime_import`` Import hook for GEM drivers. This defaults to drm_gem_prime_import() if not set. h](j)}(h``gem_prime_import``h]j)}(hjS%h]hgem_prime_import}(hjU%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ%ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM4hjM%ubj)}(hhh](h)}(hImport hook for GEM drivers.h]hImport hook for GEM drivers.}(hjl%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM2hji%ubh)}(h3This defaults to drm_gem_prime_import() if not set.h]h3This defaults to drm_gem_prime_import() if not set.}(hj{%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh%hM4hji%ubeh}(h]h ]h"]h$]h&]uh1jhjM%ubeh}(h]h ]h"]h$]h&]uh1jhjh%hM4hj ubj)}(h``gem_prime_import_sg_table`` Optional hook used by the PRIME helper functions drm_gem_prime_import() respectively drm_gem_prime_import_dev(). h](j)}(h``gem_prime_import_sg_table``h]j)}(hj%h]hgem_prime_import_sg_table}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM<hj%ubj)}(hhh]h)}(hpOptional hook used by the PRIME helper functions drm_gem_prime_import() respectively drm_gem_prime_import_dev().h]hpOptional hook used by the PRIME helper functions drm_gem_prime_import() respectively drm_gem_prime_import_dev().}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM;hj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hM<hj ubj)}(hX{``dumb_create`` This creates a new dumb buffer in the driver's backing storage manager (GEM, TTM or something else entirely) and returns the resulting buffer handle. This handle can then be wrapped up into a framebuffer modeset object. Note that userspace is not allowed to use such objects for render acceleration - drivers must create their own private ioctls for such a use case. Width, height and depth are specified in the :c:type:`drm_mode_create_dumb` argument. The callback needs to fill the handle, pitch and size for the created buffer. Called by the user via ioctl. Returns: Zero on success, negative errno on failure. h](j)}(h``dumb_create``h]j)}(hj%h]h dumb_create}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMVhj%ubj)}(hhh](h)}(hThis creates a new dumb buffer in the driver's backing storage manager (GEM, TTM or something else entirely) and returns the resulting buffer handle. This handle can then be wrapped up into a framebuffer modeset object.h]hThis creates a new dumb buffer in the driver’s backing storage manager (GEM, TTM or something else entirely) and returns the resulting buffer handle. This handle can then be wrapped up into a framebuffer modeset object.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMFhj%ubh)}(hNote that userspace is not allowed to use such objects for render acceleration - drivers must create their own private ioctls for such a use case.h]hNote that userspace is not allowed to use such objects for render acceleration - drivers must create their own private ioctls for such a use case.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMJhj%ubh)}(hWidth, height and depth are specified in the :c:type:`drm_mode_create_dumb` argument. The callback needs to fill the handle, pitch and size for the created buffer.h](h-Width, height and depth are specified in the }(hj &hhhNhNubh)}(h:c:type:`drm_mode_create_dumb`h]j)}(hj&h]hdrm_mode_create_dumb}(hj&hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_mode_create_dumbuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMNhj &ubhX argument. The callback needs to fill the handle, pitch and size for the created buffer.}(hj &hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj3&hMNhj%ubh)}(hCalled by the user via ioctl.h]hCalled by the user via ioctl.}(hj>&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMRhj%ubh)}(hReturns:h]hReturns:}(hjM&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMThj%ubh)}(h+Zero on success, negative errno on failure.h]h+Zero on success, negative errno on failure.}(hj\&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMVhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hMVhj ubj)}(hX4``dumb_map_offset`` Allocate an offset in the drm device node's address space to be able to memory map a dumb buffer. The default implementation is drm_gem_create_mmap_offset(). GEM based drivers must not overwrite this. Called by the user via ioctl. Returns: Zero on success, negative errno on failure. h](j)}(h``dumb_map_offset``h]j)}(hj|&h]hdumb_map_offset}(hj~&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhhjv&ubj)}(hhh](h)}(haAllocate an offset in the drm device node's address space to be able to memory map a dumb buffer.h]hcAllocate an offset in the drm device node’s address space to be able to memory map a dumb buffer.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM^hj&ubh)}(hfThe default implementation is drm_gem_create_mmap_offset(). GEM based drivers must not overwrite this.h]hfThe default implementation is drm_gem_create_mmap_offset(). GEM based drivers must not overwrite this.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMahj&ubh)}(hCalled by the user via ioctl.h]hCalled by the user via ioctl.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMdhj&ubh)}(hReturns:h]hReturns:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMfhj&ubh)}(h+Zero on success, negative errno on failure.h]h+Zero on success, negative errno on failure.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hMhhj&ubeh}(h]h ]h"]h$]h&]uh1jhjv&ubeh}(h]h ]h"]h$]h&]uh1jhj&hMhhj ubj)}(hX``fbdev_probe`` Allocates and initialize the fb_info structure for fbdev emulation. Furthermore it also needs to allocate the DRM framebuffer used to back the fbdev. This callback is mandatory for fbdev support. Returns: 0 on success ot a negative error code otherwise. h](j)}(h``fbdev_probe``h]j)}(hj&h]h fbdev_probe}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMyhj&ubj)}(hhh](h)}(hAllocates and initialize the fb_info structure for fbdev emulation. Furthermore it also needs to allocate the DRM framebuffer used to back the fbdev.h]hAllocates and initialize the fb_info structure for fbdev emulation. Furthermore it also needs to allocate the DRM framebuffer used to back the fbdev.}(hj 'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMqhj'ubh)}(h-This callback is mandatory for fbdev support.h]h-This callback is mandatory for fbdev support.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMuhj'ubh)}(hReturns:h]hReturns:}(hj('hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMwhj'ubh)}(h00 on success ot a negative error code otherwise.h]h00 on success ot a negative error code otherwise.}(hj7'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMyhj'ubeh}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj'hMyhj ubj)}(hZ``show_fdinfo`` Print device specific fdinfo. See Documentation/gpu/drm-usage-stats.rst. h](j)}(h``show_fdinfo``h]j)}(hjW'h]h show_fdinfo}(hjY'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjU'ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjQ'ubj)}(hhh]h)}(hIPrint device specific fdinfo. See Documentation/gpu/drm-usage-stats.rst.h]hIPrint device specific fdinfo. See Documentation/gpu/drm-usage-stats.rst.}(hjp'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjl'hMhjm'ubah}(h]h ]h"]h$]h&]uh1jhjQ'ubeh}(h]h ]h"]h$]h&]uh1jhjl'hMhj ubj)}(h``major`` driver major number h](j)}(h ``major``h]j)}(hj'h]hmajor}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj'ubj)}(hhh]h)}(hdriver major numberh]hdriver major number}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhj ubj)}(h``minor`` driver minor number h](j)}(h ``minor``h]j)}(hj'h]hminor}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj'ubj)}(hhh]h)}(hdriver minor numberh]hdriver minor number}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhj ubj)}(h"``patchlevel`` driver patch level h](j)}(h``patchlevel``h]j)}(hj(h]h patchlevel}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj'ubj)}(hhh]h)}(hdriver patch levelh]hdriver patch level}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj ubj)}(h``name`` driver name h](j)}(h``name``h]j)}(hj;(h]hname}(hj=(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj5(ubj)}(hhh]h)}(h driver nameh]h driver name}(hjT(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjP(hMhjQ(ubah}(h]h ]h"]h$]h&]uh1jhj5(ubeh}(h]h ]h"]h$]h&]uh1jhjP(hMhj ubj)}(h``desc`` driver description h](j)}(h``desc``h]j)}(hjt(h]hdesc}(hjv(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjn(ubj)}(hhh]h)}(hdriver descriptionh]hdriver description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhjn(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj ubj)}(h``driver_features`` Driver features, see :c:type:`enum drm_driver_feature `. Drivers can disable some features on a per-instance basis using :c:type:`drm_device.driver_features `. h](j)}(h``driver_features``h]j)}(hj(h]hdriver_features}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj(ubj)}(hhh]h)}(hDriver features, see :c:type:`enum drm_driver_feature `. Drivers can disable some features on a per-instance basis using :c:type:`drm_device.driver_features `.h](hDriver features, see }(hj(hhhNhNubh)}(h6:c:type:`enum drm_driver_feature `h]j)}(hj(h]henum drm_driver_feature}(hj(hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_driver_featureuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj(ubhB. Drivers can disable some features on a per-instance basis using }(hj(hhhNhNubh)}(h1:c:type:`drm_device.driver_features `h]j)}(hj(h]hdrm_device.driver_features}(hj(hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj(hMhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj ubj)}(h``ioctls`` Array of driver-private IOCTL description entries. See the chapter on :ref:`IOCTL support in the userland interfaces chapter` for the full details. h](j)}(h ``ioctls``h]j)}(hj-)h]hioctls}(hj/)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+)ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj')ubj)}(hhh]h)}(hArray of driver-private IOCTL description entries. See the chapter on :ref:`IOCTL support in the userland interfaces chapter` for the full details.h](hFArray of driver-private IOCTL description entries. See the chapter on }(hjF)hhhNhNubh)}(hI:ref:`IOCTL support in the userland interfaces chapter`h]jf)}(hjP)h]h0IOCTL support in the userland interfaces chapter}(hjR)hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjN)ubah}(h]h ]h"]h$]h&]refdocj refdomainj\)reftyperef refexplicitrefwarnj drm_driver_ioctluh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjF)ubh for the full details.}(hjF)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjn)hMhjC)ubah}(h]h ]h"]h$]h&]uh1jhj')ubeh}(h]h ]h"]h$]h&]uh1jhjB)hMhj ubj)}(h0``num_ioctls`` Number of entries in **ioctls**. h](j)}(h``num_ioctls``h]j)}(hj)h]h num_ioctls}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj)ubj)}(hhh]h)}(h Number of entries in **ioctls**.h](hNumber of entries in }(hj)hhhNhNubjB)}(h **ioctls**h]hioctls}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj)ubh.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj)hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhj)hMhj ubj)}(h``fops`` File operations for the DRM device node. See the discussion in :ref:`file operations` for in-depth coverage and some examples.h](j)}(h``fops``h]j)}(hj)h]hfops}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj)ubj)}(hhh]h)}(hFile operations for the DRM device node. See the discussion in :ref:`file operations` for in-depth coverage and some examples.h](h?File operations for the DRM device node. See the discussion in }(hj)hhhNhNubh)}(h':ref:`file operations`h]jf)}(hj)h]hfile operations}(hj)hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehj)ubah}(h]h ]h"]h$]h&]refdocj refdomainj*reftyperef refexplicitrefwarnj drm_driver_fopsuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj)ubh) for in-depth coverage and some examples.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj*hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhj)hMhj ubeh}(h]h ]h"]h$]h&]uh1jhjO ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubh)}(h**Description**h]jB)}(hj=*h]h Description}(hj?*hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj;*ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjHhhubh)}(hXdThis structure represent the common code for a family of cards. There will be one :c:type:`struct drm_device ` for each card present in this family. It contains lots of vfunc entries, and a pile of those probably should be moved to more appropriate places like :c:type:`drm_mode_config_funcs` or into a new operations structure for GEM drivers.h](hRThis structure represent the common code for a family of cards. There will be one }(hjS*hhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hj]*h]hstruct drm_device}(hj_*hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj[*ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhKhjS*ubh for each card present in this family. It contains lots of vfunc entries, and a pile of those probably should be moved to more appropriate places like }(hjS*hhhNhNubh)}(h:c:type:`drm_mode_config_funcs`h]j)}(hj*h]hdrm_mode_config_funcs}(hj*hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_mode_config_funcsuh1hhjz*hKhjS*ubh4 or into a new operations structure for GEM drivers.}(hjS*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjz*hKhjHhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdevm_drm_dev_alloc (C macro)c.devm_drm_dev_allochNtauh1jhjHhhhNhNubj)}(hhh](j)}(hdevm_drm_dev_alloch]j)}(hdevm_drm_dev_alloch]j)}(hdevm_drm_dev_alloch]j)}(hj*h]hdevm_drm_dev_alloc}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj*hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMubah}(h]h ]h"]h$]h&]j+j,juh1jjjhj*hhhj*hMubah}(h]j*ah ](jj eh"]h$]h&]j j)jhuh1jhj*hMhj*hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj*hhhj*hMubeh}(h]h ](jmacroeh"]h$]h&]j1jj2j*j3j*j4j5j6uh1jhhhjHhNhNubh)}(h5``devm_drm_dev_alloc (parent, driver, type, member)``h]j)}(hj*h]h1devm_drm_dev_alloc (parent, driver, type, member)}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjHhhubh block_quote)}(h?Resource managed allocation of a :c:type:`drm_device` instance h]h)}(h>Resource managed allocation of a :c:type:`drm_device` instanceh](h!Resource managed allocation of a }(hj+hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj+h]h drm_device}(hj+hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj+ubh instance}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj:+hMhj+ubah}(h]h ]h"]h$]h&]uh1j +hj:+hMhjHhhubj8)}(hX**Parameters** ``parent`` Parent device object ``driver`` DRM driver ``type`` the type of the struct which contains struct :c:type:`drm_device` ``member`` the name of the :c:type:`drm_device` within **type**. **Description** This allocates and initialize a new DRM device. No device registration is done. Call drm_dev_register() to advertice the device to user space and register it with other core subsystems. This should be done last in the device initialization sequence to make sure userspace can't access an inconsistent state. The initial ref-count of the object is 1. Use drm_dev_get() and drm_dev_put() to take and drop further ref-counts. It is recommended that drivers embed :c:type:`struct drm_device ` into their own device structure. Note that this manages the lifetime of the resulting :c:type:`drm_device` automatically using devres. The DRM device initialized with this function is automatically put on driver detach using drm_dev_put(). **Return** Pointer to new DRM device, or ERR_PTR on failure.h](h)}(h**Parameters**h]jB)}(hjQ+h]h Parameters}(hjS+hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjO+ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubj)}(hhh](j)}(h ``parent`` Parent device object h](j)}(h ``parent``h]j)}(hjp+h]hparent}(hjr+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjn+ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjj+ubj)}(hhh]h)}(hParent device objecth]hParent device object}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhjj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjg+ubj)}(h``driver`` DRM driver h](j)}(h ``driver``h]j)}(hj+h]hdriver}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj+ubj)}(hhh]h)}(h DRM driverh]h DRM driver}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjg+ubj)}(hK``type`` the type of the struct which contains struct :c:type:`drm_device` h](j)}(h``type``h]j)}(hj+h]htype}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj+ubj)}(hhh]h)}(hAthe type of the struct which contains struct :c:type:`drm_device`h](h-the type of the struct which contains struct }(hj+hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj,h]h drm_device}(hj,hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj+hMhj+ubeh}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjg+ubj)}(hA``member`` the name of the :c:type:`drm_device` within **type**. h](j)}(h ``member``h]j)}(hj:,h]hmember}(hj<,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8,ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj4,ubj)}(hhh]h)}(h5the name of the :c:type:`drm_device` within **type**.h](hthe name of the }(hjS,hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj],h]h drm_device}(hj_,hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj[,ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjO,hMhjS,ubh within }(hjS,hhhNhNubjB)}(h**type**h]htype}(hj~,hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjS,ubh.}(hjS,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjO,hMhjP,ubah}(h]h ]h"]h$]h&]uh1jhj4,ubeh}(h]h ]h"]h$]h&]uh1jhjO,hMhjg+ubeh}(h]h ]h"]h$]h&]uh1jhjK+ubh)}(h**Description**h]jB)}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj,ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubh)}(hX3This allocates and initialize a new DRM device. No device registration is done. Call drm_dev_register() to advertice the device to user space and register it with other core subsystems. This should be done last in the device initialization sequence to make sure userspace can't access an inconsistent state.h]hX5This allocates and initialize a new DRM device. No device registration is done. Call drm_dev_register() to advertice the device to user space and register it with other core subsystems. This should be done last in the device initialization sequence to make sure userspace can’t access an inconsistent state.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubh)}(hrThe initial ref-count of the object is 1. Use drm_dev_get() and drm_dev_put() to take and drop further ref-counts.h]hrThe initial ref-count of the object is 1. Use drm_dev_get() and drm_dev_put() to take and drop further ref-counts.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubh)}(hnIt is recommended that drivers embed :c:type:`struct drm_device ` into their own device structure.4h](h%It is recommended that drivers embed }(hj,hhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hj,h]hstruct drm_device}(hj,hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj,ubh! into their own device structure.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj-hMhjK+ubh)}(hNote that this manages the lifetime of the resulting :c:type:`drm_device` automatically using devres. The DRM device initialized with this function is automatically put on driver detach using drm_dev_put().h](h5Note that this manages the lifetime of the resulting }(hj-hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj-h]h drm_device}(hj-hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj-ubh automatically using devres. The DRM device initialized with this function is automatically put on driver detach using drm_dev_put().}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj7-hMhjK+ubh)}(h **Return**h]jB)}(hjD-h]hReturn}(hjF-hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjB-ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubh)}(h1Pointer to new DRM device, or ERR_PTR on failure.h]h1Pointer to new DRM device, or ERR_PTR on failure.}(hjZ-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjK+ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_dev_is_unplugged (C function)c.drm_dev_is_unpluggedhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h2bool drm_dev_is_unplugged (struct drm_device *dev)h]j)}(h1bool drm_dev_is_unplugged(struct drm_device *dev)h](hdesc_sig_keyword_type)}(hboolh]hbool}(hj-hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j-hj-hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhhj-hMubj)}(hdrm_dev_is_unpluggedh]j)}(hdrm_dev_is_unpluggedh]hdrm_dev_is_unplugged}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj-hhhj-hMubj)}(h(struct drm_device *dev)h]j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj-modnameN classnameNj j )}j ]j)}jj-sbc.drm_dev_is_unpluggedasbuh1hhj-ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hdevh]hdev}(hj".hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj-ubah}(h]h ]h"]h$]h&]j+j,uh1jhj-hhhj-hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj-hhhj-hMubah}(h]j|-ah ](jj eh"]h$]h&]j j)jhuh1jhj-hMhj~-hhubj)}(hhh]h)}(his a DRM device unpluggedh]his a DRM device unplugged}(hjL.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjI.hhubah}(h]h ]h"]h$]h&]uh1jhj~-hhhj-hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jd.j3jd.j4j5j6uh1jhhhjHhNhNubj8)}(hX **Parameters** ``struct drm_device *dev`` DRM device **Description** This function can be called to check whether a hotpluggable is unplugged. Unplugging itself is singalled through drm_dev_unplug(). If a device is unplugged, these two functions guarantee that any store before calling drm_dev_unplug() is visible to callers of this function after it completes WARNING: This function fundamentally races against drm_dev_unplug(). It is recommended that drivers instead use the underlying drm_dev_enter() and drm_dev_exit() function pairs.h](h)}(h**Parameters**h]jB)}(hjn.h]h Parameters}(hjp.hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjl.ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjh.ubj)}(hhh]j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj.h]hstruct drm_device *dev}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj.ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjh.ubh)}(h**Description**h]jB)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj.ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjh.ubh)}(hX#This function can be called to check whether a hotpluggable is unplugged. Unplugging itself is singalled through drm_dev_unplug(). If a device is unplugged, these two functions guarantee that any store before calling drm_dev_unplug() is visible to callers of this function after it completesh]hX#This function can be called to check whether a hotpluggable is unplugged. Unplugging itself is singalled through drm_dev_unplug(). If a device is unplugged, these two functions guarantee that any store before calling drm_dev_unplug() is visible to callers of this function after it completes}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjh.ubh)}(hWARNING: This function fundamentally races against drm_dev_unplug(). It is recommended that drivers instead use the underlying drm_dev_enter() and drm_dev_exit() function pairs.h]hWARNING: This function fundamentally races against drm_dev_unplug(). It is recommended that drivers instead use the underlying drm_dev_enter() and drm_dev_exit() function pairs.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjh.ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(drm_core_check_all_features (C function)c.drm_core_check_all_featureshNtauh1jhjHhhhNhNubj)}(hhh](j)}(hMbool drm_core_check_all_features (const struct drm_device *dev, u32 features)h]j)}(hLbool drm_core_check_all_features(const struct drm_device *dev, u32 features)h](j-)}(hj-h]hbool}(hj/hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj/hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMubj)}(h h]h }(hj*/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/hhhj)/hMubj)}(hdrm_core_check_all_featuresh]j)}(hdrm_core_check_all_featuresh]hdrm_core_check_all_features}(hj/sbc.drm_core_check_all_featuresasbuh1hhjT/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT/ubj)}(hjh]h*}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT/ubj)}(hdevh]hdev}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjT/ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjP/ubj)}(h u32 featuresh](h)}(hhh]j)}(hu32h]hu32}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj/modnameN classnameNj j )}j ]j/c.drm_core_check_all_featuresasbuh1hhj/ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hfeaturesh]hfeatures}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjP/ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj/hhhj)/hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj/hhhj)/hMubah}(h]j/ah ](jj eh"]h$]h&]j j)jhuh1jhj)/hMhj/hhubj)}(hhh]h)}(hcheck driver feature flags maskh]hcheck driver feature flags mask}(hj?0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj<0hhubah}(h]h ]h"]h$]h&]uh1jhj/hhhj)/hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jW0j3jW0j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``const struct drm_device *dev`` DRM device to check ``u32 features`` feature flag(s) mask **Description** This checks **dev** for driver features, see :c:type:`drm_driver.driver_features `, :c:type:`drm_device.driver_features `, and the various :c:type:`enum drm_driver_feature ` flags. Returns true if all features in the **features** mask are supported, false otherwise.h](h)}(h**Parameters**h]jB)}(hja0h]h Parameters}(hjc0hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj_0ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj[0ubj)}(hhh](j)}(h5``const struct drm_device *dev`` DRM device to check h](j)}(h ``const struct drm_device *dev``h]j)}(hj0h]hconst struct drm_device *dev}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjz0ubj)}(hhh]h)}(hDRM device to checkh]hDRM device to check}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhjz0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhjw0ubj)}(h&``u32 features`` feature flag(s) mask h](j)}(h``u32 features``h]j)}(hj0h]h u32 features}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj0ubj)}(hhh]h)}(hfeature flag(s) maskh]hfeature flag(s) mask}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhjw0ubeh}(h]h ]h"]h$]h&]uh1jhj[0ubh)}(h**Description**h]jB)}(hj0h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj0ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj[0ubh)}(hThis checks **dev** for driver features, see :c:type:`drm_driver.driver_features `, :c:type:`drm_device.driver_features `, and the various :c:type:`enum drm_driver_feature ` flags.h](h This checks }(hj 1hhhNhNubjB)}(h**dev**h]hdev}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj 1ubh for driver features, see }(hj 1hhhNhNubh)}(h1:c:type:`drm_driver.driver_features `h]j)}(hj&1h]hdrm_driver.driver_features}(hj(1hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj$1ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj 1ubh, }(hj 1hhhNhNubh)}(h1:c:type:`drm_device.driver_features `h]j)}(hjJ1h]hdrm_device.driver_features}(hjL1hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjH1ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjC1hMhj 1ubh, and the various }(hj 1hhhNhNubh)}(h6:c:type:`enum drm_driver_feature `h]j)}(hjm1h]henum drm_driver_feature}(hjo1hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjk1ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_driver_featureuh1hhjC1hMhj 1ubh flags.}(hj 1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjC1hMhj[0ubh)}(hUReturns true if all features in the **features** mask are supported, false otherwise.h](h$Returns true if all features in the }(hj1hhhNhNubjB)}(h **features**h]hfeatures}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj1ubh% mask are supported, false otherwise.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM hj[0ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#drm_core_check_feature (C function)c.drm_core_check_featurehNtauh1jhjHhhhNhNubj)}(hhh](j)}(h[bool drm_core_check_feature (const struct drm_device *dev, enum drm_driver_feature feature)h]j)}(hZbool drm_core_check_feature(const struct drm_device *dev, enum drm_driver_feature feature)h](j-)}(hj-h]hbool}(hj1hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj1hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hhhj1hMubj)}(hdrm_core_check_featureh]j)}(hdrm_core_check_featureh]hdrm_core_check_feature}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj1hhhj1hMubj)}(h?(const struct drm_device *dev, enum drm_driver_feature feature)h](j)}(hconst struct drm_device *devh](j)}(hjZ/h]hconst}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubj)}(hjh]hstruct}(hj,2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubj)}(h h]h }(hj92hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjJ2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjL2modnameN classnameNj j )}j ]j)}jj1sbc.drm_core_check_featureasbuh1hhj 2ubj)}(h h]h }(hjj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubj)}(hjh]h*}(hjx2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubj)}(hdevh]hdev}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj 2ubj)}(henum drm_driver_feature featureh](j)}(hj) h]henum}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubh)}(hhh]j)}(hdrm_driver_featureh]hdrm_driver_feature}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj2modnameN classnameNj j )}j ]jf2c.drm_core_check_featureasbuh1hhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(hfeatureh]hfeature}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj 2ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj1hhhj1hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj1hhhj1hMubah}(h]j1ah ](jj eh"]h$]h&]j j)jhuh1jhj1hMhj1hhubj)}(hhh]h)}(hcheck driver feature flagsh]hcheck driver feature flags}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj3hhubah}(h]h ]h"]h$]h&]uh1jhj1hhhj1hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j*3j3j*3j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``const struct drm_device *dev`` DRM device to check ``enum drm_driver_feature feature`` feature flag **Description** This checks **dev** for driver features, see :c:type:`drm_driver.driver_features `, :c:type:`drm_device.driver_features `, and the various :c:type:`enum drm_driver_feature ` flags. Returns true if the **feature** is supported, false otherwise.h](h)}(h**Parameters**h]jB)}(hj43h]h Parameters}(hj63hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj23ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj.3ubj)}(hhh](j)}(h5``const struct drm_device *dev`` DRM device to check h](j)}(h ``const struct drm_device *dev``h]j)}(hjS3h]hconst struct drm_device *dev}(hjU3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ3ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhjM3ubj)}(hhh]h)}(hDRM device to checkh]hDRM device to check}(hjl3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh3hMhji3ubah}(h]h ]h"]h$]h&]uh1jhjM3ubeh}(h]h ]h"]h$]h&]uh1jhjh3hMhjJ3ubj)}(h1``enum drm_driver_feature feature`` feature flag h](j)}(h#``enum drm_driver_feature feature``h]j)}(hj3h]henum drm_driver_feature feature}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj3ubj)}(hhh]h)}(h feature flagh]h feature flag}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj3ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjJ3ubeh}(h]h ]h"]h$]h&]uh1jhj.3ubh)}(h**Description**h]jB)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj3ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj.3ubh)}(hThis checks **dev** for driver features, see :c:type:`drm_driver.driver_features `, :c:type:`drm_device.driver_features `, and the various :c:type:`enum drm_driver_feature ` flags.h](h This checks }(hj3hhhNhNubjB)}(h**dev**h]hdev}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj3ubh for driver features, see }(hj3hhhNhNubh)}(h1:c:type:`drm_driver.driver_features `h]j)}(hj3h]hdrm_driver.driver_features}(hj3hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj3ubh, }(hj3hhhNhNubh)}(h1:c:type:`drm_device.driver_features `h]j)}(hj4h]hdrm_device.driver_features}(hj4hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj4hMhj3ubh, and the various }(hj3hhhNhNubh)}(h6:c:type:`enum drm_driver_feature `h]j)}(hj@4h]henum drm_driver_feature}(hjB4hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj>4ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_driver_featureuh1hhj4hMhj3ubh flags.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj4hMhj.3ubh)}(h>Returns true if the **feature** is supported, false otherwise.h](hReturns true if the }(hjg4hhhNhNubjB)}(h **feature**h]hfeature}(hjo4hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjg4ubh is supported, false otherwise.}(hjg4hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhMhj.3ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(drm_drv_uses_atomic_modeset (C function)c.drm_drv_uses_atomic_modesethNtauh1jhjHhhhNhNubj)}(hhh](j)}(h9bool drm_drv_uses_atomic_modeset (struct drm_device *dev)h]j)}(h8bool drm_drv_uses_atomic_modeset(struct drm_device *dev)h](j-)}(hj-h]hbool}(hj4hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj4hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM&ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhj4hM&ubj)}(hdrm_drv_uses_atomic_modeseth]j)}(hdrm_drv_uses_atomic_modeseth]hdrm_drv_uses_atomic_modeset}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj4hhhj4hM&ubj)}(h(struct drm_device *dev)h]j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNj j )}j ]j)}jj4sbc.drm_drv_uses_atomic_modesetasbuh1hhj4ubj)}(h h]h }(hj"5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hjh]h*}(hj05hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubj)}(hdevh]hdev}(hj=5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj4ubah}(h]h ]h"]h$]h&]j+j,uh1jhj4hhhj4hM&ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj4hhhj4hM&ubah}(h]j4ah ](jj eh"]h$]h&]j j)jhuh1jhj4hM&hj4hhubj)}(hhh]h)}(h.check if the driver implements atomic_commit()h]h.check if the driver implements atomic_commit()}(hjg5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM&hjd5hhubah}(h]h ]h"]h$]h&]uh1jhj4hhhj4hM&ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j5j3j5j4j5j6uh1jhhhjHhNhNubj8)}(h**Parameters** ``struct drm_device *dev`` DRM device **Description** This check is useful if drivers do not have DRIVER_ATOMIC set but have atomic modesetting internally implemented.h](h)}(h**Parameters**h]jB)}(hj5h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj5ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM*hj5ubj)}(hhh]j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj5h]hstruct drm_device *dev}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM(hj5ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hM(hj5ubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhj5hM(hj5ubah}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]jB)}(hj5h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj5ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM*hj5ubh)}(hqThis check is useful if drivers do not have DRIVER_ATOMIC set but have atomic modesetting internally implemented.h]hqThis check is useful if drivers do not have DRIVER_ATOMIC set but have atomic modesetting internally implemented.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:89: ./include/drm/drm_drv.hhM)hj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_put_dev (C function) c.drm_put_devhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h)void drm_put_dev (struct drm_device *dev)h]j)}(h(void drm_put_dev(struct drm_device *dev)h](j-)}(hvoidh]hvoid}(hj(6hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj$6hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hj76hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$6hhhj66hMubj)}(h drm_put_devh]j)}(h drm_put_devh]h drm_put_dev}(hjI6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE6ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj$6hhhj66hMubj)}(h(struct drm_device *dev)h]j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hje6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja6ubj)}(h h]h }(hjr6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja6ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj6modnameN classnameNj j )}j ]j)}jjK6sb c.drm_put_devasbuh1hhja6ubj)}(h h]h }(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja6ubj)}(hjh]h*}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja6ubj)}(hdevh]hdev}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja6ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj]6ubah}(h]h ]h"]h$]h&]j+j,uh1jhj$6hhhj66hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj 6hhhj66hMubah}(h]j6ah ](jj eh"]h$]h&]j j)jhuh1jhj66hMhj6hhubj)}(hhh]h)}(h#Unregister and release a DRM deviceh]h#Unregister and release a DRM device}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj6hhubah}(h]h ]h"]h$]h&]uh1jhj6hhhj66hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j7j3j7j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device **Description** Called at module unload time or when a PCI device is unplugged. Cleans up all DRM device, calling drm_lastclose(). **Note** Use of this function is deprecated. It will eventually go away completely. Please use drm_dev_unregister() and drm_dev_put() explicitly instead to make sure that the device isn't userspace accessible any more while teardown is in progress, ensuring that userspace can't access an inconsistent state.h](h)}(h**Parameters**h]jB)}(hj 7h]h Parameters}(hj 7hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj7ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubj)}(hhh]j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj)7h]hstruct drm_device *dev}(hj+7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'7ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj#7ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjB7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>7hMhj?7ubah}(h]h ]h"]h$]h&]uh1jhj#7ubeh}(h]h ]h"]h$]h&]uh1jhj>7hMhj 7ubah}(h]h ]h"]h$]h&]uh1jhj7ubh)}(h**Description**h]jB)}(hjd7h]h Description}(hjf7hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjb7ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubh)}(h?Called at module unload time or when a PCI device is unplugged.h]h?Called at module unload time or when a PCI device is unplugged.}(hjz7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubh)}(h2Cleans up all DRM device, calling drm_lastclose().h]h2Cleans up all DRM device, calling drm_lastclose().}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubh)}(h**Note**h]jB)}(hj7h]hNote}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj7ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubh)}(hX,Use of this function is deprecated. It will eventually go away completely. Please use drm_dev_unregister() and drm_dev_put() explicitly instead to make sure that the device isn't userspace accessible any more while teardown is in progress, ensuring that userspace can't access an inconsistent state.h]hX0Use of this function is deprecated. It will eventually go away completely. Please use drm_dev_unregister() and drm_dev_put() explicitly instead to make sure that the device isn’t userspace accessible any more while teardown is in progress, ensuring that userspace can’t access an inconsistent state.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dev_enter (C function)c.drm_dev_enterhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h5bool drm_dev_enter (struct drm_device *dev, int *idx)h]j)}(h4bool drm_dev_enter(struct drm_device *dev, int *idx)h](j-)}(hj-h]hbool}(hj7hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj7hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhj7hMubj)}(h drm_dev_enterh]j)}(h drm_dev_enterh]h drm_dev_enter}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj7hhhj7hMubj)}(h"(struct drm_device *dev, int *idx)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(h h]h }(hj(8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj98hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj68ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;8modnameN classnameNj j )}j ]j)}jj8sbc.drm_dev_enterasbuh1hhj8ubj)}(h h]h }(hjY8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(hjh]h*}(hjg8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(hdevh]hdev}(hjt8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj8ubj)}(hint *idxh](j-)}(hinth]hint}(hj8hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj8ubj)}(h h]h }(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(hjh]h*}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubj)}(hidxh]hidx}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj8ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj7hhhj7hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj7hhhj7hMubah}(h]j7ah ](jj eh"]h$]h&]j j)jhuh1jhj7hMhj7hhubj)}(hhh]h)}(hEnter device critical sectionh]hEnter device critical section}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8hhubah}(h]h ]h"]h$]h&]uh1jhj7hhhj7hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j8j3j8j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``int *idx`` Pointer to index that will be passed to the matching drm_dev_exit() **Description** This function marks and protects the beginning of a section that should not be entered after the device has been unplugged. The section end is marked with drm_dev_exit(). Calls to this function can be nested. **Return** True if it is OK to enter the section, false otherwise.h](h)}(h**Parameters**h]jB)}(hj9h]h Parameters}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj9ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj!9h]hstruct drm_device *dev}(hj#9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj9ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj:9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj69hMhj79ubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhj69hMhj9ubj)}(hQ``int *idx`` Pointer to index that will be passed to the matching drm_dev_exit() h](j)}(h ``int *idx``h]j)}(hjZ9h]hint *idx}(hj\9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjX9ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjT9ubj)}(hhh]h)}(hCPointer to index that will be passed to the matching drm_dev_exit()h]hCPointer to index that will be passed to the matching drm_dev_exit()}(hjs9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjo9hMhjp9ubah}(h]h ]h"]h$]h&]uh1jhjT9ubeh}(h]h ]h"]h$]h&]uh1jhjo9hMhj9ubeh}(h]h ]h"]h$]h&]uh1jhj8ubh)}(h**Description**h]jB)}(hj9h]h Description}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj9ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8ubh)}(hThis function marks and protects the beginning of a section that should not be entered after the device has been unplugged. The section end is marked with drm_dev_exit(). Calls to this function can be nested.h]hThis function marks and protects the beginning of a section that should not be entered after the device has been unplugged. The section end is marked with drm_dev_exit(). Calls to this function can be nested.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8ubh)}(h **Return**h]jB)}(hj9h]hReturn}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj9ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8ubh)}(h7True if it is OK to enter the section, false otherwise.h]h7True if it is OK to enter the section, false otherwise.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dev_exit (C function)c.drm_dev_exithNtauh1jhjHhhhNhNubj)}(hhh](j)}(hvoid drm_dev_exit (int idx)h]j)}(hvoid drm_dev_exit(int idx)h](j-)}(hvoidh]hvoid}(hj:hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj9hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhj:hMubj)}(h drm_dev_exith]j)}(h drm_dev_exith]h drm_dev_exit}(hj":hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj9hhhj:hMubj)}(h (int idx)h]j)}(hint idxh](j-)}(hinth]hint}(hj>:hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj::ubj)}(h h]h }(hjL:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj::ubj)}(hidxh]hidx}(hjZ:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj::ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj6:ubah}(h]h ]h"]h$]h&]j+j,uh1jhj9hhhj:hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj9hhhj:hMubah}(h]j9ah ](jj eh"]h$]h&]j j)jhuh1jhj:hMhj9hhubj)}(hhh]h)}(hExit device critical sectionh]hExit device critical section}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:hhubah}(h]h ]h"]h$]h&]uh1jhj9hhhj:hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j:j3j:j4j5j6uh1jhhhjHhNhNubj8)}(h**Parameters** ``int idx`` index returned from drm_dev_enter() **Description** This function marks the end of a section that should not be entered after the device has been unplugged.h](h)}(h**Parameters**h]jB)}(hj:h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj:ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:ubj)}(hhh]j)}(h0``int idx`` index returned from drm_dev_enter() h](j)}(h ``int idx``h]j)}(hj:h]hint idx}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:ubj)}(hhh]h)}(h#index returned from drm_dev_enter()h]h#index returned from drm_dev_enter()}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhj:hMhj:ubah}(h]h ]h"]h$]h&]uh1jhj:ubh)}(h**Description**h]jB)}(hj;h]h Description}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj:ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:ubh)}(hhThis function marks the end of a section that should not be entered after the device has been unplugged.h]hhThis function marks the end of a section that should not be entered after the device has been unplugged.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dev_unplug (C function)c.drm_dev_unplughNtauh1jhjHhhhNhNubj)}(hhh](j)}(h,void drm_dev_unplug (struct drm_device *dev)h]j)}(h+void drm_dev_unplug(struct drm_device *dev)h](j-)}(hvoidh]hvoid}(hjE;hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjA;hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hjT;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA;hhhjS;hMubj)}(hdrm_dev_unplugh]j)}(hdrm_dev_unplugh]hdrm_dev_unplug}(hjf;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjb;ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjA;hhhjS;hMubj)}(h(struct drm_device *dev)h]j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~;ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj;modnameN classnameNj j )}j ]j)}jjh;sbc.drm_dev_unplugasbuh1hhj~;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~;ubj)}(hjh]h*}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~;ubj)}(hdevh]hdev}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~;ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjz;ubah}(h]h ]h"]h$]h&]j+j,uh1jhjA;hhhjS;hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj=;hhhjS;hMubah}(h]j8;ah ](jj eh"]h$]h&]j j)jhuh1jhjS;hMhj:;hhubj)}(hhh]h)}(hunplug a DRM deviceh]hunplug a DRM device}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj<hhubah}(h]h ]h"]h$]h&]uh1jhj:;hhhjS;hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j<j3j<j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device **Description** This unplugs a hotpluggable DRM device, which makes it inaccessible to userspace operations. Entry-points can use drm_dev_enter() and drm_dev_exit() to protect device resources in a race free manner. This essentially unregisters the device like drm_dev_unregister(), but can be called while there are still open users of **dev**.h](h)}(h**Parameters**h]jB)}(hj'<h]h Parameters}(hj)<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj%<ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj!<ubj)}(hhh]j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjF<h]hstruct drm_device *dev}(hjH<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD<ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj@<ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj_<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[<hMhj\<ubah}(h]h ]h"]h$]h&]uh1jhj@<ubeh}(h]h ]h"]h$]h&]uh1jhj[<hMhj=<ubah}(h]h ]h"]h$]h&]uh1jhj!<ubh)}(h**Description**h]jB)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj<ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj!<ubh)}(hXIThis unplugs a hotpluggable DRM device, which makes it inaccessible to userspace operations. Entry-points can use drm_dev_enter() and drm_dev_exit() to protect device resources in a race free manner. This essentially unregisters the device like drm_dev_unregister(), but can be called while there are still open users of **dev**.h](hXAThis unplugs a hotpluggable DRM device, which makes it inaccessible to userspace operations. Entry-points can use drm_dev_enter() and drm_dev_exit() to protect device resources in a race free manner. This essentially unregisters the device like drm_dev_unregister(), but can be called while there are still open users of }(hj<hhhNhNubjB)}(h**dev**h]hdev}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj<ubh.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj!<ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_dev_set_dma_dev (C function)c.drm_dev_set_dma_devhNtauh1jhjHhhhNhNubj)}(hhh](j)}(hIvoid drm_dev_set_dma_dev (struct drm_device *dev, struct device *dma_dev)h]j)}(hHvoid drm_dev_set_dma_dev(struct drm_device *dev, struct device *dma_dev)h](j-)}(hvoidh]hvoid}(hj<hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj<hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhj<hMubj)}(hdrm_dev_set_dma_devh]j)}(hdrm_dev_set_dma_devh]hdrm_dev_set_dma_dev}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj<hhhj<hMubj)}(h0(struct drm_device *dev, struct device *dma_dev)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj"=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj3=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5=modnameN classnameNj j )}j ]j)}jj<sbc.drm_dev_set_dma_devasbuh1hhj=ubj)}(h h]h }(hjS=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hjh]h*}(hja=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hdevh]hdev}(hjn=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj =ubj)}(hstruct device *dma_devh](j)}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(hdeviceh]hdevice}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj=modnameN classnameNj j )}j ]jO=c.drm_dev_set_dma_devasbuh1hhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(hdma_devh]hdma_dev}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj =ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj<hhhj<hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj<hhhj<hMubah}(h]j<ah ](jj eh"]h$]h&]j j)jhuh1jhj<hMhj<hhubj)}(hhh]h)}(h#set the DMA device for a DRM deviceh]h#set the DMA device for a DRM device}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj>hhubah}(h]h ]h"]h$]h&]uh1jhj<hhhj<hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j >j3j >j4j5j6uh1jhhhjHhNhNubj8)}(hXc**Parameters** ``struct drm_device *dev`` DRM device ``struct device *dma_dev`` DMA device or NULL **Description** Sets the DMA device of the given DRM device. Only required if the DMA device is different from the DRM device's parent. After calling this function, the DRM device holds a reference on **dma_dev**. Pass NULL to clear the DMA device.h](h)}(h**Parameters**h]jB)}(hj*>h]h Parameters}(hj,>hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj(>ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj$>ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjI>h]hstruct drm_device *dev}(hjK>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjG>ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjC>ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjb>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^>hMhj_>ubah}(h]h ]h"]h$]h&]uh1jhjC>ubeh}(h]h ]h"]h$]h&]uh1jhj^>hMhj@>ubj)}(h.``struct device *dma_dev`` DMA device or NULL h](j)}(h``struct device *dma_dev``h]j)}(hj>h]hstruct device *dma_dev}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj|>ubj)}(hhh]h)}(hDMA device or NULLh]hDMA device or NULL}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj|>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhj@>ubeh}(h]h ]h"]h$]h&]uh1jhj$>ubh)}(h**Description**h]jB)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj>ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj$>ubh)}(hSets the DMA device of the given DRM device. Only required if the DMA device is different from the DRM device's parent. After calling this function, the DRM device holds a reference on **dma_dev**. Pass NULL to clear the DMA device.h](hSets the DMA device of the given DRM device. Only required if the DMA device is different from the DRM device’s parent. After calling this function, the DRM device holds a reference on }(hj>hhhNhNubjB)}(h **dma_dev**h]hdma_dev}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj>ubh$. Pass NULL to clear the DMA device.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj$>ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_dev_wedged_event (C function)c.drm_dev_wedged_eventhNtauh1jhjHhhhNhNubj)}(hhh](j)}(hiint drm_dev_wedged_event (struct drm_device *dev, unsigned long method, struct drm_wedge_task_info *info)h]j)}(hhint drm_dev_wedged_event(struct drm_device *dev, unsigned long method, struct drm_wedge_task_info *info)h](j-)}(hinth]hint}(hj?hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj?hhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM.ubj)}(h h]h }(hj#?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhj"?hM.ubj)}(hdrm_dev_wedged_eventh]j)}(hdrm_dev_wedged_eventh]hdrm_dev_wedged_event}(hj5?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1?ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj?hhhj"?hM.ubj)}(hP(struct drm_device *dev, unsigned long method, struct drm_wedge_task_info *info)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjQ?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM?ubj)}(h h]h }(hj^?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM?ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjo?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl?ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjq?modnameN classnameNj j )}j ]j)}jj7?sbc.drm_dev_wedged_eventasbuh1hhjM?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM?ubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM?ubj)}(hdevh]hdev}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM?ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjI?ubj)}(hunsigned long methodh](j-)}(hunsignedh]hunsigned}(hj?hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj-)}(hlongh]hlong}(hj?hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hmethodh]hmethod}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjI?ubj)}(h struct drm_wedge_task_info *infoh](j)}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(h h]h }(hj!@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubh)}(hhh]j)}(hdrm_wedge_task_infoh]hdrm_wedge_task_info}(hj2@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4@modnameN classnameNj j )}j ]j?c.drm_dev_wedged_eventasbuh1hhj@ubj)}(h h]h }(hjP@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(hjh]h*}(hj^@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubj)}(hinfoh]hinfo}(hjk@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjI?ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj?hhhj"?hM.ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj ?hhhj"?hM.ubah}(h]j?ah ](jj eh"]h$]h&]j j)jhuh1jhj"?hM.hj ?hhubj)}(hhh]h)}(hgenerate a device wedged ueventh]hgenerate a device wedged uevent}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM.hj@hhubah}(h]h ]h"]h$]h&]uh1jhj ?hhhj"?hM.ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j@j3j@j4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``unsigned long method`` method(s) to be used for recovery ``struct drm_wedge_task_info *info`` optional information about the guilty task **Description** This generates a device wedged uevent for the DRM device specified by **dev**. Recovery **method**\(s) of choice will be sent in the uevent environment as ``WEDGED=[,..,]`` in order of less to more side-effects. If caller is unsure about recovery or **method** is unknown (0), ``WEDGED=unknown`` will be sent instead. Refer to "Device Wedging" chapter in Documentation/gpu/drm-uapi.rst for more details. **Return** 0 on success, negative error code otherwise.h](h)}(h**Parameters**h]jB)}(hj@h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj@ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM2hj@ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj@h]hstruct drm_device *dev}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM/hj@ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hM/hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hM/hj@ubj)}(h;``unsigned long method`` method(s) to be used for recovery h](j)}(h``unsigned long method``h]j)}(hjAh]hunsigned long method}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Aubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM0hj Aubj)}(hhh]h)}(h!method(s) to be used for recoveryh]h!method(s) to be used for recovery}(hj(AhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$AhM0hj%Aubah}(h]h ]h"]h$]h&]uh1jhj Aubeh}(h]h ]h"]h$]h&]uh1jhj$AhM0hj@ubj)}(hP``struct drm_wedge_task_info *info`` optional information about the guilty task h](j)}(h$``struct drm_wedge_task_info *info``h]j)}(hjHAh]h struct drm_wedge_task_info *info}(hjJAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFAubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM1hjBAubj)}(hhh]h)}(h*optional information about the guilty taskh]h*optional information about the guilty task}(hjaAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]AhM1hj^Aubah}(h]h ]h"]h$]h&]uh1jhjBAubeh}(h]h ]h"]h$]h&]uh1jhj]AhM1hj@ubeh}(h]h ]h"]h$]h&]uh1jhj@ubh)}(h**Description**h]jB)}(hjAh]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjAubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM3hj@ubh)}(hXOThis generates a device wedged uevent for the DRM device specified by **dev**. Recovery **method**\(s) of choice will be sent in the uevent environment as ``WEDGED=[,..,]`` in order of less to more side-effects. If caller is unsure about recovery or **method** is unknown (0), ``WEDGED=unknown`` will be sent instead.+h](hFThis generates a device wedged uevent for the DRM device specified by }(hjAhhhNhNubjB)}(h**dev**h]hdev}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjAubh . Recovery }(hjAhhhNhNubjB)}(h **method**h]hmethod}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjAubh9(s) of choice will be sent in the uevent environment as }(hjAhhhNhNubj)}(h#``WEDGED=[,..,]``h]hWEDGED=[,..,]}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubhN in order of less to more side-effects. If caller is unsure about recovery or }(hjAhhhNhNubjB)}(h **method**h]hmethod}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjAubh is unknown (0), }(hjAhhhNhNubj)}(h``WEDGED=unknown``h]hWEDGED=unknown}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh will be sent instead.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM2hj@ubh)}(hURefer to "Device Wedging" chapter in Documentation/gpu/drm-uapi.rst for more details.h]hYRefer to “Device Wedging” chapter in Documentation/gpu/drm-uapi.rst for more details.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM8hj@ubh)}(h **Return**h]jB)}(hjBh]hReturn}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjBubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM;hj@ubh)}(h,0 on success, negative error code otherwise.h]h,0 on success, negative error code otherwise.}(hj)BhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM<hj@ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j__drm_dev_alloc (C function)c.__drm_dev_allochNtauh1jhjHhhhNhNubj)}(hhh](j)}(hkvoid * __drm_dev_alloc (struct device *parent, const struct drm_driver *driver, size_t size, size_t offset)h]j)}(hivoid *__drm_dev_alloc(struct device *parent, const struct drm_driver *driver, size_t size, size_t offset)h](j-)}(hvoidh]hvoid}(hjXBhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjTBhhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMWubj)}(h h]h }(hjgBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTBhhhjfBhMWubj)}(hjh]h*}(hjuBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTBhhhjfBhMWubj)}(h__drm_dev_alloch]j)}(h__drm_dev_alloch]h__drm_dev_alloc}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjTBhhhjfBhMWubj)}(hT(struct device *parent, const struct drm_driver *driver, size_t size, size_t offset)h](j)}(hstruct device *parenth](j)}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hdeviceh]hdevice}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjBmodnameN classnameNj j )}j ]j)}jjBsbc.__drm_dev_allocasbuh1hhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hparenth]hparent}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjBubj)}(hconst struct drm_driver *driverh](j)}(hjZ/h]hconst}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hj!ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(hjh]hstruct}(hj/ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hj` method after registering the device nodes, creating race conditions. Usage of the :c:type:`drm_driver.load ` methods is therefore deprecated, drivers must perform all initialization before calling drm_dev_register(). **Return** 0 on success, negative error code on failure.h](h)}(h**Parameters**h]jB)}(hjPh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjPubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM hjPubj)}(hhh](j)}(h.``struct drm_device *dev`` Device to register h](j)}(h``struct drm_device *dev``h]j)}(hjPh]hstruct drm_device *dev}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjPubj)}(hhh]h)}(hDevice to registerh]hDevice to register}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjPubj)}(hF``unsigned long flags`` Flags passed to the driver's .load() function h](j)}(h``unsigned long flags``h]j)}(hjQh]hunsigned long flags}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjQubj)}(hhh]h)}(h-Flags passed to the driver's .load() functionh]h/Flags passed to the driver’s .load() function}(hj0QhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,QhMhj-Qubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhj,QhMhjPubeh}(h]h ]h"]h$]h&]uh1jhjPubh)}(h**Description**h]jB)}(hjRQh]h Description}(hjTQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjPQubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM hjPubh)}(hRegister the DRM device **dev** with the system, advertise device to user-space and start normal device operation. **dev** must be initialized via drm_dev_init() previously.h](hRegister the DRM device }(hjhQhhhNhNubjB)}(h**dev**h]hdev}(hjpQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjhQubhT with the system, advertise device to user-space and start normal device operation. }(hjhQhhhNhNubjB)}(h**dev**h]hdev}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjhQubh3 must be initialized via drm_dev_init() previously.}(hjhQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjPubh)}(h$Never call this twice on any device!h]h$Never call this twice on any device!}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM#hjPubh)}(h**NOTE**h]jB)}(hjQh]hNOTE}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjQubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM%hjPubh)}(hXaTo ensure backward compatibility with existing drivers method this function calls the :c:type:`drm_driver.load ` method after registering the device nodes, creating race conditions. Usage of the :c:type:`drm_driver.load ` methods is therefore deprecated, drivers must perform all initialization before calling drm_dev_register().h](hVTo ensure backward compatibility with existing drivers method this function calls the }(hjQhhhNhNubh)}(h&:c:type:`drm_driver.load `h]j)}(hjQh]hdrm_driver.load}(hjQhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM&hjQubhS method after registering the device nodes, creating race conditions. Usage of the }(hjQhhhNhNubh)}(h&:c:type:`drm_driver.load `h]j)}(hjQh]hdrm_driver.load}(hjQhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhjQhM&hjQubhl methods is therefore deprecated, drivers must perform all initialization before calling drm_dev_register().}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjQhM&hjPubh)}(h **Return**h]jB)}(hjRh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjRubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM,hjPubh)}(h-0 on success, negative error code on failure.h]h-0 on success, negative error code on failure.}(hj/RhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chM,hjPubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dev_unregister (C function)c.drm_dev_unregisterhNtauh1jhjHhhhNhNubj)}(hhh](j)}(h0void drm_dev_unregister (struct drm_device *dev)h]j)}(h/void drm_dev_unregister(struct drm_device *dev)h](j-)}(hvoidh]hvoid}(hj^RhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjZRhhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMubj)}(h h]h }(hjmRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZRhhhjlRhMubj)}(hdrm_dev_unregisterh]j)}(hdrm_dev_unregisterh]hdrm_dev_unregister}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{Rubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjZRhhhjlRhMubj)}(h(struct drm_device *dev)h]j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjRmodnameN classnameNj j )}j ]j)}jjRsbc.drm_dev_unregisterasbuh1hhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hdevh]hdev}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjRubah}(h]h ]h"]h$]h&]j+j,uh1jhjZRhhhjlRhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjVRhhhjlRhMubah}(h]jQRah ](jj eh"]h$]h&]j j)jhuh1jhjlRhMhjSRhhubj)}(hhh]h)}(hUnregister DRM deviceh]hUnregister DRM device}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjShhubah}(h]h ]h"]h$]h&]uh1jhjSRhhhjlRhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j6Sj3j6Sj4j5j6uh1jhhhjHhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` Device to unregister **Description** Unregister the DRM device from the system. This does the reverse of drm_dev_register() but does not deallocate the device. The caller must call drm_dev_put() to drop their final reference, unless it is managed with devres (as devices allocated with devm_drm_dev_alloc() are), in which case there is already an unwind action registered. A special form of unregistering for hotpluggable devices is drm_dev_unplug(), which can be called while there are still open users of **dev**. This should be called first in the device teardown code to make sure userspace can't access the device instance any more.h](h)}(h**Parameters**h]jB)}(hj@Sh]h Parameters}(hjBShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj>Subah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:Subj)}(hhh]j)}(h0``struct drm_device *dev`` Device to unregister h](j)}(h``struct drm_device *dev``h]j)}(hj_Sh]hstruct drm_device *dev}(hjaShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]Subah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhjYSubj)}(hhh]h)}(hDevice to unregisterh]hDevice to unregister}(hjxShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjtShMhjuSubah}(h]h ]h"]h$]h&]uh1jhjYSubeh}(h]h ]h"]h$]h&]uh1jhjtShMhjVSubah}(h]h ]h"]h$]h&]uh1jhj:Subh)}(h**Description**h]jB)}(hjSh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:Subh)}(hXOUnregister the DRM device from the system. This does the reverse of drm_dev_register() but does not deallocate the device. The caller must call drm_dev_put() to drop their final reference, unless it is managed with devres (as devices allocated with devm_drm_dev_alloc() are), in which case there is already an unwind action registered.h]hXOUnregister the DRM device from the system. This does the reverse of drm_dev_register() but does not deallocate the device. The caller must call drm_dev_put() to drop their final reference, unless it is managed with devres (as devices allocated with devm_drm_dev_alloc() are), in which case there is already an unwind action registered.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:Subh)}(hA special form of unregistering for hotpluggable devices is drm_dev_unplug(), which can be called while there are still open users of **dev**.h](hA special form of unregistering for hotpluggable devices is drm_dev_unplug(), which can be called while there are still open users of }(hjShhhNhNubjB)}(h**dev**h]hdev}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubh.}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:Subh)}(hyThis should be called first in the device teardown code to make sure userspace can't access the device instance any more.h]h{This should be called first in the device teardown code to make sure userspace can’t access the device instance any more.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:92: ./drivers/gpu/drm/drm_drv.chMhj:Subeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjHhhhNhNubeh}(h]jah ]h"]#device instance and driver handlingah$]h&]uh1hhjhhhhhKQubh)}(hhh](h)}(h Driver Loadh]h Driver Load}(hjThhhNhNubah}(h]h ]h"]h$]h&]hj@uh1hhjShhhhhK`ubh)}(hhh](h)}(hComponent Helper Usageh]hComponent Helper Usage}(hjThhhNhNubah}(h]h ]h"]h$]h&]hj_uh1hhjThhhhhKcubh)}(hXDRM drivers that drive hardware where a logical device consists of a pile of independent hardware blocks are recommended to use the :ref:`component helper library`. For consistency and better options for code reuse the following guidelines apply:h](hDRM drivers that drive hardware where a logical device consists of a pile of independent hardware blocks are recommended to use the }(hjThhhNhNubh)}(h*:ref:`component helper library`h]jf)}(hj)Th]hcomponent helper library}(hj+ThhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehj'Tubah}(h]h ]h"]h$]h&]refdocj refdomainj5Treftyperef refexplicitrefwarnj  componentuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:101: ./drivers/gpu/drm/drm_drv.chMhjTubhS. For consistency and better options for code reuse the following guidelines apply:}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjGThMhjThhubj+)}(hX^- The entire device initialization procedure should be run from the :c:type:`component_master_ops.master_bind ` callback, starting with devm_drm_dev_alloc(), then binding all components with component_bind_all() and finishing with drm_dev_register(). - The opaque pointer passed to all components through component_bind_all() should point at :c:type:`struct drm_device ` of the device instance, not some driver specific private structure. - The component helper fills the niche where further standardization of interfaces is not practical. When there already is, or will be, a standardized interface like :c:type:`drm_bridge` or :c:type:`drm_panel`, providing its own functions to find such components at driver load time, like drm_of_find_panel_or_bridge(), then the component helper should not be used. h]j)}(hhh](j)}(hXThe entire device initialization procedure should be run from the :c:type:`component_master_ops.master_bind ` callback, starting with devm_drm_dev_alloc(), then binding all components with component_bind_all() and finishing with drm_dev_register(). h]h)}(hXThe entire device initialization procedure should be run from the :c:type:`component_master_ops.master_bind ` callback, starting with devm_drm_dev_alloc(), then binding all components with component_bind_all() and finishing with drm_dev_register().h](hBThe entire device initialization procedure should be run from the }(hj]ThhhNhNubh)}(hA:c:type:`component_master_ops.master_bind `h]j)}(hjgTh]h component_master_ops.master_bind}(hjiThhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjeTubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j component_master_opsuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:101: ./drivers/gpu/drm/drm_drv.chMhj]Tubh callback, starting with devm_drm_dev_alloc(), then binding all components with component_bind_all() and finishing with drm_dev_register().}(hj]ThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjThMhjYTubah}(h]h ]h"]h$]h&]uh1jhjVTubj)}(hThe opaque pointer passed to all components through component_bind_all() should point at :c:type:`struct drm_device ` of the device instance, not some driver specific private structure. h]h)}(hThe opaque pointer passed to all components through component_bind_all() should point at :c:type:`struct drm_device ` of the device instance, not some driver specific private structure.h](hYThe opaque pointer passed to all components through component_bind_all() should point at }(hjThhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjTh]hstruct drm_device}(hjThhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:101: ./drivers/gpu/drm/drm_drv.chMhjTubhD of the device instance, not some driver specific private structure.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjVTubj)}(hXmThe component helper fills the niche where further standardization of interfaces is not practical. When there already is, or will be, a standardized interface like :c:type:`drm_bridge` or :c:type:`drm_panel`, providing its own functions to find such components at driver load time, like drm_of_find_panel_or_bridge(), then the component helper should not be used. h]h)}(hXkThe component helper fills the niche where further standardization of interfaces is not practical. When there already is, or will be, a standardized interface like :c:type:`drm_bridge` or :c:type:`drm_panel`, providing its own functions to find such components at driver load time, like drm_of_find_panel_or_bridge(), then the component helper should not be used.h](hThe component helper fills the niche where further standardization of interfaces is not practical. When there already is, or will be, a standardized interface like }(hjThhhNhNubh)}(h:c:type:`drm_bridge`h]j)}(hjTh]h drm_bridge}(hjThhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_bridgeuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:101: ./drivers/gpu/drm/drm_drv.chMhjTubh or }(hjThhhNhNubh)}(h:c:type:`drm_panel`h]j)}(hjUh]h drm_panel}(hjUhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_paneluh1hhjThMhjTubh, providing its own functions to find such components at driver load time, like drm_of_find_panel_or_bridge(), then the component helper should not be used.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjVTubeh}(h]h ]h"]h$]h&]bullet-uh1j hjThMhjRTubah}(h]h ]h"]h$]h&]uh1j +hjThMhjThhubeh}(h]jeah ]h"]component helper usageah$]h&]uh1hhjShhhhhKcubh)}(hhh](h)}(hMemory Manager Initializationh]hMemory Manager Initialization}(hjHUhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjEUhhhhhKiubh)}(hXEvery DRM driver requires a memory manager which must be initialized at load time. DRM currently contains two memory managers, the Translation Table Manager (TTM) and the Graphics Execution Manager (GEM). This document describes the use of the GEM memory manager only. See ? for details.h]hXEvery DRM driver requires a memory manager which must be initialized at load time. DRM currently contains two memory managers, the Translation Table Manager (TTM) and the Graphics Execution Manager (GEM). This document describes the use of the GEM memory manager only. See ? for details.}(hjVUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjEUhhubeh}(h]jah ]h"]memory manager initializationah$]h&]uh1hhjShhhhhKiubh)}(hhh](h)}(h"Miscellaneous Device Configurationh]h"Miscellaneous Device Configuration}(hjnUhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjkUhhhhhKrubh)}(hXAnother task that may be necessary for PCI devices during configuration is mapping the video BIOS. On many devices, the VBIOS describes device configuration, LCD panel timings (if any), and contains flags indicating device state. Mapping the BIOS can be done using the pci_map_rom() call, a convenience function that takes care of mapping the actual ROM, whether it has been shadowed into memory (typically at address 0xc0000) or exists on the PCI device in the ROM BAR. Note that after the ROM has been mapped and any necessary information has been extracted, it should be unmapped; on many devices, the ROM address decoder is shared with other BARs, so leaving it mapped could cause undesired behaviour like hangs or memory corruption.h]hXAnother task that may be necessary for PCI devices during configuration is mapping the video BIOS. On many devices, the VBIOS describes device configuration, LCD panel timings (if any), and contains flags indicating device state. Mapping the BIOS can be done using the pci_map_rom() call, a convenience function that takes care of mapping the actual ROM, whether it has been shadowed into memory (typically at address 0xc0000) or exists on the PCI device in the ROM BAR. Note that after the ROM has been mapped and any necessary information has been extracted, it should be unmapped; on many devices, the ROM address decoder is shared with other BARs, so leaving it mapped could cause undesired behaviour like hangs or memory corruption.}(hj|UhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjkUhhubeh}(h]jah ]h"]"miscellaneous device configurationah$]h&]uh1hhjShhhhhKrubeh}(h]jFah ]h"] driver loadah$]h&]uh1hhjhhhhhK`ubh)}(hhh](h)}(hManaged Resourcesh]hManaged Resources}(hjUhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjUhhhhhKubh)}(hInspired by struct :c:type:`device` managed resources, but tied to the lifetime of struct :c:type:`drm_device`, which can outlive the underlying physical device, usually when userspace has some open files and other handles to resources still open.h](hInspired by struct }(hjUhhhNhNubh)}(h:c:type:`device`h]j)}(hjUh]hdevice}(hjUhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j deviceuh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:131: ./drivers/gpu/drm/drm_managed.chKhjUubh7 managed resources, but tied to the lifetime of struct }(hjUhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjUh]h drm_device}(hjUhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjUhKhjUubh, which can outlive the underlying physical device, usually when userspace has some open files and other handles to resources still open.}(hjUhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjUhKhjUhhubh)}(hXTRelease actions can be added with drmm_add_action(), memory allocations can be done directly with drmm_kmalloc() and the related functions. Everything will be released on the final drm_dev_put() in reverse order of how the release actions have been added and memory has been allocated since driver loading started with devm_drm_dev_alloc().h]hXTRelease actions can be added with drmm_add_action(), memory allocations can be done directly with drmm_kmalloc() and the related functions. Everything will be released on the final drm_dev_put() in reverse order of how the release actions have been added and memory has been allocated since driver loading started with devm_drm_dev_alloc().}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:131: ./drivers/gpu/drm/drm_managed.chKhjUhhubh)}(hX3Note that release actions and managed memory can also be added and removed during the lifetime of the driver, all the functions are fully concurrent safe. But it is recommended to use managed resources only for resources that change rarely, if ever, during the lifetime of the :c:type:`drm_device` instance.h](hXNote that release actions and managed memory can also be added and removed during the lifetime of the driver, all the functions are fully concurrent safe. But it is recommended to use managed resources only for resources that change rarely, if ever, during the lifetime of the }(hj VhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjVh]h drm_device}(hjVhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:131: ./drivers/gpu/drm/drm_managed.chK hj Vubh instance.}(hj VhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj4VhK hjUhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j drmm_release_action (C function)c.drmm_release_actionhNtauh1jhjUhhhNhNubj)}(hhh](j)}(hVvoid drmm_release_action (struct drm_device *dev, drmres_release_t action, void *data)h]j)}(hUvoid drmm_release_action(struct drm_device *dev, drmres_release_t action, void *data)h](j-)}(hvoidh]hvoid}(hjXVhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjTVhhh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKubj)}(h h]h }(hjgVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTVhhhjfVhKubj)}(hdrmm_release_actionh]j)}(hdrmm_release_actionh]hdrmm_release_action}(hjyVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuVubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjTVhhhjfVhKubj)}(h=(struct drm_device *dev, drmres_release_t action, void *data)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjVmodnameN classnameNj j )}j ]j)}jj{Vsbc.drmm_release_actionasbuh1hhjVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hdevh]hdev}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjVubj)}(hdrmres_release_t actionh](h)}(hhh]j)}(hdrmres_release_th]hdrmres_release_t}(hj WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj WmodnameN classnameNj j )}j ]jVc.drmm_release_actionasbuh1hhjWubj)}(h h]h }(hj(WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubj)}(hactionh]haction}(hj6WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjVubj)}(h void *datah](j-)}(hvoidh]hvoid}(hjOWhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjKWubj)}(h h]h }(hj]WhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKWubj)}(hjh]h*}(hjkWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKWubj)}(hdatah]hdata}(hjxWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKWubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjVubeh}(h]h ]h"]h$]h&]j+j,uh1jhjTVhhhjfVhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjPVhhhjfVhKubah}(h]jKVah ](jj eh"]h$]h&]j j)jhuh1jhjfVhKhjMVhhubj)}(hhh]h)}(h4release a managed action from a :c:type:`drm_device`h](h release a managed action from a }(hjWhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjWh]h drm_device}(hjWhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jVc.drmm_release_actionasbj  drm_deviceuh1hhjfVhKhjWubeh}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjWhhubah}(h]h ]h"]h$]h&]uh1jhjMVhhhjfVhKubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jWj3jWj4j5j6uh1jhhhjUhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``drmres_release_t action`` function which would be called when **dev** is released ``void *data`` opaque pointer, passed to **action** **Description** This function calls the **action** previously added by drmm_add_action() immediately. The **action** is removed from the list of cleanup actions for **dev**, which means that it won't be called in the final drm_dev_put().h](h)}(h**Parameters**h]jB)}(hjWh]h Parameters}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjWubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjWubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjXh]hstruct drm_device *dev}(hj XhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjXubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj XhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhKhjXubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjXhKhjWubj)}(hT``drmres_release_t action`` function which would be called when **dev** is released h](j)}(h``drmres_release_t action``h]j)}(hj@Xh]hdrmres_release_t action}(hjBXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>Xubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj:Xubj)}(hhh]h)}(h7function which would be called when **dev** is releasedh](h$function which would be called when }(hjYXhhhNhNubjB)}(h**dev**h]hdev}(hjaXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjYXubh is released}(hjYXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjUXhKhjVXubah}(h]h ]h"]h$]h&]uh1jhj:Xubeh}(h]h ]h"]h$]h&]uh1jhjUXhKhjWubj)}(h4``void *data`` opaque pointer, passed to **action** h](j)}(h``void *data``h]j)}(hjXh]h void *data}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjXubj)}(hhh]h)}(h$opaque pointer, passed to **action**h](hopaque pointer, passed to }(hjXhhhNhNubjB)}(h **action**h]haction}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubeh}(h]h ]h"]h$]h&]uh1hhjXhKhjXubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjXhKhjWubeh}(h]h ]h"]h$]h&]uh1jhjWubh)}(h**Description**h]jB)}(hjXh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjWubh)}(hThis function calls the **action** previously added by drmm_add_action() immediately. The **action** is removed from the list of cleanup actions for **dev**, which means that it won't be called in the final drm_dev_put().h](hThis function calls the }(hjXhhhNhNubjB)}(h **action**h]haction}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubh8 previously added by drmm_add_action() immediately. The }(hjXhhhNhNubjB)}(h **action**h]haction}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubh1 is removed from the list of cleanup actions for }(hjXhhhNhNubjB)}(h**dev**h]hdev}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubhC, which means that it won’t be called in the final drm_dev_put().}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjWubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_kmalloc (C function)c.drmm_kmallochNtauh1jhjUhhhNhNubj)}(hhh](j)}(hDvoid * drmm_kmalloc (struct drm_device *dev, size_t size, gfp_t gfp)h]j)}(hBvoid *drmm_kmalloc(struct drm_device *dev, size_t size, gfp_t gfp)h](j-)}(hvoidh]hvoid}(hjOYhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjKYhhh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKubj)}(h h]h }(hj^YhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKYhhhj]YhKubj)}(hjh]h*}(hjlYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKYhhhj]YhKubj)}(h drmm_kmalloch]j)}(h drmm_kmalloch]h drmm_kmalloc}(hj}YhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyYubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjKYhhhj]YhKubj)}(h0(struct drm_device *dev, size_t size, gfp_t gfp)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjYmodnameN classnameNj j )}j ]j)}jjYsbc.drmm_kmallocasbuh1hhjYubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(hjh]h*}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(hdevh]hdev}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubj)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Zubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjZmodnameN classnameNj j )}j ]jYc.drmm_kmallocasbuh1hhjZubj)}(h h]h }(hj,ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hsizeh]hsize}(hj:ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjVZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjXZmodnameN classnameNj j )}j ]jYc.drmm_kmallocasbuh1hhjOZubj)}(h h]h }(hjtZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOZubj)}(hgfph]hgfp}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOZubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubeh}(h]h ]h"]h$]h&]j+j,uh1jhjKYhhhj]YhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjGYhhhj]YhKubah}(h]jBYah ](jj eh"]h$]h&]j j)jhuh1jhj]YhKhjDYhhubj)}(hhh]h)}(h&:c:type:`drm_device` managed kmalloc()h](h)}(h:c:type:`drm_device`h]j)}(hjZh]h drm_device}(hjZhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jYc.drmm_kmallocasbj  drm_deviceuh1hhjfVhKhjZubh managed kmalloc()}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjZhhubah}(h]h ]h"]h$]h&]uh1jhjDYhhhj]YhKubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jZj3jZj4j5j6uh1jhhhjUhNhNubj8)}(hXv**Parameters** ``struct drm_device *dev`` DRM device ``size_t size`` size of the memory allocation ``gfp_t gfp`` GFP allocation flags **Description** This is a :c:type:`drm_device` managed version of kmalloc(). The allocated memory is automatically freed on the final drm_dev_put(). Memory can also be freed before the final drm_dev_put() by calling drmm_kfree().h](h)}(h**Parameters**h]jB)}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjZubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjZubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj[h]hstruct drm_device *dev}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj [ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj*[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&[hKhj'[ubah}(h]h ]h"]h$]h&]uh1jhj [ubeh}(h]h ]h"]h$]h&]uh1jhj&[hKhj[ubj)}(h.``size_t size`` size of the memory allocation h](j)}(h``size_t size``h]j)}(hjJ[h]h size_t size}(hjL[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH[ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjD[ubj)}(hhh]h)}(hsize of the memory allocationh]hsize of the memory allocation}(hjc[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_[hKhj`[ubah}(h]h ]h"]h$]h&]uh1jhjD[ubeh}(h]h ]h"]h$]h&]uh1jhj_[hKhj[ubj)}(h#``gfp_t gfp`` GFP allocation flags h](j)}(h ``gfp_t gfp``h]j)}(hj[h]h gfp_t gfp}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj}[ubj)}(hhh]h)}(hGFP allocation flagsh]hGFP allocation flags}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hKhj[ubah}(h]h ]h"]h$]h&]uh1jhj}[ubeh}(h]h ]h"]h$]h&]uh1jhj[hKhj[ubeh}(h]h ]h"]h$]h&]uh1jhjZubh)}(h**Description**h]jB)}(hj[h]h Description}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj[ubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhjZubh)}(hThis is a :c:type:`drm_device` managed version of kmalloc(). The allocated memory is automatically freed on the final drm_dev_put(). Memory can also be freed before the final drm_dev_put() by calling drmm_kfree().h](h This is a }(hj[hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj[h]h drm_device}(hj[hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj[ubh managed version of kmalloc(). The allocated memory is automatically freed on the final drm_dev_put(). Memory can also be freed before the final drm_dev_put() by calling drmm_kfree().}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj[hKhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_kstrdup (C function)c.drmm_kstrduphNtauh1jhjUhhhNhNubj)}(hhh](j)}(hFchar * drmm_kstrdup (struct drm_device *dev, const char *s, gfp_t gfp)h]j)}(hDchar *drmm_kstrdup(struct drm_device *dev, const char *s, gfp_t gfp)h](j-)}(hcharh]hchar}(hj&\hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj"\hhh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKubj)}(h h]h }(hj5\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"\hhhj4\hKubj)}(hjh]h*}(hjC\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"\hhhj4\hKubj)}(h drmm_kstrduph]j)}(h drmm_kstrduph]h drmm_kstrdup}(hjT\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP\ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj"\hhhj4\hKubj)}(h2(struct drm_device *dev, const char *s, gfp_t gfp)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjp\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl\ubj)}(h h]h }(hj}\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl\ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj\modnameN classnameNj j )}j ]j)}jjV\sbc.drmm_kstrdupasbuh1hhjl\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl\ubj)}(hjh]h*}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl\ubj)}(hdevh]hdev}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl\ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjh\ubj)}(h const char *sh](j)}(hjZ/h]hconst}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj-)}(hcharh]hchar}(hj\hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj\ubj)}(h h]h }(hj ]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hjh]h*}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hsh]hs}(hj&]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjh\ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjB]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?]ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjD]modnameN classnameNj j )}j ]j\c.drmm_kstrdupasbuh1hhj;]ubj)}(h h]h }(hj`]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;]ubj)}(hgfph]hgfp}(hjn]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;]ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjh\ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj"\hhhj4\hKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj\hhhj4\hKubah}(h]j\ah ](jj eh"]h$]h&]j j)jhuh1jhj4\hKhj\hhubj)}(hhh]h)}(h&:c:type:`drm_device` managed kstrdup()h](h)}(h:c:type:`drm_device`h]j)}(hj]h]h drm_device}(hj]hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j\c.drmm_kstrdupasbj  drm_deviceuh1hhjfVhKhj]ubh managed kstrdup()}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj]hhubah}(h]h ]h"]h$]h&]uh1jhj\hhhj4\hKubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j]j3j]j4j5j6uh1jhhhjUhNhNubj8)}(hXt**Parameters** ``struct drm_device *dev`` DRM device ``const char *s`` 0-terminated string to be duplicated ``gfp_t gfp`` GFP allocation flags **Description** This is a :c:type:`drm_device` managed version of kstrdup(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h)}(h**Parameters**h]jB)}(hj]h]h Parameters}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj]ubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj]ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj]h]hstruct drm_device *dev}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj]ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hKhj^ubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhj^hKhj]ubj)}(h7``const char *s`` 0-terminated string to be duplicated h](j)}(h``const char *s``h]j)}(hj6^h]h const char *s}(hj8^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4^ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj0^ubj)}(hhh]h)}(h$0-terminated string to be duplicatedh]h$0-terminated string to be duplicated}(hjO^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK^hKhjL^ubah}(h]h ]h"]h$]h&]uh1jhj0^ubeh}(h]h ]h"]h$]h&]uh1jhjK^hKhj]ubj)}(h#``gfp_t gfp`` GFP allocation flags h](j)}(h ``gfp_t gfp``h]j)}(hjo^h]h gfp_t gfp}(hjq^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjm^ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhji^ubj)}(hhh]h)}(hGFP allocation flagsh]hGFP allocation flags}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hKhj^ubah}(h]h ]h"]h$]h&]uh1jhji^ubeh}(h]h ]h"]h$]h&]uh1jhj^hKhj]ubeh}(h]h ]h"]h$]h&]uh1jhj]ubh)}(h**Description**h]jB)}(hj^h]h Description}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj^ubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj]ubh)}(hThis is a :c:type:`drm_device` managed version of kstrdup(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h This is a }(hj^hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj^h]h drm_device}(hj^hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chKhj^ubh managed version of kstrdup(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().}(hj^hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj^hKhj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_kfree (C function) c.drmm_kfreehNtauh1jhjUhhhNhNubj)}(hhh](j)}(h4void drmm_kfree (struct drm_device *dev, void *data)h]j)}(h3void drmm_kfree(struct drm_device *dev, void *data)h](j-)}(hvoidh]hvoid}(hj_hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj_hhh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMubj)}(h h]h }(hj!_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_hhhj _hMubj)}(h drmm_kfreeh]j)}(h drmm_kfreeh]h drmm_kfree}(hj3_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/_ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj_hhhj _hMubj)}(h$(struct drm_device *dev, void *data)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjO_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK_ubj)}(h h]h }(hj\_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK_ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjm_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjj_ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjo_modnameN classnameNj j )}j ]j)}jj5_sb c.drmm_kfreeasbuh1hhjK_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK_ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK_ubj)}(hdevh]hdev}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK_ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjG_ubj)}(h void *datah](j-)}(hvoidh]hvoid}(hj_hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj)}(hdatah]hdata}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjG_ubeh}(h]h ]h"]h$]h&]j+j,uh1jhj_hhhj _hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj _hhhj _hMubah}(h]j_ah ](jj eh"]h$]h&]j j)jhuh1jhj _hMhj_hhubj)}(hhh]h)}(h$:c:type:`drm_device` managed kfree()h](h)}(h:c:type:`drm_device`h]j)}(hj`h]h drm_device}(hj`hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j_ c.drmm_kfreeasbj  drm_deviceuh1hhjfVhKhj`ubh managed kfree()}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhj`hhubah}(h]h ]h"]h$]h&]uh1jhj_hhhj _hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jP`j3jP`j4j5j6uh1jhhhjUhNhNubj8)}(hXC**Parameters** ``struct drm_device *dev`` DRM device ``void *data`` memory allocation to be freed **Description** This is a :c:type:`drm_device` managed version of kfree() which can be used to release memory allocated through drmm_kmalloc() or any of its related functions before the final drm_dev_put() of **dev**.h](h)}(h**Parameters**h]jB)}(hjZ`h]h Parameters}(hj\`hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjX`ubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhjT`ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjy`h]hstruct drm_device *dev}(hj{`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjw`ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhjs`ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhjs`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjp`ubj)}(h-``void *data`` memory allocation to be freed h](j)}(h``void *data``h]j)}(hj`h]h void *data}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhj`ubj)}(hhh]h)}(hmemory allocation to be freedh]hmemory allocation to be freed}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjp`ubeh}(h]h ]h"]h$]h&]uh1jhjT`ubh)}(h**Description**h]jB)}(hj`h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj`ubah}(h]h ]h"]h$]h&]uh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhjT`ubh)}(hThis is a :c:type:`drm_device` managed version of kfree() which can be used to release memory allocated through drmm_kmalloc() or any of its related functions before the final drm_dev_put() of **dev**.h](h This is a }(hjahhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj ah]h drm_device}(hjahhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj aubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh`/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:134: ./drivers/gpu/drm/drm_managed.chMhjaubh managed version of kfree() which can be used to release memory allocated through drmm_kmalloc() or any of its related functions before the final drm_dev_put() of }(hjahhhNhNubjB)}(h**dev**h]hdev}(hj/ahhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjaubh.}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj*ahMhjT`ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_add_action (C macro)c.drmm_add_actionhNtauh1jhjUhhhNhNubj)}(hhh](j)}(hdrmm_add_actionh]j)}(hdrmm_add_actionh]j)}(hdrmm_add_actionh]j)}(hjaah]hdrmm_add_action}(hjkahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgaubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjcahhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKubah}(h]h ]h"]h$]h&]j+j,juh1jjjhj_ahhhj~ahKubah}(h]jZaah ](jj eh"]h$]h&]j j)jhuh1jhj~ahKhj\ahhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj\ahhhj~ahKubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jaj3jaj4j5j6uh1jhhhjUhNhNubh)}(h'``drmm_add_action (dev, action, data)``h]j)}(hjah]h#drmm_add_action (dev, action, data)}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjUhhubj+)}(h7add a managed release action to a :c:type:`drm_device` h]h)}(h6add a managed release action to a :c:type:`drm_device`h](h"add a managed release action to a }(hjahhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjah]h drm_device}(hjahhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjaubeh}(h]h ]h"]h$]h&]uh1hhjahKhjaubah}(h]h ]h"]h$]h&]uh1j +hjahKhjUhhubj8)}(hX**Parameters** ``dev`` DRM device ``action`` function which should be called when **dev** is released ``data`` opaque pointer, passed to **action** **Description** This function adds the release **action** with optional parameter **data** to the list of cleanup actions for **dev**. The cleanup actions will be run in reverse order in the final drm_dev_put() call for **dev**.h](h)}(h**Parameters**h]jB)}(hjah]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjaubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjaubj)}(hhh](j)}(h``dev`` DRM device h](j)}(h``dev``h]j)}(hjbh]hdev}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhj bubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj)bhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%bhKhj&bubah}(h]h ]h"]h$]h&]uh1jhj bubeh}(h]h ]h"]h$]h&]uh1jhj%bhKhjbubj)}(hD``action`` function which should be called when **dev** is released h](j)}(h ``action``h]j)}(hjIbh]haction}(hjKbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGbubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjCbubj)}(hhh]h)}(h8function which should be called when **dev** is releasedh](h%function which should be called when }(hjbbhhhNhNubjB)}(h**dev**h]hdev}(hjjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbbubh is released}(hjbbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj^bhKhj_bubah}(h]h ]h"]h$]h&]uh1jhjCbubeh}(h]h ]h"]h$]h&]uh1jhj^bhKhjbubj)}(h.``data`` opaque pointer, passed to **action** h](j)}(h``data``h]j)}(hjbh]hdata}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjbubj)}(hhh]h)}(h$opaque pointer, passed to **action**h](hopaque pointer, passed to }(hjbhhhNhNubjB)}(h **action**h]haction}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubeh}(h]h ]h"]h$]h&]uh1hhjbhKhjbubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhjbhKhjbubeh}(h]h ]h"]h$]h&]uh1jhjaubh)}(h**Description**h]jB)}(hjbh]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjaubh)}(hThis function adds the release **action** with optional parameter **data** to the list of cleanup actions for **dev**. The cleanup actions will be run in reverse order in the final drm_dev_put() call for **dev**.h](hThis function adds the release }(hjbhhhNhNubjB)}(h **action**h]haction}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubh with optional parameter }(hjbhhhNhNubjB)}(h**data**h]hdata}(hj chhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubh$ to the list of cleanup actions for }(hjbhhhNhNubjB)}(h**dev**h]hdev}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubhW. The cleanup actions will be run in reverse order in the final drm_dev_put() call for }(hjbhhhNhNubjB)}(h**dev**h]hdev}(hj1chhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubh.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"drmm_add_action_or_reset (C macro)c.drmm_add_action_or_resethNtauh1jhjUhhhNhNubj)}(hhh](j)}(hdrmm_add_action_or_reseth]j)}(hdrmm_add_action_or_reseth]j)}(hdrmm_add_action_or_reseth]j)}(hjdch]hdrmm_add_action_or_reset}(hjnchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjcubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjfchhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK!ubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjbchhhjchK!ubah}(h]j]cah ](jj eh"]h$]h&]j j)jhuh1jhjchK!hj_chhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj_chhhjchK!ubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jcj3jcj4j5j6uh1jhhhjUhNhNubh)}(h0``drmm_add_action_or_reset (dev, action, data)``h]j)}(hjch]h,drmm_add_action_or_reset (dev, action, data)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK#hjUhhubj+)}(h7add a managed release action to a :c:type:`drm_device` h]h)}(h6add a managed release action to a :c:type:`drm_device`h](h"add a managed release action to a }(hjchhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjch]h drm_device}(hjchhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK!hjcubeh}(h]h ]h"]h$]h&]uh1hhjchK!hjcubah}(h]h ]h"]h$]h&]uh1j +hjchK!hjUhhubj8)}(hXA**Parameters** ``dev`` DRM device ``action`` function which should be called when **dev** is released ``data`` opaque pointer, passed to **action** **Description** Similar to drmm_add_action(), with the only difference that upon failure **action** is directly called for any cleanup work necessary on failures.h](h)}(h**Parameters**h]jB)}(hjch]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjcubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK%hjcubj)}(hhh](j)}(h``dev`` DRM device h](j)}(h``dev``h]j)}(hjdh]hdev}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK"hj dubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj,dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(dhK"hj)dubah}(h]h ]h"]h$]h&]uh1jhj dubeh}(h]h ]h"]h$]h&]uh1jhj(dhK"hj dubj)}(hD``action`` function which should be called when **dev** is released h](j)}(h ``action``h]j)}(hjLdh]haction}(hjNdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJdubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK#hjFdubj)}(hhh]h)}(h8function which should be called when **dev** is releasedh](h%function which should be called when }(hjedhhhNhNubjB)}(h**dev**h]hdev}(hjmdhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjedubh is released}(hjedhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjadhK#hjbdubah}(h]h ]h"]h$]h&]uh1jhjFdubeh}(h]h ]h"]h$]h&]uh1jhjadhK#hj dubj)}(h.``data`` opaque pointer, passed to **action** h](j)}(h``data``h]j)}(hjdh]hdata}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK$hjdubj)}(hhh]h)}(h$opaque pointer, passed to **action**h](hopaque pointer, passed to }(hjdhhhNhNubjB)}(h **action**h]haction}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjdubeh}(h]h ]h"]h$]h&]uh1hhjdhK$hjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjdhK$hj dubeh}(h]h ]h"]h$]h&]uh1jhjcubh)}(h**Description**h]jB)}(hjdh]h Description}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjdubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK&hjcubh)}(hSimilar to drmm_add_action(), with the only difference that upon failure **action** is directly called for any cleanup work necessary on failures.h](hISimilar to drmm_add_action(), with the only difference that upon failure }(hjdhhhNhNubjB)}(h **action**h]haction}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjdubh? is directly called for any cleanup work necessary on failures.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK%hjcubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_kzalloc (C function)c.drmm_kzallochNtauh1jhjUhhhNhNubj)}(hhh](j)}(hDvoid * drmm_kzalloc (struct drm_device *dev, size_t size, gfp_t gfp)h]j)}(hBvoid *drmm_kzalloc(struct drm_device *dev, size_t size, gfp_t gfp)h](j-)}(hvoidh]hvoid}(hj7ehhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj3ehhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK7ubj)}(h h]h }(hjFehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ehhhjEehK7ubj)}(hjh]h*}(hjTehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ehhhjEehK7ubj)}(h drmm_kzalloch]j)}(h drmm_kzalloch]h drmm_kzalloc}(hjeehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaeubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj3ehhhjEehK7ubj)}(h0(struct drm_device *dev, size_t size, gfp_t gfp)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}eubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}eubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjemodnameN classnameNj j )}j ]j)}jjgesbc.drmm_kzallocasbuh1hhj}eubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}eubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}eubj)}(hdevh]hdev}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}eubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjyeubj)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjemodnameN classnameNj j )}j ]jec.drmm_kzallocasbuh1hhjeubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hsizeh]hsize}(hj"fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjyeubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj>fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;fubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@fmodnameN classnameNj j )}j ]jec.drmm_kzallocasbuh1hhj7fubj)}(h h]h }(hj\fhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7fubj)}(hgfph]hgfp}(hjjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7fubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjyeubeh}(h]h ]h"]h$]h&]j+j,uh1jhj3ehhhjEehK7ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj/ehhhjEehK7ubah}(h]j*eah ](jj eh"]h$]h&]j j)jhuh1jhjEehK7hj,ehhubj)}(hhh]h)}(h&:c:type:`drm_device` managed kzalloc()h](h)}(h:c:type:`drm_device`h]j)}(hjfh]h drm_device}(hjfhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jec.drmm_kzallocasbj  drm_deviceuh1hhj~ahKhjfubh managed kzalloc()}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK7hjfhhubah}(h]h ]h"]h$]h&]uh1jhj,ehhhjEehK7ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jfj3jfj4j5j6uh1jhhhjUhNhNubj8)}(hXv**Parameters** ``struct drm_device *dev`` DRM device ``size_t size`` size of the memory allocation ``gfp_t gfp`` GFP allocation flags **Description** This is a :c:type:`drm_device` managed version of kzalloc(). The allocated memory is automatically freed on the final drm_dev_put(). Memory can also be freed before the final drm_dev_put() by calling drmm_kfree().h](h)}(h**Parameters**h]jB)}(hjfh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjfubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK;hjfubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjfh]hstruct drm_device *dev}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK8hjfubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghK8hjgubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjghK8hjfubj)}(h.``size_t size`` size of the memory allocation h](j)}(h``size_t size``h]j)}(hj2gh]h size_t size}(hj4ghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0gubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK9hj,gubj)}(hhh]h)}(hsize of the memory allocationh]hsize of the memory allocation}(hjKghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGghK9hjHgubah}(h]h ]h"]h$]h&]uh1jhj,gubeh}(h]h ]h"]h$]h&]uh1jhjGghK9hjfubj)}(h#``gfp_t gfp`` GFP allocation flags h](j)}(h ``gfp_t gfp``h]j)}(hjkgh]h gfp_t gfp}(hjmghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjigubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK:hjegubj)}(hhh]h)}(hGFP allocation flagsh]hGFP allocation flags}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghK:hjgubah}(h]h ]h"]h$]h&]uh1jhjegubeh}(h]h ]h"]h$]h&]uh1jhjghK:hjfubeh}(h]h ]h"]h$]h&]uh1jhjfubh)}(h**Description**h]jB)}(hjgh]h Description}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjgubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhsbc.drmm_kmalloc_arrayasbuh1hhjThubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThubj)}(hjh]h*}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThubj)}(hdevh]hdev}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjPhubj)}(hsize_t nh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjhmodnameN classnameNj j )}j ]jhc.drmm_kmalloc_arrayasbuh1hhjhubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(hjh]hn}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjPhubj)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjimodnameN classnameNj j )}j ]jhc.drmm_kmalloc_arrayasbuh1hhj iubj)}(h h]h }(hj2ihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj iubj)}(hsizeh]hsize}(hj@ihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj iubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjPhubj)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj\ihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYiubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^imodnameN classnameNj j )}j ]jhc.drmm_kmalloc_arrayasbuh1hhjUiubj)}(h h]h }(hjzihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUiubj)}(hflagsh]hflags}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUiubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjPhubeh}(h]h ]h"]h$]h&]j+j,uh1jhj hhhhjhhKFubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhhjhhKFubah}(h]jhah ](jj eh"]h$]h&]j j)jhuh1jhjhhKFhjhhhubj)}(hhh]h)}(h,:c:type:`drm_device` managed kmalloc_array()h](h)}(h:c:type:`drm_device`h]j)}(hjih]h drm_device}(hjihhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jhc.drmm_kmalloc_arrayasbj  drm_deviceuh1hhj~ahKhjiubh managed kmalloc_array()}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKFhjihhubah}(h]h ]h"]h$]h&]uh1jhjhhhhjhhKFubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jij3jij4j5j6uh1jhhhjUhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``size_t n`` number of array elements to allocate ``size_t size`` size of array member ``gfp_t flags`` GFP allocation flags **Description** This is a :c:type:`drm_device` managed version of kmalloc_array(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h)}(h**Parameters**h]jB)}(hjih]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjiubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKJhjiubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjjh]hstruct drm_device *dev}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKGhjjubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj0jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,jhKGhj-jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhj,jhKGhjjubj)}(h2``size_t n`` number of array elements to allocate h](j)}(h ``size_t n``h]j)}(hjPjh]hsize_t n}(hjRjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKHhjJjubj)}(hhh]h)}(h$number of array elements to allocateh]h$number of array elements to allocate}(hjijhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjejhKHhjfjubah}(h]h ]h"]h$]h&]uh1jhjJjubeh}(h]h ]h"]h$]h&]uh1jhjejhKHhjjubj)}(h%``size_t size`` size of array member h](j)}(h``size_t size``h]j)}(hjjh]h size_t size}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKIhjjubj)}(hhh]h)}(hsize of array memberh]hsize of array member}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhKIhjjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjjhKIhjjubj)}(h%``gfp_t flags`` GFP allocation flags h](j)}(h``gfp_t flags``h]j)}(hjjh]h gfp_t flags}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKJhjjubj)}(hhh]h)}(hGFP allocation flagsh]hGFP allocation flags}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhKJhjjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjjhKJhjjubeh}(h]h ]h"]h$]h&]uh1jhjiubh)}(h**Description**h]jB)}(hjjh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjjubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKLhjiubh)}(hThis is a :c:type:`drm_device` managed version of kmalloc_array(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h This is a }(hjkhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjkh]h drm_device}(hjkhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKKhjkubh managed version of kmalloc_array(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().}(hjkhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj:khKKhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_kcalloc (C function)c.drmm_kcallochNtauh1jhjUhhhNhNubj)}(hhh](j)}(hPvoid * drmm_kcalloc (struct drm_device *dev, size_t n, size_t size, gfp_t flags)h]j)}(hNvoid *drmm_kcalloc(struct drm_device *dev, size_t n, size_t size, gfp_t flags)h](j-)}(hvoidh]hvoid}(hjekhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjakhhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK\ubj)}(h h]h }(hjtkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjakhhhjskhK\ubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjakhhhjskhK\ubj)}(h drmm_kcalloch]j)}(h drmm_kcalloch]h drmm_kcalloc}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjakhhhjskhK\ubj)}(h<(struct drm_device *dev, size_t n, size_t size, gfp_t flags)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjkmodnameN classnameNj j )}j ]j)}jjksbc.drmm_kcallocasbuh1hhjkubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubj)}(hdevh]hdev}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjkubj)}(hsize_t nh](h)}(hhh]j)}(hsize_th]hsize_t}(hj$lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!lubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj&lmodnameN classnameNj j )}j ]jkc.drmm_kcallocasbuh1hhjlubj)}(h h]h }(hjBlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(hjh]hn}(hjPlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjkubj)}(h size_t sizeh](h)}(hhh]j)}(hsize_th]hsize_t}(hjklhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhlubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmlmodnameN classnameNj j )}j ]jkc.drmm_kcallocasbuh1hhjdlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdlubj)}(hsizeh]hsize}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdlubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjkubj)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjlmodnameN classnameNj j )}j ]jkc.drmm_kcallocasbuh1hhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(hflagsh]hflags}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjkubeh}(h]h ]h"]h$]h&]j+j,uh1jhjakhhhjskhK\ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj]khhhjskhK\ubah}(h]jXkah ](jj eh"]h$]h&]j j)jhuh1jhjskhK\hjZkhhubj)}(hhh]h)}(h&:c:type:`drm_device` managed kcalloc()h](h)}(h:c:type:`drm_device`h]j)}(hjmh]h drm_device}(hjmhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj mubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jkc.drmm_kcallocasbj  drm_deviceuh1hhj~ahKhj mubh managed kcalloc()}(hj mhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK\hjmhhubah}(h]h ]h"]h$]h&]uh1jhjZkhhhjskhK\ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jEmj3jEmj4j5j6uh1jhhhjUhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``size_t n`` number of array elements to allocate ``size_t size`` size of array member ``gfp_t flags`` GFP allocation flags **Description** This is a :c:type:`drm_device` managed version of kcalloc(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h)}(h**Parameters**h]jB)}(hjOmh]h Parameters}(hjQmhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjMmubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK`hjImubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjnmh]hstruct drm_device *dev}(hjpmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlmubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK]hjhmubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhK]hjmubah}(h]h ]h"]h$]h&]uh1jhjhmubeh}(h]h ]h"]h$]h&]uh1jhjmhK]hjemubj)}(h2``size_t n`` number of array elements to allocate h](j)}(h ``size_t n``h]j)}(hjmh]hsize_t n}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK^hjmubj)}(hhh]h)}(h$number of array elements to allocateh]h$number of array elements to allocate}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhK^hjmubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjmhK^hjemubj)}(h%``size_t size`` size of array member h](j)}(h``size_t size``h]j)}(hjmh]h size_t size}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK_hjmubj)}(hhh]h)}(hsize of array memberh]hsize of array member}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhK_hjmubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjmhK_hjemubj)}(h%``gfp_t flags`` GFP allocation flags h](j)}(h``gfp_t flags``h]j)}(hjnh]h gfp_t flags}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhK`hjnubj)}(hhh]h)}(hGFP allocation flagsh]hGFP allocation flags}(hj2nhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.nhK`hj/nubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhj.nhK`hjemubeh}(h]h ]h"]h$]h&]uh1jhjImubh)}(h**Description**h]jB)}(hjTnh]h Description}(hjVnhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjRnubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKbhjImubh)}(hThis is a :c:type:`drm_device` managed version of kcalloc(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().h](h This is a }(hjjnhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hjtnh]h drm_device}(hjvnhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjrnubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKahjjnubh managed version of kcalloc(). The allocated memory is automatically freed on the final drm_dev_put() and works exactly like a memory allocation obtained by drmm_kmalloc().}(hjjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjnhKahjImubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrmm_mutex_init (C macro)c.drmm_mutex_inithNtauh1jhjUhhhNhNubj)}(hhh](j)}(hdrmm_mutex_inith]j)}(hdrmm_mutex_inith]j)}(hdrmm_mutex_inith]j)}(hjnh]hdrmm_mutex_init}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjnhhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKsubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjnhhhjnhKsubah}(h]jnah ](jj eh"]h$]h&]j j)jhuh1jhjnhKshjnhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjnhhhjnhKsubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jnj3jnj4j5j6uh1jhhhjUhNhNubh)}(h``drmm_mutex_init (dev, lock)``h]j)}(hjnh]hdrmm_mutex_init (dev, lock)}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKuhjUhhubj+)}(h*:c:type:`drm_device`-managed mutex_init() h]h)}(h):c:type:`drm_device`-managed mutex_init()h](h)}(h:c:type:`drm_device`h]j)}(hjoh]h drm_device}(hjohhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKshj oubh-managed mutex_init()}(hj ohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj/ohKshjoubah}(h]h ]h"]h$]h&]uh1j +hj/ohKshjUhhubj8)}(hX$**Parameters** ``dev`` DRM device ``lock`` lock to be initialized **Return** 0 on success, or a negative errno code otherwise. **Description** This is a :c:type:`drm_device`-managed version of mutex_init(). The initialized lock is automatically destroyed on the final drm_dev_put().h](h)}(h**Parameters**h]jB)}(hjFoh]h Parameters}(hjHohhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjDoubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKwhj@oubj)}(hhh](j)}(h``dev`` DRM device h](j)}(h``dev``h]j)}(hjeoh]hdev}(hjgohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcoubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKthj_oubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj~ohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzohKthj{oubah}(h]h ]h"]h$]h&]uh1jhj_oubeh}(h]h ]h"]h$]h&]uh1jhjzohKthj\oubj)}(h ``lock`` lock to be initialized h](j)}(h``lock``h]j)}(hjoh]hlock}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKuhjoubj)}(hhh]h)}(hlock to be initializedh]hlock to be initialized}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohKuhjoubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjohKuhj\oubeh}(h]h ]h"]h$]h&]uh1jhj@oubh)}(h **Return**h]jB)}(hjoh]hReturn}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjoubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKwhj@oubh)}(h10 on success, or a negative errno code otherwise.h]h10 on success, or a negative errno code otherwise.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKwhj@oubh)}(h**Description**h]jB)}(hjph]h Description}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjoubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKyhj@oubh)}(hThis is a :c:type:`drm_device`-managed version of mutex_init(). The initialized lock is automatically destroyed on the final drm_dev_put().h](h This is a }(hjphhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj ph]h drm_device}(hj"phhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKyhjpubhm-managed version of mutex_init(). The initialized lock is automatically destroyed on the final drm_dev_put().}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj=phKyhj@oubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&drmm_alloc_ordered_workqueue (C macro)c.drmm_alloc_ordered_workqueuehNtauh1jhjUhhhNhNubj)}(hhh](j)}(hdrmm_alloc_ordered_workqueueh]j)}(hdrmm_alloc_ordered_workqueueh]j)}(hdrmm_alloc_ordered_workqueueh]j)}(hjbph]hdrmm_alloc_ordered_workqueue}(hjlphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhpubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjdphhh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKubah}(h]h ]h"]h$]h&]j+j,juh1jjjhj`phhhjphKubah}(h]j[pah ](jj eh"]h$]h&]j j)jhuh1jhjphKhj]phhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj]phhhjphKubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jpj3jpj4j5j6uh1jhhhjUhNhNubh)}(h;``drmm_alloc_ordered_workqueue (dev, fmt, flags, args...)``h]j)}(hjph]h7drmm_alloc_ordered_workqueue (dev, fmt, flags, args...)}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjUhhubj+)}(h7:c:type:`drm_device` managed alloc_ordered_workqueue() h]h)}(h6:c:type:`drm_device` managed alloc_ordered_workqueue()h](h)}(h:c:type:`drm_device`h]j)}(hjph]h drm_device}(hjphhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjpubh" managed alloc_ordered_workqueue()}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjphKhjpubah}(h]h ]h"]h$]h&]uh1j +hjphKhjUhhubj8)}(hX**Parameters** ``dev`` DRM device ``fmt`` printf format for the name of the workqueue ``flags`` WQ_* flags (only WQ_FREEZABLE and WQ_MEM_RECLAIM are meaningful) ``args...`` args for **fmt** **Description** This is a :c:type:`drm_device`-managed version of alloc_ordered_workqueue(). The allocated workqueue is automatically destroyed on the final drm_dev_put(). **Return** workqueue on success, negative ERR_PTR otherwise.h](h)}(h**Parameters**h]jB)}(hjph]h Parameters}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjpubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjpubj)}(hhh](j)}(h``dev`` DRM device h](j)}(h``dev``h]j)}(hjqh]hdev}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhj qubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj*qhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&qhKhj'qubah}(h]h ]h"]h$]h&]uh1jhj qubeh}(h]h ]h"]h$]h&]uh1jhj&qhKhjqubj)}(h4``fmt`` printf format for the name of the workqueue h](j)}(h``fmt``h]j)}(hjJqh]hfmt}(hjLqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHqubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjDqubj)}(hhh]h)}(h+printf format for the name of the workqueueh]h+printf format for the name of the workqueue}(hjcqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_qhKhj`qubah}(h]h ]h"]h$]h&]uh1jhjDqubeh}(h]h ]h"]h$]h&]uh1jhj_qhKhjqubj)}(hK``flags`` WQ_* flags (only WQ_FREEZABLE and WQ_MEM_RECLAIM are meaningful) h](j)}(h ``flags``h]j)}(hjqh]hflags}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhj}qubj)}(hhh]h)}(h@WQ_* flags (only WQ_FREEZABLE and WQ_MEM_RECLAIM are meaningful)h]h@WQ_* flags (only WQ_FREEZABLE and WQ_MEM_RECLAIM are meaningful)}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhKhjqubah}(h]h ]h"]h$]h&]uh1jhj}qubeh}(h]h ]h"]h$]h&]uh1jhjqhKhjqubj)}(h``args...`` args for **fmt** h](j)}(h ``args...``h]j)}(hjqh]hargs...}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjqubj)}(hhh]h)}(hargs for **fmt**h](h args for }(hjqhhhNhNubjB)}(h**fmt**h]hfmt}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjqubeh}(h]h ]h"]h$]h&]uh1hhjqhKhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhKhjqubeh}(h]h ]h"]h$]h&]uh1jhjpubh)}(h**Description**h]jB)}(hjrh]h Description}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjrubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjpubh)}(hThis is a :c:type:`drm_device`-managed version of alloc_ordered_workqueue(). The allocated workqueue is automatically destroyed on the final drm_dev_put().h](h This is a }(hjrhhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj%rh]h drm_device}(hj'rhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj#rubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjrubh}-managed version of alloc_ordered_workqueue(). The allocated workqueue is automatically destroyed on the final drm_dev_put().}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjBrhKhjpubh)}(h **Return**h]jB)}(hjOrh]hReturn}(hjQrhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjMrubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjpubh)}(h1workqueue on success, negative ERR_PTR otherwise.h]h1workqueue on success, negative ERR_PTR otherwise.}(hjerhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:137: ./include/drm/drm_managed.hhKhjpubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjUhhhNhNubeh}(h]jah ]h"]managed resourcesah$]h&]uh1hhjhhhhhKubeh}(h]jIah ]h"]driver initializationah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h&Open/Close, File Operations and IOCTLsh]h&Open/Close, File Operations and IOCTLs}(hjrhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjrhhhhhKubhtarget)}(h.. _drm_driver_fops:h]h}(h]h ]h"]h$]h&]hʌdrm-driver-fopsuh1jrhKhjrhhhhubh)}(hhh](h)}(hFile Operationsh]hFile Operations}(hjrhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjrhhhhhKubh)}(hXDrivers must define the file operations structure that forms the DRM userspace API entry point, even though most of those operations are implemented in the DRM core. The resulting :c:type:`struct file_operations ` must be stored in the :c:type:`drm_driver.fops ` field. The mandatory functions are drm_open(), drm_read(), drm_ioctl() and drm_compat_ioctl() if CONFIG_COMPAT is enabled Note that drm_compat_ioctl will be NULL if CONFIG_COMPAT=n, so there's no need to sprinkle #ifdef into the code. Drivers which implement private ioctls that require 32/64 bit compatibility support must provide their own :c:type:`file_operations.compat_ioctl ` handler that processes private ioctls and calls drm_compat_ioctl() for core ioctls.h](hDrivers must define the file operations structure that forms the DRM userspace API entry point, even though most of those operations are implemented in the DRM core. The resulting }(hjrhhhNhNubh)}(h2:c:type:`struct file_operations `h]j)}(hjrh]hstruct file_operations}(hjrhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKHhjrubh must be stored in the }(hjrhhhNhNubh)}(h&:c:type:`drm_driver.fops `h]j)}(hjrh]hdrm_driver.fops}(hjrhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhjrhKHhjrubhXY field. The mandatory functions are drm_open(), drm_read(), drm_ioctl() and drm_compat_ioctl() if CONFIG_COMPAT is enabled Note that drm_compat_ioctl will be NULL if CONFIG_COMPAT=n, so there’s no need to sprinkle #ifdef into the code. Drivers which implement private ioctls that require 32/64 bit compatibility support must provide their own }(hjrhhhNhNubh)}(h8:c:type:`file_operations.compat_ioctl `h]j)}(hj sh]hfile_operations.compat_ioctl}(hj shhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hhjrhKHhjrubhT handler that processes private ioctls and calls drm_compat_ioctl() for core ioctls.}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjrhKHhjrhhubh)}(hX_In addition drm_read() and drm_poll() provide support for DRM events. DRM events are a generic and extensible means to send asynchronous events to userspace through the file descriptor. They are used to send vblank event and page flip completions by the KMS API. But drivers can also use it for their own needs, e.g. to signal completion of rendering.h]hX_In addition drm_read() and drm_poll() provide support for DRM events. DRM events are a generic and extensible means to send asynchronous events to userspace through the file descriptor. They are used to send vblank event and page flip completions by the KMS API. But drivers can also use it for their own needs, e.g. to signal completion of rendering.}(hj0shhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKShjrhhubh)}(hrFor the driver-side event interface see drm_event_reserve_init() and drm_send_event() as the main starting points.h]hrFor the driver-side event interface see drm_event_reserve_init() and drm_send_event() as the main starting points.}(hj?shhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKYhjrhhubh)}(hThe memory mapping implementation will vary depending on how the driver manages memory. For GEM-based drivers this is drm_gem_mmap().h]hThe memory mapping implementation will vary depending on how the driver manages memory. For GEM-based drivers this is drm_gem_mmap().}(hjNshhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chK\hjrhhubh)}(hNo other file operations are supported by the DRM userspace API. Overall the following is an example :c:type:`file_operations` structure::h](heNo other file operations are supported by the DRM userspace API. Overall the following is an example }(hj]shhhNhNubh)}(h:c:type:`file_operations`h]j)}(hjgsh]hfile_operations}(hjishhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjesubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chK_hj]subh structure:}(hj]shhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjshK_hjrhhubj)}(hX8static const example_drm_fops = { .owner = THIS_MODULE, .open = drm_open, .release = drm_release, .unlocked_ioctl = drm_ioctl, .compat_ioctl = drm_compat_ioctl, // NULL if CONFIG_COMPAT=n .poll = drm_poll, .read = drm_read, .mmap = drm_gem_mmap, };h]hX8static const example_drm_fops = { .owner = THIS_MODULE, .open = drm_open, .release = drm_release, .unlocked_ioctl = drm_ioctl, .compat_ioctl = drm_compat_ioctl, // NULL if CONFIG_COMPAT=n .poll = drm_poll, .read = drm_read, .mmap = drm_gem_mmap, };}hjssbah}(h]h ]h"]h$]h&]j+j,uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKbhjrhhubh)}(hFor plain GEM based drivers there is the DEFINE_DRM_GEM_FOPS() macro, and for DMA based drivers there is the DEFINE_DRM_GEM_DMA_FOPS() macro to make this simpler.h]hFor plain GEM based drivers there is the DEFINE_DRM_GEM_FOPS() macro, and for DMA based drivers there is the DEFINE_DRM_GEM_DMA_FOPS() macro to make this simpler.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKmhjrhhubh)}(h`The driver's :c:type:`file_operations` must be stored in :c:type:`drm_driver.fops `.h](hThe driver’s }(hjshhhNhNubh)}(h:c:type:`file_operations`h]j)}(hjsh]hfile_operations}(hjshhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKqhjsubh must be stored in }(hjshhhNhNubh)}(h&:c:type:`drm_driver.fops `h]j)}(hjsh]hdrm_driver.fops}(hjshhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhjshKqhjsubh.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjshKqhjrhhubh)}(hFor driver-private IOCTL handling see the more detailed discussion in :ref:`IOCTL support in the userland interfaces chapter`.h](hFFor driver-private IOCTL handling see the more detailed discussion in }(hjthhhNhNubh)}(hI:ref:`IOCTL support in the userland interfaces chapter`h]jf)}(hj th]h0IOCTL support in the userland interfaces chapter}(hjthhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehj tubah}(h]h ]h"]h$]h&]refdocj refdomainjtreftyperef refexplicitrefwarnj drm_driver_ioctluh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:148: ./drivers/gpu/drm/drm_file.chKshjtubh.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj*thKshjrhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_minor (C struct) c.drm_minorhNtauh1jhjrhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhNubj)}(hhh](j)}(h drm_minorh]j)}(hstruct drm_minorh](j)}(hjh]hstruct}(hjOthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKthhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKubj)}(h h]h }(hj]thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKthhhj\thKubj)}(h drm_minorh]j)}(hjIth]h drm_minor}(hjothhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjktubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjKthhhj\thKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjGthhhj\thKubah}(h]jAtah ](jj eh"]h$]h&]j j)jhuh1jhj\thKhjDthhubj)}(hhh]h)}(hDRM device minor structureh]hDRM device minor structure}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKFhjthhubah}(h]h ]h"]h$]h&]uh1jhjDthhhj\thKubeh}(h]h ](jstructeh"]h$]h&]j1jj2jtj3jtj4j5j6uh1jhhhjrhjCthNubj8)}(h8**Definition**:: struct drm_minor { }; **Members**h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjtubh:}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKJhjtubj)}(hstruct drm_minor { };h]hstruct drm_minor { };}hjtsbah}(h]h ]h"]h$]h&]j+j,uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKLhjtubh)}(h **Members**h]jB)}(hjth]hMembers}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjtubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKOhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubh)}(h**Description**h]jB)}(hjth]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjtubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKRhjrhhubh)}(hXeThis structure represents a DRM minor number for device nodes in /dev. Entirely opaque to drivers and should never be inspected directly by drivers. Drivers instead should only interact with :c:type:`struct drm_file ` and of course :c:type:`struct drm_device `, which is also where driver-private data and resources can be attached to.h](hThis structure represents a DRM minor number for device nodes in /dev. Entirely opaque to drivers and should never be inspected directly by drivers. Drivers instead should only interact with }(hjuhhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hjuh]hstruct drm_file}(hj uhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKGhjuubh and of course }(hjuhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjBuh]hstruct drm_device}(hjDuhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj@uubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj;uhKGhjuubhK, which is also where driver-private data and resources can be attached to.}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj;uhKGhjrhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_pending_event (C struct)c.drm_pending_eventhNtauh1jhjrhhhjCthNubj)}(hhh](j)}(hdrm_pending_eventh]j)}(hstruct drm_pending_eventh](j)}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~uhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKPubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~uhhhjuhKPubj)}(hdrm_pending_eventh]j)}(hj|uh]hdrm_pending_event}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj~uhhhjuhKPubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjzuhhhjuhKPubah}(h]juuah ](jj eh"]h$]h&]j j)jhuh1jhjuhKPhjwuhhubj)}(hhh]h)}(h%Event queued up for userspace to readh]h%Event queued up for userspace to read}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKZhjuhhubah}(h]h ]h"]h$]h&]uh1jhjwuhhhjuhKPubeh}(h]h ](jstructeh"]h$]h&]j1jj2juj3juj4j5j6uh1jhhhjrhjCthNubj8)}(hXu**Definition**:: struct drm_pending_event { struct completion *completion; void (*completion_release)(struct completion *completion); struct drm_event *event; struct dma_fence *fence; struct drm_file *file_priv; struct list_head link; struct list_head pending_link; }; **Members** ``completion`` Optional pointer to a kernel internal completion signalled when drm_send_event() is called, useful to internally synchronize with nonblocking operations. ``completion_release`` Optional callback currently only used by the atomic modeset helpers to clean up the reference count for the structure **completion** is stored in. ``event`` Pointer to the actual event that should be sent to userspace to be read using drm_read(). Can be optional, since nowadays events are also used to signal kernel internal threads with **completion** or DMA transactions using **fence**. ``fence`` Optional DMA fence to unblock other hardware transactions which depend upon the nonblocking DRM operation this event represents. ``file_priv`` :c:type:`struct drm_file ` where **event** should be delivered to. Only set when **event** is set. ``link`` Double-linked list to keep track of this event. Can be used by the driver up to the point when it calls drm_send_event(), after that this list entry is owned by the core for its own book-keeping. ``pending_link`` Entry on :c:type:`drm_file.pending_event_list `, to keep track of all pending events for **file_priv**, to allow correct unwinding of them when userspace closes the file before the event is delivered.h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjuubh:}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhK^hjuubj)}(hXstruct drm_pending_event { struct completion *completion; void (*completion_release)(struct completion *completion); struct drm_event *event; struct dma_fence *fence; struct drm_file *file_priv; struct list_head link; struct list_head pending_link; };h]hXstruct drm_pending_event { struct completion *completion; void (*completion_release)(struct completion *completion); struct drm_event *event; struct dma_fence *fence; struct drm_file *file_priv; struct list_head link; struct list_head pending_link; };}hjvsbah}(h]h ]h"]h$]h&]j+j,uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhK`hjuubh)}(h **Members**h]jB)}(hjvh]hMembers}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKjhjuubj)}(hhh](j)}(h``completion`` Optional pointer to a kernel internal completion signalled when drm_send_event() is called, useful to internally synchronize with nonblocking operations. h](j)}(h``completion``h]j)}(hj1vh]h completion}(hj3vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/vubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKehj+vubj)}(hhh]h)}(hOptional pointer to a kernel internal completion signalled when drm_send_event() is called, useful to internally synchronize with nonblocking operations.h]hOptional pointer to a kernel internal completion signalled when drm_send_event() is called, useful to internally synchronize with nonblocking operations.}(hjJvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKchjGvubah}(h]h ]h"]h$]h&]uh1jhj+vubeh}(h]h ]h"]h$]h&]uh1jhjFvhKehj(vubj)}(h``completion_release`` Optional callback currently only used by the atomic modeset helpers to clean up the reference count for the structure **completion** is stored in. h](j)}(h``completion_release``h]j)}(hjkvh]hcompletion_release}(hjmvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjivubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKnhjevubj)}(hhh]h)}(hOptional callback currently only used by the atomic modeset helpers to clean up the reference count for the structure **completion** is stored in.h](hvOptional callback currently only used by the atomic modeset helpers to clean up the reference count for the structure }(hjvhhhNhNubjB)}(h**completion**h]h completion}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubh is stored in.}(hjvhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKlhjvubah}(h]h ]h"]h$]h&]uh1jhjevubeh}(h]h ]h"]h$]h&]uh1jhjvhKnhj(vubj)}(h``event`` Pointer to the actual event that should be sent to userspace to be read using drm_read(). Can be optional, since nowadays events are also used to signal kernel internal threads with **completion** or DMA transactions using **fence**. h](j)}(h ``event``h]j)}(hjvh]hevent}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKxhjvubj)}(hhh]h)}(hPointer to the actual event that should be sent to userspace to be read using drm_read(). Can be optional, since nowadays events are also used to signal kernel internal threads with **completion** or DMA transactions using **fence**.h](hPointer to the actual event that should be sent to userspace to be read using drm_read(). Can be optional, since nowadays events are also used to signal kernel internal threads with }(hjvhhhNhNubjB)}(h**completion**h]h completion}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubh or DMA transactions using }(hjvhhhNhNubjB)}(h **fence**h]hfence}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubh.}(hjvhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKuhjvubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjvhKxhj(vubj)}(h``fence`` Optional DMA fence to unblock other hardware transactions which depend upon the nonblocking DRM operation this event represents. h](j)}(h ``fence``h]j)}(hjwh]hfence}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjwubj)}(hhh]h)}(hOptional DMA fence to unblock other hardware transactions which depend upon the nonblocking DRM operation this event represents.h]hOptional DMA fence to unblock other hardware transactions which depend upon the nonblocking DRM operation this event represents.}(hj.whhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj+wubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhj*whKhj(vubj)}(h{``file_priv`` :c:type:`struct drm_file ` where **event** should be delivered to. Only set when **event** is set. h](j)}(h ``file_priv``h]j)}(hjOwh]h file_priv}(hjQwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMwubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjIwubj)}(hhh]h)}(hl:c:type:`struct drm_file ` where **event** should be delivered to. Only set when **event** is set.h](h)}(h$:c:type:`struct drm_file `h]j)}(hjnwh]hstruct drm_file}(hjpwhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjlwubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjhwubh where }(hjhwhhhNhNubjB)}(h **event**h]hevent}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjhwubh' should be delivered to. Only set when }(hjhwhhhNhNubjB)}(h **event**h]hevent}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjhwubh is set.}(hjhwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjwhKhjewubah}(h]h ]h"]h$]h&]uh1jhjIwubeh}(h]h ]h"]h$]h&]uh1jhjdwhKhj(vubj)}(h``link`` Double-linked list to keep track of this event. Can be used by the driver up to the point when it calls drm_send_event(), after that this list entry is owned by the core for its own book-keeping. h](j)}(h``link``h]j)}(hjwh]hlink}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjwubj)}(hhh]h)}(hDouble-linked list to keep track of this event. Can be used by the driver up to the point when it calls drm_send_event(), after that this list entry is owned by the core for its own book-keeping.h]hDouble-linked list to keep track of this event. Can be used by the driver up to the point when it calls drm_send_event(), after that this list entry is owned by the core for its own book-keeping.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhKhj(vubj)}(h``pending_link`` Entry on :c:type:`drm_file.pending_event_list `, to keep track of all pending events for **file_priv**, to allow correct unwinding of them when userspace closes the file before the event is delivered.h](j)}(h``pending_link``h]j)}(hjxh]h pending_link}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjxubj)}(hhh]h)}(hEntry on :c:type:`drm_file.pending_event_list `, to keep track of all pending events for **file_priv**, to allow correct unwinding of them when userspace closes the file before the event is delivered.h](h Entry on }(hjxhhhNhNubh)}(h0:c:type:`drm_file.pending_event_list `h]j)}(hj)xh]hdrm_file.pending_event_list}(hj+xhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj'xubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjxubh*, to keep track of all pending events for }(hjxhhhNhNubjB)}(h **file_priv**h]h file_priv}(hjKxhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjxubhb, to allow correct unwinding of them when userspace closes the file before the event is delivered.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjFxhKhjxubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjxhKhj(vubeh}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubh)}(h**Description**h]jB)}(hj~xh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj|xubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjrhhubh)}(hXThis represents a DRM event. Drivers can use this as a generic completion mechanism, which supports kernel-internal :c:type:`struct completion `, :c:type:`struct dma_fence ` and also the DRM-specific :c:type:`struct drm_event ` delivery mechanism.h](htThis represents a DRM event. Drivers can use this as a generic completion mechanism, which supports kernel-internal }(hjxhhhNhNubh)}(h(:c:type:`struct completion `h]j)}(hjxh]hstruct completion}(hjxhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  completionuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhK[hjxubh, }(hjxhhhNhNubh)}(h&:c:type:`struct dma_fence `h]j)}(hjxh]hstruct dma_fence}(hjxhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  dma_fenceuh1hhjxhK[hjxubh and also the DRM-specific }(hjxhhhNhNubh)}(h&:c:type:`struct drm_event `h]j)}(hjxh]hstruct drm_event}(hjxhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_eventuh1hhjxhK[hjxubh delivery mechanism.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjxhK[hjrhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_file (C struct) c.drm_filehNtauh1jhjrhhhjCthNubj)}(hhh](j)}(hdrm_fileh]j)}(hstruct drm_fileh](j)}(hjh]hstruct}(hj%yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!yhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKbubj)}(h h]h }(hj3yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!yhhhj2yhKbubj)}(hdrm_fileh]j)}(hjyh]hdrm_file}(hjEyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAyubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj!yhhhj2yhKbubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjyhhhj2yhKbubah}(h]jyah ](jj eh"]h$]h&]j j)jhuh1jhj2yhKbhjyhhubj)}(hhh]h)}(hDRM file private datah]hDRM file private data}(hjgyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjdyhhubah}(h]h ]h"]h$]h&]uh1jhjyhhhj2yhKbubeh}(h]h ](jstructeh"]h$]h&]j1jj2jyj3jyj4j5j6uh1jhhhjrhjCthNubj8)}(hX**Definition**:: struct drm_file { bool authenticated; bool stereo_allowed; bool universal_planes; bool atomic; bool aspect_ratio_allowed; bool writeback_connectors; bool plane_color_pipeline; bool was_master; bool is_master; bool supports_virtualized_cursor_plane; struct drm_master *master; spinlock_t master_lookup_lock; struct pid *pid; u64 client_id; drm_magic_t magic; struct list_head lhead; struct drm_minor *minor; struct idr object_idr; spinlock_t table_lock; struct xarray syncobj_xa; struct file *filp; void *driver_priv; struct list_head fbs; struct mutex fbs_lock; struct list_head blobs; wait_queue_head_t event_wait; struct list_head pending_event_list; struct list_head event_list; int event_space; struct mutex event_read_lock; struct drm_prime_file_private prime; const char *client_name; struct mutex client_name_lock; struct dentry *debugfs_client; }; **Members** ``authenticated`` Whether the client is allowed to submit rendering, which for legacy nodes means it must be authenticated. See also the :ref:`section on primary nodes and authentication `. ``stereo_allowed`` True when the client has asked us to expose stereo 3D mode flags. ``universal_planes`` True if client understands CRTC primary planes and cursor planes in the plane list. Automatically set when **atomic** is set. ``atomic`` True if client understands atomic properties. ``aspect_ratio_allowed`` True, if client can handle picture aspect ratios, and has requested to pass this information along with the mode. ``writeback_connectors`` True if client understands writeback connectors ``plane_color_pipeline`` True if client understands plane color pipelines ``was_master`` This client has or had, master capability. Protected by struct :c:type:`drm_device.master_mutex `. This is used to ensure that CAP_SYS_ADMIN is not enforced, if the client is or was master in the past. ``is_master`` This client is the creator of **master**. Protected by struct :c:type:`drm_device.master_mutex `. See also the :ref:`section on primary nodes and authentication `. ``supports_virtualized_cursor_plane`` This client is capable of handling the cursor plane with the restrictions imposed on it by the virtualized drivers. This implies that the cursor plane has to behave like a cursor i.e. track cursor movement. It also requires setting of the hotspot properties by the client on the cursor plane. ``master`` Master this node is currently associated with. Protected by struct :c:type:`drm_device.master_mutex `, and serialized by **master_lookup_lock**. Only relevant if drm_is_primary_client() returns true. Note that this only matches :c:type:`drm_device.master ` if the master is the currently active one. To update **master**, both :c:type:`drm_device.master_mutex ` and **master_lookup_lock** need to be held, therefore holding either of them is safe and enough for the read side. When dereferencing this pointer, either hold struct :c:type:`drm_device.master_mutex ` for the duration of the pointer's use, or use drm_file_get_master() if struct :c:type:`drm_device.master_mutex ` is not currently held and there is no other need to hold it. This prevents **master** from being freed during use. See also **authentication** and **is_master** and the :ref:`section on primary nodes and authentication `. ``master_lookup_lock`` Serializes **master**. ``pid`` Process that is using this file. Must only be dereferenced under a rcu_read_lock or equivalent. Updates are guarded with dev->filelist_mutex and reference must be dropped after a RCU grace period to accommodate lockless readers. ``client_id`` A unique id for fdinfo ``magic`` Authentication magic, see **authenticated**. ``lhead`` List of all open files of a DRM device, linked into :c:type:`drm_device.filelist `. Protected by :c:type:`drm_device.filelist_mutex `. ``minor`` :c:type:`struct drm_minor ` for this file. ``object_idr`` Mapping of mm object handles to object pointers. Used by the GEM subsystem. Protected by **table_lock**. Note that allocated entries might be NULL as a transient state when creating or deleting a handle. ``table_lock`` Protects **object_idr**. ``syncobj_xa`` Mapping of sync object handles to object pointers. ``filp`` Pointer to the core file structure. ``driver_priv`` Optional pointer for driver private data. Can be allocated in :c:type:`drm_driver.open ` and should be freed in :c:type:`drm_driver.postclose `. ``fbs`` List of :c:type:`struct drm_framebuffer ` associated with this file, using the :c:type:`drm_framebuffer.filp_head ` entry. Protected by **fbs_lock**. Note that the **fbs** list holds a reference on the framebuffer object to prevent it from untimely disappearing. ``fbs_lock`` Protects **fbs**. ``blobs`` User-created blob properties; this retains a reference on the property. Protected by **drm_mode_config.blob_lock**; ``event_wait`` Waitqueue for new events added to **event_list**. ``pending_event_list`` List of pending :c:type:`struct drm_pending_event `, used to clean up pending events in case this file gets closed before the event is signalled. Uses the :c:type:`drm_pending_event.pending_link ` entry. Protect by :c:type:`drm_device.event_lock `. ``event_list`` List of :c:type:`struct drm_pending_event `, ready for delivery to userspace through drm_read(). Uses the :c:type:`drm_pending_event.link ` entry. Protect by :c:type:`drm_device.event_lock `. ``event_space`` Available event space to prevent userspace from exhausting kernel memory. Currently limited to the fairly arbitrary value of 4KB. ``event_read_lock`` Serializes drm_read(). ``prime`` Per-file buffer caches used by the PRIME buffer sharing code. ``client_name`` Userspace-provided name; useful for accounting and debugging. ``client_name_lock`` Protects **client_name**. ``debugfs_client`` debugfs directory for each client under a drm node.h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjyubh:}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubj)}(hXstruct drm_file { bool authenticated; bool stereo_allowed; bool universal_planes; bool atomic; bool aspect_ratio_allowed; bool writeback_connectors; bool plane_color_pipeline; bool was_master; bool is_master; bool supports_virtualized_cursor_plane; struct drm_master *master; spinlock_t master_lookup_lock; struct pid *pid; u64 client_id; drm_magic_t magic; struct list_head lhead; struct drm_minor *minor; struct idr object_idr; spinlock_t table_lock; struct xarray syncobj_xa; struct file *filp; void *driver_priv; struct list_head fbs; struct mutex fbs_lock; struct list_head blobs; wait_queue_head_t event_wait; struct list_head pending_event_list; struct list_head event_list; int event_space; struct mutex event_read_lock; struct drm_prime_file_private prime; const char *client_name; struct mutex client_name_lock; struct dentry *debugfs_client; };h]hXstruct drm_file { bool authenticated; bool stereo_allowed; bool universal_planes; bool atomic; bool aspect_ratio_allowed; bool writeback_connectors; bool plane_color_pipeline; bool was_master; bool is_master; bool supports_virtualized_cursor_plane; struct drm_master *master; spinlock_t master_lookup_lock; struct pid *pid; u64 client_id; drm_magic_t magic; struct list_head lhead; struct drm_minor *minor; struct idr object_idr; spinlock_t table_lock; struct xarray syncobj_xa; struct file *filp; void *driver_priv; struct list_head fbs; struct mutex fbs_lock; struct list_head blobs; wait_queue_head_t event_wait; struct list_head pending_event_list; struct list_head event_list; int event_space; struct mutex event_read_lock; struct drm_prime_file_private prime; const char *client_name; struct mutex client_name_lock; struct dentry *debugfs_client; };}hjysbah}(h]h ]h"]h$]h&]j+j,uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubh)}(h **Members**h]jB)}(hjyh]hMembers}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjyubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubj)}(hhh](j)}(h``authenticated`` Whether the client is allowed to submit rendering, which for legacy nodes means it must be authenticated. See also the :ref:`section on primary nodes and authentication `. h](j)}(h``authenticated``h]j)}(hjyh]h authenticated}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubj)}(hhh](h)}(hiWhether the client is allowed to submit rendering, which for legacy nodes means it must be authenticated.h]hiWhether the client is allowed to submit rendering, which for legacy nodes means it must be authenticated.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubh)}(hSSee also the :ref:`section on primary nodes and authentication `.h](h See also the }(hjyhhhNhNubh)}(hE:ref:`section on primary nodes and authentication `h]jf)}(hjzh]h+section on primary nodes and authentication}(hjzhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjzubah}(h]h ]h"]h$]h&]refdocj refdomainjzreftyperef refexplicitrefwarnj drm_primary_nodeuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjyubh.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj$zhKhjyubeh}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjyhKhjyubj)}(hU``stereo_allowed`` True when the client has asked us to expose stereo 3D mode flags. h](j)}(h``stereo_allowed``h]j)}(hjAzh]hstereo_allowed}(hjCzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?zubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj;zubj)}(hhh]h)}(hATrue when the client has asked us to expose stereo 3D mode flags.h]hATrue when the client has asked us to expose stereo 3D mode flags.}(hjZzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVzhKhjWzubah}(h]h ]h"]h$]h&]uh1jhj;zubeh}(h]h ]h"]h$]h&]uh1jhjVzhKhjyubj)}(h``universal_planes`` True if client understands CRTC primary planes and cursor planes in the plane list. Automatically set when **atomic** is set. h](j)}(h``universal_planes``h]j)}(hjzzh]huniversal_planes}(hj|zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjtzubj)}(hhh]h)}(h}True if client understands CRTC primary planes and cursor planes in the plane list. Automatically set when **atomic** is set.h](hkTrue if client understands CRTC primary planes and cursor planes in the plane list. Automatically set when }(hjzhhhNhNubjB)}(h **atomic**h]hatomic}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjzubh is set.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjzubah}(h]h ]h"]h$]h&]uh1jhjtzubeh}(h]h ]h"]h$]h&]uh1jhjzhKhjyubj)}(h9``atomic`` True if client understands atomic properties. h](j)}(h ``atomic``h]j)}(hjzh]hatomic}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjzubj)}(hhh]h)}(h-True if client understands atomic properties.h]h-True if client understands atomic properties.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhKhjzubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjzhKhjyubj)}(h``aspect_ratio_allowed`` True, if client can handle picture aspect ratios, and has requested to pass this information along with the mode. h](j)}(h``aspect_ratio_allowed``h]j)}(hjzh]haspect_ratio_allowed}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjzubj)}(hhh]h)}(hqTrue, if client can handle picture aspect ratios, and has requested to pass this information along with the mode.h]hqTrue, if client can handle picture aspect ratios, and has requested to pass this information along with the mode.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj{ubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhj{hKhjyubj)}(hI``writeback_connectors`` True if client understands writeback connectors h](j)}(h``writeback_connectors``h]j)}(hj9{h]hwriteback_connectors}(hj;{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7{ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj3{ubj)}(hhh]h)}(h/True if client understands writeback connectorsh]h/True if client understands writeback connectors}(hjR{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjN{hKhjO{ubah}(h]h ]h"]h$]h&]uh1jhj3{ubeh}(h]h ]h"]h$]h&]uh1jhjN{hKhjyubj)}(hJ``plane_color_pipeline`` True if client understands plane color pipelines h](j)}(h``plane_color_pipeline``h]j)}(hjr{h]hplane_color_pipeline}(hjt{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp{ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjl{ubj)}(hhh]h)}(h0True if client understands plane color pipelinesh]h0True if client understands plane color pipelines}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hKhj{ubah}(h]h ]h"]h$]h&]uh1jhjl{ubeh}(h]h ]h"]h$]h&]uh1jhj{hKhjyubj)}(h``was_master`` This client has or had, master capability. Protected by struct :c:type:`drm_device.master_mutex `. This is used to ensure that CAP_SYS_ADMIN is not enforced, if the client is or was master in the past. h](j)}(h``was_master``h]j)}(hj{h]h was_master}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj{ubj)}(hhh](h)}(hnThis client has or had, master capability. Protected by struct :c:type:`drm_device.master_mutex `.h](h?This client has or had, master capability. Protected by struct }(hj{hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj{h]hdrm_device.master_mutex}(hj{hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj{ubh.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj{hKhj{ubh)}(hfThis is used to ensure that CAP_SYS_ADMIN is not enforced, if the client is or was master in the past.h]hfThis is used to ensure that CAP_SYS_ADMIN is not enforced, if the client is or was master in the past.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj{ubeh}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhj{hKhjyubj)}(h``is_master`` This client is the creator of **master**. Protected by struct :c:type:`drm_device.master_mutex `. See also the :ref:`section on primary nodes and authentication `. h](j)}(h ``is_master``h]j)}(hj|h]h is_master}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj|ubj)}(hhh](h)}(hmThis client is the creator of **master**. Protected by struct :c:type:`drm_device.master_mutex `.h](hThis client is the creator of }(hj0|hhhNhNubjB)}(h **master**h]hmaster}(hj8|hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj0|ubh. Protected by struct }(hj0|hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hjL|h]hdrm_device.master_mutex}(hjN|hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjJ|ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj0|ubh.}(hj0|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhji|hKhj-|ubh)}(hSSee also the :ref:`section on primary nodes and authentication `.h](h See also the }(hjt|hhhNhNubh)}(hE:ref:`section on primary nodes and authentication `h]jf)}(hj~|h]h+section on primary nodes and authentication}(hj|hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehj||ubah}(h]h ]h"]h$]h&]refdocj refdomainj|reftyperef refexplicitrefwarnj drm_primary_nodeuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjt|ubh.}(hjt|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj|hKhj-|ubeh}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj,|hKhjyubj)}(hXL``supports_virtualized_cursor_plane`` This client is capable of handling the cursor plane with the restrictions imposed on it by the virtualized drivers. This implies that the cursor plane has to behave like a cursor i.e. track cursor movement. It also requires setting of the hotspot properties by the client on the cursor plane. h](j)}(h%``supports_virtualized_cursor_plane``h]j)}(hj|h]h!supports_virtualized_cursor_plane}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj|ubj)}(hhh](h)}(hsThis client is capable of handling the cursor plane with the restrictions imposed on it by the virtualized drivers.h]hsThis client is capable of handling the cursor plane with the restrictions imposed on it by the virtualized drivers.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj|ubh)}(hThis implies that the cursor plane has to behave like a cursor i.e. track cursor movement. It also requires setting of the hotspot properties by the client on the cursor plane.h]hThis implies that the cursor plane has to behave like a cursor i.e. track cursor movement. It also requires setting of the hotspot properties by the client on the cursor plane.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|hKhjyubj)}(hX``master`` Master this node is currently associated with. Protected by struct :c:type:`drm_device.master_mutex `, and serialized by **master_lookup_lock**. Only relevant if drm_is_primary_client() returns true. Note that this only matches :c:type:`drm_device.master ` if the master is the currently active one. To update **master**, both :c:type:`drm_device.master_mutex ` and **master_lookup_lock** need to be held, therefore holding either of them is safe and enough for the read side. When dereferencing this pointer, either hold struct :c:type:`drm_device.master_mutex ` for the duration of the pointer's use, or use drm_file_get_master() if struct :c:type:`drm_device.master_mutex ` is not currently held and there is no other need to hold it. This prevents **master** from being freed during use. See also **authentication** and **is_master** and the :ref:`section on primary nodes and authentication `. h](j)}(h ``master``h]j)}(hj}h]hmaster}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj|ubj)}(hhh](h)}(hMaster this node is currently associated with. Protected by struct :c:type:`drm_device.master_mutex `, and serialized by **master_lookup_lock**.h](hCMaster this node is currently associated with. Protected by struct }(hj}hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj%}h]hdrm_device.master_mutex}(hj'}hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj#}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhj}ubh, and serialized by }(hj}hhhNhNubjB)}(h**master_lookup_lock**h]hmaster_lookup_lock}(hjG}hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}ubh.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjB}hKhj}ubh)}(hOnly relevant if drm_is_primary_client() returns true. Note that this only matches :c:type:`drm_device.master ` if the master is the currently active one.h](hSOnly relevant if drm_is_primary_client() returns true. Note that this only matches }(hj_}hhhNhNubh)}(h(:c:type:`drm_device.master `h]j)}(hji}h]hdrm_device.master}(hjk}hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjg}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj_}ubh+ if the master is the currently active one.}(hj_}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj}hMhj}ubh)}(hTo update **master**, both :c:type:`drm_device.master_mutex ` and **master_lookup_lock** need to be held, therefore holding either of them is safe and enough for the read side.h](h To update }(hj}hhhNhNubjB)}(h **master**h]hmaster}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}ubh, both }(hj}hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj}h]hdrm_device.master_mutex}(hj}hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj}ubh and }(hj}hhhNhNubjB)}(h**master_lookup_lock**h]hmaster_lookup_lock}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}ubhX need to be held, therefore holding either of them is safe and enough for the read side.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj}hMhj}ubh)}(hXRWhen dereferencing this pointer, either hold struct :c:type:`drm_device.master_mutex ` for the duration of the pointer's use, or use drm_file_get_master() if struct :c:type:`drm_device.master_mutex ` is not currently held and there is no other need to hold it. This prevents **master** from being freed during use.h](h4When dereferencing this pointer, either hold struct }(hj}hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj}h]hdrm_device.master_mutex}(hj}hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj}ubhQ for the duration of the pointer’s use, or use drm_file_get_master() if struct }(hj}hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj~h]hdrm_device.master_mutex}(hj~hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhj~hMhj}ubhL is not currently held and there is no other need to hold it. This prevents }(hj}hhhNhNubjB)}(h **master**h]hmaster}(hj6~hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}ubh from being freed during use.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj~hMhj}ubh)}(h|See also **authentication** and **is_master** and the :ref:`section on primary nodes and authentication `.h](h See also }(hjN~hhhNhNubjB)}(h**authentication**h]hauthentication}(hjV~hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjN~ubh and }(hjN~hhhNhNubjB)}(h **is_master**h]h is_master}(hjh~hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjN~ubh and the }(hjN~hhhNhNubh)}(hE:ref:`section on primary nodes and authentication `h]jf)}(hj|~h]h+section on primary nodes and authentication}(hj~~hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjz~ubah}(h]h ]h"]h$]h&]refdocj refdomainj~reftyperef refexplicitrefwarnj drm_primary_nodeuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjN~ubh.}(hjN~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj~hMhj}ubeh}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj}hMhjyubj)}(h.``master_lookup_lock`` Serializes **master**. h](j)}(h``master_lookup_lock``h]j)}(hj~h]hmaster_lookup_lock}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj~ubj)}(hhh]h)}(hSerializes **master**.h](h Serializes }(hj~hhhNhNubjB)}(h **master**h]hmaster}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj~ubh.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj~hMhj~ubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhj~hMhjyubj)}(h``pid`` Process that is using this file. Must only be dereferenced under a rcu_read_lock or equivalent. Updates are guarded with dev->filelist_mutex and reference must be dropped after a RCU grace period to accommodate lockless readers. h](j)}(h``pid``h]j)}(hjh]hpid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj~ubj)}(hhh](h)}(h Process that is using this file.h]h Process that is using this file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh)}(h>Must only be dereferenced under a rcu_read_lock or equivalent.h]h>Must only be dereferenced under a rcu_read_lock or equivalent.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh)}(hUpdates are guarded with dev->filelist_mutex and reference must be dropped after a RCU grace period to accommodate lockless readers.h]hUpdates are guarded with dev->filelist_mutex and reference must be dropped after a RCU grace period to accommodate lockless readers.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubeh}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjyubj)}(h%``client_id`` A unique id for fdinfo h](j)}(h ``client_id``h]j)}(hjZh]h client_id}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM"hjTubj)}(hhh]h)}(hA unique id for fdinfoh]hA unique id for fdinfo}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohM"hjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjohM"hjyubj)}(h7``magic`` Authentication magic, see **authenticated**. h](j)}(h ``magic``h]j)}(hjh]hmagic}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM%hjubj)}(hhh]h)}(h,Authentication magic, see **authenticated**.h](hAuthentication magic, see }(hjhhhNhNubjB)}(h**authenticated**h]h authenticated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM%hjyubj)}(h``lhead`` List of all open files of a DRM device, linked into :c:type:`drm_device.filelist `. Protected by :c:type:`drm_device.filelist_mutex `. h](j)}(h ``lhead``h]j)}(hjh]hlhead}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM*hjubj)}(hhh]h)}(hList of all open files of a DRM device, linked into :c:type:`drm_device.filelist `. Protected by :c:type:`drm_device.filelist_mutex `.h](h4List of all open files of a DRM device, linked into }(hjhhhNhNubh)}(h*:c:type:`drm_device.filelist `h]j)}(hjh]hdrm_device.filelist}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM)hjubh. Protected by }(hjhhhNhNubh)}(h0:c:type:`drm_device.filelist_mutex `h]j)}(hj%h]hdrm_device.filelist_mutex}(hj'hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjhM)hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjyubj)}(h@``minor`` :c:type:`struct drm_minor ` for this file. h](j)}(h ``minor``h]j)}(hj^h]hminor}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM0hjXubj)}(hhh]h)}(h5:c:type:`struct drm_minor ` for this file.h](h)}(h&:c:type:`struct drm_minor `h]j)}(hj}h]hstruct drm_minor}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_minoruh1hhjshM0hjwubh for this file.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjshM0hjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhjshM0hjyubj)}(h``object_idr`` Mapping of mm object handles to object pointers. Used by the GEM subsystem. Protected by **table_lock**. Note that allocated entries might be NULL as a transient state when creating or deleting a handle. h](j)}(h``object_idr``h]j)}(hjh]h object_idr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM8hjubj)}(hhh](h)}(hhMapping of mm object handles to object pointers. Used by the GEM subsystem. Protected by **table_lock**.h](hYMapping of mm object handles to object pointers. Used by the GEM subsystem. Protected by }(hjπhhhNhNubjB)}(h**table_lock**h]h table_lock}(hj׀hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjπubh.}(hjπhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM4hj̀ubh)}(hbNote that allocated entries might be NULL as a transient state when creating or deleting a handle.h]hbNote that allocated entries might be NULL as a transient state when creating or deleting a handle.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM7hj̀ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjˀhM8hjyubj)}(h(``table_lock`` Protects **object_idr**. h](j)}(h``table_lock``h]j)}(hjh]h table_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM>hj ubj)}(hhh]h)}(hProtects **object_idr**.h](h Protects }(hj*hhhNhNubjB)}(h**object_idr**h]h object_idr}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj*ubh.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj&hM>hj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hM>hjyubj)}(hB``syncobj_xa`` Mapping of sync object handles to object pointers. h](j)}(h``syncobj_xa``h]j)}(hj\h]h syncobj_xa}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMAhjVubj)}(hhh]h)}(h2Mapping of sync object handles to object pointers.h]h2Mapping of sync object handles to object pointers.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhMAhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjqhMAhjyubj)}(h-``filp`` Pointer to the core file structure. h](j)}(h``filp``h]j)}(hjh]hfilp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMDhjubj)}(hhh]h)}(h#Pointer to the core file structure.h]h#Pointer to the core file structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMDhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMDhjyubj)}(h``driver_priv`` Optional pointer for driver private data. Can be allocated in :c:type:`drm_driver.open ` and should be freed in :c:type:`drm_driver.postclose `. h](j)}(h``driver_priv``h]j)}(hj΁h]h driver_priv}(hjЁhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj́ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMIhjȁubj)}(hhh]h)}(hOptional pointer for driver private data. Can be allocated in :c:type:`drm_driver.open ` and should be freed in :c:type:`drm_driver.postclose `.h](h>Optional pointer for driver private data. Can be allocated in }(hjhhhNhNubh)}(h&:c:type:`drm_driver.open `h]j)}(hjh]hdrm_driver.open}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMHhjubh and should be freed in }(hjhhhNhNubh)}(h+:c:type:`drm_driver.postclose `h]j)}(hjh]hdrm_driver.postclose}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhjhMHhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMHhjubah}(h]h ]h"]h$]h&]uh1jhjȁubeh}(h]h ]h"]h$]h&]uh1jhjhMIhjyubj)}(hX2``fbs`` List of :c:type:`struct drm_framebuffer ` associated with this file, using the :c:type:`drm_framebuffer.filp_head ` entry. Protected by **fbs_lock**. Note that the **fbs** list holds a reference on the framebuffer object to prevent it from untimely disappearing. h](j)}(h``fbs``h]j)}(hjNh]hfbs}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMThjHubj)}(hhh](h)}(hList of :c:type:`struct drm_framebuffer ` associated with this file, using the :c:type:`drm_framebuffer.filp_head ` entry.h](hList of }(hjghhhNhNubh)}(h2:c:type:`struct drm_framebuffer `h]j)}(hjqh]hstruct drm_framebuffer}(hjshhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_framebufferuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMPhjgubh& associated with this file, using the }(hjghhhNhNubh)}(h5:c:type:`drm_framebuffer.filp_head `h]j)}(hjh]hdrm_framebuffer.filp_head}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_framebufferuh1hhjhMPhjgubh entry.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMPhjdubh)}(hProtected by **fbs_lock**. Note that the **fbs** list holds a reference on the framebuffer object to prevent it from untimely disappearing.h](h Protected by }(hjhhhNhNubjB)}(h **fbs_lock**h]hfbs_lock}(hjĂhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh. Note that the }(hjhhhNhNubjB)}(h**fbs**h]hfbs}(hjւhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh[ list holds a reference on the framebuffer object to prevent it from untimely disappearing.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMShjdubeh}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchMThjyubj)}(h``fbs_lock`` Protects **fbs**. h](j)}(h ``fbs_lock``h]j)}(hjh]hfbs_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMZhjubj)}(hhh]h)}(hProtects **fbs**.h](h Protects }(hjhhhNhNubjB)}(h**fbs**h]hfbs}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMZhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMZhjyubj)}(h``blobs`` User-created blob properties; this retains a reference on the property. Protected by **drm_mode_config.blob_lock**; h](j)}(h ``blobs``h]j)}(hjLh]hblobs}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMahjFubj)}(hhh](h)}(hGUser-created blob properties; this retains a reference on the property.h]hGUser-created blob properties; this retains a reference on the property.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhM^hjbubh)}(h+Protected by **drm_mode_config.blob_lock**;h](h Protected by }(hjthhhNhNubjB)}(h**drm_mode_config.blob_lock**h]hdrm_mode_config.blob_lock}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjtubh;}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjahMahjbubeh}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahMahjyubj)}(hA``event_wait`` Waitqueue for new events added to **event_list**. h](j)}(h``event_wait``h]j)}(hjh]h event_wait}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMghjubj)}(hhh]h)}(h1Waitqueue for new events added to **event_list**.h](h"Waitqueue for new events added to }(hjhhhNhNubjB)}(h**event_list**h]h event_list}(hjǃhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMghjyubj)}(hXC``pending_event_list`` List of pending :c:type:`struct drm_pending_event `, used to clean up pending events in case this file gets closed before the event is signalled. Uses the :c:type:`drm_pending_event.pending_link ` entry. Protect by :c:type:`drm_device.event_lock `. h](j)}(h``pending_event_list``h]j)}(hjh]hpending_event_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMohjubj)}(hhh](h)}(hList of pending :c:type:`struct drm_pending_event `, used to clean up pending events in case this file gets closed before the event is signalled. Uses the :c:type:`drm_pending_event.pending_link ` entry.h](hList of pending }(hj hhhNhNubh)}(h6:c:type:`struct drm_pending_event `h]j)}(hjh]hstruct drm_pending_event}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_pending_eventuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMkhj ubhh, used to clean up pending events in case this file gets closed before the event is signalled. Uses the }(hj hhhNhNubh)}(h<:c:type:`drm_pending_event.pending_link `h]j)}(hj8h]hdrm_pending_event.pending_link}(hj:hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_pending_eventuh1hhj1hMkhj ubh entry.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj1hMkhjubh)}(h8Protect by :c:type:`drm_device.event_lock `.h](h Protect by }(hj_hhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjih]hdrm_device.event_lock}(hjkhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjhMohj_ubh.}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMohjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohjyubj)}(hX``event_list`` List of :c:type:`struct drm_pending_event `, ready for delivery to userspace through drm_read(). Uses the :c:type:`drm_pending_event.link ` entry. Protect by :c:type:`drm_device.event_lock `. h](j)}(h``event_list``h]j)}(hjh]h event_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMyhjubj)}(hhh](h)}(hList of :c:type:`struct drm_pending_event `, ready for delivery to userspace through drm_read(). Uses the :c:type:`drm_pending_event.link ` entry.h](hList of }(hjhhhNhNubh)}(h6:c:type:`struct drm_pending_event `h]j)}(hjńh]hstruct drm_pending_event}(hjDŽhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjÄubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_pending_eventuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMvhjubh?, ready for delivery to userspace through drm_read(). Uses the }(hjhhhNhNubh)}(h4:c:type:`drm_pending_event.link `h]j)}(hjh]hdrm_pending_event.link}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_pending_eventuh1hhjhMvhjubh entry.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMvhjubh)}(h8Protect by :c:type:`drm_device.event_lock `.h](h Protect by }(hjhhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjh]hdrm_device.event_lock}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjhMyhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMyhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMyhjyubj)}(h``event_space`` Available event space to prevent userspace from exhausting kernel memory. Currently limited to the fairly arbitrary value of 4KB. h](j)}(h``event_space``h]j)}(hjSh]h event_space}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjMubj)}(hhh]h)}(hAvailable event space to prevent userspace from exhausting kernel memory. Currently limited to the fairly arbitrary value of 4KB.h]hAvailable event space to prevent userspace from exhausting kernel memory. Currently limited to the fairly arbitrary value of 4KB.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMhjyubj)}(h+``event_read_lock`` Serializes drm_read(). h](j)}(h``event_read_lock``h]j)}(hjh]hevent_read_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(hSerializes drm_read().h]hSerializes drm_read().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjyubj)}(hH``prime`` Per-file buffer caches used by the PRIME buffer sharing code. h](j)}(h ``prime``h]j)}(hjƅh]hprime}(hjȅhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjąubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(h=Per-file buffer caches used by the PRIME buffer sharing code.h]h=Per-file buffer caches used by the PRIME buffer sharing code.}(hj߅hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjۅhMhj܅ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjۅhMhjyubj)}(hN``client_name`` Userspace-provided name; useful for accounting and debugging. h](j)}(h``client_name``h]j)}(hjh]h client_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(h=Userspace-provided name; useful for accounting and debugging.h]h=Userspace-provided name; useful for accounting and debugging.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjyubj)}(h/``client_name_lock`` Protects **client_name**. h](j)}(h``client_name_lock``h]j)}(hj8h]hclient_name_lock}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj2ubj)}(hhh]h)}(hProtects **client_name**.h](h Protects }(hjQhhhNhNubjB)}(h**client_name**h]h client_name}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjQubh.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjMhMhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjyubj)}(hF``debugfs_client`` debugfs directory for each client under a drm node.h](j)}(h``debugfs_client``h]j)}(hjh]hdebugfs_client}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj}ubj)}(hhh]h)}(h3debugfs directory for each client under a drm node.h]h3debugfs directory for each client under a drm node.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjyubeh}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubh)}(h**Description**h]jB)}(hjƆh]h Description}(hjȆhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjĆubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjrhhubh)}(h9This structure tracks DRM state per open file descriptor.h]h9This structure tracks DRM state per open file descriptor.}(hj܆hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhKhjrhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"drm_is_primary_client (C function)c.drm_is_primary_clienthNtauh1jhjrhhhjCthNubj)}(hhh](j)}(h=bool drm_is_primary_client (const struct drm_file *file_priv)h]j)}(h` of **file_priv** is a primary minor. See also the :ref:`section on primary nodes and authentication `.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]j)}(h.``const struct drm_file *file_priv`` DRM file h](j)}(h$``const struct drm_file *file_priv``h]j)}(hjh]h const struct drm_file *file_priv}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(hDRM fileh]hDRM file}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjZh]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh)}(hReturns true if this is an open file of the primary node, i.e. :c:type:`drm_file.minor ` of **file_priv** is a primary minor.h](h?Returns true if this is an open file of the primary node, i.e. }(hjphhhNhNubh)}(h#:c:type:`drm_file.minor `h]j)}(hjzh]hdrm_file.minor}(hj|hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjpubh of }(hjphhhNhNubjB)}(h **file_priv**h]h file_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjpubh is a primary minor.}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(hSSee also the :ref:`section on primary nodes and authentication `.h](h See also the }(hjhhhNhNubh)}(hE:ref:`section on primary nodes and authentication `h]jf)}(hjh]h+section on primary nodes and authentication}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&]refdocj refdomainjʈreftyperef refexplicitrefwarnj drm_primary_nodeuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj܈hMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_is_render_client (C function)c.drm_is_render_clienthNtauh1jhjrhhhjCthNubj)}(hhh](j)}(h` of **file_priv** is a render minor. See also the :ref:`section on render nodes `.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]j)}(h.``const struct drm_file *file_priv`` DRM file h](j)}(h$``const struct drm_file *file_priv``h]j)}(hj"h]h const struct drm_file *file_priv}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(hDRM fileh]hDRM file}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hMhj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj[ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh)}(hReturns true if this is an open file of the render node, i.e. :c:type:`drm_file.minor ` of **file_priv** is a render minor.h](h>Returns true if this is an open file of the render node, i.e. }(hjshhhNhNubh)}(h#:c:type:`drm_file.minor `h]j)}(hj}h]hdrm_file.minor}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjsubh of }(hjshhhNhNubjB)}(h **file_priv**h]h file_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjsubh is a render minor.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(h>See also the :ref:`section on render nodes `.h](h See also the }(hjhhhNhNubh)}(h0:ref:`section on render nodes `h]jf)}(hjh]hsection on render nodes}(hjÊhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&]refdocj refdomainj͊reftyperef refexplicitrefwarnj drm_render_nodeuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjߊhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_is_accel_client (C function)c.drm_is_accel_clienthNtauh1jhjrhhhjCthNubj)}(hhh](j)}(h;bool drm_is_accel_client (const struct drm_file *file_priv)h]j)}(h:bool drm_is_accel_client(const struct drm_file *file_priv)h](j-)}(hj-h]hbool}(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hdrm_is_accel_clienth]j)}(hdrm_is_accel_clienth]hdrm_is_accel_client}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(h"(const struct drm_file *file_priv)h]j)}(h const struct drm_file *file_privh](j)}(hjZ/h]hconst}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hjh]hstruct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubh)}(hhh]j)}(hdrm_fileh]hdrm_file}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jj,sbc.drm_is_accel_clientasbuh1hhjBubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(h file_privh]h file_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj>ubah}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(h5is this an open file of the compute acceleration nodeh]h5is this an open file of the compute acceleration node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhjCthNubj8)}(hX;**Parameters** ``const struct drm_file *file_priv`` DRM file **Description** Returns true if this is an open file of the compute acceleration node, i.e. :c:type:`drm_file.minor ` of **file_priv** is a accel minor. See also :doc:`Introduction to compute accelerators subsystem `.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]j)}(h.``const struct drm_file *file_priv`` DRM file h](j)}(h$``const struct drm_file *file_priv``h]j)}(hj%h]h const struct drm_file *file_priv}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(hDRM fileh]hDRM file}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hMhj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj^ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh)}(hReturns true if this is an open file of the compute acceleration node, i.e. :c:type:`drm_file.minor ` of **file_priv** is a accel minor.h](hLReturns true if this is an open file of the compute acceleration node, i.e. }(hjvhhhNhNubh)}(h#:c:type:`drm_file.minor `h]j)}(hjh]hdrm_file.minor}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drm_fileuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjvubh of }(hjvhhhNhNubjB)}(h **file_priv**h]h file_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubh is a accel minor.}(hjvhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(hUSee also :doc:`Introduction to compute accelerators subsystem `.h](h See also }(hjhhhNhNubh)}(hK:doc:`Introduction to compute accelerators subsystem `h]jf)}(hjČh]h.Introduction to compute accelerators subsystem}(hjƌhhhNhNubah}(h]h ](jstdstd-doceh"]h$]h&]uh1jehjŒubah}(h]h ]h"]h$]h&]refdocj refdomainjЌreftypedoc refexplicitrefwarnj /accel/introductionuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_memory_stats (C struct)c.drm_memory_statshNtauh1jhjrhhhjCthNubj)}(hhh](j)}(hdrm_memory_statsh]j)}(hstruct drm_memory_statsh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMubj)}(hdrm_memory_statsh]j)}(hjh]hdrm_memory_stats}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj hhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(hGEM object stats associatedh]hGEM object stats associated}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjLhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jstructeh"]h$]h&]j1jj2jgj3jgj4j5j6uh1jhhhjrhjCthNubj8)}(hX**Definition**:: struct drm_memory_stats { u64 shared; u64 private; u64 resident; u64 purgeable; u64 active; }; **Members** ``shared`` Total size of GEM objects shared between processes ``private`` Total size of GEM objects ``resident`` Total size of GEM objects backing pages ``purgeable`` Total size of GEM objects that can be purged (resident and not active) ``active`` Total size of GEM objects active on one or more enginesh](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjoubh:}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjkubj)}(hrstruct drm_memory_stats { u64 shared; u64 private; u64 resident; u64 purgeable; u64 active; };h]hrstruct drm_memory_stats { u64 shared; u64 private; u64 resident; u64 purgeable; u64 active; };}hjsbah}(h]h ]h"]h$]h&]j+j,uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjkubh)}(h **Members**h]jB)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjkubj)}(hhh](j)}(h>``shared`` Total size of GEM objects shared between processes h](j)}(h ``shared``h]j)}(hjh]hshared}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(h2Total size of GEM objects shared between processesh]h2Total size of GEM objects shared between processes}(hjՍhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjэhMhjҍubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjэhMhjubj)}(h&``private`` Total size of GEM objects h](j)}(h ``private``h]j)}(hjh]hprivate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(hTotal size of GEM objectsh]hTotal size of GEM objects}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h5``resident`` Total size of GEM objects backing pages h](j)}(h ``resident``h]j)}(hj.h]hresident}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhj(ubj)}(hhh]h)}(h'Total size of GEM objects backing pagesh]h'Total size of GEM objects backing pages}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChMhjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhjChMhjubj)}(hU``purgeable`` Total size of GEM objects that can be purged (resident and not active) h](j)}(h ``purgeable``h]j)}(hjgh]h purgeable}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjaubj)}(hhh]h)}(hFTotal size of GEM objects that can be purged (resident and not active)h]hFTotal size of GEM objects that can be purged (resident and not active)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hMhj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hMhjubj)}(hB``active`` Total size of GEM objects active on one or more enginesh](j)}(h ``active``h]j)}(hjh]hactive}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubj)}(hhh]h)}(h7Total size of GEM objects active on one or more enginesh]h7Total size of GEM objects active on one or more engines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhjCthNubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjrhhubh)}(h Used by drm_print_memory_stats()h]h Used by drm_print_memory_stats()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:151: ./include/drm/drm_file.hhMhjrhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_open (C function) c.drm_openhNtauh1jhjrhhhNhNubj)}(hhh](j)}(h5int drm_open (struct inode *inode, struct file *filp)h]j)}(h4int drm_open(struct inode *inode, struct file *filp)h](j-)}(hinth]hint}(hj!hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMfubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj/hMfubj)}(hdrm_openh]j)}(hdrm_openh]hdrm_open}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhj/hMfubj)}(h((struct inode *inode, struct file *filp)h](j)}(hstruct inode *inodeh](j)}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]j)}(hinodeh]hinode}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj~modnameN classnameNj j )}j ]j)}jjDsb c.drm_openasbuh1hhjZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjVubj)}(hstruct file *filph](j)}(hjh]hstruct}(hjЏhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̏ubj)}(h h]h }(hjݏhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̏ubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j c.drm_openasbuh1hhj̏ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̏ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̏ubj)}(hfilph]hfilp}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̏ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjVubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhj/hMfubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhj/hMfubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj/hMfhjhhubj)}(hhh]h)}(hopen method for DRM fileh]hopen method for DRM file}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMfhjNhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj/hMfubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jij3jij4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct inode *inode`` device inode ``struct file *filp`` file pointer. **Description** This function must be used by drivers as their :c:type:`file_operations.open ` method. It looks up the correct DRM device and instantiates all the per-file resources for it. It also calls the :c:type:`drm_driver.open ` driver callback. **Return** 0 on success or negative errno value on failure.h](h)}(h**Parameters**h]jB)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjqubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMjhjmubj)}(hhh](j)}(h%``struct inode *inode`` device inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMghjubj)}(hhh]h)}(h device inodeh]h device inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMghjubj)}(h$``struct file *filp`` file pointer. h](j)}(h``struct file *filp``h]j)}(hjːh]hstruct file *filp}(hj͐hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɐubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhhjŐubj)}(hhh]h)}(h file pointer.h]h file pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjŐubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjubeh}(h]h ]h"]h$]h&]uh1jhjmubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMjhjmubh)}(hXThis function must be used by drivers as their :c:type:`file_operations.open ` method. It looks up the correct DRM device and instantiates all the per-file resources for it. It also calls the :c:type:`drm_driver.open ` driver callback.h](h/This function must be used by drivers as their }(hjhhhNhNubh)}(h0:c:type:`file_operations.open `h]j)}(hj&h]hfile_operations.open}(hj(hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMihjubhr method. It looks up the correct DRM device and instantiates all the per-file resources for it. It also calls the }(hjhhhNhNubh)}(h&:c:type:`drm_driver.open `h]j)}(hjJh]hdrm_driver.open}(hjLhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hhjChMihjubh driver callback.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjChMihjmubh)}(h **Return**h]jB)}(hjsh]hReturn}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjqubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMmhjmubh)}(h00 on success or negative errno value on failure.h]h00 on success or negative errno value on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMnhjmubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_release (C function) c.drm_releasehNtauh1jhjrhhhNhNubj)}(hhh](j)}(h8int drm_release (struct inode *inode, struct file *filp)h]j)}(h7int drm_release(struct inode *inode, struct file *filp)h](j-)}(hinth]hint}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjǑhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjƑhMubj)}(h drm_releaseh]j)}(h drm_releaseh]h drm_release}(hjّhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjՑubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjƑhMubj)}(h((struct inode *inode, struct file *filp)h](j)}(hstruct inode *inodeh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjۑsb c.drm_releaseasbuh1hhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hinodeh]hinode}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct file *filph](j)}(hjh]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j/ c.drm_releaseasbuh1hhjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hfilph]hfilp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjƑhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjƑhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjƑhMhjhhubj)}(hhh]h)}(hrelease method for DRM fileh]hrelease method for DRM file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjƑhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct inode *inode`` device inode ``struct file *filp`` file pointer. **Description** This function must be used by drivers as their :c:type:`file_operations.release ` method. It frees any resources associated with the open file. If this is the last open file for the DRM device, it also restores the active in-kernel DRM client. **Return** Always succeeds and returns 0.h](h)}(h**Parameters**h]jB)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(h%``struct inode *inode`` device inode h](j)}(h``struct inode *inode``h]j)}(hj)h]hstruct inode *inode}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj#ubj)}(hhh]h)}(h device inodeh]h device inode}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhj ubj)}(h$``struct file *filp`` file pointer. h](j)}(h``struct file *filp``h]j)}(hjbh]hstruct file *filp}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj\ubj)}(hhh]h)}(h file pointer.h]h file pointer.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjwhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hXThis function must be used by drivers as their :c:type:`file_operations.release ` method. It frees any resources associated with the open file. If this is the last open file for the DRM device, it also restores the active in-kernel DRM client.h](h/This function must be used by drivers as their }(hjhhhNhNubh)}(h3:c:type:`file_operations.release `h]j)}(hjh]hfile_operations.release}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh method. It frees any resources associated with the open file. If this is the last open file for the DRM device, it also restores the active in-kernel DRM client.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjړhMhjubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hAlways succeeds and returns 0.h]hAlways succeeds and returns 0.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_release_noglobal (C function)c.drm_release_noglobalhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hAint drm_release_noglobal (struct inode *inode, struct file *filp)h]j)}(h@int drm_release_noglobal(struct inode *inode, struct file *filp)h](j-)}(hinth]hint}(hj,hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj(hhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhj:hMubj)}(hdrm_release_noglobalh]j)}(hdrm_release_noglobalh]hdrm_release_noglobal}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj(hhhj:hMubj)}(h((struct inode *inode, struct file *filp)h](j)}(hstruct inode *inodeh](j)}(hjh]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]j)}(hinodeh]hinode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjOsbc.drm_release_noglobalasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(hinodeh]hinode}(hj”hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjaubj)}(hstruct file *filph](j)}(hjh]hstruct}(hj۔hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjהubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjהubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_release_noglobalasbuh1hhjהubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjהubj)}(hjh]h*}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjהubj)}(hfilph]hfilp}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjהubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjaubeh}(h]h ]h"]h$]h&]j+j,uh1jhj(hhhj:hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj$hhhj:hMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj:hMhj!hhubj)}(hhh]h)}(hrelease method for DRM fileh]hrelease method for DRM file}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjYhhubah}(h]h ]h"]h$]h&]uh1jhj!hhhj:hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jtj3jtj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct inode *inode`` device inode ``struct file *filp`` file pointer. **Description** This function may be used by drivers as their :c:type:`file_operations.release ` method. It frees any resources associated with the open file prior to taking the drm_global_mutex. If this is the last open file for the DRM device, it then restores the active in-kernel DRM client. **Return** Always succeeds and returns 0.h](h)}(h**Parameters**h]jB)}(hj~h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj|ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjxubj)}(hhh](j)}(h%``struct inode *inode`` device inode h](j)}(h``struct inode *inode``h]j)}(hjh]hstruct inode *inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h device inodeh]h device inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h$``struct file *filp`` file pointer. h](j)}(h``struct file *filp``h]j)}(hj֕h]hstruct file *filp}(hjؕhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjԕubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjЕubj)}(hhh]h)}(h file pointer.h]h file pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjЕubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjxubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjxubh)}(hX(This function may be used by drivers as their :c:type:`file_operations.release ` method. It frees any resources associated with the open file prior to taking the drm_global_mutex. If this is the last open file for the DRM device, it then restores the active in-kernel DRM client.h](h.This function may be used by drivers as their }(hj'hhhNhNubh)}(h3:c:type:`file_operations.release `h]j)}(hj1h]hfile_operations.release}(hj3hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj'ubh method. It frees any resources associated with the open file prior to taking the drm_global_mutex. If this is the last open file for the DRM device, it then restores the active in-kernel DRM client.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjNhMhjxubh)}(h **Return**h]jB)}(hj[h]hReturn}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjYubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjxubh)}(hAlways succeeds and returns 0.h]hAlways succeeds and returns 0.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjxubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_read (C function) c.drm_readhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hWssize_t drm_read (struct file *filp, char __user *buffer, size_t count, loff_t *offset)h]j)}(hVssize_t drm_read(struct file *filp, char __user *buffer, size_t count, loff_t *offset)h](h)}(hhh]j)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jdrm_readsb c.drm_readasbuh1hhjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjŖhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjĖhMubj)}(hdrm_readh]j)}(hjh]hdrm_read}(hjזhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjӖubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjĖhMubj)}(hF(struct file *filp, char __user *buffer, size_t count, loff_t *offset)h](j)}(hstruct file *filph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j c.drm_readasbuh1hhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfilph]hfilp}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hchar __user *bufferh](j-)}(hcharh]hchar}(hjbhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj^ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubh__user}(hj^hhhNhNubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hbufferh]hbuffer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h size_t counth](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j c.drm_readasbuh1hhjubj)}(h h]h }(hjחhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounth]hcount}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hloff_t *offseth](h)}(hhh]j)}(hloff_th]hloff_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j c.drm_readasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hoffseth]hoffset}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjĖhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjĖhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjĖhMhjhhubj)}(hhh]h)}(hread method for DRM fileh]hread method for DRM file}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjahhubah}(h]h ]h"]h$]h&]uh1jhjhhhjĖhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j|j3j|j4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct file *filp`` file pointer ``char __user *buffer`` userspace destination pointer for the read ``size_t count`` count in bytes to read ``loff_t *offset`` offset to read **Description** This function must be used by drivers as their :c:type:`file_operations.read ` method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it. **offset** is ignored, DRM events are read like a pipe. Polling support is provided by drm_poll(). This function will only ever read a full event. Therefore userspace must supply a big enough buffer to fit any event to ensure forward progress. Since the maximum event space is currently 4K it's recommended to just use that for safety. **Return** Number of bytes read (always aligned to full events, and can be 0) or a negative error code on failure.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjubj)}(hhh](j)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hjh]hstruct file *filp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h file pointerh]h file pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hC``char __user *buffer`` userspace destination pointer for the read h](j)}(h``char __user *buffer``h]j)}(hjޘh]hchar __user *buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܘubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjؘubj)}(hhh]h)}(h*userspace destination pointer for the readh]h*userspace destination pointer for the read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjؘubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h(``size_t count`` count in bytes to read h](j)}(h``size_t count``h]j)}(hjh]h size_t count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(hcount in bytes to readh]hcount in bytes to read}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhjubj)}(h"``loff_t *offset`` offset to read h](j)}(h``loff_t *offset``h]j)}(hjPh]hloff_t *offset}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjJubj)}(hhh]h)}(hoffset to readh]hoffset to read}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehM hjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjubh)}(hX#This function must be used by drivers as their :c:type:`file_operations.read ` method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it.h](h/This function must be used by drivers as their }(hjhhhNhNubh)}(h0:c:type:`file_operations.read `h]j)}(hjh]hfile_operations.read}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjubh method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjșhM hjubh)}(hb**offset** is ignored, DRM events are read like a pipe. Polling support is provided by drm_poll().h](jB)}(h **offset**h]hoffset}(hjיhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjәubhX is ignored, DRM events are read like a pipe. Polling support is provided by drm_poll().}(hjәhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hThis function will only ever read a full event. Therefore userspace must supply a big enough buffer to fit any event to ensure forward progress. Since the maximum event space is currently 4K it's recommended to just use that for safety.h]hThis function will only ever read a full event. Therefore userspace must supply a big enough buffer to fit any event to ensure forward progress. Since the maximum event space is currently 4K it’s recommended to just use that for safety.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hgNumber of bytes read (always aligned to full events, and can be 0) or a negative error code on failure.h]hgNumber of bytes read (always aligned to full events, and can be 0) or a negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_poll (C function) c.drm_pollhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hE__poll_t drm_poll (struct file *filp, struct poll_table_struct *wait)h]j)}(hD__poll_t drm_poll(struct file *filp, struct poll_table_struct *wait)h](h)}(hhh]j)}(h__poll_th]h__poll_t}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNj j )}j ]j)}jdrm_pollsb c.drm_pollasbuh1hhjBhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMbubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBhhhjjhMbubj)}(hdrm_pollh]j)}(hjgh]hdrm_poll}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjBhhhjjhMbubj)}(h3(struct file *filp, struct poll_table_struct *wait)h](j)}(hstruct file *filph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]je c.drm_pollasbuh1hhjubj)}(h h]h }(hjԚhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfilph]hfilp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct poll_table_struct *waith](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpoll_table_structh]hpoll_table_struct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj(modnameN classnameNj j )}j ]je c.drm_pollasbuh1hhjubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hwaith]hwait}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjBhhhjjhMbubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj>hhhjjhMbubah}(h]j9ah ](jj eh"]h$]h&]j j)jhuh1jhjjhMbhj;hhubj)}(hhh]h)}(hpoll method for DRM fileh]hpoll method for DRM file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMbhjhhubah}(h]h ]h"]h$]h&]uh1jhj;hhhjjhMbubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct file *filp`` file pointer ``struct poll_table_struct *wait`` poll waiter table **Description** This function must be used by drivers as their :c:type:`file_operations.read ` method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it. See also drm_read(). **Return** Mask of POLL flags indicating the current status of the file.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMfhjubj)}(hhh](j)}(h#``struct file *filp`` file pointer h](j)}(h``struct file *filp``h]j)}(hjʛh]hstruct file *filp}(hj̛hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjțubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMchjěubj)}(hhh]h)}(h file pointerh]h file pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjߛhMchjubah}(h]h ]h"]h$]h&]uh1jhjěubeh}(h]h ]h"]h$]h&]uh1jhjߛhMchjubj)}(h5``struct poll_table_struct *wait`` poll waiter table h](j)}(h"``struct poll_table_struct *wait``h]j)}(hjh]hstruct poll_table_struct *wait}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMdhjubj)}(hhh]h)}(hpoll waiter tableh]hpoll waiter table}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj<ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMfhjubh)}(hX$This function must be used by drivers as their :c:type:`file_operations.read ` method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it.h](h/This function must be used by drivers as their }(hjThhhNhNubh)}(h0:c:type:`file_operations.read `h]j)}(hj^h]hfile_operations.read}(hj`hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j file_operationsuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMehjTubh method if they use DRM events for asynchronous signalling to userspace. Since events are used by the KMS API for vblank and page flip completion this means all modern display drivers must use it.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj{hMehjubh)}(hSee also drm_read().h]hSee also drm_read().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMjhjubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMlhjubh)}(h=Mask of POLL flags indicating the current status of the file.h]h=Mask of POLL flags indicating the current status of the file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMmhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j*drm_event_reserve_init_locked (C function)c.drm_event_reserve_init_lockedhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hint drm_event_reserve_init_locked (struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h]j)}(hint drm_event_reserve_init_locked(struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h](j-)}(hinth]hint}(hjܜhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj؜hhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj؜hhhjhMubj)}(hdrm_event_reserve_init_lockedh]j)}(hdrm_event_reserve_init_lockedh]hdrm_event_reserve_init_locked}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj؜hhhjhMubj)}(hf(struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj9modnameN classnameNj j )}j ]j)}jjsbc.drm_event_reserve_init_lockedasbuh1hhjubj)}(h h]h }(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdevh]hdev}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_file *file_privh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_fileh]hdrm_file}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jSc.drm_event_reserve_init_lockedasbuh1hhjubj)}(h h]h }(hjǝhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj՝hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h file_privh]h file_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_pending_event *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jSc.drm_event_reserve_init_lockedasbuh1hhjubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_event *eh](j)}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubh)}(hhh]j)}(h drm_eventh]h drm_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jSc.drm_event_reserve_init_lockedasbuh1hhjfubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(heh]he}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhj؜hhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjԜhhhjhMubah}(h]jϜah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjќhhubj)}(hhh]h)}(h)init a DRM event and reserve space for ith]h)init a DRM event and reserve space for it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjќhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_file *file_priv`` DRM file private data ``struct drm_pending_event *p`` tracking structure for the pending event ``struct drm_event *e`` actual event data to deliver to userspace **Description** This function prepares the passed in event for eventual delivery. If the event doesn't get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace. If callers embedded **p** into a larger structure it must be allocated with kmalloc and **p** must be the first member element. This is the locked version of drm_event_reserve_init() for callers which already hold :c:type:`drm_device.event_lock `. **Return** 0 on success or a negative error code on failure.h](h)}(h**Parameters**h]jB)}(hj h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj,h]hstruct drm_device *dev}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj&ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMhjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhMhj#ubj)}(h5``struct drm_file *file_priv`` DRM file private data h](j)}(h``struct drm_file *file_priv``h]j)}(hjeh]hstruct drm_file *file_priv}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj_ubj)}(hhh]h)}(hDRM file private datah]hDRM file private data}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhMhj#ubj)}(hI``struct drm_pending_event *p`` tracking structure for the pending event h](j)}(h``struct drm_pending_event *p``h]j)}(hjh]hstruct drm_pending_event *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h(tracking structure for the pending eventh]h(tracking structure for the pending event}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj#ubj)}(hB``struct drm_event *e`` actual event data to deliver to userspace h](j)}(h``struct drm_event *e``h]j)}(hjןh]hstruct drm_event *e}(hjٟhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj՟ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjџubj)}(hhh]h)}(h)actual event data to deliver to userspaceh]h)actual event data to deliver to userspace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjџubeh}(h]h ]h"]h$]h&]uh1jhjhMhj#ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hXThis function prepares the passed in event for eventual delivery. If the event doesn't get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace.h]hXThis function prepares the passed in event for eventual delivery. If the event doesn’t get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hIf callers embedded **p** into a larger structure it must be allocated with kmalloc and **p** must be the first member element.h](hIf callers embedded }(hj7hhhNhNubjB)}(h**p**h]hp}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj7ubh? into a larger structure it must be allocated with kmalloc and }(hj7hhhNhNubjB)}(h**p**h]hp}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj7ubh" must be the first member element.}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hThis is the locked version of drm_event_reserve_init() for callers which already hold :c:type:`drm_device.event_lock `.h](hVThis is the locked version of drm_event_reserve_init() for callers which already hold }(hjjhhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjth]hdrm_device.event_lock}(hjvhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjjubh.}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#drm_event_reserve_init (C function)c.drm_event_reserve_inithNtauh1jhjrhhhNhNubj)}(hhh](j)}(hint drm_event_reserve_init (struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h]j)}(hint drm_event_reserve_init(struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h](j-)}(hinth]hint}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjߠhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߠhhhjhMubj)}(hdrm_event_reserve_inith]j)}(hdrm_event_reserve_inith]hdrm_event_reserve_init}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjߠhhhjhMubj)}(hf(struct drm_device *dev, struct drm_file *file_priv, struct drm_pending_event *p, struct drm_event *e)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj@modnameN classnameNj j )}j ]j)}jjsbc.drm_event_reserve_initasbuh1hhjubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdevh]hdev}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_file *file_privh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_fileh]hdrm_file}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jZc.drm_event_reserve_initasbuh1hhjubj)}(h h]h }(hjΡhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjܡhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h file_privh]h file_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_pending_event *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hj hhhNhNuba)h}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj"modnameN classnameNj j )}j ]jZc.drm_event_reserve_initasbuh1hhjubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_event *eh](j)}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubh)}(hhh]j)}(h drm_eventh]h drm_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jZc.drm_event_reserve_initasbuh1hhjmubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjÞh]he}(hjȢhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjߠhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj۠hhhjhMubah}(h]j֠ah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjؠhhubj)}(hhh]h)}(h)init a DRM event and reserve space for ith]h)init a DRM event and reserve space for it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjؠhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j j3j j4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_file *file_priv`` DRM file private data ``struct drm_pending_event *p`` tracking structure for the pending event ``struct drm_event *e`` actual event data to deliver to userspace **Description** This function prepares the passed in event for eventual delivery. If the event doesn't get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace. If callers embedded **p** into a larger structure it must be allocated with kmalloc and **p** must be the first member element. Callers which already hold :c:type:`drm_device.event_lock ` should use drm_event_reserve_init_locked() instead. **Return** 0 on success or a negative error code on failure.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hj2h]hstruct drm_device *dev}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj,ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhMhj)ubj)}(h5``struct drm_file *file_priv`` DRM file private data h](j)}(h``struct drm_file *file_priv``h]j)}(hjkh]hstruct drm_file *file_priv}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjeubj)}(hhh]h)}(hDRM file private datah]hDRM file private data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jhjhMhj)ubj)}(hI``struct drm_pending_event *p`` tracking structure for the pending event h](j)}(h``struct drm_pending_event *p``h]j)}(hjh]hstruct drm_pending_event *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h(tracking structure for the pending eventh]h(tracking structure for the pending event}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj)ubj)}(hB``struct drm_event *e`` actual event data to deliver to userspace h](j)}(h``struct drm_event *e``h]j)}(hjݣh]hstruct drm_event *e}(hjߣhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjۣubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjףubj)}(hhh]h)}(h)actual event data to deliver to userspaceh]h)actual event data to deliver to userspace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjףubeh}(h]h ]h"]h$]h&]uh1jhjhMhj)ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubh)}(hXThis function prepares the passed in event for eventual delivery. If the event doesn't get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace.h]hXThis function prepares the passed in event for eventual delivery. If the event doesn’t get delivered (because the IOCTL fails later on, before queuing up anything) then the even must be cancelled and freed using drm_event_cancel_free(). Successfully initialized events should be sent out using drm_send_event() or drm_send_event_locked() to signal completion of the asynchronous event to userspace.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubh)}(hIf callers embedded **p** into a larger structure it must be allocated with kmalloc and **p** must be the first member element.h](hIf callers embedded }(hj=hhhNhNubjB)}(h**p**h]hp}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj=ubh? into a larger structure it must be allocated with kmalloc and }(hj=hhhNhNubjB)}(h**p**h]hp}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj=ubh" must be the first member element.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubh)}(h{Callers which already hold :c:type:`drm_device.event_lock ` should use drm_event_reserve_init_locked() instead.h](hCallers which already hold }(hjphhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjzh]hdrm_device.event_lock}(hj|hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjpubh4 should use drm_event_reserve_init_locked() instead.}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj ubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubh)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"drm_event_cancel_free (C function)c.drm_event_cancel_freehNtauh1jhjrhhhNhNubj)}(hhh](j)}(hPvoid drm_event_cancel_free (struct drm_device *dev, struct drm_pending_event *p)h]j)}(hOvoid drm_event_cancel_free(struct drm_device *dev, struct drm_pending_event *p)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hdrm_event_cancel_freeh]j)}(hdrm_event_cancel_freeh]hdrm_event_cancel_free}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(h5(struct drm_device *dev, struct drm_pending_event *p)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFmodnameN classnameNj j )}j ]j)}jj sbc.drm_event_cancel_freeasbuh1hhj"ubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hjh]h*}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_pending_event *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j`c.drm_event_cancel_freeasbuh1hhjubj)}(h h]h }(hjԥhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jܤah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjޤhhubj)}(hhh]h)}(h&free a DRM event and release its spaceh]h&free a DRM event and release its space}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjޤhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j0j3j0j4j5j6uh1jhhhjrhNhNubj8)}(hXs**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_pending_event *p`` tracking structure for the pending event **Description** This function frees the event **p** initialized with drm_event_reserve_init() and releases any allocated space. It is used to cancel an event when the nonblocking operation could not be submitted and needed to be aborted.h](h)}(h**Parameters**h]jB)}(hj:h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj8ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj4ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjYh]hstruct drm_device *dev}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjSubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjPubj)}(hI``struct drm_pending_event *p`` tracking structure for the pending event h](j)}(h``struct drm_pending_event *p``h]j)}(hjh]hstruct drm_pending_event *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h(tracking structure for the pending eventh]h(tracking structure for the pending event}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjPubeh}(h]h ]h"]h$]h&]uh1jhj4ubh)}(h**Description**h]jB)}(hjͦh]h Description}(hjϦhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj˦ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj4ubh)}(hThis function frees the event **p** initialized with drm_event_reserve_init() and releases any allocated space. It is used to cancel an event when the nonblocking operation could not be submitted and needed to be aborted.h](hThis function frees the event }(hjhhhNhNubjB)}(h**p**h]hp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh initialized with drm_event_reserve_init() and releases any allocated space. It is used to cancel an event when the nonblocking operation could not be submitted and needed to be aborted.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j,drm_send_event_timestamp_locked (C function)!c.drm_send_event_timestamp_lockedhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hmvoid drm_send_event_timestamp_locked (struct drm_device *dev, struct drm_pending_event *e, ktime_t timestamp)h]j)}(hlvoid drm_send_event_timestamp_locked(struct drm_device *dev, struct drm_pending_event *e, ktime_t timestamp)h](j-)}(hvoidh]hvoid}(hj$hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj hhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj2hM ubj)}(hdrm_send_event_timestamp_lockedh]j)}(hdrm_send_event_timestamp_lockedh]hdrm_send_event_timestamp_locked}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj hhhj2hM ubj)}(hH(struct drm_device *dev, struct drm_pending_event *e, ktime_t timestamp)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjGsb!c.drm_send_event_timestamp_lockedasbuh1hhj]ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubj)}(hstruct drm_pending_event *eh](j)}(hjh]hstruct}(hjӧhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϧubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϧubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j!c.drm_send_event_timestamp_lockedasbuh1hhjϧubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϧubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϧubj)}(hjÞh]he}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjϧubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubj)}(hktime_t timestamph](h)}(hhh]j)}(hktime_th]hktime_t}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjGmodnameN classnameNj j )}j ]j!c.drm_send_event_timestamp_lockedasbuh1hhj>ubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h timestamph]h timestamp}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjYubeh}(h]h ]h"]h$]h&]j+j,uh1jhj hhhj2hM ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhj2hM ubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj2hM hjhhubj)}(hhh]h)}(h!send DRM event to file descriptorh]h!send DRM event to file descriptor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj2hM ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_pending_event *e`` DRM event to deliver ``ktime_t timestamp`` timestamp to set for the fence event in kernel's CLOCK_MONOTONIC time domain **Description** This function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold :c:type:`drm_device.event_lock `. Note that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjܨh]hstruct drm_device *dev}(hjިhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjڨubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hj֨ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj֨ubeh}(h]h ]h"]h$]h&]uh1jhjhM hjӨubj)}(h5``struct drm_pending_event *e`` DRM event to deliver h](j)}(h``struct drm_pending_event *e``h]j)}(hjh]hstruct drm_pending_event *e}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjubj)}(hhh]h)}(hDRM event to deliverh]hDRM event to deliver}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hM hj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hM hjӨubj)}(hc``ktime_t timestamp`` timestamp to set for the fence event in kernel's CLOCK_MONOTONIC time domain h](j)}(h``ktime_t timestamp``h]j)}(hjNh]hktime_t timestamp}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjHubj)}(hhh]h)}(hLtimestamp to set for the fence event in kernel's CLOCK_MONOTONIC time domainh]hNtimestamp to set for the fence event in kernel’s CLOCK_MONOTONIC time domain}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM hjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchMhjӨubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hThis function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold :c:type:`drm_device.event_lock `.h](hThis function sends the event }(hjhhhNhNubjB)}(h**e**h]he}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubhm, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold }(hjhhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjh]hdrm_device.event_lock}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj٩hMhjubh)}(hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h]hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"drm_send_event_locked (C function)c.drm_send_event_lockedhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hPvoid drm_send_event_locked (struct drm_device *dev, struct drm_pending_event *e)h]j)}(hOvoid drm_send_event_locked(struct drm_device *dev, struct drm_pending_event *e)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM!ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj!hM!ubj)}(hdrm_send_event_lockedh]j)}(hdrm_send_event_lockedh]hdrm_send_event_locked}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhj!hM!ubj)}(h5(struct drm_device *dev, struct drm_pending_event *e)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjpmodnameN classnameNj j )}j ]j)}jj6sbc.drm_send_event_lockedasbuh1hhjLubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjHubj)}(hstruct drm_pending_event *eh](j)}(hjh]hstruct}(hjªhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjϪhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݪubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_send_event_lockedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjÞh]he}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjHubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhj!hM!ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj hhhj!hM!ubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj!hM!hjhhubj)}(hhh]h)}(h!send DRM event to file descriptorh]h!send DRM event to file descriptor}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM!hj?hhubah}(h]h ]h"]h$]h&]uh1jhjhhhj!hM!ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jZj3jZj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_pending_event *e`` DRM event to deliver **Description** This function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold :c:type:`drm_device.event_lock `, see drm_send_event() for the unlocked version. Note that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h](h)}(h**Parameters**h]jB)}(hjdh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM%hj^ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjh]hstruct drm_device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM"hj}ubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM"hjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjhM"hjzubj)}(h5``struct drm_pending_event *e`` DRM event to deliver h](j)}(h``struct drm_pending_event *e``h]j)}(hjh]hstruct drm_pending_event *e}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM#hjubj)}(hhh]h)}(hDRM event to deliverh]hDRM event to deliver}(hjիhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjѫhM#hjҫubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjѫhM#hjzubeh}(h]h ]h"]h$]h&]uh1jhj^ubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM%hj^ubh)}(hThis function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold :c:type:`drm_device.event_lock `, see drm_send_event() for the unlocked version.h](hThis function sends the event }(hj hhhNhNubjB)}(h**e**h]he}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubhm, initialized with drm_event_reserve_init(), to its associated userspace DRM file. Callers must already hold }(hj hhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hj)h]hdrm_device.event_lock}(hj+hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM$hj ubh0, see drm_send_event() for the unlocked version.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjFhM$hj^ubh)}(hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h]hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM(hj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_send_event (C function)c.drm_send_eventhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hIvoid drm_send_event (struct drm_device *dev, struct drm_pending_event *e)h]j)}(hHvoid drm_send_event(struct drm_device *dev, struct drm_pending_event *e)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj|hhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|hhhjhM5ubj)}(hdrm_send_eventh]j)}(hdrm_send_eventh]hdrm_send_event}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj|hhhjhM5ubj)}(h5(struct drm_device *dev, struct drm_pending_event *e)h](j)}(hstruct drm_device *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjʬhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hj۬hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjجubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjݬmodnameN classnameNj j )}j ]j)}jjsbc.drm_send_eventasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct drm_pending_event *eh](j)}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubh)}(hhh]j)}(hdrm_pending_eventh]hdrm_pending_event}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjOmodnameN classnameNj j )}j ]jc.drm_send_eventasbuh1hhj+ubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjh]h*}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(hjÞh]he}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhj|hhhjhM5ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjxhhhjhM5ubah}(h]jsah ](jj eh"]h$]h&]j j)jhuh1jhjhM5hjuhhubj)}(hhh]h)}(h!send DRM event to file descriptorh]h!send DRM event to file descriptor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM5hjhhubah}(h]h ]h"]h$]h&]uh1jhjuhhhjhM5ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jǭj3jǭj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_device *dev`` DRM device ``struct drm_pending_event *e`` DRM event to deliver **Description** This function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. This function acquires :c:type:`drm_device.event_lock `, see drm_send_event_locked() for callers which already hold this lock. Note that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h](h)}(h**Parameters**h]jB)}(hjѭh]h Parameters}(hjӭhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjϭubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM9hj˭ubj)}(hhh](j)}(h&``struct drm_device *dev`` DRM device h](j)}(h``struct drm_device *dev``h]j)}(hjh]hstruct drm_device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM6hjubj)}(hhh]h)}(h DRM deviceh]h DRM device}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hjubj)}(h5``struct drm_pending_event *e`` DRM event to deliver h](j)}(h``struct drm_pending_event *e``h]j)}(hj)h]hstruct drm_pending_event *e}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM7hj#ubj)}(hhh]h)}(hDRM event to deliverh]hDRM event to deliver}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hM7hj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj>hM7hjubeh}(h]h ]h"]h$]h&]uh1jhj˭ubh)}(h**Description**h]jB)}(hjdh]h Description}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjbubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM9hj˭ubh)}(hXThis function sends the event **e**, initialized with drm_event_reserve_init(), to its associated userspace DRM file. This function acquires :c:type:`drm_device.event_lock `, see drm_send_event_locked() for callers which already hold this lock.h](hThis function sends the event }(hjzhhhNhNubjB)}(h**e**h]he}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjzubhj, initialized with drm_event_reserve_init(), to its associated userspace DRM file. This function acquires }(hjzhhhNhNubh)}(h,:c:type:`drm_device.event_lock `h]j)}(hjh]hdrm_device.event_lock}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM8hjzubhG, see drm_send_event_locked() for callers which already hold this lock.}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM8hj˭ubh)}(hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.h]hXNote that the core will take care of unlinking and disarming events when the corresponding DRM file is closed. Drivers need not worry about whether the DRM file for this event still exists and can call this function upon completion of the asynchronous work unconditionally.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chM=hj˭ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#drm_print_memory_stats (C function)c.drm_print_memory_statshNtauh1jhjrhhhNhNubj)}(hhh](j)}(hvoid drm_print_memory_stats (struct drm_printer *p, const struct drm_memory_stats *stats, enum drm_gem_object_status supported_status, const char *region)h]j)}(hvoid drm_print_memory_stats(struct drm_printer *p, const struct drm_memory_stats *stats, enum drm_gem_object_status supported_status, const char *region)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMlubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMlubj)}(hdrm_print_memory_statsh]j)}(hdrm_print_memory_statsh]hdrm_print_memory_stats}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMlubj)}(h~(struct drm_printer *p, const struct drm_memory_stats *stats, enum drm_gem_object_status supported_status, const char *region)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJmodnameN classnameNj j )}j ]j)}jjsbc.drm_print_memory_statsasbuh1hhj&ubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hjh]h*}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj"ubj)}(h$const struct drm_memory_stats *statsh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjïhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_memory_statsh]hdrm_memory_stats}(hjԯhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjѯubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj֯modnameN classnameNj j )}j ]jdc.drm_print_memory_statsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstatsh]hstats}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj"ubj)}(h+enum drm_gem_object_status supported_statush](j)}(hj) h]henum}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hdrm_gem_object_statush]hdrm_gem_object_status}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjFmodnameN classnameNj j )}j ]jdc.drm_print_memory_statsasbuh1hhj"ubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hsupported_statush]hsupported_status}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj"ubj)}(hconst char *regionh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hregionh]hregion}(hjͰhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj"ubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMlubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMlubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMlhjhhubj)}(hhh]h)}(hA helper to print memory statsh]hA helper to print memory stats}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMlhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMlubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX**Parameters** ``struct drm_printer *p`` The printer to print output to ``const struct drm_memory_stats *stats`` The collected memory stats ``enum drm_gem_object_status supported_status`` Bitmask of optional stats which are available ``const char *region`` The memory regionh](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMphjubj)}(hhh](j)}(h9``struct drm_printer *p`` The printer to print output to h](j)}(h``struct drm_printer *p``h]j)}(hj8h]hstruct drm_printer *p}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMmhj2ubj)}(hhh]h)}(hThe printer to print output toh]hThe printer to print output to}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMmhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMmhj/ubj)}(hD``const struct drm_memory_stats *stats`` The collected memory stats h](j)}(h(``const struct drm_memory_stats *stats``h]j)}(hjqh]h$const struct drm_memory_stats *stats}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMnhjkubj)}(hhh]h)}(hThe collected memory statsh]hThe collected memory stats}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMnhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhMnhj/ubj)}(h^``enum drm_gem_object_status supported_status`` Bitmask of optional stats which are available h](j)}(h/``enum drm_gem_object_status supported_status``h]j)}(hjh]h+enum drm_gem_object_status supported_status}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMohjubj)}(hhh]h)}(h-Bitmask of optional stats which are availableh]h-Bitmask of optional stats which are available}(hjñhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMohjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohj/ubj)}(h(``const char *region`` The memory regionh](j)}(h``const char *region``h]j)}(hjh]hconst char *region}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMqhjݱubj)}(hhh]h)}(hThe memory regionh]hThe memory region}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMphjubah}(h]h ]h"]h$]h&]uh1jhjݱubeh}(h]h ]h"]h$]h&]uh1jhjhMqhj/ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"drm_show_memory_stats (C function)c.drm_show_memory_statshNtauh1jhjrhhhNhNubj)}(hhh](j)}(hIvoid drm_show_memory_stats (struct drm_printer *p, struct drm_file *file)h]j)}(hHvoid drm_show_memory_stats(struct drm_printer *p, struct drm_file *file)h](j-)}(hvoidh]hvoid}(hj=hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj9hhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhjKhMubj)}(hdrm_show_memory_statsh]j)}(hdrm_show_memory_statsh]hdrm_show_memory_stats}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj9hhhjKhMubj)}(h.(struct drm_printer *p, struct drm_file *file)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jj`sbc.drm_show_memory_statsasbuh1hhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hjh]h*}(hjƲhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(hjh]hp}(hjӲhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjrubj)}(hstruct drm_file *fileh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_fileh]hdrm_file}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNj j )}j ]jc.drm_show_memory_statsasbuh1hhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfileh]hfile}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjrubeh}(h]h ]h"]h$]h&]j+j,uh1jhj9hhhjKhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj5hhhjKhMubah}(h]j0ah ](jj eh"]h$]h&]j j)jhuh1jhjKhMhj2hhubj)}(hhh]h)}(h7Helper to collect and show standard fdinfo memory statsh]h7Helper to collect and show standard fdinfo memory stats}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjihhubah}(h]h ]h"]h$]h&]uh1jhj2hhhjKhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(h**Parameters** ``struct drm_printer *p`` the printer to print output to ``struct drm_file *file`` the DRM file **Description** Helper to iterate over GEM objects with a handle allocated in the specified file.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(h9``struct drm_printer *p`` the printer to print output to h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(hthe printer to print output toh]hthe printer to print output to}(hjƳhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj³hMhjóubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj³hMhjubj)}(h'``struct drm_file *file`` the DRM file h](j)}(h``struct drm_file *file``h]j)}(hjh]hstruct drm_file *file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh]h)}(h the DRM fileh]h the DRM file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hj!h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hQHelper to iterate over GEM objects with a handle allocated in the specified file.h]hQHelper to iterate over GEM objects with a handle allocated in the specified file.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_show_fdinfo (C function)c.drm_show_fdinfohNtauh1jhjrhhhNhNubj)}(hhh](j)}(h9void drm_show_fdinfo (struct seq_file *m, struct file *f)h]j)}(h8void drm_show_fdinfo(struct seq_file *m, struct file *f)h](j-)}(hvoidh]hvoid}(hjfhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjbhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbhhhjthMubj)}(hdrm_show_fdinfoh]j)}(hdrm_show_fdinfoh]hdrm_show_fdinfo}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjbhhhjthMubj)}(h$(struct seq_file *m, struct file *f)h](j)}(hstruct seq_file *mh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hseq_fileh]hseq_file}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjômodnameN classnameNj j )}j ]j)}jjsbc.drm_show_fdinfoasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hmh]hm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct file *fh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hfileh]hfile}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNj j )}j ]jݴc.drm_show_fdinfoasbuh1hhjubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfh]hf}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjbhhhjthMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj^hhhjthMubah}(h]jYah ](jj eh"]h$]h&]j j)jhuh1jhjthMhj[hhubj)}(hhh]h)}(hhelper for drm file fopsh]hhelper for drm file fops}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhj[hhhjthMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hXf**Parameters** ``struct seq_file *m`` output stream ``struct file *f`` the device file instance **Description** Helper to implement fdinfo, for userspace to query usage stats, etc, of a process using the GPU. See also :c:type:`drm_driver.show_fdinfo `. For text output format description please see Documentation/gpu/drm-usage-stats.rsth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(h%``struct seq_file *m`` output stream h](j)}(h``struct seq_file *m``h]j)}(hj׵h]hstruct seq_file *m}(hjٵhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjյubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjѵubj)}(hhh]h)}(h output streamh]h output stream}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjѵubeh}(h]h ]h"]h$]h&]uh1jhjhMhjεubj)}(h,``struct file *f`` the device file instance h](j)}(h``struct file *f``h]j)}(hjh]hstruct file *f}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj ubj)}(hhh]h)}(hthe device file instanceh]hthe device file instance}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjεubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjKh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjIubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubh)}(hHelper to implement fdinfo, for userspace to query usage stats, etc, of a process using the GPU. See also :c:type:`drm_driver.show_fdinfo `.h](hkHelper to implement fdinfo, for userspace to query usage stats, etc, of a process using the GPU. See also }(hjahhhNhNubh)}(h-:c:type:`drm_driver.show_fdinfo `h]j)}(hjkh]hdrm_driver.show_fdinfo}(hjmhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_driveruh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjaubh.}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(hSFor text output format description please see Documentation/gpu/drm-usage-stats.rsth]hSFor text output format description please see Documentation/gpu/drm-usage-stats.rst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_file_err (C function)c.drm_file_errhNtauh1jhjrhhhNhNubj)}(hhh](j)}(hDvoid drm_file_err (struct drm_file *file_priv, const char *fmt, ...)h]j)}(hCvoid drm_file_err(struct drm_file *file_priv, const char *fmt, ...)h](j-)}(hvoidh]hvoid}(hj¶hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMubj)}(h h]h }(hjѶhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjжhMubj)}(h drm_file_errh]j)}(h drm_file_errh]h drm_file_err}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߶ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjжhMubj)}(h2(struct drm_file *file_priv, const char *fmt, ...)h](j)}(hstruct drm_file *file_privh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_fileh]hdrm_file}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjsbc.drm_file_errasbuh1hhjubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h file_privh]h file_priv}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hconst char *fmth](j)}(hjZ/h]hconst}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj-)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjmubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(hfmth]hfmt}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h...h]j)}(h...h]h...}(hjηhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjʷubah}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjжhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjжhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjжhMhjhhubj)}(hhh]h)}(h@log process name, pid and client_name associated with a drm_fileh]h@log process name, pid and client_name associated with a drm_file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjжhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjrhNhNubj8)}(hX.**Parameters** ``struct drm_file *file_priv`` context of interest for process name and pid ``const char *fmt`` printf() like format string ``...`` variable arguments **Description** Helper function for clients which needs to log process details such as name and pid etc along with user logs.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubj)}(hhh](j)}(hL``struct drm_file *file_priv`` context of interest for process name and pid h](j)}(h``struct drm_file *file_priv``h]j)}(hj9h]hstruct drm_file *file_priv}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhj3ubj)}(hhh]h)}(h,context of interest for process name and pidh]h,context of interest for process name and pid}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhMhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhMhj0ubj)}(h0``const char *fmt`` printf() like format string h](j)}(h``const char *fmt``h]j)}(hjrh]hconst char *fmt}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjlubj)}(hhh]h)}(hprintf() like format stringh]hprintf() like format string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhMhj0ubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chKhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjĸhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj0ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chKhjubh)}(hmHelper function for clients which needs to log process details such as name and pid etc along with user logs.h]hmHelper function for clients which needs to log process details such as name and pid etc along with user logs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:154: ./drivers/gpu/drm/drm_file.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjrhhhNhNubeh}(h](j$jreh ]h"](file operationsdrm_driver_fopseh$]h&]uh1hhjrhhhhhKexpect_referenced_by_name}jjrsexpect_referenced_by_id}jrjrsubeh}(h]jah ]h"]&open/close, file operations and ioctlsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hMisc Utilitiesh]hMisc Utilities}(hj(hhhNhNubah}(h]h ]h"]h$]h&]hjLuh1hhj%hhhhhKubh)}(hhh](h)}(hPrinterh]hPrinter}(hj9hhhNhNubah}(h]h ]h"]h$]h&]hjkuh1hhj6hhhhhKubh)}(h}A simple wrapper for dev_printk(), seq_printf(), etc. Allows same debug code to be used for both debugfs and printk logging.h]h}A simple wrapper for dev_printk(), seq_printf(), etc. Allows same debug code to be used for both debugfs and printk logging.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:163: ./include/drm/drm_print.hhK-hj6hhubh)}(h For example::h]h For example:}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:163: ./include/drm/drm_print.hhK0hj6hhubj)}(hXvoid log_some_info(struct drm_printer *p) { drm_printf(p, "foo=%d\n", foo); drm_printf(p, "bar=%d\n", bar); } #ifdef CONFIG_DEBUG_FS void debugfs_show(struct seq_file *f) { struct drm_printer p = drm_seq_file_printer(f); log_some_info(&p); } #endif void some_other_function(...) { struct drm_printer p = drm_info_printer(drm->dev); log_some_info(&p); }h]hXvoid log_some_info(struct drm_printer *p) { drm_printf(p, "foo=%d\n", foo); drm_printf(p, "bar=%d\n", bar); } #ifdef CONFIG_DEBUG_FS void debugfs_show(struct seq_file *f) { struct drm_printer p = drm_seq_file_printer(f); log_some_info(&p); } #endif void some_other_function(...) { struct drm_printer p = drm_info_printer(drm->dev); log_some_info(&p); }}hjesbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:163: ./include/drm/drm_print.hhK2hj6hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_debug_category (C enum)c.drm_debug_categoryhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hdrm_debug_categoryh]j)}(henum drm_debug_categoryh](j)}(hj) h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hdrm_debug_categoryh]j)}(hjh]hdrm_debug_category}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhKubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhKhjhhubj)}(hhh]h)}(hThe DRM debug categoriesh]hThe DRM debug categories}(hjϹhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKJhj̹hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jenumeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(hXd**Constants** ``DRM_UT_CORE`` Used in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ... ``DRM_UT_DRIVER`` Used in the vendor specific part of the driver: i915, radeon, ... macro. ``DRM_UT_KMS`` Used in the modesetting code. ``DRM_UT_PRIME`` Used in the prime code. ``DRM_UT_ATOMIC`` Used in the atomic code. ``DRM_UT_VBL`` Used for verbose debug message in the vblank code. ``DRM_UT_STATE`` Used for verbose atomic state debugging. ``DRM_UT_LEASE`` Used in the lease code. ``DRM_UT_DP`` Used in the DP code. ``DRM_UT_DRMRES`` Used in the drm managed resources code.h](h)}(h **Constants**h]jB)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKNhjubj)}(hhh](j)}(hW``DRM_UT_CORE`` Used in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ... h](j)}(h``DRM_UT_CORE``h]j)}(hjh]h DRM_UT_CORE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKRhj ubj)}(hhh]h)}(hFUsed in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ...h]hFUsed in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ...}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKQhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj%hKRhjubj)}(h[``DRM_UT_DRIVER`` Used in the vendor specific part of the driver: i915, radeon, ... macro. h](j)}(h``DRM_UT_DRIVER``h]j)}(hjJh]h DRM_UT_DRIVER}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKVhjDubj)}(hhh]h)}(hHUsed in the vendor specific part of the driver: i915, radeon, ... macro.h]hHUsed in the vendor specific part of the driver: i915, radeon, ... macro.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKUhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj_hKVhjubj)}(h-``DRM_UT_KMS`` Used in the modesetting code. h](j)}(h``DRM_UT_KMS``h]j)}(hjh]h DRM_UT_KMS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKYhj~ubj)}(hhh]h)}(hUsed in the modesetting code.h]hUsed in the modesetting code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKYhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhKYhjubj)}(h)``DRM_UT_PRIME`` Used in the prime code. h](j)}(h``DRM_UT_PRIME``h]j)}(hjh]h DRM_UT_PRIME}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhK\hjubj)}(hhh]h)}(hUsed in the prime code.h]hUsed in the prime code.}(hjֺhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjҺhK\hjӺubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjҺhK\hjubj)}(h+``DRM_UT_ATOMIC`` Used in the atomic code. h](j)}(h``DRM_UT_ATOMIC``h]j)}(hjh]h DRM_UT_ATOMIC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhK_hjubj)}(hhh]h)}(hUsed in the atomic code.h]hUsed in the atomic code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hK_hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hK_hjubj)}(hB``DRM_UT_VBL`` Used for verbose debug message in the vblank code. h](j)}(h``DRM_UT_VBL``h]j)}(hj/h]h DRM_UT_VBL}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKbhj)ubj)}(hhh]h)}(h2Used for verbose debug message in the vblank code.h]h2Used for verbose debug message in the vblank code.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhKbhjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhKbhjubj)}(h:``DRM_UT_STATE`` Used for verbose atomic state debugging. h](j)}(h``DRM_UT_STATE``h]j)}(hjhh]h DRM_UT_STATE}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKehjbubj)}(hhh]h)}(h(Used for verbose atomic state debugging.h]h(Used for verbose atomic state debugging.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hKehj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hKehjubj)}(h)``DRM_UT_LEASE`` Used in the lease code. h](j)}(h``DRM_UT_LEASE``h]j)}(hjh]h DRM_UT_LEASE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhhjubj)}(hhh]h)}(hUsed in the lease code.h]hUsed in the lease code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhhjubj)}(h#``DRM_UT_DP`` Used in the DP code. h](j)}(h ``DRM_UT_DP``h]j)}(hjڻh]h DRM_UT_DP}(hjܻhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjػubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKkhjԻubj)}(hhh]h)}(hUsed in the DP code.h]hUsed in the DP code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKkhjubah}(h]h ]h"]h$]h&]uh1jhjԻubeh}(h]h ]h"]h$]h&]uh1jhjhKkhjubj)}(h9``DRM_UT_DRMRES`` Used in the drm managed resources code.h](j)}(h``DRM_UT_DRMRES``h]j)}(hjh]h DRM_UT_DRMRES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKmhj ubj)}(hhh]h)}(h'Used in the drm managed resources code.h]h'Used in the drm managed resources code.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKnhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hKmhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubh)}(h**Description**h]jB)}(hjVh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjTubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKphj6hhubh)}(hEach of the DRM debug logging macros use a specific category, and the logging is filtered by the drm.debug module parameter. This enum specifies the values for the interface.h]hEach of the DRM debug logging macros use a specific category, and the logging is filtered by the drm.debug module parameter. This enum specifies the values for the interface.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKKhj6hhubh)}(hkEach DRM_DEBUG_ macro logs to DRM_UT_ category, except DRM_DEBUG() logs to DRM_UT_CORE.h]hkEach DRM_DEBUG_ macro logs to DRM_UT_ category, except DRM_DEBUG() logs to DRM_UT_CORE.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKOhj6hhubh)}(hnEnabling verbose debug messages is done through the drm.debug parameter, each category being enabled by a bit:h]hnEnabling verbose debug messages is done through the drm.debug parameter, each category being enabled by a bit:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKRhj6hhubj+)}(h- drm.debug=0x1 will enable CORE messages - drm.debug=0x2 will enable DRIVER messages - drm.debug=0x3 will enable CORE and DRIVER messages - ... - drm.debug=0x3ff will enable all messages h]j)}(hhh](j)}(h'drm.debug=0x1 will enable CORE messagesh]h)}(hjh]h'drm.debug=0x1 will enable CORE messages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKUhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h)drm.debug=0x2 will enable DRIVER messagesh]h)}(hjh]h)drm.debug=0x2 will enable DRIVER messages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKVhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h2drm.debug=0x3 will enable CORE and DRIVER messagesh]h)}(hjҼh]h2drm.debug=0x3 will enable CORE and DRIVER messages}(hjԼhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKWhjмubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h...h]h)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h)drm.debug=0x3ff will enable all messages h]h)}(h(drm.debug=0x3ff will enable all messagesh]h(drm.debug=0x3ff will enable all messages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKYhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]j6Uj7Uuh1j hjhKUhjubah}(h]h ]h"]h$]h&]uh1j +hjhKUhj6hhubh)}(hAn interesting feature is that it's possible to enable verbose logging at run-time by echoing the debug value in its sysfs node::h]hAn interesting feature is that it’s possible to enable verbose logging at run-time by echoing the debug value in its sysfs node:}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhK[hj6hhubj)}(h-# echo 0xf > /sys/module/drm/parameters/debugh]h-# echo 0xf > /sys/module/drm/parameters/debug}hj4sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhK^hj6hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_printer (C struct) c.drm_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h drm_printerh]j)}(hstruct drm_printerh](j)}(hjh]hstruct}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKcubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjihKcubj)}(h drm_printerh]j)}(hjVh]h drm_printer}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjXhhhjihKcubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjThhhjihKcubah}(h]jOah ](jj eh"]h$]h&]j j)jhuh1jhjihKchjQhhubj)}(hhh]h)}(hdrm output "stream"h]hdrm output “stream”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjQhhhjihKcubeh}(h]h ](jstructeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h:**Definition**:: struct drm_printer { }; **Members**h](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hj½hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hstruct drm_printer { };h]hstruct drm_printer { };}hj۽sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(h **Members**h]jB)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubh)}(h**Description**h]jB)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj6hhubh)}(hDo not use struct members directly. Use drm_printer_seq_file(), drm_printer_info(), etc to initialize. And drm_printf() for output.h]hDo not use struct members directly. Use drm_printer_seq_file(), drm_printer_info(), etc to initialize. And drm_printf() for output.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj6hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_vprintf (C function) c.drm_vprintfhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hFvoid drm_vprintf (struct drm_printer *p, const char *fmt, va_list *va)h]j)}(hEvoid drm_vprintf(struct drm_printer *p, const char *fmt, va_list *va)h](j-)}(hvoidh]hvoid}(hjIhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjEhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjWhKubj)}(h drm_vprintfh]j)}(h drm_vprintfh]h drm_vprintf}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjEhhhjWhKubj)}(h5(struct drm_printer *p, const char *fmt, va_list *va)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjlsb c.drm_vprintfasbuh1hhjubj)}(h h]h }(hjľhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjҾhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hj߾hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj~ubj)}(hconst char *fmth](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hfmth]hfmt}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj~ubj)}(h va_list *vah](h)}(hhh]j)}(hva_listh]hva_list}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjYmodnameN classnameNj j )}j ]j c.drm_vprintfasbuh1hhjPubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(hvah]hva}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj~ubeh}(h]h ]h"]h$]h&]j+j,uh1jhjEhhhjWhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjAhhhjWhKubah}(h]j<ah ](jj eh"]h$]h&]j j)jhuh1jhjWhKhj>hhubj)}(hhh]h)}(h'print to a :c:type:`drm_printer` streamh](h print to a }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjĿh]h drm_printer}(hjƿhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj¿ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j c.drm_vprintfasbj  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh stream}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhj>hhhjWhKubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct drm_printer *p`` the :c:type:`drm_printer` ``const char *fmt`` format string ``va_list *va`` the va_listh](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh](j)}(h4``struct drm_printer *p`` the :c:type:`drm_printer` h](j)}(h``struct drm_printer *p``h]j)}(hj$h]hstruct drm_printer *p}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hthe :c:type:`drm_printer`h](hthe }(hj=hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjGh]h drm_printer}(hjIhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhj9hKhj=ubeh}(h]h ]h"]h$]h&]uh1hhj9hKhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hKhjubj)}(h"``const char *fmt`` format string h](j)}(h``const char *fmt``h]j)}(hj|h]hconst char *fmt}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjvubj)}(hhh]h)}(h format stringh]h format string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``va_list *va`` the va_listh](j)}(h``va_list *va``h]j)}(hjh]h va_list *va}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(h the va_listh]h the va_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_printf_indent (C macro)c.drm_printf_indenthNtauh1jhj6hhhNhNubj)}(hhh](j)}(hdrm_printf_indenth]j)}(hdrm_printf_indenth]j)}(hdrm_printf_indenth]j)}(hj h]hdrm_printf_indent}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhj&hKubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj&hKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhj&hKubeh}(h]h ](jmacroeh"]h$]h&]j1jj2j?j3j?j4j5j6uh1jhhhj6hNhNubh)}(h1``drm_printf_indent (printer, indent, fmt, ...)``h]j)}(hjEh]h-drm_printf_indent (printer, indent, fmt, ...)}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj6hhubj+)}(h9Print to a :c:type:`drm_printer` stream with indentation h]h)}(h8Print to a :c:type:`drm_printer` stream with indentationh](h Print to a }(hj_hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjih]h drm_printer}(hjkhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj_ubh stream with indentation}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhj[ubah}(h]h ]h"]h$]h&]uh1j +hjhKhj6hhubj8)}(h**Parameters** ``printer`` DRM printer ``indent`` Tab indentation level (max 5) ``fmt`` Format string ``...`` variable argumentsh](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh](j)}(h``printer`` DRM printer h](j)}(h ``printer``h]j)}(hjh]hprinter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(h DRM printerh]h DRM printer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h)``indent`` Tab indentation level (max 5) h](j)}(h ``indent``h]j)}(hjh]hindent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hTab indentation level (max 5)h]hTab indentation level (max 5)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(h``fmt`` Format string h](j)}(h``fmt``h]j)}(hj.h]hfmt}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj(ubj)}(hhh]h)}(h Format stringh]h Format string}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChKhjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhjChKhjubj)}(h``...`` variable argumentsh](j)}(h``...``h]j)}(hjgh]h...}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjaubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_print_iterator (C struct)c.drm_print_iteratorhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hdrm_print_iteratorh]j)}(hstruct drm_print_iteratorh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hdrm_print_iteratorh]j)}(hjh]hdrm_print_iterator}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhKubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhKhjhhubj)}(hhh]h)}(h+local struct used with drm_printer_coredumph]h+local struct used with drm_printer_coredump}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jstructeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(hXz**Definition**:: struct drm_print_iterator { void *data; ssize_t start; ssize_t remain; }; **Members** ``data`` Pointer to the devcoredump output buffer, can be NULL if using drm_printer_coredump to determine size of devcoredump ``start`` The offset within the buffer to start writing ``remain`` The number of bytes to write for this iterationh](h)}(h**Definition**::h](jB)}(h**Definition**h]h Definition}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj#ubh:}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hUstruct drm_print_iterator { void *data; ssize_t start; ssize_t remain; };h]hUstruct drm_print_iterator { void *data; ssize_t start; ssize_t remain; };}hj@sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(h **Members**h]jB)}(hjQh]hMembers}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjOubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh](j)}(h~``data`` Pointer to the devcoredump output buffer, can be NULL if using drm_printer_coredump to determine size of devcoredump h](j)}(h``data``h]j)}(hjph]hdata}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjjubj)}(hhh]h)}(htPointer to the devcoredump output buffer, can be NULL if using drm_printer_coredump to determine size of devcoredumph]htPointer to the devcoredump output buffer, can be NULL if using drm_printer_coredump to determine size of devcoredump}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjgubj)}(h8``start`` The offset within the buffer to start writing h](j)}(h ``start``h]j)}(hjh]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(h-The offset within the buffer to start writingh]h-The offset within the buffer to start writing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjgubj)}(h:``remain`` The number of bytes to write for this iterationh](j)}(h ``remain``h]j)}(hjh]hremain}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(h/The number of bytes to write for this iterationh]h/The number of bytes to write for this iteration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjgubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_coredump_printer (C function)c.drm_coredump_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hIstruct drm_printer drm_coredump_printer (struct drm_print_iterator *iter)h]j)}(hHstruct drm_printer drm_coredump_printer(struct drm_print_iterator *iter)h](j)}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhjJhKubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^modnameN classnameNj j )}j ]j)}jdrm_coredump_printersbc.drm_coredump_printerasbuh1hhj9hhhjJhKubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhhjJhKubj)}(hdrm_coredump_printerh]j)}(hjzh]hdrm_coredump_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj9hhhjJhKubj)}(h!(struct drm_print_iterator *iter)h]j)}(hstruct drm_print_iterator *iterh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_print_iteratorh]hdrm_print_iterator}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jxc.drm_coredump_printerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hiterh]hiter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubah}(h]h ]h"]h$]h&]j+j,uh1jhj9hhhjJhKubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj5hhhjJhKubah}(h]j0ah ](jj eh"]h$]h&]j j)jhuh1jhjJhKhj2hhubj)}(hhh]h)}(hdconstruct a :c:type:`drm_printer` that can output to a buffer from the read function for devcoredumph](h construct a }(hj+hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj5h]h drm_printer}(hj7hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jxc.drm_coredump_printerasbj  drm_printeruh1hhjhKhj+ubhC that can output to a buffer from the read function for devcoredump}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj(hhubah}(h]h ]h"]h$]h&]uh1jhj2hhhjJhKubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jkj3jkj4j5j6uh1jhhhj6hNhNubj8)}(hX **Parameters** ``struct drm_print_iterator *iter`` A pointer to a struct drm_print_iterator for the read instance **Description** This wrapper extends drm_printf() to work with a dev_coredumpm() callback function. The passed in drm_print_iterator struct contains the buffer pointer, size and offset as passed in from devcoredump. For example:: void coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = offset; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); } void makecoredump(...) { ... dev_coredumpm(dev, THIS_MODULE, data, 0, GFP_KERNEL, coredump_read, ...) } The above example has a time complexity of O(N^2), where N is the size of the devcoredump. This is acceptable for small devcoredumps but scales poorly for larger ones. Another use case for drm_coredump_printer is to capture the devcoredump into a saved buffer before the dev_coredump() callback. This involves two passes: one to determine the size of the devcoredump and another to print it to a buffer. Then, in dev_coredump(), copy from the saved buffer into the devcoredump read buffer. For example:: char *devcoredump_saved_buffer; ssize_t __coredump_print(char *buffer, ssize_t count, ...) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = 0; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); ... return count - iter.remain; } void coredump_print(...) { ssize_t count; count = __coredump_print(NULL, INT_MAX, ...); devcoredump_saved_buffer = kvmalloc(count, GFP_KERNEL); __coredump_print(devcoredump_saved_buffer, count, ...); } void coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { ... memcpy(buffer, devcoredump_saved_buffer + offset, count); ... } The above example has a time complexity of O(N*2), where N is the size of the devcoredump. This scales better than the previous example for larger devcoredumps. **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjuh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjsubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjoubj)}(hhh]j)}(hc``struct drm_print_iterator *iter`` A pointer to a struct drm_print_iterator for the read instance h](j)}(h#``struct drm_print_iterator *iter``h]j)}(hjh]hstruct drm_print_iterator *iter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(h>A pointer to a struct drm_print_iterator for the read instanceh]h>A pointer to a struct drm_print_iterator for the read instance}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjoubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjoubh)}(hThis wrapper extends drm_printf() to work with a dev_coredumpm() callback function. The passed in drm_print_iterator struct contains the buffer pointer, size and offset as passed in from devcoredump.h]hThis wrapper extends drm_printf() to work with a dev_coredumpm() callback function. The passed in drm_print_iterator struct contains the buffer pointer, size and offset as passed in from devcoredump.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjoubh)}(h For example::h]h For example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjoubj)}(hXvoid coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = offset; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); } void makecoredump(...) { ... dev_coredumpm(dev, THIS_MODULE, data, 0, GFP_KERNEL, coredump_read, ...) }h]hXvoid coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = offset; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); } void makecoredump(...) { ... dev_coredumpm(dev, THIS_MODULE, data, 0, GFP_KERNEL, coredump_read, ...) }}hjsbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjoubh)}(hThe above example has a time complexity of O(N^2), where N is the size of the devcoredump. This is acceptable for small devcoredumps but scales poorly for larger ones.h]hThe above example has a time complexity of O(N^2), where N is the size of the devcoredump. This is acceptable for small devcoredumps but scales poorly for larger ones.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjoubh)}(hXAAnother use case for drm_coredump_printer is to capture the devcoredump into a saved buffer before the dev_coredump() callback. This involves two passes: one to determine the size of the devcoredump and another to print it to a buffer. Then, in dev_coredump(), copy from the saved buffer into the devcoredump read buffer.h]hXAAnother use case for drm_coredump_printer is to capture the devcoredump into a saved buffer before the dev_coredump() callback. This involves two passes: one to determine the size of the devcoredump and another to print it to a buffer. Then, in dev_coredump(), copy from the saved buffer into the devcoredump read buffer.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjoubh)}(h For example::h]h For example:}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjoubj)}(hX2char *devcoredump_saved_buffer; ssize_t __coredump_print(char *buffer, ssize_t count, ...) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = 0; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); ... return count - iter.remain; } void coredump_print(...) { ssize_t count; count = __coredump_print(NULL, INT_MAX, ...); devcoredump_saved_buffer = kvmalloc(count, GFP_KERNEL); __coredump_print(devcoredump_saved_buffer, count, ...); } void coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { ... memcpy(buffer, devcoredump_saved_buffer + offset, count); ... }h]hX2char *devcoredump_saved_buffer; ssize_t __coredump_print(char *buffer, ssize_t count, ...) { struct drm_print_iterator iter; struct drm_printer p; iter.data = buffer; iter.start = 0; iter.remain = count; p = drm_coredump_printer(&iter); drm_printf(p, "foo=%d\n", foo); ... return count - iter.remain; } void coredump_print(...) { ssize_t count; count = __coredump_print(NULL, INT_MAX, ...); devcoredump_saved_buffer = kvmalloc(count, GFP_KERNEL); __coredump_print(devcoredump_saved_buffer, count, ...); } void coredump_read(char *buffer, loff_t offset, size_t count, void *data, size_t datalen) { ... memcpy(buffer, devcoredump_saved_buffer + offset, count); ... }}hj?sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM!hjoubh)}(hThe above example has a time complexity of O(N*2), where N is the size of the devcoredump. This scales better than the previous example for larger devcoredumps.h]hThe above example has a time complexity of O(N*2), where N is the size of the devcoredump. This scales better than the previous example for larger devcoredumps.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMDhjoubh)}(h **Return**h]jB)}(hj_h]hReturn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj]ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMHhjoubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjuhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMIhjuubh object}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMIhjoubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j)drm_coredump_printer_is_full (C function)c.drm_coredump_printer_is_fullhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h9bool drm_coredump_printer_is_full (struct drm_printer *p)h]j)}(h8bool drm_coredump_printer_is_full(struct drm_printer *p)h](j-)}(hj-h]hbool}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM\ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM\ubj)}(hdrm_coredump_printer_is_fullh]j)}(hdrm_coredump_printer_is_fullh]hdrm_coredump_printer_is_full}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhM\ubj)}(h(struct drm_printer *p)h]j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj#modnameN classnameNj j )}j ]j)}jjsbc.drm_coredump_printer_is_fullasbuh1hhjubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubah}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhM\ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhM\ubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhM\hjhhubj)}(hhh]h)}(h#DRM coredump printer output is fullh]h#DRM coredump printer output is full}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM\hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM\ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct drm_printer *p`` DRM coredump printer **Description** DRM printer output is full, useful to short circuit coredump printing once printer is full. **Return** True if DRM coredump printer output buffer is full, False otherwiseh](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM`hjubj)}(hhh]j)}(h/``struct drm_printer *p`` DRM coredump printer h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM]hjubj)}(hhh]h)}(hDRM coredump printerh]hDRM coredump printer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM]hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM_hjubh)}(h[DRM printer output is full, useful to short circuit coredump printing once printer is full.h]h[DRM printer output is full, useful to short circuit coredump printing once printer is full.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM^hjubh)}(h **Return**h]jB)}(hj(h]hReturn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj&ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMahjubh)}(hCTrue if DRM coredump printer output buffer is full, False otherwiseh]hCTrue if DRM coredump printer output buffer is full, False otherwise}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMbhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!drm_seq_file_printer (C function)c.drm_seq_file_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h` to output to **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMthjubj)}(hhh]j)}(hM``struct seq_file *f`` the :c:type:`struct seq_file ` to output to h](j)}(h``struct seq_file *f``h]j)}(hjh]hstruct seq_file *f}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMqhjubj)}(hhh]h)}(h5the :c:type:`struct seq_file ` to output toh](hthe }(hjhhhNhNubh)}(h$:c:type:`struct seq_file `h]j)}(hjh]hstruct seq_file}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j seq_fileuh1hhjhMqhjubh to output to}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMqhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jB)}(hj@h]hReturn}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj>ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMshjubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjVhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj`h]h drm_printer}(hjbhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMshjVubh object}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj}hMshjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_info_printer (C function)c.drm_info_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h8struct drm_printer drm_info_printer (struct device *dev)h]j)}(h7struct drm_printer drm_info_printer(struct device *dev)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jdrm_info_printersbc.drm_info_printerasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hdrm_info_printerh]j)}(hjh]hdrm_info_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(h(struct device *dev)h]j)}(hstruct device *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdeviceh]hdevice}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNj j )}j ]jc.drm_info_printerasbuh1hhjubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hdevh]hdev}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj ubah}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(h>construct a :c:type:`drm_printer` that outputs to dev_printk()h](h construct a }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jc.drm_info_printerasbj  drm_printeruh1hhjhKhjubh that outputs to dev_printk()}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct device *dev`` the :c:type:`struct device ` pointer **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]j)}(hD``struct device *dev`` the :c:type:`struct device ` pointer h](j)}(h``struct device *dev``h]j)}(hjh]hstruct device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(h,the :c:type:`struct device ` pointerh](hthe }(hjhhhNhNubh)}(h :c:type:`struct device `h]j)}(hj"h]h struct device}(hj$hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j deviceuh1hhjhMhjubh pointer}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jB)}(hj]h]hReturn}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj[ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjshhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj}h]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjsubh object}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_dbg_printer (C function)c.drm_dbg_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hqstruct drm_printer drm_dbg_printer (struct drm_device *drm, enum drm_debug_category category, const char *prefix)h]j)}(hpstruct drm_printer drm_dbg_printer(struct drm_device *drm, enum drm_debug_category category, const char *prefix)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jdrm_dbg_printersbc.drm_dbg_printerasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hdrm_dbg_printerh]j)}(hjh]hdrm_dbg_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(hN(struct drm_device *drm, enum drm_debug_category category, const char *prefix)h](j)}(hstruct drm_device *drmh](j)}(hjh]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjRmodnameN classnameNj j )}j ]jc.drm_dbg_printerasbuh1hhj.ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hjh]h*}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(hdrmh]hdrm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj*ubj)}(h enum drm_debug_category categoryh](j)}(hj) h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdrm_debug_categoryh]hdrm_debug_category}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_dbg_printerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcategoryh]hcategory}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj*ubj)}(hconst char *prefixh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hprefixh]hprefix}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj*ubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(h@construct a :c:type:`drm_printer` for drm device specific outputh](h construct a }(hjshhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj}h]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jc.drm_dbg_printerasbj  drm_printeruh1hhjhKhjsubh for drm device specific output}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjphhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(hX**Parameters** ``struct drm_device *drm`` the :c:type:`struct drm_device ` pointer, or NULL ``enum drm_debug_category category`` the debug category to use ``const char *prefix`` debug output prefix, or NULL for no prefix **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh](j)}(hY``struct drm_device *drm`` the :c:type:`struct drm_device ` pointer, or NULL h](j)}(h``struct drm_device *drm``h]j)}(hjh]hstruct drm_device *drm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(h=the :c:type:`struct drm_device ` pointer, or NULLh](hthe }(hjhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjh]hstruct drm_device}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjhMhjubh pointer, or NULL}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h?``enum drm_debug_category category`` the debug category to use h](j)}(h$``enum drm_debug_category category``h]j)}(hj8h]h enum drm_debug_category category}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj2ubj)}(hhh]h)}(hthe debug category to useh]hthe debug category to use}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjubj)}(hB``const char *prefix`` debug output prefix, or NULL for no prefix h](j)}(h``const char *prefix``h]j)}(hjqh]hconst char *prefix}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjkubj)}(hhh]h)}(h*debug output prefix, or NULL for no prefixh]h*debug output prefix, or NULL for no prefix}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jB)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh object}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_err_printer (C function)c.drm_err_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hOstruct drm_printer drm_err_printer (struct drm_device *drm, const char *prefix)h]j)}(hNstruct drm_printer drm_err_printer(struct drm_device *drm, const char *prefix)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj!hMubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj5modnameN classnameNj j )}j ]j)}jdrm_err_printersbc.drm_err_printerasbuh1hhjhhhj!hMubj)}(h h]h }(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj!hMubj)}(hdrm_err_printerh]j)}(hjQh]hdrm_err_printer}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhj!hMubj)}(h,(struct drm_device *drm, const char *prefix)h](j)}(hstruct drm_device *drmh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubh)}(hhh]j)}(h drm_deviceh]h drm_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jOc.drm_err_printerasbuh1hhj}ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubj)}(hdrmh]hdrm}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjyubj)}(hconst char *prefixh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hprefixh]hprefix}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjyubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhj!hMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj hhhj!hMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj!hMhj hhubj)}(hhh]h)}(h;construct a :c:type:`drm_printer` that outputs to drm_err()h](h construct a }(hj_hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjih]h drm_printer}(hjkhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jOc.drm_err_printerasbj  drm_printeruh1hhjhKhj_ubh that outputs to drm_err()}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj\hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj!hMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct drm_device *drm`` the :c:type:`struct drm_device ` pointer ``const char *prefix`` debug output prefix, or NULL for no prefix **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh](j)}(hP``struct drm_device *drm`` the :c:type:`struct drm_device ` pointer h](j)}(h``struct drm_device *drm``h]j)}(hjh]hstruct drm_device *drm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(h4the :c:type:`struct drm_device ` pointerh](hthe }(hjhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjh]hstruct drm_device}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_deviceuh1hhjhMhjubh pointer}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hB``const char *prefix`` debug output prefix, or NULL for no prefix h](j)}(h``const char *prefix``h]j)}(hj$h]hconst char *prefix}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(h*debug output prefix, or NULL for no prefixh]h*debug output prefix, or NULL for no prefix}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jB)}(hj_h]hReturn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj]ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjuhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjuubh object}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_line_printer (C function)c.drm_line_printerhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hdstruct drm_printer drm_line_printer (struct drm_printer *p, const char *prefix, unsigned int series)h]j)}(hcstruct drm_printer drm_line_printer(struct drm_printer *p, const char *prefix, unsigned int series)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jdrm_line_printersbc.drm_line_printerasbuh1hhjhhhjhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hdrm_line_printerh]j)}(hjh]hdrm_line_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(h@(struct drm_printer *p, const char *prefix, unsigned int series)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjTmodnameN classnameNj j )}j ]jc.drm_line_printerasbuh1hhj0ubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hjh]h*}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj,ubj)}(hconst char *prefixh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hprefixh]hprefix}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj,ubj)}(hunsigned int seriesh](j-)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hinth]hint}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hseriesh]hseries}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhj,ubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(hIconstruct a :c:type:`drm_printer` that prefixes outputs with line numbersh](h construct a }(hjbhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjlh]h drm_printer}(hjnhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jc.drm_line_printerasbj  drm_printeruh1hhjhKhjbubh( that prefixes outputs with line numbers}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj_hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(hX**Parameters** ``struct drm_printer *p`` the :c:type:`struct drm_printer ` which actually generates the output ``const char *prefix`` optional output prefix, or NULL for no prefix ``unsigned int series`` optional unique series identifier, or 0 to omit identifier in the output **Description** This printer can be used to increase the robustness of the captured output to make sure we didn't lost any intermediate lines of the output. Helpful while capturing some crash data. Example 1:: void crash_dump(struct drm_device *drm) { static unsigned int id; struct drm_printer p = drm_err_printer(drm, "crash"); struct drm_printer lp = drm_line_printer(&p, "dump", ++id); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); } Above code will print into the dmesg something like:: [ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.1: foo [ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.2: bar Example 2:: void line_dump(struct device *dev) { struct drm_printer p = drm_info_printer(dev); struct drm_printer lp = drm_line_printer(&p, NULL, 0); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); } Above code will print:: [ ] 0000:00:00.0: [drm] 1: foo [ ] 0000:00:00.0: [drm] 2: bar **Return** The :c:type:`drm_printer` objecth](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh](j)}(hm``struct drm_printer *p`` the :c:type:`struct drm_printer ` which actually generates the output h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(hRthe :c:type:`struct drm_printer ` which actually generates the outputh](hthe }(hjhhhNhNubh)}(h*:c:type:`struct drm_printer `h]j)}(hjh]hstruct drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhjhMhjubh$ which actually generates the output}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hE``const char *prefix`` optional output prefix, or NULL for no prefix h](j)}(h``const char *prefix``h]j)}(hj'h]hconst char *prefix}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj!ubj)}(hhh]h)}(h-optional output prefix, or NULL for no prefixh]h-optional output prefix, or NULL for no prefix}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hMhj=ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj<hMhjubj)}(ha``unsigned int series`` optional unique series identifier, or 0 to omit identifier in the output h](j)}(h``unsigned int series``h]j)}(hj`h]hunsigned int series}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjZubj)}(hhh]h)}(hHoptional unique series identifier, or 0 to omit identifier in the outputh]hHoptional unique series identifier, or 0 to omit identifier in the output}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(hThis printer can be used to increase the robustness of the captured output to make sure we didn't lost any intermediate lines of the output. Helpful while capturing some crash data.h]hThis printer can be used to increase the robustness of the captured output to make sure we didn’t lost any intermediate lines of the output. Helpful while capturing some crash data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h Example 1::h]h Example 1:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hXvoid crash_dump(struct drm_device *drm) { static unsigned int id; struct drm_printer p = drm_err_printer(drm, "crash"); struct drm_printer lp = drm_line_printer(&p, "dump", ++id); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); }h]hXvoid crash_dump(struct drm_device *drm) { static unsigned int id; struct drm_printer p = drm_err_printer(drm, "crash"); struct drm_printer lp = drm_line_printer(&p, "dump", ++id); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); }}hjsbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h5Above code will print into the dmesg something like::h]h4Above code will print into the dmesg something like:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hg[ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.1: foo [ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.2: barh]hg[ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.1: foo [ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.2: bar}hjsbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h Example 2::h]h Example 2:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hvoid line_dump(struct device *dev) { struct drm_printer p = drm_info_printer(dev); struct drm_printer lp = drm_line_printer(&p, NULL, 0); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); }h]hvoid line_dump(struct device *dev) { struct drm_printer p = drm_info_printer(dev); struct drm_printer lp = drm_line_printer(&p, NULL, 0); drm_printf(&lp, "foo"); drm_printf(&lp, "bar"); }}hj sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(hAbove code will print::h]hAbove code will print:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(h=[ ] 0000:00:00.0: [drm] 1: foo [ ] 0000:00:00.0: [drm] 2: barh]h=[ ] 0000:00:00.0: [drm] 1: foo [ ] 0000:00:00.0: [drm] 2: bar}hj)sbah}(h]h ]h"]h$]h&]j+j,uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h **Return**h]jB)}(hj:h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h The :c:type:`drm_printer` objecth](hThe }(hjPhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjZh]h drm_printer}(hj\hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjPubh object}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjwhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jDRM_DEV_ERROR (C macro)c.DRM_DEV_ERRORhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h DRM_DEV_ERRORh]j)}(h DRM_DEV_ERRORh]j)}(h DRM_DEV_ERRORh]j)}(hjh]h DRM_DEV_ERROR}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubh)}(h!``DRM_DEV_ERROR (dev, fmt, ...)``h]j)}(hjh]hDRM_DEV_ERROR (dev, fmt, ...)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj6hhubj+)}(hError output. h]h)}(h Error output.h]h Error output.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubah}(h]h ]h"]h$]h&]uh1j +hjhMhj6hhubj8)}(h**Parameters** ``dev`` device pointer ``fmt`` printf() like format string. ``...`` variable arguments **NOTE** this is deprecated in favor of drm_err() or dev_err().h](h)}(h**Parameters**h]jB)}(hj h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh](j)}(h``dev`` device pointer h](j)}(h``dev``h]j)}(hj,h]hdev}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj&ubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMhjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhMhj#ubj)}(h%``fmt`` printf() like format string. h](j)}(h``fmt``h]j)}(hjeh]hfmt}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM hj_ubj)}(hhh]h)}(hprintf() like format string.h]hprintf() like format string.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhM hj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhM hj#ubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj#ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**NOTE**h]jB)}(hjh]hNOTE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(h6this is deprecated in favor of drm_err() or dev_err().h]h6this is deprecated in favor of drm_err() or dev_err().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#DRM_DEV_ERROR_RATELIMITED (C macro)c.DRM_DEV_ERROR_RATELIMITEDhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hDRM_DEV_ERROR_RATELIMITEDh]j)}(hDRM_DEV_ERROR_RATELIMITEDh]j)}(hDRM_DEV_ERROR_RATELIMITEDh]j)}(hjh]hDRM_DEV_ERROR_RATELIMITED}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhj5hMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhj5hMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhj5hMubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jNj3jNj4j5j6uh1jhhhj6hNhNubh)}(h-``DRM_DEV_ERROR_RATELIMITED (dev, fmt, ...)``h]j)}(hjTh]h)DRM_DEV_ERROR_RATELIMITED (dev, fmt, ...)}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhj6hhubj+)}(hRate limited error output. h]h)}(hRate limited error output.h]hRate limited error output.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjjubah}(h]h ]h"]h$]h&]uh1j +hj|hMhj6hhubj8)}(hX**Parameters** ``dev`` device pointer ``fmt`` printf() like format string. ``...`` variable arguments **NOTE** this is deprecated in favor of drm_err_ratelimited() or dev_err_ratelimited(). **Description** Like DRM_ERROR() but won't flood the log.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh](j)}(h``dev`` device pointer h](j)}(h``dev``h]j)}(hjh]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h%``fmt`` printf() like format string. h](j)}(h``fmt``h]j)}(hjh]hfmt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubj)}(hhh]h)}(hprintf() like format string.h]hprintf() like format string.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hKhj0ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj/hKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**NOTE**h]jB)}(hjUh]hNOTE}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(hNthis is deprecated in favor of drm_err_ratelimited() or dev_err_ratelimited().h]hNthis is deprecated in favor of drm_err_ratelimited() or dev_err_ratelimited().}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h**Description**h]jB)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjzubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubh)}(h)Like DRM_ERROR() but won't flood the log.h]h+Like DRM_ERROR() but won’t flood the log.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jDRM_DEV_DEBUG (C macro)c.DRM_DEV_DEBUGhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h DRM_DEV_DEBUGh]j)}(h DRM_DEV_DEBUGh]j)}(h DRM_DEV_DEBUGh]j)}(hjh]h DRM_DEV_DEBUG}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM;ubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhM;ubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhM;hjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhM;ubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubh)}(h!``DRM_DEV_DEBUG (dev, fmt, ...)``h]j)}(hjh]hDRM_DEV_DEBUG (dev, fmt, ...)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM=hj6hhubj+)}(h"Debug output for generic drm code h]h)}(h!Debug output for generic drm codeh]h!Debug output for generic drm code}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM;hj ubah}(h]h ]h"]h$]h&]uh1j +hjhM;hj6hhubj8)}(h**Parameters** ``dev`` device pointer ``fmt`` printf() like format string. ``...`` variable arguments **NOTE** this is deprecated in favor of drm_dbg_core().h](h)}(h**Parameters**h]jB)}(hj,h]h Parameters}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj*ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM?hj&ubj)}(hhh](j)}(h``dev`` device pointer h](j)}(h``dev``h]j)}(hjKh]hdev}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM?hjEubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hM?hjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hM?hjBubj)}(h%``fmt`` printf() like format string. h](j)}(h``fmt``h]j)}(hjh]hfmt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM@hj~ubj)}(hhh]h)}(hprintf() like format string.h]hprintf() like format string.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM@hjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjBubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjBubeh}(h]h ]h"]h$]h&]uh1jhj&ubh)}(h**NOTE**h]jB)}(hjh]hNOTE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj&ubh)}(h.this is deprecated in favor of drm_dbg_core().h]h.this is deprecated in favor of drm_dbg_core().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhM=hj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jDRM_DEV_DEBUG_DRIVER (C macro)c.DRM_DEV_DEBUG_DRIVERhNtauh1jhj6hhhNhNubj)}(hhh](j)}(hDRM_DEV_DEBUG_DRIVERh]j)}(hDRM_DEV_DEBUG_DRIVERh]j)}(hDRM_DEV_DEBUG_DRIVERh]j)}(hj7h]hDRM_DEV_DEBUG_DRIVER}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj9hhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMEubah}(h]h ]h"]h$]h&]j+j,juh1jjjhj5hhhjThMEubah}(h]j0ah ](jj eh"]h$]h&]j j)jhuh1jhjThMEhj2hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj2hhhjThMEubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jmj3jmj4j5j6uh1jhhhj6hNhNubh)}(h(``DRM_DEV_DEBUG_DRIVER (dev, fmt, ...)``h]j)}(hjsh]h$DRM_DEV_DEBUG_DRIVER (dev, fmt, ...)}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMGhj6hhubj+)}(h4Debug output for vendor specific part of the driver h]h)}(h3Debug output for vendor specific part of the driverh]h3Debug output for vendor specific part of the driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMEhjubah}(h]h ]h"]h$]h&]uh1j +hjhMEhj6hhubj8)}(h**Parameters** ``dev`` device pointer ``fmt`` printf() like format string. ``...`` variable arguments **NOTE** this is deprecated in favor of drm_dbg() or dev_dbg().h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMIhjubj)}(hhh](j)}(h``dev`` device pointer h](j)}(h``dev``h]j)}(hjh]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMIhjubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMIhjubj)}(h%``fmt`` printf() like format string. h](j)}(h``fmt``h]j)}(hjh]hfmt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMJhjubj)}(hhh]h)}(hprintf() like format string.h]hprintf() like format string.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMJhjubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hj9h]h...}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhj3ubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhKhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**NOTE**h]jB)}(hjth]hNOTE}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjrubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(h6this is deprecated in favor of drm_dbg() or dev_dbg().h]h6this is deprecated in favor of drm_dbg() or dev_dbg().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMGhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jDRM_DEV_DEBUG_KMS (C macro)c.DRM_DEV_DEBUG_KMShNtauh1jhj6hhhNhNubj)}(hhh](j)}(hDRM_DEV_DEBUG_KMSh]j)}(hDRM_DEV_DEBUG_KMSh]j)}(hDRM_DEV_DEBUG_KMSh]j)}(hjh]hDRM_DEV_DEBUG_KMS}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMOubah}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMOubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMOhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMOubeh}(h]h ](jmacroeh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubh)}(h%``DRM_DEV_DEBUG_KMS (dev, fmt, ...)``h]j)}(hjh]h!DRM_DEV_DEBUG_KMS (dev, fmt, ...)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMQhj6hhubj+)}(h"Debug output for modesetting code h]h)}(h!Debug output for modesetting codeh]h!Debug output for modesetting code}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMOhjubah}(h]h ]h"]h$]h&]uh1j +hjhMOhj6hhubj8)}(h**Parameters** ``dev`` device pointer ``fmt`` printf() like format string. ``...`` variable arguments **NOTE** this is deprecated in favor of drm_dbg_kms().h](h)}(h**Parameters**h]jB)}(hj$h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj"ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMShjubj)}(hhh](j)}(h``dev`` device pointer h](j)}(h``dev``h]j)}(hjCh]hdev}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMShj=ubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMShjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMShj:ubj)}(h%``fmt`` printf() like format string. h](j)}(h``fmt``h]j)}(hj|h]hfmt}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMThjvubj)}(hhh]h)}(hprintf() like format string.h]hprintf() like format string.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMThj:ubj)}(h``...`` variable arguments h](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj:ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**NOTE**h]jB)}(hjh]hNOTE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhKhjubh)}(h-this is deprecated in favor of drm_dbg_kms().h]h-this is deprecated in favor of drm_dbg_kms().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:166: ./include/drm/drm_print.hhMQhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_puts (C function) c.drm_putshNtauh1jhj6hhhNhNubj)}(hhh](j)}(h6void drm_puts (struct drm_printer *p, const char *str)h]j)}(h5void drm_puts(struct drm_printer *p, const char *str)h](j-)}(hvoidh]hvoid}(hj5hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj1hhh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hhhjChMubj)}(hdrm_putsh]j)}(hdrm_putsh]hdrm_puts}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj1hhhjChMubj)}(h((struct drm_printer *p, const char *str)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjXsb c.drm_putsasbuh1hhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjjubj)}(hconst char *strh](j)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)@}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hstrh]hstr}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjjubeh}(h]h ]h"]h$]h&]j+j,uh1jhj1hhhjChMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj-hhhjChMubah}(h]j(ah ](jj eh"]h$]h&]j j)jhuh1jhjChMhj*hhubj)}(hhh]h)}(h6print a const string to a :c:type:`drm_printer` streamh](hprint a const string to a }(hjQhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj[h]h drm_printer}(hj]hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j c.drm_putsasbj  drm_printeruh1hhjChMhjQubh stream}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjNhhubah}(h]h ]h"]h$]h&]uh1jhj*hhhjChMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct drm_printer *p`` the :c:type:`drm` printer ``const char *str`` const string **Description** Allow :c:type:`drm_printer` types that have a constant string option to use it.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh](j)}(h4``struct drm_printer *p`` the :c:type:`drm` printer h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(hthe :c:type:`drm` printerh](hthe }(hjhhhNhNubh)}(h :c:type:`drm`h]j)}(hjh]hdrm}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drmuh1hhjhMhjubh printer}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h!``const char *str`` const string h](j)}(h``const char *str``h]j)}(hjh]hconst char *str}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(h const stringh]h const string}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjOubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubh)}(hOAllow :c:type:`drm_printer` types that have a constant string option to use it.h](hAllow }(hjghhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjqh]h drm_printer}(hjshhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjgubh4 types that have a constant string option to use it.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_printf (C function) c.drm_printfhNtauh1jhj6hhhNhNubj)}(hhh](j)}(h;void drm_printf (struct drm_printer *p, const char *f, ...)h]j)}(h:void drm_printf(struct drm_printer *p, const char *f, ...)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(h drm_printfh]j)}(h drm_printfh]h drm_printf}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMubj)}(h+(struct drm_printer *p, const char *f, ...)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjsb c.drm_printfasbuh1hhjubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h const char *fh](j)}(hjZ/h]hconst}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj-)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hjnh]hf}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h...h]j)}(hjзh]h...}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMhjhhubj)}(hhh]h)}(h'print to a :c:type:`drm_printer` streamh](h print to a }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j0 c.drm_printfasbj  drm_printeruh1hhjChMhjubh stream}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2j,j3j,j4j5j6uh1jhhhj6hNhNubj8)}(h**Parameters** ``struct drm_printer *p`` the :c:type:`drm_printer` ``const char *f`` format string ``...`` variable argumentsh](h)}(h**Parameters**h]jB)}(hj6h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj4ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhj0ubj)}(hhh](j)}(h4``struct drm_printer *p`` the :c:type:`drm_printer` h](j)}(h``struct drm_printer *p``h]j)}(hjUh]hstruct drm_printer *p}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjOubj)}(hhh]h)}(hthe :c:type:`drm_printer`h](hthe }(hjnhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjxh]h drm_printer}(hjzhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhjjhMhjnubeh}(h]h ]h"]h$]h&]uh1hhjjhMhjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhMhjLubj)}(h ``const char *f`` format string h](j)}(h``const char *f``h]j)}(hjh]h const char *f}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(h format stringh]h format string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjLubj)}(h``...`` variable argumentsh](j)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(hvariable argumentsh]hvariable arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjLubeh}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_print_bits (C function)c.drm_print_bitshNtauh1jhj6hhhNhNubj)}(hhh](j)}(hovoid drm_print_bits (struct drm_printer *p, unsigned long value, const char * const bits[], unsigned int nbits)h]j)}(hmvoid drm_print_bits(struct drm_printer *p, unsigned long value, const char *const bits[], unsigned int nbits)h](j-)}(hvoidh]hvoid}(hj@hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj<hhh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM ubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhjNhM ubj)}(hdrm_print_bitsh]j)}(hdrm_print_bitsh]hdrm_print_bits}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj<hhhjNhM ubj)}(hZ(struct drm_printer *p, unsigned long value, const char *const bits[], unsigned int nbits)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjcsbc.drm_print_bitsasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjuubj)}(hunsigned long valueh](j-)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvalueh]hvalue}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjuubj)}(hconst char *const bits[]h](j)}(hjZ/h]hconst}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj-)}(hcharh]hchar}(hjZhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj;ubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hjh]h*}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hjZ/h]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(hbitsh]hbits}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h[h]h[}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h]h]h]}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjuubj)}(hunsigned int nbitsh](j-)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hinth]hint}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hnbitsh]hnbits}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjuubeh}(h]h ]h"]h$]h&]j+j,uh1jhj<hhhjNhM ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj8hhhjNhM ubah}(h]j3ah ](jj eh"]h$]h&]j j)jhuh1jhjNhM hj5hhubj)}(hhh]h)}(h,print bits to a :c:type:`drm_printer` streamh](hprint bits to a }(hj5hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj?h]h drm_printer}(hjAhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jc.drm_print_bitsasbj  drm_printeruh1hhjChMhj5ubh stream}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM hj2hhubah}(h]h ]h"]h$]h&]uh1jhj5hhhjNhM ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2juj3juj4j5j6uh1jhhhj6hNhNubj8)}(hX)**Parameters** ``struct drm_printer *p`` the :c:type:`drm_printer` ``unsigned long value`` field value. ``const char * const bits[]`` Array with bit names. ``unsigned int nbits`` Size of bit names array. **Description** Print bits (in flag fields for example) in human readable form.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM$hjyubj)}(hhh](j)}(h4``struct drm_printer *p`` the :c:type:`drm_printer` h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM$hjubj)}(hhh]h)}(hthe :c:type:`drm_printer`h](hthe }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhjhM$hjubeh}(h]h ]h"]h$]h&]uh1hhjhM$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$hjubj)}(h%``unsigned long value`` field value. h](j)}(h``unsigned long value``h]j)}(hjh]hunsigned long value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM%hjubj)}(hhh]h)}(h field value.h]h field value.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM%hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM%hjubj)}(h4``const char * const bits[]`` Array with bit names. h](j)}(h``const char * const bits[]``h]j)}(hj/h]hconst char * const bits[]}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM&hj)ubj)}(hhh]h)}(hArray with bit names.h]hArray with bit names.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhM&hjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhM&hjubj)}(h0``unsigned int nbits`` Size of bit names array. h](j)}(h``unsigned int nbits``h]j)}(hjhh]hunsigned int nbits}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM'hjbubj)}(hhh]h)}(hSize of bit names array.h]hSize of bit names array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hM'hj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hM'hjubeh}(h]h ]h"]h$]h&]uh1jhjyubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM)hjyubh)}(h?Print bits (in flag fields for example) in human readable form.h]h?Print bits (in flag fields for example) in human readable form.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chM!hjyubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_print_regset32 (C function)c.drm_print_regset32hNtauh1jhj6hhhNhNubj)}(hhh](j)}(hPvoid drm_print_regset32 (struct drm_printer *p, struct debugfs_regset32 *regset)h]j)}(hOvoid drm_print_regset32(struct drm_printer *p, struct debugfs_regset32 *regset)h](j-)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjhhh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMrubj)}(hdrm_print_regset32h]j)}(hdrm_print_regset32h]hdrm_print_regset32}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjhhhjhMrubj)}(h8(struct drm_printer *p, struct debugfs_regset32 *regset)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjEmodnameN classnameNj j )}j ]j)}jj sbc.drm_print_regset32asbuh1hhj!ubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hjh]h*}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hjh]hp}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hstruct debugfs_regset32 *regseth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdebugfs_regset32h]hdebugfs_regset32}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j_c.drm_print_regset32asbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hregseth]hregset}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjhhhjhMrubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjhhhjhMrubah}(h]jah ](jj eh"]h$]h&]j j)jhuh1jhjhMrhjhhubj)}(hhh]h)}(hBprint the contents of registers to a :c:type:`drm_printer` stream.h](h%print the contents of registers to a }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj!h]h drm_printer}(hj#hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]j_c.drm_print_regset32asbj  drm_printeruh1hhjChMhjubh stream.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMrhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMrubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jWj3jWj4j5j6uh1jhhhj6hNhNubj8)}(hX**Parameters** ``struct drm_printer *p`` the :c:type:`drm` printer ``struct debugfs_regset32 *regset`` the list of registers to print. **Description** Often in driver debug, it's useful to be able to either capture the contents of registers in the steady state using debugfs or at specific points during operation. This lets the driver have a single list of registers for both.h](h)}(h**Parameters**h]jB)}(hjah]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj_ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMvhj[ubj)}(hhh](j)}(h4``struct drm_printer *p`` the :c:type:`drm` printer h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMuhjzubj)}(hhh]h)}(hthe :c:type:`drm` printerh](hthe }(hjhhhNhNubh)}(h :c:type:`drm`h]j)}(hjh]hdrm}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j drmuh1hhjhMuhjubh printer}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjhMuhjwubj)}(hD``struct debugfs_regset32 *regset`` the list of registers to print. h](j)}(h#``struct debugfs_regset32 *regset``h]j)}(hjh]hstruct debugfs_regset32 *regset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMvhjubj)}(hhh]h)}(hthe list of registers to print.h]hthe list of registers to print.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMvhjwubeh}(h]h ]h"]h$]h&]uh1jhj[ubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMxhj[ubh)}(hOften in driver debug, it's useful to be able to either capture the contents of registers in the steady state using debugfs or at specific points during operation. This lets the driver have a single list of registers for both.h]hOften in driver debug, it’s useful to be able to either capture the contents of registers in the steady state using debugfs or at specific points during operation. This lets the driver have a single list of registers for both.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMwhj[ubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_print_hex_dump (C function)c.drm_print_hex_dumphNtauh1jhj6hhhNhNubj)}(hhh](j)}(h^void drm_print_hex_dump (struct drm_printer *p, const char *prefix, const u8 *buf, size_t len)h]j)}(h]void drm_print_hex_dump(struct drm_printer *p, const char *prefix, const u8 *buf, size_t len)h](j-)}(hvoidh]hvoid}(hj\hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjXhhh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjjhMubj)}(hdrm_print_hex_dumph]j)}(hdrm_print_hex_dumph]hdrm_print_hex_dump}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhjXhhhjjhMubj)}(hF(struct drm_printer *p, const char *prefix, const u8 *buf, size_t len)h](j)}(hstruct drm_printer *ph](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h drm_printerh]h drm_printer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j)}jjsbc.drm_print_hex_dumpasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(hconst char *prefixh](j)}(hjZ/h]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hcharh]hchar}(hj%hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hprefixh]hprefix}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h const u8 *bufh](j)}(hjZ/h]hconst}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubh)}(hhh]j)}(hu8h]hu8}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_print_hex_dumpasbuh1hhjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(hbufh]hbuf}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubj)}(h size_t lenh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]jc.drm_print_hex_dumpasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlenh]hlen}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj+j,uh1jhjubeh}(h]h ]h"]h$]h&]j+j,uh1jhjXhhhjjhMubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhjThhhjjhMubah}(h]jOah ](jj eh"]h$]h&]j j)jhuh1jhjjhMhjQhhubj)}(hhh]h)}(h2print a hex dump to a :c:type:`drm_printer` streamh](hprint a hex dump to a }(hj0hhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hj:h]h drm_printer}(hj<hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j )}j ]jc.drm_print_hex_dumpasbj  drm_printeruh1hhjChMhj0ubh stream}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhj-hhubah}(h]h ]h"]h$]h&]uh1jhjQhhhjjhMubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jpj3jpj4j5j6uh1jhhhj6hNhNubj8)}(hX**Parameters** ``struct drm_printer *p`` The :c:type:`drm_printer` ``const char *prefix`` Prefix for each line, may be NULL for no prefix ``const u8 *buf`` Buffer to dump ``size_t len`` Length of buffer **Description** Print hex dump to :c:type:`drm_printer`, with 16 space-separated hex bytes per line, optionally with a prefix on each line. No separator is added after prefix.h](h)}(h**Parameters**h]jB)}(hjzh]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjxubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjtubj)}(hhh](j)}(h4``struct drm_printer *p`` The :c:type:`drm_printer` h](j)}(h``struct drm_printer *p``h]j)}(hjh]hstruct drm_printer *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(hThe :c:type:`drm_printer`h](hThe }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hG``const char *prefix`` Prefix for each line, may be NULL for no prefix h](j)}(h``const char *prefix``h]j)}(hjh]hconst char *prefix}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubj)}(hhh]h)}(h/Prefix for each line, may be NULL for no prefixh]h/Prefix for each line, may be NULL for no prefix}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h!``const u8 *buf`` Buffer to dump h](j)}(h``const u8 *buf``h]j)}(hj*h]h const u8 *buf}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhj$ubj)}(hhh]h)}(hBuffer to dumph]hBuffer to dump}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hMhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMhjubj)}(h ``size_t len`` Length of buffer h](j)}(h``size_t len``h]j)}(hjch]h size_t len}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhj]ubj)}(hhh]h)}(hLength of bufferh]hLength of buffer}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhMhjubeh}(h]h ]h"]h$]h&]uh1jhjtubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjtubh)}(hPrint hex dump to :c:type:`drm_printer`, with 16 space-separated hex bytes per line, optionally with a prefix on each line. No separator is added after prefix.h](hPrint hex dump to }(hjhhhNhNubh)}(h:c:type:`drm_printer`h]j)}(hjh]h drm_printer}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  drm_printeruh1hh^/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:169: ./drivers/gpu/drm/drm_print.chMhjubhx, with 16 space-separated hex bytes per line, optionally with a prefix on each line. No separator is added after prefix.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hj6hhhNhNubeh}(h]jqah ]h"]printerah$]h&]uh1hhj%hhhhhKubh)}(hhh](h)}(h Utilitiesh]h Utilities}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKubh)}(hJMacros and inline functions that does not naturally belong in other placesh]hJMacros and inline functions that does not naturally belong in other places}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:175: ./include/drm/drm_util.hhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrm_can_sleep (C function)c.drm_can_sleephNtauh1jhjhhhNhNubj)}(hhh](j)}(hbool drm_can_sleep (void)h]j)}(hbool drm_can_sleep(void)h](j-)}(hj-h]hbool}(hj-hhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hj)hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK4ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj:hK4ubj)}(h drm_can_sleeph]j)}(h drm_can_sleeph]h drm_can_sleep}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]j+j,uh1jhj)hhhj:hK4ubj)}(h(void)h]j)}(hvoidh]j-)}(hvoidh]hvoid}(hjihhhNhNubah}(h]h ]j-ah"]h$]h&]uh1j-hjeubah}(h]h ]h"]h$]h&]noemphj+j,uh1jhjaubah}(h]h ]h"]h$]h&]j+j,uh1jhj)hhhj:hK4ubeh}(h]h ]h"]h$]h&]j+j,juh1jjjhj%hhhj:hK4ubah}(h]j ah ](jj eh"]h$]h&]j j)jhuh1jhj:hK4hj"hhubj)}(hhh]h)}(h'returns true if currently okay to sleeph]h'returns true if currently okay to sleep}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK4hjhhubah}(h]h ]h"]h$]h&]uh1jhj"hhhj:hK4ubeh}(h]h ](jfunctioneh"]h$]h&]j1jj2jj3jj4j5j6uh1jhhhjhNhNubj8)}(hXK**Parameters** ``void`` no arguments **Description** This function shall not be used in new code. The check for running in atomic context may not work - see linux/preempt.h. FIXME: All users of drm_can_sleep should be removed (see todo.rst) **Return** False if kgdb is active, we are in atomic context or irqs are disabled.h](h)}(h**Parameters**h]jB)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK8hjubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jB)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhKhjubh)}(hxThis function shall not be used in new code. The check for running in atomic context may not work - see linux/preempt.h.h]hxThis function shall not be used in new code. The check for running in atomic context may not work - see linux/preempt.h.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK5hjubh)}(hBFIXME: All users of drm_can_sleep should be removed (see todo.rst)h]hBFIXME: All users of drm_can_sleep should be removed (see todo.rst)}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK8hjubh)}(h **Return**h]jB)}(hjEh]hReturn}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjCubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK:hjubh)}(hGFalse if kgdb is active, we are in atomic context or irqs are disabled.h]hGFalse if kgdb is active, we are in atomic context or irqs are disabled.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-internals:178: ./include/drm/drm_util.hhK;hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j7hjhhhNhNubeh}(h]jah ]h"] utilitiesah$]h&]uh1hhj%hhhhhKubeh}(h]jRah ]h"]misc utilitiesah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Unit testingh]h Unit testing}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKubh)}(hhh](h)}(hKUnith]hKUnit}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKubh)}(hiKUnit (Kernel unit testing framework) provides a common framework for unit tests within the Linux kernel.h]hiKUnit (Kernel unit testing framework) provides a common framework for unit tests within the Linux kernel.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThis section covers the specifics for the DRM subsystem. For general information about KUnit, please refer to Documentation/dev-tools/kunit/start.rst.h]hThis section covers the specifics for the DRM subsystem. For general information about KUnit, please refer to Documentation/dev-tools/kunit/start.rst.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hHow to run the tests?h]hHow to run the tests?}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKubh)}(hIn order to facilitate running the test suite, a configuration file is present in ``drivers/gpu/drm/tests/.kunitconfig``. It can be used by ``kunit.py`` as follows:h](hRIn order to facilitate running the test suite, a configuration file is present in }(hjhhhNhNubj)}(h&``drivers/gpu/drm/tests/.kunitconfig``h]h"drivers/gpu/drm/tests/.kunitconfig}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. It can be used by }(hjhhhNhNubj)}(h ``kunit.py``h]hkunit.py}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh as follows:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h$ ./tools/testing/kunit/kunit.py run --kunitconfig=drivers/gpu/drm/tests \ --kconfig_add CONFIG_VIRTIO_UML=y \ --kconfig_add CONFIG_UML_PCI_OVER_VIRTIO=yh]h$ ./tools/testing/kunit/kunit.py run --kunitconfig=drivers/gpu/drm/tests \ --kconfig_add CONFIG_VIRTIO_UML=y \ --kconfig_add CONFIG_UML_PCI_OVER_VIRTIO=y}hjsbah}(h]h ]h"]h$]h&]j+j,j-j.bashj/}uh1jhhhKhjhhubhnote)}(hThe configuration included in ``.kunitconfig`` should be as generic as possible. ``CONFIG_VIRTIO_UML`` and ``CONFIG_UML_PCI_OVER_VIRTIO`` are not included in it because they are only required for User Mode Linux.h]h)}(hThe configuration included in ``.kunitconfig`` should be as generic as possible. ``CONFIG_VIRTIO_UML`` and ``CONFIG_UML_PCI_OVER_VIRTIO`` are not included in it because they are only required for User Mode Linux.h](hThe configuration included in }(hjhhhNhNubj)}(h``.kunitconfig``h]h .kunitconfig}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# should be as generic as possible. }(hjhhhNhNubj)}(h``CONFIG_VIRTIO_UML``h]hCONFIG_VIRTIO_UML}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``CONFIG_UML_PCI_OVER_VIRTIO``h]hCONFIG_UML_PCI_OVER_VIRTIO}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhK are not included in it because they are only required for User Mode Linux.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]jah ]h"]how to run the tests?ah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hKUnit Coverage Rulesh]hKUnit Coverage Rules}(hjjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjghhhhhKubh)}(hX*KUnit support is gradually added to the DRM framework and helpers. There's no general requirement for the framework and helpers to have KUnit tests at the moment. However, patches that are affecting a function or helper already covered by KUnit tests must provide tests if the change calls for one.h]hX,KUnit support is gradually added to the DRM framework and helpers. There’s no general requirement for the framework and helpers to have KUnit tests at the moment. However, patches that are affecting a function or helper already covered by KUnit tests must provide tests if the change calls for one.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjghhubeh}(h]j!ah ]h"]kunit coverage rulesah$]h&]uh1hhjhhhhhKubeh}(h]jah ]h"]kunitah$]h&]uh1hhjhhhhhKubeh}(h]jah ]h"] unit testingah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hLegacy Support Codeh]hLegacy Support Code}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjUuh1hhjhhhhhKubh)}(hXaThe section very briefly covers some of the old legacy support code which is only used by old DRM drivers which have done a so-called shadow-attach to the underlying device instead of registering as a real driver. This also includes some of the old generic buffer management and command submission code. Do not use any of this in new and modern drivers.h]hXaThe section very briefly covers some of the old legacy support code which is only used by old DRM drivers which have done a so-called shadow-attach to the underlying device instead of registering as a real driver. This also includes some of the old generic buffer management and command submission code. Do not use any of this in new and modern drivers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hLegacy Suspend/Resumeh]hLegacy Suspend/Resume}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjtuh1hhjhhhhhKubh)}(hX/The DRM core provides some suspend/resume code, but drivers wanting full suspend/resume support should provide save() and restore() functions. These are called at suspend, hibernate, or resume time, and should perform any state save or restore required by your device across suspend or hibernate states.h]hX/The DRM core provides some suspend/resume code, but drivers wanting full suspend/resume support should provide save() and restore() functions. These are called at suspend, hibernate, or resume time, and should perform any state save or restore required by your device across suspend or hibernate states.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXint (\*suspend) (struct drm_device \*, pm_message_t state); int (\*resume) (struct drm_device \*); Those are legacy suspend and resume methods which *only* work with the legacy shadow-attach driver registration functions. New driver should use the power management interface provided by their bus type (usually through the :c:type:`struct device_driver ` dev_pm_ops) and set these methods to NULL.h](hint (*suspend) (struct drm_device *, pm_message_t state); int (*resume) (struct drm_device *); Those are legacy suspend and resume methods which }(hjhhhNhNubjE)}(h*only*h]honly}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh work with the legacy shadow-attach driver registration functions. New driver should use the power management interface provided by their bus type (usually through the }(hjhhhNhNubh)}(h.:c:type:`struct device_driver `h]j)}(hjh]hstruct device_driver}(hjhhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnj j j  device_driveruh1hhhhKhjubh+ dev_pm_ops) and set these methods to NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]jzah ]h"]legacy suspend/resumeah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hLegacy DMA Servicesh]hLegacy DMA Services}(hj&hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj#hhhhhKubh)}(hwThis should cover how DMA mapping etc. is supported by the core. These functions are deprecated and should not be used.h]hwThis should cover how DMA mapping etc. is supported by the core. These functions are deprecated and should not be used.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj#hhubeh}(h]jah ]h"]legacy dma servicesah$]h&]uh1hhjhhhhhKubeh}(h]j[ah ]h"]legacy support codeah$]h&]uh1hhhhhhhhKubeh}(h]j*ah ]h"] drm internalsah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjzerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceȟ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}jr]jrasnameids}(jTj*jjjrjIjjhjjjjjEjjSjjjjUjFjBUjejhUjjUjjrjj"jjjrjj$j|jRjjqjujjjjjjdjjj!jMj[j jzjFju nametypes}(jTjjrjjjjEjSjjUjBUjhUjUjrj"jjj|jjujjjdjjMj jFuh}(j*hjhjIjjhjljj}jjjjjjHjjSjjj j j j jOjTj=jBjjj*j*j|-j-j/j/j1j1j4j4j6j 6j7j7j9j9j8;j=;j<j<j?j ?jKBjPBj4Fj9FjHjIjJjJjWLj\LjOjOjQRjVRjFjSjejTjjEUjjkUjjUjKVjPVjBYjGYj\j\j_j _jZaj_aj]cjbcj*ej/ejhjhjXkj]kjnjnj[pj`pjjrjrjrj$jrjAtjGtjuujzujyjyjjjjjjjjjjjjjj$jjj9j>jϜjԜj֠j۠jܤjjjjj jsjxjjj0j5jYj^jjjRj%jqj6jjjOjTj<jAjjjjj0j5jjj`jejjjjjj jjjjjjjjj0j5jjj(j-jjj3j8jjjOjTjjj j%jjjjjjj!jgj[jjzjjj#hjjCj:jbjYjjxjjjjjjjj j@j7j_jVjjxjjjjjjjjjLjCjkjbjjjjjjjjjjjUjLjtjkjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]hsystem_message)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOlineKXsourcejuh1jhjubatransform_messages]j)}(hhh]h)}(hhh]h5Hyperlink target "drm-driver-fops" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejsourceȟlineKuh1juba transformerN include_log] decorationNhhub.