sphinx.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-uapimodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/zh_TW/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/it_IT/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ja_JP/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ko_KR/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/pt_BR/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/sp_SP/gpu/drm-uapimodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h$Copyright 2020 DisplayLink (UK) Ltd.h]h$Copyright 2020 DisplayLink (UK) Ltd.}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh:/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi.rsthKubhsection)}(hhh](htitle)}(hUserland interfacesh]hUserland interfaces}(hhhhhNhNubah}(h]h ]h"]h$]h&]refidid3uh1hhhhhhhhKubh paragraph)}(hXThe DRM core exports several interfaces to applications, generally intended to be used through corresponding libdrm wrapper functions. In addition, drivers export device-specific interfaces for use by userspace drivers & device-aware applications through ioctls and sysfs files.h]hXThe DRM core exports several interfaces to applications, generally intended to be used through corresponding libdrm wrapper functions. In addition, drivers export device-specific interfaces for use by userspace drivers & device-aware applications through ioctls and sysfs files.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hExternal interfaces include: memory mapping, context management, DMA operations, AGP management, vblank control, fence management, memory management, and output management.h]hExternal interfaces include: memory mapping, context management, DMA operations, AGP management, vblank control, fence management, memory management, and output management.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hpCover generic ioctls and sysfs layout here. We only need high-level info, since man pages should cover the rest.h]hpCover generic ioctls and sysfs layout here. We only need high-level info, since man pages should cover the rest.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhtopic)}(h Contents h](h)}(hContentsh]hContents}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhKubh bullet_list)}(hhh]h list_item)}(hhh](h)}(hhh]h reference)}(hhh]hUserland interfaces}(hj.hhhNhNubah}(h]hah ]h"]h$]h&]refiduserland-interfacesuh1j,hj)ubah}(h]h ]h"]h$]h&]uh1hhj&ubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]hlibdrm Device Lookup}(hjLhhhNhNubah}(h]id4ah ]h"]h$]h&]refidlibdrm-device-lookupuh1j,hjIubah}(h]h ]h"]h$]h&]uh1hhjFubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]h,Primary Nodes, DRM Master and Authentication}(hjnhhhNhNubah}(h]id5ah ]h"]h$]h&]refid+primary-nodes-drm-master-and-authenticationuh1j,hjkubah}(h]h ]h"]h$]h&]uh1hhjhubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]hDRM Display Resource Leasing}(hjhhhNhNubah}(h]id6ah ]h"]h$]h&]refiddrm-display-resource-leasinguh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]h"Open-Source Userspace Requirements}(hjhhhNhNubah}(h]id7ah ]h"]h$]h&]refid"open-source-userspace-requirementsuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]h Render nodes}(hjhhhNhNubah}(h]id8ah ]h"]h$]h&]refid render-nodesuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]hDevice Hot-Unplug}(hjhhhNhNubah}(h]id9ah ]h"]h$]h&]refiddevice-hot-unpluguh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]hRequirements for KMS UAPI}(hjhhhNhNubah}(h]id10ah ]h"]h$]h&]refidrequirements-for-kms-uapiuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hhh]j-)}(hhh]h-Requirements for Render and Cross-Device UAPI}(hj7hhhNhNubah}(h]id11ah ]h"]h$]h&]refid-requirements-for-render-and-cross-device-uapiuh1j,hj4ubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hhh]j-)}(hhh]hRequirements for Memory Maps}(hjYhhhNhNubah}(h]id12ah ]h"]h$]h&]refidrequirements-for-memory-mapsuh1j,hjVubah}(h]h ]h"]h$]h&]uh1hhjSubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]h Device reset}(hjhhhNhNubah}(h]id13ah ]h"]h$]h&]refid device-resetuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]hKernel Mode Driver}(hjhhhNhNubah}(h]id14ah ]h"]h$]h&]refidkernel-mode-driveruh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hUser Mode Driver}(hjhhhNhNubah}(h]id15ah ]h"]h$]h&]refiduser-mode-driveruh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh](h)}(hhh]j-)}(hhh]h Robustness}(hjhhhNhNubah}(h]id16ah ]h"]h$]h&]refid robustnessuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]hOpenGL}(hj hhhNhNubah}(h]id17ah ]h"]h$]h&]refidopengluh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hVulkan}(hj+hhhNhNubah}(h]id18ah ]h"]h$]h&]refidid1uh1j,hj(ubah}(h]h ]h"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hReporting causes of resets}(hjYhhhNhNubah}(h]id19ah ]h"]h$]h&]refidreporting-causes-of-resetsuh1j,hjVubah}(h]h ]h"]h$]h&]uh1hhjSubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]hDevice Wedging}(hjhhhNhNubah}(h]id20ah ]h"]h$]h&]refiddevice-wedginguh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]hDriver prerequisites}(hjhhhNhNubah}(h]id21ah ]h"]h$]h&]refiddriver-prerequisitesuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hRecovery}(hjhhhNhNubah}(h]id22ah ]h"]h$]h&]refidrecoveryuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]h No Recovery}(hjhhhNhNubah}(h]id23ah ]h"]h$]h&]refid no-recoveryuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hCold Reset Recovery}(hj hhhNhNubah}(h]id24ah ]h"]h$]h&]refidcold-reset-recoveryuh1j,hj ubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hVendor Specific Recovery}(hj.hhhNhNubah}(h]id25ah ]h"]h$]h&]refidvendor-specific-recoveryuh1j,hj+ubah}(h]h ]h"]h$]h&]uh1hhj(ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hTask information}(hjPhhhNhNubah}(h]id26ah ]h"]h$]h&]refidtask-informationuh1j,hjMubah}(h]h ]h"]h$]h&]uh1hhjJubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hConsumer prerequisites}(hjrhhhNhNubah}(h]id27ah ]h"]h$]h&]refidconsumer-prerequisitesuh1j,hjoubah}(h]h ]h"]h$]h&]uh1hhjlubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hExample - rebind}(hjhhhNhNubah}(h]id28ah ]h"]h$]h&]refidexample-rebinduh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]hExample - cold-reset}(hjhhhNhNubah}(h]id29ah ]h"]h$]h&]refidexample-cold-resetuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(hhh]j-)}(hhh]h Customization}(hjhhhNhNubah}(h]id30ah ]h"]h$]h&]refid customizationuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]hIOCTL Support on Device Nodes}(hjhhhNhNubah}(h]id31ah ]h"]h$]h&]refidioctl-support-on-device-nodesuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh]j%)}(hhh]h)}(hhh]j-)}(hhh]hRecommended IOCTL Return Values}(hj%hhhNhNubah}(h]id32ah ]h"]h$]h&]refidrecommended-ioctl-return-valuesuh1j,hj"ubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]hTesting and validation}(hjShhhNhNubah}(h]id33ah ]h"]h$]h&]refidtesting-and-validationuh1j,hjPubah}(h]h ]h"]h$]h&]uh1hhjMubj )}(hhh](j%)}(hhh]h)}(hhh]j-)}(hhh]h&Testing Requirements for userspace API}(hjrhhhNhNubah}(h]id34ah ]h"]h$]h&]refid&testing-requirements-for-userspace-apiuh1j,hjoubah}(h]h ]h"]h$]h&]uh1hhjlubah}(h]h ]h"]h$]h&]uh1j$hjiubj%)}(hhh]h)}(hhh]j-)}(hhh]hValidating changes with IGT}(hjhhhNhNubah}(h]id35ah ]h"]h$]h&]refidvalidating-changes-with-igtuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjiubj%)}(hhh]h)}(hhh]j-)}(hhh]hUsing VKMS to test DRM API}(hjhhhNhNubah}(h]id36ah ]h"]h$]h&]refidusing-vkms-to-test-drm-apiuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjiubj%)}(hhh]h)}(hhh]j-)}(hhh]hDisplay CRC Support}(hjhhhNhNubah}(h]id37ah ]h"]h$]h&]refiddisplay-crc-supportuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjiubj%)}(hhh]h)}(hhh]j-)}(hhh]hDebugfs Support}(hjhhhNhNubah}(h]id38ah ]h"]h$]h&]refiddebugfs-supportuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjiubeh}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]h Sysfs Support}(hj(hhhNhNubah}(h]id39ah ]h"]h$]h&]refid sysfs-supportuh1j,hj%ubah}(h]h ]h"]h$]h&]uh1hhj"ubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]hVBlank event handling}(hjJhhhNhNubah}(h]id40ah ]h"]h$]h&]refidvblank-event-handlinguh1j,hjGubah}(h]h ]h"]h$]h&]uh1hhjDubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]hUserspace API Structures}(hjlhhhNhNubah}(h]id41ah ]h"]h$]h&]refiduserspace-api-structuresuh1j,hjiubah}(h]h ]h"]h$]h&]uh1hhjfubj )}(hhh]j%)}(hhh]h)}(hhh]j-)}(hhh]h CRTC index}(hjhhhNhNubah}(h]id42ah ]h"]h$]h&]refid crtc-indexuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh]h)}(hhh]j-)}(hhh]hdma-buf interoperability}(hjhhhNhNubah}(h]id43ah ]h"]h$]h&]refiddma-buf-interoperabilityuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjCubj%)}(hhh](h)}(hhh]j-)}(hhh]h Trace events}(hjhhhNhNubah}(h]id44ah ]h"]h$]h&]refid trace-eventsuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubj )}(hhh]j%)}(hhh]h)}(hhh]j-)}(hhh]hStable uAPI events}(hjhhhNhNubah}(h]id45ah ]h"]h$]h&]refidstable-uapi-eventsuh1j,hjubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j$hjCubeh}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1j$hj!ubah}(h]h ]h"]h$]h&]uh1jhj hhhNhNubeh}(h]contentsah ]contentsah"]contentsah$]h&]uh1j hhhKhhhhubh)}(hhh](h)}(hlibdrm Device Lookuph]hlibdrm Device Lookup}(hj@hhhNhNubah}(h]h ]h"]h$]h&]hjUuh1hhj=hhhhhKubh)}(h'BEWARE THE DRAGONS! MIND THE TRAPDOORS!h]h'BEWARE THE DRAGONS! MIND THE TRAPDOORS!}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:24: ./drivers/gpu/drm/drm_ioctl.chK/hj=hhubh)}(hIn an attempt to warn anyone else who's trying to figure out what's going on here, I'll try to summarize the story. First things first, let's clear up the names, because the kernel internals, libdrm and the ioctls are all named differently:h]hIn an attempt to warn anyone else who’s trying to figure out what’s going on here, I’ll try to summarize the story. First things first, let’s clear up the names, because the kernel internals, libdrm and the ioctls are all named differently:}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:24: ./drivers/gpu/drm/drm_ioctl.chK1hj=hhubh block_quote)}(hX- GET_UNIQUE ioctl, implemented by drm_getunique is wrapped up in libdrm through the drmGetBusid function. - The libdrm drmSetBusid function is backed by the SET_UNIQUE ioctl. All that code is nerved in the kernel with drm_invalid_op(). - The internal set_busid kernel functions and driver callbacks are exclusively use by the SET_VERSION ioctl, because only drm 1.0 (which is nerved) allowed userspace to set the busid through the above ioctl. - Other ioctls and functions involved are named consistently. h]j )}(hhh](j%)}(hhGET_UNIQUE ioctl, implemented by drm_getunique is wrapped up in libdrm through the drmGetBusid function.h]h)}(hhGET_UNIQUE ioctl, implemented by drm_getunique is wrapped up in libdrm through the drmGetBusid function.h]hhGET_UNIQUE ioctl, implemented by drm_getunique is wrapped up in libdrm through the drmGetBusid function.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:24: ./drivers/gpu/drm/drm_ioctl.chK6hjuubah}(h]h ]h"]h$]h&]uh1j$hjrubj%)}(hThe libdrm drmSetBusid function is backed by the SET_UNIQUE ioctl. All that code is nerved in the kernel with drm_invalid_op().h]h)}(hThe libdrm drmSetBusid function is backed by the SET_UNIQUE ioctl. All that code is nerved in the kernel with drm_invalid_op().h]hThe libdrm drmSetBusid function is backed by the SET_UNIQUE ioctl. All that code is nerved in the kernel with drm_invalid_op().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:24: ./drivers/gpu/drm/drm_ioctl.chK8hjubah}(h]h ]h"]h$]h&]uh1j$hjrubj%)}(hThe internal set_busid kernel functions and driver callbacks are exclusively use by the SET_VERSION ioctl, because only drm 1.0 (which is nerved) allowed userspace to set the busid through the above ioctl.h]h)}(hThe internal set_busid kernel functions and driver callbacks are exclusively use by the SET_VERSION ioctl, because only drm 1.0 (which is nerved) allowed userspace to set the busid through the above ioctl.h]hThe internal set_busid kernel functions and driver callbacks are exclusively use by the SET_VERSION ioctl, because only drm 1.0 (which is nerved) allowed userspace to set the busid through the above ioctl.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:24: ./drivers/gpu/drm/drm_ioctl.chK:hjubah}(h]h ]h"]h$]h&]uh1j$hjrubj%)}(h` is used to track groups of clients with open primary device nodes. For every :c:type:`struct drm_file ` which has had at least once successfully became the device master (either through the SET_MASTER IOCTL, or implicitly through opening the primary device node when no one else is the current master that time) there exists one :c:type:`drm_master`. This is noted in :c:type:`drm_file.is_master `. All other clients have just a pointer to the :c:type:`drm_master` they are associated with.h](h)}(h(:c:type:`struct drm_master `h]hliteral)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](xrefcc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdoc gpu/drm-uapi refdomainj reftypetype refexplicitrefwarn reftarget drm_masteruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:33: ./drivers/gpu/drm/drm_auth.chK+hjubhN is used to track groups of clients with open primary device nodes. For every }(hjhhhNhNubh)}(h$:c:type:`struct drm_file `h]j)}(hj h]hstruct drm_file}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_fileuh1hhj hK+hjubh which has had at least once successfully became the device master (either through the SET_MASTER IOCTL, or implicitly through opening the primary device node when no one else is the current master that time) there exists one }(hjhhhNhNubh)}(h:c:type:`drm_master`h]j)}(hj@ h]h drm_master}(hjB hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj> ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_masteruh1hhj hK+hjubh. This is noted in }(hjhhhNhNubh)}(h':c:type:`drm_file.is_master `h]j)}(hjc h]hdrm_file.is_master}(hje hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhja ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_fileuh1hhj hK+hjubh/. All other clients have just a pointer to the }(hjhhhNhNubh)}(h:c:type:`drm_master`h]j)}(hj h]h drm_master}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_masteruh1hhj hK+hjubh they are associated with.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hK+hjhhubh)}(hXIn addition only one :c:type:`drm_master` can be the current master for a :c:type:`drm_device`. It can be switched through the DROP_MASTER and SET_MASTER IOCTL, or implicitly through closing/opening the primary device node. See also drm_is_current_master().h](hIn addition only one }(hj hhhNhNubh)}(h:c:type:`drm_master`h]j)}(hj h]h drm_master}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_masteruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:33: ./drivers/gpu/drm/drm_auth.chK3hj ubh! can be the current master for a }(hj hhhNhNubh)}(h:c:type:`drm_device`h]j)}(hj h]h drm_device}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj drm_deviceuh1hhj hK3hj ubh. It can be switched through the DROP_MASTER and SET_MASTER IOCTL, or implicitly through closing/opening the primary device node. See also drm_is_current_master().}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hK3hjhhubh)}(hClients can authenticate against the current master (if it matches their own) using the GETMAGIC and AUTHMAGIC IOCTLs. Together with exchanging masters, this allows controlled access to the device for an entire group of mutually trusted clients.h]hClients can authenticate against the current master (if it matches their own) using the GETMAGIC and AUTHMAGIC IOCTLs. Together with exchanging masters, this allows controlled access to the device for an entire group of mutually trusted clients.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:33: ./drivers/gpu/drm/drm_auth.chK8hjhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single"drm_is_current_master (C function)c.drm_is_current_masterhNtauh1j hjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h3bool drm_is_current_master (struct drm_file *fpriv)h]hdesc_signature_line)}(h2bool drm_is_current_master(struct drm_file *fpriv)h](hdesc_sig_keyword_type)}(hboolh]hbool}(hj5 hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j3 hj/ hhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKIubhdesc_sig_space)}(h h]h }(hjG hhhNhNubah}(h]h ]wah"]h$]h&]uh1jE hj/ hhhjD hKIubh desc_name)}(hdrm_is_current_masterh]h desc_sig_name)}(hdrm_is_current_masterh]hdrm_is_current_master}(hj^ hhhNhNubah}(h]h ]nah"]h$]h&]uh1j\ hjX ubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jV hj/ hhhjD hKIubhdesc_parameterlist)}(h(struct drm_file *fpriv)h]hdesc_parameter)}(hstruct drm_file *fprivh](hdesc_sig_keyword)}(hstructh]hstruct}(hj hhhNhNubah}(h]h ]kah"]h$]h&]uh1j hj} ubjF )}(h h]h }(hj hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj} ubh)}(hhh]j] )}(hdrm_fileh]hdrm_file}(hj hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj ubah}(h]h ]h"]h$]h&] refdomainj reftype identifier reftargetj modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}j j` sbc.drm_is_current_masterasbuh1hhj} ubjF )}(h h]h }(hj hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj} ubhdesc_sig_punctuation)}(h*h]h*}(hj hhhNhNubah}(h]h ]pah"]h$]h&]uh1j hj} ubj] )}(hfprivh]hfpriv}(hj hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj} ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjw ubah}(h]h ]h"]h$]h&]hhuh1ju hj/ hhhjD hKIubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1j- sphinx_line_type declaratorhj) hhhjD hKIubah}(h]j ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j' hjD hKIhj$ hhubh desc_content)}(hhh]h)}(h-checks whether **priv** is the current masterh](hchecks whether }(hj hhhNhNubhstrong)}(h**priv**h]hpriv}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubh is the current master}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKIhj hhubah}(h]h ]h"]h$]h&]uh1j hj$ hhhjD hKIubeh}(h]h ](j functioneh"]h$]h&]domainj objtypejJ desctypejJ noindex noindexentrynocontentsentryuh1j" hhhjhNhNubh container)}(hXe**Parameters** ``struct drm_file *fpriv`` DRM file private **Description** Checks whether **fpriv** is current master on its device. This decides whether a client is allowed to run DRM_MASTER IOCTLs. Most of the modern IOCTL which require DRM_MASTER are for kernel modesetting - the current master is assumed to own the non-shareable display hardware.h](h)}(h**Parameters**h]j' )}(hj\ h]h Parameters}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjZ ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKMhjV ubhdefinition_list)}(hhh]hdefinition_list_item)}(h,``struct drm_file *fpriv`` DRM file private h](hterm)}(h``struct drm_file *fpriv``h]j)}(hj h]hstruct drm_file *fpriv}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKJhjy ubh definition)}(hhh]h)}(hDRM file privateh]hDRM file private}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKJhj ubah}(h]h ]h"]h$]h&]uh1j hjy ubeh}(h]h ]h"]h$]h&]uh1jw hj hKJhjt ubah}(h]h ]h"]h$]h&]uh1jr hjV ubh)}(h**Description**h]j' )}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKLhjV ubh)}(h|Checks whether **fpriv** is current master on its device. This decides whether a client is allowed to run DRM_MASTER IOCTLs.h](hChecks whether }(hj hhhNhNubj' )}(h **fpriv**h]hfpriv}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubhd is current master on its device. This decides whether a client is allowed to run DRM_MASTER IOCTLs.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKKhjV ubh)}(hMost of the modern IOCTL which require DRM_MASTER are for kernel modesetting - the current master is assumed to own the non-shareable display hardware.h]hMost of the modern IOCTL which require DRM_MASTER are for kernel modesetting - the current master is assumed to own the non-shareable display hardware.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chKNhjV ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_master_get (C function)c.drm_master_gethNtauh1j hjhhhNhNubj# )}(hhh](j( )}(h>struct drm_master * drm_master_get (struct drm_master *master)h]j. )}(h` **Description** Increments the reference count of **master** and returns a pointer to **master**.h](h)}(h**Parameters**h]j' )}(hjA h]h Parameters}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj? ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMrhj; ubjs )}(hhh]jx )}(hG``struct drm_master *master`` :c:type:`struct drm_master ` h](j~ )}(h``struct drm_master *master``h]j)}(hj` h]hstruct drm_master *master}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ ubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMohjZ ubj )}(hhh]h)}(h(:c:type:`struct drm_master `h]h)}(hj{ h]j)}(hj{ h]hstruct drm_master}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj} ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]sbj drm_masteruh1hhju hMohjy ubah}(h]h ]h"]h$]h&]uh1hhju hMohjv ubah}(h]h ]h"]h$]h&]uh1j hjZ ubeh}(h]h ]h"]h$]h&]uh1jw hju hMohjW ubah}(h]h ]h"]h$]h&]uh1jr hj; ubh)}(h**Description**h]j' )}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMqhj; ubh)}(hQIncrements the reference count of **master** and returns a pointer to **master**.h](h"Increments the reference count of }(hj hhhNhNubj' )}(h **master**h]hmaster}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubh and returns a pointer to }(hj hhhNhNubj' )}(h **master**h]hmaster}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMphj; ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_file_get_master (C function)c.drm_file_get_masterhNtauh1j hjhhhNhNubj# )}(hhh](j( )}(hDstruct drm_master * drm_file_get_master (struct drm_file *file_priv)h]j. )}(hBstruct drm_master *drm_file_get_master(struct drm_file *file_priv)h](j )}(hj h]hstruct}(hj!hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chM{ubjF )}(h h]h }(hj/hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhj.hM{ubh)}(hhh]j] )}(h drm_masterh]h drm_master}(hj@hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj=ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjBmodnameN classnameNj j )}j ]j )}j drm_file_get_mastersbc.drm_file_get_masterasbuh1hhjhhhj.hM{ubjF )}(h h]h }(hjahhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhj.hM{ubj )}(hj h]h*}(hjohhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhj.hM{ubjW )}(hdrm_file_get_masterh]j] )}(hj^h]hdrm_file_get_master}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj|ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhj.hM{ubjv )}(h(struct drm_file *file_priv)h]j| )}(hstruct drm_file *file_privh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjubh)}(hhh]j] )}(hdrm_fileh]hdrm_file}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjmodnameN classnameNj j )}j ]j\c.drm_file_get_masterasbuh1hhjubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj] )}(h file_privh]h file_priv}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjubah}(h]h ]h"]h$]h&]hhuh1ju hjhhhj.hM{ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhj.hM{ubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hj.hM{hjhhubj )}(hhh]h)}(h?reference :c:type:`drm_file.master ` of **file_priv**h](h reference }(hjhhhNhNubh)}(h$:c:type:`drm_file.master `h]j)}(hj&h]hdrm_file.master}(hj(hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]j\c.drm_file_get_masterasbj drm_fileuh1hhjD hKIhjubh of }(hjhhhNhNubj' )}(h **file_priv**h]h file_priv}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chM{hjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhj.hM{ubeh}(h]h ](j functioneh"]h$]h&]jN j jO jjjP jjjQ jR jS uh1j" hhhjhNhNubjU )}(hX**Parameters** ``struct drm_file *file_priv`` DRM file private **Description** Increments the reference count of **file_priv**'s :c:type:`drm_file.master ` and returns the :c:type:`drm_file.master `. If **file_priv** has no :c:type:`drm_file.master `, returns NULL. Master pointers returned from this function should be unreferenced using drm_master_put().h](h)}(h**Parameters**h]j' )}(hjth]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjrubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjnubjs )}(hhh]jx )}(h0``struct drm_file *file_priv`` DRM file private h](j~ )}(h``struct drm_file *file_priv``h]j)}(hjh]hstruct drm_file *file_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chM|hjubj )}(hhh]h)}(hDRM file privateh]hDRM file private}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM|hjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhM|hjubah}(h]h ]h"]h$]h&]uh1jr hjnubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chM~hjnubh)}(hIncrements the reference count of **file_priv**'s :c:type:`drm_file.master ` and returns the :c:type:`drm_file.master `. If **file_priv** has no :c:type:`drm_file.master `, returns NULL.h](h"Increments the reference count of }(hjhhhNhNubj' )}(h **file_priv**h]h file_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh’s }(hjhhhNhNubh)}(h$:c:type:`drm_file.master `h]j)}(hjh]hdrm_file.master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chM}hjubh and returns the }(hjhhhNhNubh)}(h$:c:type:`drm_file.master `h]j)}(hj$h]hdrm_file.master}(hj&hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_fileuh1hhjhM}hjubh. If }(hjhhhNhNubj' )}(h **file_priv**h]h file_priv}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh has no }(hjhhhNhNubh)}(h$:c:type:`drm_file.master `h]j)}(hjYh]hdrm_file.master}(hj[hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_fileuh1hhjhM}hjubh, returns NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM}hjnubh)}(hZMaster pointers returned from this function should be unreferenced using drm_master_put().h]hZMaster pointers returned from this function should be unreferenced using drm_master_put().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjnubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_master_put (C function)c.drm_master_puthNtauh1j hjhhhNhNubj# )}(hhh](j( )}(h0void drm_master_put (struct drm_master **master)h]j. )}(h/void drm_master_put(struct drm_master **master)h](j4 )}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMubjW )}(hdrm_master_puth]j] )}(hdrm_master_puth]hdrm_master_put}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMubjv )}(h(struct drm_master **master)h]j| )}(hstruct drm_master **masterh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjubh)}(hhh]j] )}(h drm_masterh]h drm_master}(hj hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj modnameN classnameNj j )}j ]j )}j jsbc.drm_master_putasbuh1hhjubjF )}(h h]h }(hj*hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjubj )}(hj h]h*}(hj8hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj )}(hj h]h*}(hjEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj] )}(hmasterh]hmaster}(hjRhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjubah}(h]h ]h"]h$]h&]hhuh1ju hjhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(h&unreference and clear a master pointerh]h&unreference and clear a master pointer}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjyhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j functioneh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhjhNhNubjU )}(h**Parameters** ``struct drm_master **master`` pointer to a pointer of :c:type:`struct drm_master ` **Description** This decrements the :c:type:`drm_master` behind **master** and sets it to NULL.h](h)}(h**Parameters**h]j' )}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjubjs )}(hhh]jx )}(h```struct drm_master **master`` pointer to a pointer of :c:type:`struct drm_master ` h](j~ )}(h``struct drm_master **master``h]j)}(hjh]hstruct drm_master **master}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjubj )}(hhh]h)}(h@pointer to a pointer of :c:type:`struct drm_master `h](hpointer to a pointer of }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubah}(h]h ]h"]h$]h&]uh1jr hjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhjubh)}(hOThis decrements the :c:type:`drm_master` behind **master** and sets it to NULL.h](hThis decrements the }(hj-hhhNhNubh)}(h:c:type:`drm_master`h]j)}(hj7h]h drm_master}(hj9hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:36: ./drivers/gpu/drm/drm_auth.chMhj-ubh behind }(hj-hhhNhNubj' )}(h **master**h]hmaster}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj-ubh and sets it to NULL.}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjThMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_master (C struct) c.drm_masterhNtauh1j hjhhhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhNubj# )}(hhh](j( )}(h drm_masterh]j. )}(hstruct drm_masterh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhKubjW )}(h drm_masterh]j] )}(hjh]h drm_master}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhKubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhKhjhhubj )}(hhh]h)}(hdrm master structureh]hdrm master structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK&hjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhKubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhjhjhNubjU )}(hXB **Definition**:: struct drm_master { struct kref refcount; struct drm_device *dev; char *unique; int unique_len; struct idr magic_map; void *driver_priv; struct drm_master *lessor; int lessee_id; struct list_head lessee_list; struct list_head lessees; struct idr leases; struct idr lessee_idr; }; **Members** ``refcount`` Refcount for this master object. ``dev`` Link back to the DRM device ``unique`` Unique identifier: e.g. busid. Protected by :c:type:`drm_device.master_mutex `. ``unique_len`` Length of unique field. Protected by :c:type:`drm_device.master_mutex `. ``magic_map`` Map of used authentication tokens. Protected by :c:type:`drm_device.master_mutex `. ``driver_priv`` Pointer to driver-private information. ``lessor`` Lease grantor, only set if this :c:type:`struct drm_master ` represents a lessee holding a lease of objects from **lessor**. Full owners of the device have this set to NULL. The lessor does not change once it's set in drm_lease_create(), and each lessee holds a reference to its lessor that it releases upon being destroyed in drm_lease_destroy(). See also the :ref:`section on display resource leasing `. ``lessee_id`` ID for lessees. Owners (i.e. **lessor** is NULL) always have ID 0. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. ``lessee_list`` List entry of lessees of **lessor**, where they are linked to **lessees**. Not used for owners. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. ``lessees`` List of drm_masters leasing from this one. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. This list is empty if no leases have been granted, or if all lessees have been destroyed. Since lessors are referenced by all their lessees, this master cannot be destroyed unless the list is empty. ``leases`` Objects leased to this drm_master. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. Objects are leased all together in drm_lease_create(), and are removed all together when the lease is revoked. ``lessee_idr`` All lessees under this owner (only used where **lessor** is NULL). Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK*hjubh literal_block)}(hXGstruct drm_master { struct kref refcount; struct drm_device *dev; char *unique; int unique_len; struct idr magic_map; void *driver_priv; struct drm_master *lessor; int lessee_id; struct list_head lessee_list; struct list_head lessees; struct idr leases; struct idr lessee_idr; };h]hXGstruct drm_master { struct kref refcount; struct drm_device *dev; char *unique; int unique_len; struct idr magic_map; void *driver_priv; struct drm_master *lessor; int lessee_id; struct list_head lessee_list; struct list_head lessees; struct idr leases; struct idr lessee_idr; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK,hjubh)}(h **Members**h]j' )}(hj$h]hMembers}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj"ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK;hjubjs )}(hhh](jx )}(h.``refcount`` Refcount for this master object. h](j~ )}(h ``refcount``h]j)}(hjCh]hrefcount}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK)hj=ubj )}(hhh]h)}(h Refcount for this master object.h]h Refcount for this master object.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhK)hjYubah}(h]h ]h"]h$]h&]uh1j hj=ubeh}(h]h ]h"]h$]h&]uh1jw hjXhK)hj:ubjx )}(h$``dev`` Link back to the DRM device h](j~ )}(h``dev``h]j)}(hj|h]hdev}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK*hjvubj )}(hhh]h)}(hLink back to the DRM deviceh]hLink back to the DRM device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK*hjubah}(h]h ]h"]h$]h&]uh1j hjvubeh}(h]h ]h"]h$]h&]uh1jw hjhK*hj:ubjx )}(hg``unique`` Unique identifier: e.g. busid. Protected by :c:type:`drm_device.master_mutex `. h](j~ )}(h ``unique``h]j)}(hjh]hunique}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK5hjubj )}(hhh]h)}(h[Unique identifier: e.g. busid. Protected by :c:type:`drm_device.master_mutex `.h](h,Unique identifier: e.g. busid. Protected by }(hjhhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hjh]hdrm_device.master_mutex}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j  drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK4hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK4hjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhK5hj:ubjx )}(hd``unique_len`` Length of unique field. Protected by :c:type:`drm_device.master_mutex `. h](j~ )}(h``unique_len``h]j)}(hjh]h unique_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK:hj ubj )}(hhh]h)}(hTLength of unique field. Protected by :c:type:`drm_device.master_mutex `.h](h%Length of unique field. Protected by }(hj+hhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hj5h]hdrm_device.master_mutex}(hj7hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK9hj+ubh.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjRhK9hj(ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1jw hj'hK:hj:ubjx )}(hn``magic_map`` Map of used authentication tokens. Protected by :c:type:`drm_device.master_mutex `. h](j~ )}(h ``magic_map``h]j)}(hjoh]h magic_map}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK?hjiubj )}(hhh]h)}(h_Map of used authentication tokens. Protected by :c:type:`drm_device.master_mutex `.h](h0Map of used authentication tokens. Protected by }(hjhhhNhNubh)}(h.:c:type:`drm_device.master_mutex `h]j)}(hjh]hdrm_device.master_mutex}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK>hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK>hjubah}(h]h ]h"]h$]h&]uh1j hjiubeh}(h]h ]h"]h$]h&]uh1jw hjhK?hj:ubjx )}(h7``driver_priv`` Pointer to driver-private information. h](j~ )}(h``driver_priv``h]j)}(hjh]h driver_priv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK+hjubj )}(hhh]h)}(h&Pointer to driver-private information.h]h&Pointer to driver-private information.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK+hjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhK+hj:ubjx )}(hX``lessor`` Lease grantor, only set if this :c:type:`struct drm_master ` represents a lessee holding a lease of objects from **lessor**. Full owners of the device have this set to NULL. The lessor does not change once it's set in drm_lease_create(), and each lessee holds a reference to its lessor that it releases upon being destroyed in drm_lease_destroy(). See also the :ref:`section on display resource leasing `. h](j~ )}(h ``lessor``h]j)}(hjh]hlessor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKNhjubj )}(hhh](h)}(hLease grantor, only set if this :c:type:`struct drm_master ` represents a lessee holding a lease of objects from **lessor**. Full owners of the device have this set to NULL.h](h Lease grantor, only set if this }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hj(h]hstruct drm_master}(hj*hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKEhjubh5 represents a lessee holding a lease of objects from }(hjhhhNhNubj' )}(h **lessor**h]hlessor}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh2. Full owners of the device have this set to NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjEhKEhjubh)}(hThe lessor does not change once it's set in drm_lease_create(), and each lessee holds a reference to its lessor that it releases upon being destroyed in drm_lease_destroy().h]hThe lessor does not change once it’s set in drm_lease_create(), and each lessee holds a reference to its lessor that it releases upon being destroyed in drm_lease_destroy().}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKIhjubh)}(hFSee also the :ref:`section on display resource leasing `.h](h See also the }(hjqhhhNhNubh)}(h8:ref:`section on display resource leasing `h]hinline)}(hj{h]h#section on display resource leasing}(hjhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjyubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnj drm_leasinguh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKMhjqubh.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKNhj:ubjx )}(h``lessee_id`` ID for lessees. Owners (i.e. **lessor** is NULL) always have ID 0. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. h](j~ )}(h ``lessee_id``h]j)}(hjh]h lessee_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKVhjubj )}(hhh]h)}(hID for lessees. Owners (i.e. **lessor** is NULL) always have ID 0. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](hID for lessees. Owners (i.e. }(hjhhhNhNubj' )}(h **lessor**h]hlessor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh) is NULL) always have ID 0. Protected by }(hjhhhNhNubh)}(h-:c:type:`drm_device.mode_config `h]j)}(hjh]hdrm_device.mode_config}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKUhjubh’s }(hjhhhNhNubh)}(h5:c:type:`drm_mode_config.idr_mutex `h]j)}(hjh]hdrm_mode_config.idr_mutex}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_configuh1hhj hKUhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj hKUhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKVhj:ubjx )}(h``lessee_list`` List entry of lessees of **lessor**, where they are linked to **lessees**. Not used for owners. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. h](j~ )}(h``lessee_list``h]j)}(hjJh]h lessee_list}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK_hjDubj )}(hhh]h)}(hList entry of lessees of **lessor**, where they are linked to **lessees**. Not used for owners. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](hList entry of lessees of }(hjchhhNhNubj' )}(h **lessor**h]hlessor}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjcubh, where they are linked to }(hjchhhNhNubj' )}(h **lessees**h]hlessees}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjcubh$. Not used for owners. Protected by }(hjchhhNhNubh)}(h-:c:type:`drm_device.mode_config `h]j)}(hjh]hdrm_device.mode_config}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK]hjcubh’s }(hjchhhNhNubh)}(h5:c:type:`drm_mode_config.idr_mutex `h]j)}(hjh]hdrm_mode_config.idr_mutex}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_configuh1hhjhK]hjcubh.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK]hj`ubah}(h]h ]h"]h$]h&]uh1j hjDubeh}(h]h ]h"]h$]h&]uh1jw hj_hK_hj:ubjx )}(hXs``lessees`` List of drm_masters leasing from this one. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. This list is empty if no leases have been granted, or if all lessees have been destroyed. Since lessors are referenced by all their lessees, this master cannot be destroyed unless the list is empty. h](j~ )}(h ``lessees``h]j)}(hjh]hlessees}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKkhjubj )}(hhh](h)}(hList of drm_masters leasing from this one. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](h8List of drm_masters leasing from this one. Protected by }(hjhhhNhNubh)}(h-:c:type:`drm_device.mode_config `h]j)}(hjh]hdrm_device.mode_config}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKfhjubh’s }(hjhhhNhNubh)}(h5:c:type:`drm_mode_config.idr_mutex `h]j)}(hj5h]hdrm_mode_config.idr_mutex}(hj7hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_configuh1hhj.hKfhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj.hKfhjubh)}(hThis list is empty if no leases have been granted, or if all lessees have been destroyed. Since lessors are referenced by all their lessees, this master cannot be destroyed unless the list is empty.h]hThis list is empty if no leases have been granted, or if all lessees have been destroyed. Since lessors are referenced by all their lessees, this master cannot be destroyed unless the list is empty.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKihjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKkhj:ubjx )}(hX``leases`` Objects leased to this drm_master. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `. Objects are leased all together in drm_lease_create(), and are removed all together when the lease is revoked. h](j~ )}(h ``leases``h]j)}(hj}h]hleases}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKvhjwubj )}(hhh](h)}(hObjects leased to this drm_master. Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](h0Objects leased to this drm_master. Protected by }(hjhhhNhNubh)}(h-:c:type:`drm_device.mode_config `h]j)}(hjh]hdrm_device.mode_config}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKrhjubh’s }(hjhhhNhNubh)}(h5:c:type:`drm_mode_config.idr_mutex `h]j)}(hjh]hdrm_mode_config.idr_mutex}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_configuh1hhjhKrhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKrhjubh)}(hnObjects are leased all together in drm_lease_create(), and are removed all together when the lease is revoked.h]hnObjects are leased all together in drm_lease_create(), and are removed all together when the lease is revoked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKuhjubeh}(h]h ]h"]h$]h&]uh1j hjwubeh}(h]h ]h"]h$]h&]uh1jw hjhKvhj:ubjx )}(h``lessee_idr`` All lessees under this owner (only used where **lessor** is NULL). Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](j~ )}(h``lessee_idr``h]j)}(hj h]h lessee_idr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j} hS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK}hjubj )}(hhh]h)}(hAll lessees under this owner (only used where **lessor** is NULL). Protected by :c:type:`drm_device.mode_config `'s :c:type:`drm_mode_config.idr_mutex `.h](h.All lessees under this owner (only used where }(hj%hhhNhNubj' )}(h **lessor**h]hlessor}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj%ubh is NULL). Protected by }(hj%hhhNhNubh)}(h-:c:type:`drm_device.mode_config `h]j)}(hjAh]hdrm_device.mode_config}(hjChhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhj!hK}hj%ubh’s }(hj%hhhNhNubh)}(h5:c:type:`drm_mode_config.idr_mutex `h]j)}(hjdh]hdrm_mode_config.idr_mutex}(hjfhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_configuh1hhj!hK}hj%ubh.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj!hK}hj"ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj!hK}hj:ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjhhhjhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhKhjhhubh)}(hNote that master structures are only relevant for the legacy/primary device nodes, hence there can only be one per device, not one per drm_minor.h]hNote that master structures are only relevant for the legacy/primary device nodes, hence there can only be one per device, not one per drm_minor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:39: ./include/drm/drm_auth.hhK+hjhhubj)}(h.. _drm_leasing:h]h}(h]h ]h"]h$]h&]h݌ drm-leasinguh1jhK+hjhhhhubeh}(h](j}jeh ]h"](,primary nodes, drm master and authenticationdrm_primary_nodeeh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}jjsexpect_referenced_by_id}jjsubh)}(hhh](h)}(hDRM Display Resource Leasingh]hDRM Display Resource Leasing}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhK.ubh)}(hDRM leases provide information about whether a DRM master may control a DRM mode setting object. This enables the creation of multiple DRM masters that manage subsets of display resources.h]hDRM leases provide information about whether a DRM master may control a DRM mode setting object. This enables the creation of multiple DRM masters that manage subsets of display resources.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chKhjhhubh)}(hXIThe original DRM master of a device 'owns' the available drm resources. It may create additional DRM masters and 'lease' resources which it controls to the new DRM master. This gives the new DRM master control over the leased resources until the owner revokes the lease, or the new DRM master is closed. Some helpful terminology:h]hXQThe original DRM master of a device ‘owns’ the available drm resources. It may create additional DRM masters and ‘lease’ resources which it controls to the new DRM master. This gives the new DRM master control over the leased resources until the owner revokes the lease, or the new DRM master is closed. Some helpful terminology:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chKhjhhubj )}(hhh](j%)}(hX2An 'owner' is a :c:type:`struct drm_master ` that is not leasing objects from another :c:type:`struct drm_master `, and hence 'owns' the objects. The owner can be identified as the :c:type:`struct drm_master ` for which :c:type:`drm_master.lessor ` is NULL. h]h)}(hX1An 'owner' is a :c:type:`struct drm_master ` that is not leasing objects from another :c:type:`struct drm_master `, and hence 'owns' the objects. The owner can be identified as the :c:type:`struct drm_master ` for which :c:type:`drm_master.lessor ` is NULL.h](hAn ‘owner’ is a }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hj"h]hstruct drm_master}(hj$hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chKhjubh* that is not leasing objects from another }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjFh]hstruct drm_master}(hjHhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhj?hKhjubhG, and hence ‘owns’ the objects. The owner can be identified as the }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjih]hstruct drm_master}(hjkhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhj?hKhjubh for which }(hjhhhNhNubh)}(h(:c:type:`drm_master.lessor `h]j)}(hjh]hdrm_master.lessor}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhj?hKhjubh is NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj?hKhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hA 'lessor' is a :c:type:`struct drm_master ` which is leasing objects to one or more other :c:type:`struct drm_master `. Currently, lessees are not allowed to create sub-leases, hence the lessor is the same as the owner. h]h)}(hA 'lessor' is a :c:type:`struct drm_master ` which is leasing objects to one or more other :c:type:`struct drm_master `. Currently, lessees are not allowed to create sub-leases, hence the lessor is the same as the owner.h](hA ‘lessor’ is a }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK!hjubh/ which is leasing objects to one or more other }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjhK!hjubhe. Currently, lessees are not allowed to create sub-leases, hence the lessor is the same as the owner.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK!hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hXVA 'lessee' is a :c:type:`struct drm_master ` which is leasing objects from some other :c:type:`struct drm_master `. Each lessee only leases resources from a single lessor recorded in :c:type:`drm_master.lessor `, and holds the set of objects that it is leasing in :c:type:`drm_master.leases `. h]h)}(hXUA 'lessee' is a :c:type:`struct drm_master ` which is leasing objects from some other :c:type:`struct drm_master `. Each lessee only leases resources from a single lessor recorded in :c:type:`drm_master.lessor `, and holds the set of objects that it is leasing in :c:type:`drm_master.leases `.h](hA ‘lessee’ is a }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hj&h]hstruct drm_master}(hj(hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK%hjubh* which is leasing objects from some other }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjJh]hstruct drm_master}(hjLhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjChK%hjubhE. Each lessee only leases resources from a single lessor recorded in }(hjhhhNhNubh)}(h(:c:type:`drm_master.lessor `h]j)}(hjmh]hdrm_master.lessor}(hjohhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjChK%hjubh5, and holds the set of objects that it is leasing in }(hjhhhNhNubh)}(h(:c:type:`drm_master.leases `h]j)}(hjh]hdrm_master.leases}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjChK%hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjChK%hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hXA 'lease' is a contract between the lessor and lessee that identifies which resources may be controlled by the lessee. All of the resources that are leased must be owned by or leased to the lessor, and lessors are not permitted to lease the same object to multiple lessees. h]h)}(hXA 'lease' is a contract between the lessor and lessee that identifies which resources may be controlled by the lessee. All of the resources that are leased must be owned by or leased to the lessor, and lessors are not permitted to lease the same object to multiple lessees.h]hXA ‘lease’ is a contract between the lessor and lessee that identifies which resources may be controlled by the lessee. All of the resources that are leased must be owned by or leased to the lessor, and lessors are not permitted to lease the same object to multiple lessees.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK*hjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]jjuh1jhj?hKhjhhubh)}(hThe set of objects any :c:type:`struct drm_master ` 'controls' is limited to the set of objects it leases (for lessees) or all objects (for owners).h](hThe set of objects any }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK/hjubhe ‘controls’ is limited to the set of objects it leases (for lessees) or all objects (for owners).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK/hjhhubh)}(hXSObjects not controlled by a :c:type:`struct drm_master ` cannot be modified through the various state manipulating ioctls, and any state reported back to user space will be edited to make them appear idle and/or unusable. For instance, connectors always report 'disconnected', while encoders report no possible crtcs or clones.h](hObjects not controlled by a }(hjhhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK2hjubhX cannot be modified through the various state manipulating ioctls, and any state reported back to user space will be edited to make them appear idle and/or unusable. For instance, connectors always report ‘disconnected’, while encoders report no possible crtcs or clones.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj5hK2hjhhubh)}(hXSince each lessee may lease objects from a single lessor, display resource leases form a tree of :c:type:`struct drm_master `. As lessees are currently not allowed to create sub-leases, the tree depth is limited to 1. All of these get activated simultaneously when the top level device owner changes through the SETMASTER or DROPMASTER IOCTL, so :c:type:`drm_device.master ` points to the owner at the top of the lease tree (i.e. the :c:type:`struct drm_master ` for which :c:type:`drm_master.lessor ` is NULL). The full list of lessees that are leasing objects from the owner can be searched via the owner's :c:type:`drm_master.lessee_idr `.h](haSince each lessee may lease objects from a single lessor, display resource leases form a tree of }(hj@hhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjJh]hstruct drm_master}(hjLhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhX/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:48: ./drivers/gpu/drm/drm_lease.chK8hj@ubh. As lessees are currently not allowed to create sub-leases, the tree depth is limited to 1. All of these get activated simultaneously when the top level device owner changes through the SETMASTER or DROPMASTER IOCTL, so }(hj@hhhNhNubh)}(h(:c:type:`drm_device.master `h]j)}(hjnh]hdrm_device.master}(hjphhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhjghK8hj@ubh< points to the owner at the top of the lease tree (i.e. the }(hj@hhhNhNubh)}(h(:c:type:`struct drm_master `h]j)}(hjh]hstruct drm_master}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjghK8hj@ubh for which }(hj@hhhNhNubh)}(h(:c:type:`drm_master.lessor `h]j)}(hjh]hdrm_master.lessor}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjghK8hj@ubhn is NULL). The full list of lessees that are leasing objects from the owner can be searched via the owner’s }(hj@hhhNhNubh)}(h,:c:type:`drm_master.lessee_idr `h]j)}(hjh]hdrm_master.lessee_idr}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_masteruh1hhjghK8hj@ubh.}(hj@hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjghK8hjhhubeh}(h](jjeh ]h"](drm display resource leasing drm_leasingeh$]h&]uh1hhhhhhhhK.j}jjsj}jjsubh)}(hhh](h)}(h"Open-Source Userspace Requirementsh]h"Open-Source Userspace Requirements}(hj hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhK4ubh)}(hThe DRM subsystem has stricter requirements than most other kernel subsystems on what the userspace side for new uAPI needs to look like. This section here explains what exactly those requirements are, and why they exist.h]hThe DRM subsystem has stricter requirements than most other kernel subsystems on what the userspace side for new uAPI needs to look like. This section here explains what exactly those requirements are, and why they exist.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubh)}(hThe short summary is that any addition of DRM uAPI requires corresponding open-sourced userspace patches, and those patches must be reviewed and ready for merging into a suitable and canonical upstream project.h]hThe short summary is that any addition of DRM uAPI requires corresponding open-sourced userspace patches, and those patches must be reviewed and ready for merging into a suitable and canonical upstream project.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjhhubh)}(hXXGFX devices (both display and render/GPU side) are really complex bits of hardware, with userspace and kernel by necessity having to work together really closely. The interfaces, for rendering and modesetting, must be extremely wide and flexible, and therefore it is almost always impossible to precisely define them for every possible corner case. This in turn makes it really practically infeasible to differentiate between behaviour that's required by userspace, and which must not be changed to avoid regressions, and behaviour which is only an accidental artifact of the current implementation.h]hXZGFX devices (both display and render/GPU side) are really complex bits of hardware, with userspace and kernel by necessity having to work together really closely. The interfaces, for rendering and modesetting, must be extremely wide and flexible, and therefore it is almost always impossible to precisely define them for every possible corner case. This in turn makes it really practically infeasible to differentiate between behaviour that’s required by userspace, and which must not be changed to avoid regressions, and behaviour which is only an accidental artifact of the current implementation.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjhhubh)}(hXeWithout access to the full source code of all userspace users that means it becomes impossible to change the implementation details, since userspace could depend upon the accidental behaviour of the current implementation in minute details. And debugging such regressions without access to source code is pretty much impossible. As a consequence this means:h]hXeWithout access to the full source code of all userspace users that means it becomes impossible to change the implementation details, since userspace could depend upon the accidental behaviour of the current implementation in minute details. And debugging such regressions without access to source code is pretty much impossible. As a consequence this means:}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjhhubj )}(hhh](j%)}(hX~The Linux kernel's "no regression" policy holds in practice only for open-source userspace of the DRM subsystem. DRM developers are perfectly fine if closed-source blob drivers in userspace use the same uAPI as the open drivers, but they must do so in the exact same way as the open drivers. Creative (ab)use of the interfaces will, and in the past routinely has, lead to breakage. h]h)}(hX}The Linux kernel's "no regression" policy holds in practice only for open-source userspace of the DRM subsystem. DRM developers are perfectly fine if closed-source blob drivers in userspace use the same uAPI as the open drivers, but they must do so in the exact same way as the open drivers. Creative (ab)use of the interfaces will, and in the past routinely has, lead to breakage.h]hXThe Linux kernel’s “no regression” policy holds in practice only for open-source userspace of the DRM subsystem. DRM developers are perfectly fine if closed-source blob drivers in userspace use the same uAPI as the open drivers, but they must do so in the exact same way as the open drivers. Creative (ab)use of the interfaces will, and in the past routinely has, lead to breakage.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjTubah}(h]h ]h"]h$]h&]uh1j$hjQhhhhhNubj%)}(h^Any new userspace interface must have an open-source implementation as demonstration vehicle. h]h)}(h]Any new userspace interface must have an open-source implementation as demonstration vehicle.h]h]Any new userspace interface must have an open-source implementation as demonstration vehicle.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjlubah}(h]h ]h"]h$]h&]uh1j$hjQhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhKMhjhhubh)}(hX`The other reason for requiring open-source userspace is uAPI review. Since the kernel and userspace parts of a GFX stack must work together so closely, code review can only assess whether a new interface achieves its goals by looking at both sides. Making sure that the interface indeed covers the use-case fully leads to a few additional requirements:h]hX`The other reason for requiring open-source userspace is uAPI review. Since the kernel and userspace parts of a GFX stack must work together so closely, code review can only assess whether a new interface achieves its goals by looking at both sides. Making sure that the interface indeed covers the use-case fully leads to a few additional requirements:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjhhubj )}(hhh](j%)}(hXThe open-source userspace must not be a toy/test application, but the real thing. Specifically it needs to handle all the usual error and corner cases. These are often the places where new uAPI falls apart and hence essential to assess the fitness of a proposed interface. h]h)}(hXThe open-source userspace must not be a toy/test application, but the real thing. Specifically it needs to handle all the usual error and corner cases. These are often the places where new uAPI falls apart and hence essential to assess the fitness of a proposed interface.h]hXThe open-source userspace must not be a toy/test application, but the real thing. Specifically it needs to handle all the usual error and corner cases. These are often the places where new uAPI falls apart and hence essential to assess the fitness of a proposed interface.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hXThe userspace side must be fully reviewed and tested to the standards of that userspace project. For e.g. mesa this means piglit testcases and review on the mailing list. This is again to ensure that the new interface actually gets the job done. The userspace-side reviewer should also provide an Acked-by on the kernel uAPI patch indicating that they believe the proposed uAPI is sound and sufficiently documented and validated for userspace's consumption. h]h)}(hXThe userspace side must be fully reviewed and tested to the standards of that userspace project. For e.g. mesa this means piglit testcases and review on the mailing list. This is again to ensure that the new interface actually gets the job done. The userspace-side reviewer should also provide an Acked-by on the kernel uAPI patch indicating that they believe the proposed uAPI is sound and sufficiently documented and validated for userspace's consumption.h]hXThe userspace side must be fully reviewed and tested to the standards of that userspace project. For e.g. mesa this means piglit testcases and review on the mailing list. This is again to ensure that the new interface actually gets the job done. The userspace-side reviewer should also provide an Acked-by on the kernel uAPI patch indicating that they believe the proposed uAPI is sound and sufficiently documented and validated for userspace’s consumption.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hThe userspace patches must be against the canonical upstream, not some vendor fork. This is to make sure that no one cheats on the review and testing requirements by doing a quick fork. h]h)}(hThe userspace patches must be against the canonical upstream, not some vendor fork. This is to make sure that no one cheats on the review and testing requirements by doing a quick fork.h]hThe userspace patches must be against the canonical upstream, not some vendor fork. This is to make sure that no one cheats on the review and testing requirements by doing a quick fork.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hX2The kernel patch can only be merged after all the above requirements are met, but it **must** be merged to either drm-next or drm-misc-next **before** the userspace patches land. uAPI always flows from the kernel, doing things the other way round risks divergence of the uAPI definitions and header files. h]h)}(hX1The kernel patch can only be merged after all the above requirements are met, but it **must** be merged to either drm-next or drm-misc-next **before** the userspace patches land. uAPI always flows from the kernel, doing things the other way round risks divergence of the uAPI definitions and header files.h](hUThe kernel patch can only be merged after all the above requirements are met, but it }(hjhhhNhNubj' )}(h**must**h]hmust}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh/ be merged to either drm-next or drm-misc-next }(hjhhhNhNubj' )}(h **before**h]hbefore}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh the userspace patches land. uAPI always flows from the kernel, doing things the other way round risks divergence of the uAPI definitions and header files.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKmhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhK]hjhhubh)}(hXVThese are fairly steep requirements, but have grown out from years of shared pain and experience with uAPI added hastily, and almost always regretted about just as fast. GFX devices change really fast, requiring a paradigm shift and entire new set of uAPI interfaces every few years at least. Together with the Linux kernel's guarantee to keep existing userspace running for 10+ years this is already rather painful for the DRM subsystem, with multiple different uAPIs for the same thing co-existing. If we add a few more complete mistakes into the mix every year it would be entirely unmanageable.h]hXXThese are fairly steep requirements, but have grown out from years of shared pain and experience with uAPI added hastily, and almost always regretted about just as fast. GFX devices change really fast, requiring a paradigm shift and entire new set of uAPI interfaces every few years at least. Together with the Linux kernel’s guarantee to keep existing userspace running for 10+ years this is already rather painful for the DRM subsystem, with multiple different uAPIs for the same thing co-existing. If we add a few more complete mistakes into the mix every year it would be entirely unmanageable.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjhhubh)}(hThe DRM subsystem has however no concern with independent closed-source userspace implementations. To officialize that position, the DRM uAPI headers are covered by the MIT license.h]hThe DRM subsystem has however no concern with independent closed-source userspace implementations. To officialize that position, the DRM uAPI headers are covered by the MIT license.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjhhubj)}(h.. _drm_render_node:h]h}(h]h ]h"]h$]h&]h݌drm-render-nodeuh1jhKhjhhhhubeh}(h]jah ]h"]"open-source userspace requirementsah$]h&]uh1hhhhhhhhK4ubh)}(hhh](h)}(h Render nodesh]h Render nodes}(hjVhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjShhhhhKubh)}(hXBDRM core provides multiple character-devices for user-space to use. Depending on which device is opened, user-space can perform a different set of operations (mainly ioctls). The primary node is always created and called card. Additionally, a currently unused control node, called controlD is also created. The primary node provides all legacy operations and historically was the only interface used by userspace. With KMS, the control node was introduced. However, the planned KMS control interface has never been written and so the control node stays unused to date.h]hXBDRM core provides multiple character-devices for user-space to use. Depending on which device is opened, user-space can perform a different set of operations (mainly ioctls). The primary node is always created and called card. Additionally, a currently unused control node, called controlD is also created. The primary node provides all legacy operations and historically was the only interface used by userspace. With KMS, the control node was introduced. However, the planned KMS control interface has never been written and so the control node stays unused to date.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubh)}(hXWith the increased use of offscreen renderers and GPGPU applications, clients no longer require running compositors or graphics servers to make use of a GPU. But the DRM API required unprivileged clients to authenticate to a DRM-Master prior to getting GPU access. To avoid this step and to grant clients GPU access without authenticating, render nodes were introduced. Render nodes solely serve render clients, that is, no modesetting or privileged ioctls can be issued on render nodes. Only non-global rendering commands are allowed. If a driver supports render nodes, it must advertise it via the DRIVER_RENDER DRM driver capability. If not supported, the primary node must be used for render clients together with the legacy drmAuth authentication procedure.h]hXWith the increased use of offscreen renderers and GPGPU applications, clients no longer require running compositors or graphics servers to make use of a GPU. But the DRM API required unprivileged clients to authenticate to a DRM-Master prior to getting GPU access. To avoid this step and to grant clients GPU access without authenticating, render nodes were introduced. Render nodes solely serve render clients, that is, no modesetting or privileged ioctls can be issued on render nodes. Only non-global rendering commands are allowed. If a driver supports render nodes, it must advertise it via the DRIVER_RENDER DRM driver capability. If not supported, the primary node must be used for render clients together with the legacy drmAuth authentication procedure.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubh)}(hX If a driver advertises render node support, DRM core will create a separate render node called renderD. There will be one render node per device. No ioctls except PRIME-related ioctls will be allowed on this node. Especially GEM_OPEN will be explicitly prohibited. For a complete list of driver-independent ioctls that can be used on render nodes, see the ioctls marked DRM_RENDER_ALLOW in drm_ioctl.c Render nodes are designed to avoid the buffer-leaks, which occur if clients guess the flink names or mmap offsets on the legacy interface. Additionally to this basic interface, drivers must mark their driver-dependent render-only ioctls as DRM_RENDER_ALLOW so render clients can use them. Driver authors must be careful not to allow any privileged ioctls on render nodes.h]hX If a driver advertises render node support, DRM core will create a separate render node called renderD. There will be one render node per device. No ioctls except PRIME-related ioctls will be allowed on this node. Especially GEM_OPEN will be explicitly prohibited. For a complete list of driver-independent ioctls that can be used on render nodes, see the ioctls marked DRM_RENDER_ALLOW in drm_ioctl.c Render nodes are designed to avoid the buffer-leaks, which occur if clients guess the flink names or mmap offsets on the legacy interface. Additionally to this basic interface, drivers must mark their driver-dependent render-only ioctls as DRM_RENDER_ALLOW so render clients can use them. Driver authors must be careful not to allow any privileged ioctls on render nodes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubh)}(hXWith render nodes, user-space can now control access to the render node via basic file-system access-modes. A running graphics server which authenticates clients on the privileged primary/legacy node is no longer required. Instead, a client can open the render node and is immediately granted GPU access. Communication between clients (or servers) is done via PRIME. FLINK from render node to legacy node is not supported. New clients must not use the insecure FLINK interface.h]hXWith render nodes, user-space can now control access to the render node via basic file-system access-modes. A running graphics server which authenticates clients on the privileged primary/legacy node is no longer required. Instead, a client can open the render node and is immediately granted GPU access. Communication between clients (or servers) is done via PRIME. FLINK from render node to legacy node is not supported. New clients must not use the insecure FLINK interface.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubh)}(hX Besides dropping all modeset/global ioctls, render nodes also drop the DRM-Master concept. There is no reason to associate render clients with a DRM-Master as they are independent of any graphics server. Besides, they must work without any running master, anyway. Drivers must be able to run without a master object if they support render nodes. If, on the other hand, a driver requires shared state between clients which is visible to user-space and accessible beyond open-file boundaries, they cannot support render nodes.h]hX Besides dropping all modeset/global ioctls, render nodes also drop the DRM-Master concept. There is no reason to associate render clients with a DRM-Master as they are independent of any graphics server. Besides, they must work without any running master, anyway. Drivers must be able to run without a master object if they support render nodes. If, on the other hand, a driver requires shared state between clients which is visible to user-space and accessible beyond open-file boundaries, they cannot support render nodes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubeh}(h](jjKeh ]h"]( render nodesdrm_render_nodeeh$]h&]uh1hhhhhhhhKj}jjAsj}jKjAsubh)}(hhh](h)}(hDevice Hot-Unplugh]hDevice Hot-Unplug}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhKubhnote)}(hFThe following is the plan. Implementation is not there yet (2020 May).h]h)}(hFThe following is the plan. Implementation is not there yet (2020 May).h]hFThe following is the plan. Implementation is not there yet (2020 May).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hXGraphics devices (display and/or render) may be connected via USB (e.g. display adapters or docking stations) or Thunderbolt (e.g. eGPU). An end user is able to hot-unplug this kind of devices while they are being used, and expects that the very least the machine does not crash. Any damage from hot-unplugging a DRM device needs to be limited as much as possible and userspace must be given the chance to handle it if it wants to. Ideally, unplugging a DRM device still lets a desktop continue to run, but that is going to need explicit support throughout the whole graphics stack: from kernel and userspace drivers, through display servers, via window system protocols, and in applications and libraries.h]hXGraphics devices (display and/or render) may be connected via USB (e.g. display adapters or docking stations) or Thunderbolt (e.g. eGPU). An end user is able to hot-unplug this kind of devices while they are being used, and expects that the very least the machine does not crash. Any damage from hot-unplugging a DRM device needs to be limited as much as possible and userspace must be given the chance to handle it if it wants to. Ideally, unplugging a DRM device still lets a desktop continue to run, but that is going to need explicit support throughout the whole graphics stack: from kernel and userspace drivers, through display servers, via window system protocols, and in applications and libraries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hOther scenarios that should lead to the same are: unrecoverable GPU crash, PCI device disappearing off the bus, or forced unbind of a driver from the physical device.h]hOther scenarios that should lead to the same are: unrecoverable GPU crash, PCI device disappearing off the bus, or forced unbind of a driver from the physical device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXoIn other words, from userspace perspective everything needs to keep on working more or less, until userspace stops using the disappeared DRM device and closes it completely. Userspace will learn of the device disappearance from the device removed uevent, ioctls returning ENODEV (or driver-specific ioctls returning driver-specific things), or open() returning ENXIO.h]hXoIn other words, from userspace perspective everything needs to keep on working more or less, until userspace stops using the disappeared DRM device and closes it completely. Userspace will learn of the device disappearance from the device removed uevent, ioctls returning ENODEV (or driver-specific ioctls returning driver-specific things), or open() returning ENXIO.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXOnly after userspace has closed all relevant DRM device and dmabuf file descriptors and removed all mmaps, the DRM driver can tear down its instance for the device that no longer exists. If the same physical device somehow comes back in the mean time, it shall be a new DRM device.h]hXOnly after userspace has closed all relevant DRM device and dmabuf file descriptors and removed all mmaps, the DRM driver can tear down its instance for the device that no longer exists. If the same physical device somehow comes back in the mean time, it shall be a new DRM device.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hSimilar to PIDs, chardev minor numbers are not recycled immediately. A new DRM device always picks the next free minor number compared to the previous one allocated, and wraps around when minor numbers are exhausted.h]hSimilar to PIDs, chardev minor numbers are not recycled immediately. A new DRM device always picks the next free minor number compared to the previous one allocated, and wraps around when minor numbers are exhausted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hOThe goal raises at least the following requirements for the kernel and drivers.h]hOThe goal raises at least the following requirements for the kernel and drivers.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hRequirements for KMS UAPIh]hRequirements for KMS UAPI}(hj6hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj3hhhhhKubj )}(hhh](j%)}(h9KMS connectors must change their status to disconnected. h]h)}(h8KMS connectors must change their status to disconnected.h]h8KMS connectors must change their status to disconnected.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjGubah}(h]h ]h"]h$]h&]uh1j$hjDhhhhhNubj%)}(hLegacy modesets and pageflips, and atomic commits, both real and TEST_ONLY, and any other ioctls either fail with ENODEV or fake success. h]h)}(hLegacy modesets and pageflips, and atomic commits, both real and TEST_ONLY, and any other ioctls either fail with ENODEV or fake success.h]hLegacy modesets and pageflips, and atomic commits, both real and TEST_ONLY, and any other ioctls either fail with ENODEV or fake success.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj_ubah}(h]h ]h"]h$]h&]uh1j$hjDhhhhhNubj%)}(hPending non-blocking KMS operations deliver the DRM events userspace is expecting. This applies also to ioctls that faked success. h]h)}(hPending non-blocking KMS operations deliver the DRM events userspace is expecting. This applies also to ioctls that faked success.h]hPending non-blocking KMS operations deliver the DRM events userspace is expecting. This applies also to ioctls that faked success.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjwubah}(h]h ]h"]h$]h&]uh1j$hjDhhhhhNubj%)}(hVopen() on a device node whose underlying device has disappeared will fail with ENXIO. h]h)}(hUopen() on a device node whose underlying device has disappeared will fail with ENXIO.h]hUopen() on a device node whose underlying device has disappeared will fail with ENXIO.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjDhhhhhNubj%)}(hAttempting to create a DRM lease on a disappeared DRM device will fail with ENODEV. Existing DRM leases remain and work as listed above. h]h)}(hAttempting to create a DRM lease on a disappeared DRM device will fail with ENODEV. Existing DRM leases remain and work as listed above.h]hAttempting to create a DRM lease on a disappeared DRM device will fail with ENODEV. Existing DRM leases remain and work as listed above.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjDhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhj3hhubeh}(h]j$ah ]h"]requirements for kms uapiah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h-Requirements for Render and Cross-Device UAPIh]h-Requirements for Render and Cross-Device UAPI}(hjhhhNhNubah}(h]h ]h"]h$]h&]hj@uh1hhjhhhhhKubj )}(hhh](j%)}(hAll GPU jobs that can no longer run must have their fences force-signalled to avoid inflicting hangs on userspace. The associated error code is ENODEV. h]h)}(hAll GPU jobs that can no longer run must have their fences force-signalled to avoid inflicting hangs on userspace. The associated error code is ENODEV.h]hAll GPU jobs that can no longer run must have their fences force-signalled to avoid inflicting hangs on userspace. The associated error code is ENODEV.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hXaSome userspace APIs already define what should happen when the device disappears (OpenGL, GL ES: `GL_KHR_robustness`_; `Vulkan`_: VK_ERROR_DEVICE_LOST; etc.). DRM drivers are free to implement this behaviour the way they see best, e.g. returning failures in driver-specific ioctls and handling those in userspace drivers, or rely on uevents, and so on. h]h)}(hX`Some userspace APIs already define what should happen when the device disappears (OpenGL, GL ES: `GL_KHR_robustness`_; `Vulkan`_: VK_ERROR_DEVICE_LOST; etc.). DRM drivers are free to implement this behaviour the way they see best, e.g. returning failures in driver-specific ioctls and handling those in userspace drivers, or rely on uevents, and so on.h](haSome userspace APIs already define what should happen when the device disappears (OpenGL, GL ES: }(hjhhhNhNubj-)}(h`GL_KHR_robustness`_h]hGL_KHR_robustness}(hjhhhNhNubah}(h]h ]h"]h$]h&]nameGL_KHR_robustnessrefuriIhttps://www.khronos.org/registry/OpenGL/extensions/KHR/KHR_robustness.txtuh1j,hjresolvedKubh; }(hjhhhNhNubj-)}(h `Vulkan`_h]hVulkan}(hjhhhNhNubah}(h]h ]h"]h$]h&]nameVulkanjhttps://www.khronos.org/vulkan/uh1j,hjjKubh: VK_ERROR_DEVICE_LOST; etc.). DRM drivers are free to implement this behaviour the way they see best, e.g. returning failures in driver-specific ioctls and handling those in userspace drivers, or rely on uevents, and so on.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hdmabuf which point to memory that has disappeared will either fail to import with ENODEV or continue to be successfully imported if it would have succeeded before the disappearance. See also about memory maps below for already imported dmabufs. h]h)}(hdmabuf which point to memory that has disappeared will either fail to import with ENODEV or continue to be successfully imported if it would have succeeded before the disappearance. See also about memory maps below for already imported dmabufs.h]hdmabuf which point to memory that has disappeared will either fail to import with ENODEV or continue to be successfully imported if it would have succeeded before the disappearance. See also about memory maps below for already imported dmabufs.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj<ubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hAttempting to import a dmabuf to a disappeared device will either fail with ENODEV or succeed if it would have succeeded without the disappearance. h]h)}(hAttempting to import a dmabuf to a disappeared device will either fail with ENODEV or succeed if it would have succeeded without the disappearance.h]hAttempting to import a dmabuf to a disappeared device will either fail with ENODEV or succeed if it would have succeeded without the disappearance.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjTubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hVopen() on a device node whose underlying device has disappeared will fail with ENXIO. h]h)}(hUopen() on a device node whose underlying device has disappeared will fail with ENXIO.h]hUopen() on a device node whose underlying device has disappeared will fail with ENXIO.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjlubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubj)}(h`.. _GL_KHR_robustness: https://www.khronos.org/registry/OpenGL/extensions/KHR/KHR_robustness.txth]h}(h]gl-khr-robustnessah ]h"]gl_khr_robustnessah$]h&]jjuh1jhMhjhhhhnj referencedKubj)}(h+.. _Vulkan: https://www.khronos.org/vulkan/h]h}(h]vulkanah ]h"]vulkanah$]h&]jj+uh1jhMhjhhhhjKubeh}(h]jFah ]h"]-requirements for render and cross-device uapiah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hRequirements for Memory Mapsh]hRequirements for Memory Maps}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjbuh1hhjhhhhhMubh)}(hXMemory maps have further requirements that apply to both existing maps and maps created after the device has disappeared. If the underlying memory disappears, the map is created or modified such that reads and writes will still complete successfully but the result is undefined. This applies to both userspace mmap()'d memory and memory pointed to by dmabuf which might be mapped to other devices (cross-device dmabuf imports).h]hXMemory maps have further requirements that apply to both existing maps and maps created after the device has disappeared. If the underlying memory disappears, the map is created or modified such that reads and writes will still complete successfully but the result is undefined. This applies to both userspace mmap()’d memory and memory pointed to by dmabuf which might be mapped to other devices (cross-device dmabuf imports).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hXRaising SIGBUS is not an option, because userspace cannot realistically handle it. Signal handlers are global, which makes them extremely difficult to use correctly from libraries like those that Mesa produces. Signal handlers are not composable, you can't have different handlers for GPU1 and GPU2 from different vendors, and a third handler for mmapped regular files. Threads cause additional pain with signal handling as well.h]hXRaising SIGBUS is not an option, because userspace cannot realistically handle it. Signal handlers are global, which makes them extremely difficult to use correctly from libraries like those that Mesa produces. Signal handlers are not composable, you can’t have different handlers for GPU1 and GPU2 from different vendors, and a third handler for mmapped regular files. Threads cause additional pain with signal handling as well.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]jhah ]h"]requirements for memory mapsah$]h&]uh1hhjhhhhhMubeh}(h]jah ]h"]device hot-unplugah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Device reseth]h Device reset}(hjhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjhhhhhM'ubh)}(hX^The GPU stack is really complex and is prone to errors, from hardware bugs, faulty applications and everything in between the many layers. Some errors require resetting the device in order to make the device usable again. This section describes the expectations for DRM and usermode drivers when a device resets and how to propagate the reset status.h]hX^The GPU stack is really complex and is prone to errors, from hardware bugs, faulty applications and everything in between the many layers. Some errors require resetting the device in order to make the device usable again. This section describes the expectations for DRM and usermode drivers when a device resets and how to propagate the reset status.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hjhhubh)}(hXDevice resets can not be disabled without tainting the kernel, which can lead to hanging the entire kernel through shrinkers/mmu_notifiers. Userspace role in device resets is to propagate the message to the application and apply any special policy for blocking guilty applications, if any. Corollary is that debugging a hung GPU context require hardware support to be able to preempt such a GPU context while it's stopped.h]hXDevice resets can not be disabled without tainting the kernel, which can lead to hanging the entire kernel through shrinkers/mmu_notifiers. Userspace role in device resets is to propagate the message to the application and apply any special policy for blocking guilty applications, if any. Corollary is that debugging a hung GPU context require hardware support to be able to preempt such a GPU context while it’s stopped.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM/hjhhubh)}(hhh](h)}(hKernel Mode Driverh]hKernel Mode Driver}(hj hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj hhhhhM7ubh)}(hThe KMD is responsible for checking if the device needs a reset, and to perform it as needed. Usually a hang is detected when a job gets stuck executing.h]hThe KMD is responsible for checking if the device needs a reset, and to perform it as needed. Usually a hang is detected when a job gets stuck executing.}(hj# hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hj hhubh)}(hXPropagation of errors to userspace has proven to be tricky since it goes in the opposite direction of the usual flow of commands. Because of this vendor independent error handling was added to the &dma_fence object, this way drivers can add an error code to their fences before signaling them. See function dma_fence_set_error() on how to do this and for examples of error codes to use.h]hXPropagation of errors to userspace has proven to be tricky since it goes in the opposite direction of the usual flow of commands. Because of this vendor independent error handling was added to the &dma_fence object, this way drivers can add an error code to their fences before signaling them. See function dma_fence_set_error() on how to do this and for examples of error codes to use.}(hj1 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM<hj hhubh)}(hXThe DRM scheduler also allows setting error codes on all pending fences when hardware submissions are restarted after an reset. Error codes are also forwarded from the hardware fence to the scheduler fence to bubble up errors to the higher levels of the stack and eventually userspace.h]hXThe DRM scheduler also allows setting error codes on all pending fences when hardware submissions are restarted after an reset. Error codes are also forwarded from the hardware fence to the scheduler fence to bubble up errors to the higher levels of the stack and eventually userspace.}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhj hhubh)}(hFence errors can be queried by userspace through the generic SYNC_IOC_FILE_INFO IOCTL as well as through driver specific interfaces.h]hFence errors can be queried by userspace through the generic SYNC_IOC_FILE_INFO IOCTL as well as through driver specific interfaces.}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhj hhubh)}(hXAdditional to setting fence errors drivers should also keep track of resets per context, the DRM scheduler provides the drm_sched_entity_error() function as helper for this use case. After a reset, KMD should reject new command submissions for affected contexts.h]hXAdditional to setting fence errors drivers should also keep track of resets per context, the DRM scheduler provides the drm_sched_entity_error() function as helper for this use case. After a reset, KMD should reject new command submissions for affected contexts.}(hj[ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMJhj hhubeh}(h]jah ]h"]kernel mode driverah$]h&]uh1hhjhhhhhM7ubh)}(hhh](h)}(hUser Mode Driverh]hUser Mode Driver}(hjs hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjp hhhhhMPubh)}(hXAfter command submission, UMD should check if the submission was accepted or rejected. After a reset, KMD should reject submissions, and UMD can issue an ioctl to the KMD to check the reset status, and this can be checked more often if the UMD requires it. After detecting a reset, UMD will then proceed to report it to the application using the appropriate API error code, as explained in the section below about robustness.h]hXAfter command submission, UMD should check if the submission was accepted or rejected. After a reset, KMD should reject submissions, and UMD can issue an ioctl to the KMD to check the reset status, and this can be checked more often if the UMD requires it. After detecting a reset, UMD will then proceed to report it to the application using the appropriate API error code, as explained in the section below about robustness.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMRhjp hhubeh}(h]jah ]h"]user mode driverah$]h&]uh1hhjhhhhhMPubh)}(hhh](h)}(h Robustnessh]h Robustness}(hj hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj hhhhhMZubh)}(hThe only way to try to keep a graphical API context working after a reset is if it complies with the robustness aspects of the graphical API that it is using.h]hThe only way to try to keep a graphical API context working after a reset is if it complies with the robustness aspects of the graphical API that it is using.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM\hj hhubh)}(hXGraphical APIs provide ways to applications to deal with device resets. However, there is no guarantee that the app will use such features correctly, and a userspace that doesn't support robust interfaces (like a non-robust OpenGL context or API without any robustness support like libva) leave the robustness handling entirely to the userspace driver. There is no strong community consensus on what the userspace driver should do in that case, since all reasonable approaches have some clear downsides.h]hXGraphical APIs provide ways to applications to deal with device resets. However, there is no guarantee that the app will use such features correctly, and a userspace that doesn’t support robust interfaces (like a non-robust OpenGL context or API without any robustness support like libva) leave the robustness handling entirely to the userspace driver. There is no strong community consensus on what the userspace driver should do in that case, since all reasonable approaches have some clear downsides.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM_hj hhubh)}(hhh](h)}(hOpenGLh]hOpenGL}(hj hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj hhhhhMhubh)}(hX`Apps using OpenGL should use the available robust interfaces, like the extension ``GL_ARB_robustness`` (or ``GL_EXT_robustness`` for OpenGL ES). This interface tells if a reset has happened, and if so, all the context state is considered lost and the app proceeds by creating new ones. There's no consensus on what to do to if robustness is not in use.h](hQApps using OpenGL should use the available robust interfaces, like the extension }(hj hhhNhNubj)}(h``GL_ARB_robustness``h]hGL_ARB_robustness}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh (or }(hj hhhNhNubj)}(h``GL_EXT_robustness``h]hGL_EXT_robustness}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh for OpenGL ES). This interface tells if a reset has happened, and if so, all the context state is considered lost and the app proceeds by creating new ones. There’s no consensus on what to do to if robustness is not in use.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMjhj hhubeh}(h]jah ]h"]openglah$]h&]uh1hhj hhhhhMhubh)}(hhh](h)}(hVulkanh]hVulkan}(hj!hhhNhNubah}(h]h ]h"]h$]h&]hj4uh1hhj !hhhhhMqubh)}(hApps using Vulkan should check for ``VK_ERROR_DEVICE_LOST`` for submissions. This error code means, among other things, that a device reset has happened and it needs to recreate the contexts to keep going.h](h#Apps using Vulkan should check for }(hj!hhhNhNubj)}(h``VK_ERROR_DEVICE_LOST``h]hVK_ERROR_DEVICE_LOST}(hj&!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubh for submissions. This error code means, among other things, that a device reset has happened and it needs to recreate the contexts to keep going.}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMshj !hhubeh}(h]j:ah ]h"]h$]vulkanah&]uh1hhj hhhhhMqjKubeh}(h]jah ]h"] robustnessah$]h&]uh1hhjhhhhhMZubh)}(hhh](h)}(hReporting causes of resetsh]hReporting causes of resets}(hjO!hhhNhNubah}(h]h ]h"]h$]h&]hjbuh1hhjL!hhhhhMxubh)}(hXApart from propagating the reset through the stack so apps can recover, it's really useful for driver developers to learn more about what caused the reset in the first place. For this, drivers can make use of devcoredump to store relevant information about the reset and send device wedged event with ``none`` recovery method (as explained in "Device Wedging" chapter) to notify userspace, so this information can be collected and added to user bug reports.h](hX/Apart from propagating the reset through the stack so apps can recover, it’s really useful for driver developers to learn more about what caused the reset in the first place. For this, drivers can make use of devcoredump to store relevant information about the reset and send device wedged event with }(hj]!hhhNhNubj)}(h``none``h]hnone}(hje!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]!ubh recovery method (as explained in “Device Wedging” chapter) to notify userspace, so this information can be collected and added to user bug reports.}(hj]!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMzhjL!hhubeh}(h]jhah ]h"]reporting causes of resetsah$]h&]uh1hhjhhhhhMxubeh}(h]jah ]h"] device resetah$]h&]uh1hhhhhhhhM'ubh)}(hhh](h)}(hDevice Wedgingh]hDevice Wedging}(hj!hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj!hhhhhMubh)}(hXsDrivers can optionally make use of device wedged event (implemented as drm_dev_wedged_event() in DRM subsystem), which notifies userspace of 'wedged' (hanged/unusable) state of the DRM device through a uevent. This is useful especially in cases where the device is no longer operating as expected and has become unrecoverable from driver context. Purpose of this implementation is to provide drivers a generic way to recover the device with the help of userspace intervention, without taking any drastic measures (like resetting or re-enumerating the full bus, on which the underlying physical device is sitting) in the driver.h]hXwDrivers can optionally make use of device wedged event (implemented as drm_dev_wedged_event() in DRM subsystem), which notifies userspace of ‘wedged’ (hanged/unusable) state of the DRM device through a uevent. This is useful especially in cases where the device is no longer operating as expected and has become unrecoverable from driver context. Purpose of this implementation is to provide drivers a generic way to recover the device with the help of userspace intervention, without taking any drastic measures (like resetting or re-enumerating the full bus, on which the underlying physical device is sitting) in the driver.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj!hhubh)}(hXA 'wedged' device is basically a device that is declared dead by the driver after exhausting all possible attempts to recover it from driver context. The uevent is the notification that is sent to userspace along with a hint about what could possibly be attempted to recover the device from userspace and bring it back to usable state. Different drivers may have different ideas of a 'wedged' device depending on hardware implementation of the underlying physical device, and hence the vendor agnostic nature of the event. It is up to the drivers to decide when they see the need for device recovery and how they want to recover from the available methods.h]hXA ‘wedged’ device is basically a device that is declared dead by the driver after exhausting all possible attempts to recover it from driver context. The uevent is the notification that is sent to userspace along with a hint about what could possibly be attempted to recover the device from userspace and bring it back to usable state. Different drivers may have different ideas of a ‘wedged’ device depending on hardware implementation of the underlying physical device, and hence the vendor agnostic nature of the event. It is up to the drivers to decide when they see the need for device recovery and how they want to recover from the available methods.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj!hhubh)}(hhh](h)}(hDriver prerequisitesh]hDriver prerequisites}(hj!hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj!hhhhhMubh)}(hXSThe driver, before opting for recovery, needs to make sure that the 'wedged' device doesn't harm the system as a whole by taking care of the prerequisites. Necessary actions must include disabling DMA to system memory as well as any communication channels with other devices. Further, the driver must ensure that all dma_fences are signalled and any device state that the core kernel might depend on is cleaned up. All existing mmaps should be invalidated and page faults should be redirected to a dummy page. Once the event is sent, the device must be kept in 'wedged' state until the recovery is performed. New accesses to the device (IOCTLs) should be rejected, preferably with an error code that resembles the type of failure the device has encountered. This will signify the reason for wedging, which can be reported to the application if needed.h]hX]The driver, before opting for recovery, needs to make sure that the ‘wedged’ device doesn’t harm the system as a whole by taking care of the prerequisites. Necessary actions must include disabling DMA to system memory as well as any communication channels with other devices. Further, the driver must ensure that all dma_fences are signalled and any device state that the core kernel might depend on is cleaned up. All existing mmaps should be invalidated and page faults should be redirected to a dummy page. Once the event is sent, the device must be kept in ‘wedged’ state until the recovery is performed. New accesses to the device (IOCTLs) should be rejected, preferably with an error code that resembles the type of failure the device has encountered. This will signify the reason for wedging, which can be reported to the application if needed.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj!hhubeh}(h]jah ]h"]driver prerequisitesah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hRecoveryh]hRecovery}(hj!hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj!hhhhhMubh)}(hXCurrent implementation defines several recovery methods, out of which, drivers can use any one, multiple or none. Method(s) of choice will be sent in the uevent environment as ``WEDGED=[,..,]`` in order of less to more side-effects. See the section `Vendor Specific Recovery`_ for ``WEDGED=vendor-specific``. If driver is unsure about recovery or method is unknown, ``WEDGED=unknown`` will be sent instead.h](hCurrent implementation defines several recovery methods, out of which, drivers can use any one, multiple or none. Method(s) of choice will be sent in the uevent environment as }(hj!hhhNhNubj)}(h#``WEDGED=[,..,]``h]hWEDGED=[,..,]}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubh8 in order of less to more side-effects. See the section }(hj!hhhNhNubj-)}(h`Vendor Specific Recovery`_h]hVendor Specific Recovery}(hj "hhhNhNubah}(h]h ]h"]h$]h&]nameVendor Specific Recoveryhj=uh1j,hj!jKubh for }(hj!hhhNhNubj)}(h``WEDGED=vendor-specific``h]hWEDGED=vendor-specific}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubh;. If driver is unsure about recovery or method is unknown, }(hj!hhhNhNubj)}(h``WEDGED=unknown``h]hWEDGED=unknown}(hj/"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubh will be sent instead.}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj!hhubh)}(h`Userspace consumers can parse this event and attempt recovery as per the following expectations.h]h`Userspace consumers can parse this event and attempt recovery as per the following expectations.}(hjG"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj!hhubjm)}(hX=============== ========================================= Recovery method Consumer expectations =============== ========================================= none optional telemetry collection rebind unbind + bind driver bus-reset unbind + bus reset/re-enumeration + bind vendor-specific vendor specific recovery method cold-reset remove device + slot power cycle + rescan unknown consumer policy =============== ========================================= h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jc"hj`"ubjd")}(hhh]h}(h]h ]h"]h$]h&]colwidthK)uh1jc"hj`"ubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hRecovery methodh]hRecovery method}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hj"ubj")}(hhh]h)}(hConsumer expectationsh]hConsumer expectations}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hj"ubeh}(h]h ]h"]h$]h&]uh1j~"hj{"ubah}(h]h ]h"]h$]h&]uh1jy"hj`"ubhtbody)}(hhh](j")}(hhh](j")}(hhh]h)}(hnoneh]hnone}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hj"ubj")}(hhh]h)}(hoptional telemetry collectionh]hoptional telemetry collection}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hj"ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubj")}(hhh](j")}(hhh]h)}(hrebindh]hrebind}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hj"ubj")}(hhh]h)}(hunbind + bind driverh]hunbind + bind driver}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hj"ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubj")}(hhh](j")}(hhh]h)}(h bus-reseth]h bus-reset}(hj8#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj5#ubah}(h]h ]h"]h$]h&]uh1j"hj2#ubj")}(hhh]h)}(h(unbind + bus reset/re-enumeration + bindh]h(unbind + bus reset/re-enumeration + bind}(hjO#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjL#ubah}(h]h ]h"]h$]h&]uh1j"hj2#ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubj")}(hhh](j")}(hhh]h)}(hvendor-specifich]hvendor-specific}(hjo#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjl#ubah}(h]h ]h"]h$]h&]uh1j"hji#ubj")}(hhh]h)}(hvendor specific recovery methodh]hvendor specific recovery method}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hji#ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubj")}(hhh](j")}(hhh]h)}(h cold-reseth]h cold-reset}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hj#ubj")}(hhh]h)}(h)remove device + slot power cycle + rescanh]h)remove device + slot power cycle + rescan}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hj#ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubj")}(hhh](j")}(hhh]h)}(hunknownh]hunknown}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hj#ubj")}(hhh]h)}(hconsumer policyh]hconsumer policy}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#ubah}(h]h ]h"]h$]h&]uh1j"hj#ubeh}(h]h ]h"]h$]h&]uh1j~"hj"ubeh}(h]h ]h"]h$]h&]uh1j"hj`"ubeh}(h]h ]h"]h$]h&]colsKuh1j^"hj["ubah}(h]h ]h"]h$]h&]uh1jY"hjU"ubah}(h]h ]h"]h$]h&]uh1jlhhhMhj!hhubeh}(h]jah ]h"]recoveryah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(h No Recoveryh]h No Recovery}(hj1$hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj.$hhhhhMubh)}(hXOHere ``WEDGED=none`` signifies that no recovery is expected from the consumer but it can still try to gather telemetry information (devcoredump, syslog) for debug purpose in order to root cause the hang. This is useful because the first hang is usually the most critical one which can result in consequential hangs or complete wedging.h](hHere }(hj?$hhhNhNubj)}(h``WEDGED=none``h]h WEDGED=none}(hjG$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?$ubhX; signifies that no recovery is expected from the consumer but it can still try to gather telemetry information (devcoredump, syslog) for debug purpose in order to root cause the hang. This is useful because the first hang is usually the most critical one which can result in consequential hangs or complete wedging.}(hj?$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj.$hhubeh}(h]jah ]h"] no recoveryah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hCold Reset Recoveryh]hCold Reset Recovery}(hji$hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjf$hhhhhMubh)}(hXWhen ``WEDGED=cold-reset`` is sent, it indicates that the device has encountered an error condition that cannot be resolved through other recovery methods such as driver rebind or bus reset, and requires a complete device power cycle to restore functionality.h](hWhen }(hjw$hhhNhNubj)}(h``WEDGED=cold-reset``h]hWEDGED=cold-reset}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjw$ubh is sent, it indicates that the device has encountered an error condition that cannot be resolved through other recovery methods such as driver rebind or bus reset, and requires a complete device power cycle to restore functionality.}(hjw$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjf$hhubh)}(hnThis method is used by devices that are plugged directly into the PCIe slot which supports removing the power.h]hnThis method is used by devices that are plugged directly into the PCIe slot which supports removing the power.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjf$hhubeh}(h]jah ]h"]cold reset recoveryah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hVendor Specific Recoveryh]hVendor Specific Recovery}(hj$hhhNhNubah}(h]h ]h"]h$]h&]hj7uh1hhj$hhhhhMubh)}(hWhen ``WEDGED=vendor-specific`` is sent, it indicates that the device requires a recovery procedure specific to the hardware vendor and is not one of the standardized approaches.h](hWhen }(hj$hhhNhNubj)}(h``WEDGED=vendor-specific``h]hWEDGED=vendor-specific}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh is sent, it indicates that the device requires a recovery procedure specific to the hardware vendor and is not one of the standardized approaches.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hXx``WEDGED=vendor-specific`` may be used to indicate different cases within a single vendor driver, each requiring a distinct recovery procedure. In such scenarios, the vendor driver must provide comprehensive documentation that describes each case, include additional hints to identify specific case and outline the corresponding recovery procedure. The documentation includes:h](j)}(h``WEDGED=vendor-specific``h]hWEDGED=vendor-specific}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubhX^ may be used to indicate different cases within a single vendor driver, each requiring a distinct recovery procedure. In such scenarios, the vendor driver must provide comprehensive documentation that describes each case, include additional hints to identify specific case and outline the corresponding recovery procedure. The documentation includes:}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hUCase - A list of all cases that sends the ``WEDGED=vendor-specific`` recovery method.h](h*Case - A list of all cases that sends the }(hj$hhhNhNubj)}(h``WEDGED=vendor-specific``h]hWEDGED=vendor-specific}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh recovery method.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hHints - Additional Information to assist the userspace consumer in identifying and differentiating between different cases. This can be exposed through sysfs, debugfs, traces, dmesg etc.h]hHints - Additional Information to assist the userspace consumer in identifying and differentiating between different cases. This can be exposed through sysfs, debugfs, traces, dmesg etc.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hRecovery Procedure - Clear instructions and guidance for recovering each case. This may include userspace scripts, tools needed for the recovery procedure.h]hRecovery Procedure - Clear instructions and guidance for recovering each case. This may include userspace scripts, tools needed for the recovery procedure.}(hj'%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hIt is the responsibility of the admin/userspace consumer to identify the case and verify additional identification hints before attempting a recovery procedure.h]hIt is the responsibility of the admin/userspace consumer to identify the case and verify additional identification hints before attempting a recovery procedure.}(hj5%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hExample: If the device uses the Xe driver, then userspace consumer should refer to :ref:`Xe Device Wedging ` for the detailed documentation.h](hSExample: If the device uses the Xe driver, then userspace consumer should refer to }(hjC%hhhNhNubh)}(h,:ref:`Xe Device Wedging `h]j~)}(hjM%h]hXe Device Wedging}(hjO%hhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjK%ubah}(h]h ]h"]h$]h&]refdocj refdomainjY%reftyperef refexplicitrefwarnj xe-device-wedginguh1hhhhMhjC%ubh for the detailed documentation.}(hjC%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubeh}(h]j=ah ]h"]vendor specific recoveryah$]h&]uh1hhj!hhhhhMjKubh)}(hhh](h)}(hTask informationh]hTask information}(hj%hhhNhNubah}(h]h ]h"]h$]h&]hjYuh1hhj|%hhhhhMubh)}(hX#The information about which application (if any) was involved in the device wedging is useful for userspace if they want to notify the user about what happened (e.g. the compositor display a message to the user "The caused a graphical error and the system recovered") or to implement policies (e.g. the daemon may "ban" an task that keeps resetting the device). If the task information is available, the uevent will display as ``PID=`` and ``TASK=``. Otherwise, ``PID`` and ``TASK`` will not appear in the event string.h](hXThe information about which application (if any) was involved in the device wedging is useful for userspace if they want to notify the user about what happened (e.g. the compositor display a message to the user “The caused a graphical error and the system recovered”) or to implement policies (e.g. the daemon may “ban” an task that keeps resetting the device). If the task information is available, the uevent will display as }(hj%hhhNhNubj)}(h ``PID=``h]h PID=}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh and }(hj%hhhNhNubj)}(h``TASK=``h]hTASK=}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh . Otherwise, }(hj%hhhNhNubj)}(h``PID``h]hPID}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh and }(hj%hhhNhNubj)}(h``TASK``h]hTASK}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubh% will not appear in the event string.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj|%hhubh)}(hXThe reliability of this information is driver and hardware specific, and should be taken with a caution regarding it's precision. To have a big picture of what really happened, the devcoredump file provides much more detailed information about the device state and about the event.h]hXThe reliability of this information is driver and hardware specific, and should be taken with a caution regarding it’s precision. To have a big picture of what really happened, the devcoredump file provides much more detailed information about the device state and about the event.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj|%hhubeh}(h]j_ah ]h"]task informationah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hConsumer prerequisitesh]hConsumer prerequisites}(hj%hhhNhNubah}(h]h ]h"]h$]h&]hj{uh1hhj%hhhhhMubh)}(hXIt is the responsibility of the consumer to make sure that the device or its resources are not in use by any process before attempting recovery. With IOCTLs erroring out, all device memory should be unmapped and file descriptors should be closed to prevent leaks or undefined behaviour. The idea here is to clear the device of all user context beforehand and set the stage for a clean recovery.h]hXIt is the responsibility of the consumer to make sure that the device or its resources are not in use by any process before attempting recovery. With IOCTLs erroring out, all device memory should be unmapped and file descriptors should be closed to prevent leaks or undefined behaviour. The idea here is to clear the device of all user context beforehand and set the stage for a clean recovery.}(hj &hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj%hhubh)}(hFor ``WEDGED=vendor-specific`` recovery method, it is the responsibility of the consumer to check the driver documentation and the usecase before attempting a recovery.h](hFor }(hj&hhhNhNubj)}(h``WEDGED=vendor-specific``h]hWEDGED=vendor-specific}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh recovery method, it is the responsibility of the consumer to check the driver documentation and the usecase before attempting a recovery.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM hj%hhubeh}(h]jah ]h"]consumer prerequisitesah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hExample - rebindh]hExample - rebind}(hjA&hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj>&hhhhhMubh)}(h Udev rule::h]h Udev rule:}(hjO&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj>&hhubj)}(hnSUBSYSTEM=="drm", ENV{WEDGED}=="rebind", DEVPATH=="*/drm/card[0-9]", \ RUN+="/path/to/rebind.sh $env{DEVPATH}"h]hnSUBSYSTEM=="drm", ENV{WEDGED}=="rebind", DEVPATH=="*/drm/card[0-9]", \ RUN+="/path/to/rebind.sh $env{DEVPATH}"}hj]&sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj>&hhubh)}(hRecovery script::h]hRecovery script:}(hjk&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj>&hhubj)}(h#!/bin/sh DEVPATH=$(readlink -f /sys/$1/device) DEVICE=$(basename $DEVPATH) DRIVER=$(readlink -f $DEVPATH/driver) echo -n $DEVICE > $DRIVER/unbind echo -n $DEVICE > $DRIVER/bindh]h#!/bin/sh DEVPATH=$(readlink -f /sys/$1/device) DEVICE=$(basename $DEVPATH) DRIVER=$(readlink -f $DEVPATH/driver) echo -n $DEVICE > $DRIVER/unbind echo -n $DEVICE > $DRIVER/bind}hjy&sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj>&hhubeh}(h]jah ]h"]example - rebindah$]h&]uh1hhj!hhhhhMubh)}(hhh](h)}(hExample - cold-reseth]hExample - cold-reset}(hj&hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj&hhhhhM"ubh)}(h Udev rule::h]h Udev rule:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hj&hhubj)}(hvSUBSYSTEM=="drm", ENV{WEDGED}=="cold-reset", DEVPATH=="*/drm/card[0-9]", \ RUN+="/path/to/cold-reset.sh $env{DEVPATH}"h]hvSUBSYSTEM=="drm", ENV{WEDGED}=="cold-reset", DEVPATH=="*/drm/card[0-9]", \ RUN+="/path/to/cold-reset.sh $env{DEVPATH}"}hj&sbah}(h]h ]h"]h$]h&]hhuh1jhhhM&hj&hhubh)}(hRecovery script::h]hRecovery script:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hj&hhubj)}(hXm#!/bin/sh die() { echo "ERROR: $*" >&2; exit 1; } [ -n "$1" ] || die "Usage: $0 " PCI_DEVS=/sys/bus/pci/devices PCI_SLOTS=/sys/bus/pci/slots syspath=$(readlink -f "/sys/$1/device" 2>/dev/null || readlink -f "/sys/$1" 2>/dev/null) [ -n "$syspath" ] || die "cannot resolve sysfs path for: $1" dev=$(basename "$syspath") [ -e "$PCI_DEVS/$dev" ] || die "not a PCI device: $dev" echo "device : $dev" slot="" walk=$(dirname "$(readlink -f "$PCI_DEVS/$dev")") while true; do ancestor=$(basename "$walk") case "$ancestor" in pci*) break ;; esac # reached the virtual bus root ancestor_nofn=${ancestor%.*} # strip function: 0000:03:01.0 -> 0000:03:01 for f in "$PCI_SLOTS"/*/address; do [ -f "$f" ] || continue addr=$(cat "$f") case "$ancestor_nofn" in *"$addr") slot=$(basename "$(dirname "$f")"); break ;; esac done if [ -n "$slot" ] && [ -e "$PCI_SLOTS/$slot/power" ]; then echo "slot : $slot (port $ancestor)" break fi slot="" walk=$(dirname "$walk") done [ -n "$slot" ] || die "no hotplug slot with power control found in PCIe topology" # Cold reset: remove the device, cut slot power, restore power, rescan. echo "Removing $dev..." [ -e "$PCI_DEVS/$dev" ] && echo 1 > "$PCI_DEVS/$dev/remove" echo "Powering off slot $slot..." echo 0 > "$PCI_SLOTS/$slot/power" echo "Powering on slot $slot..." echo 1 > "$PCI_SLOTS/$slot/power" echo "Rescanning PCI bus..." echo 1 > /sys/bus/pci/rescan if [ -e "$PCI_DEVS/$dev" ]; then echo "Done: $dev is back online." else echo "WARNING: $dev did not re-appear after rescan." fih]hXm#!/bin/sh die() { echo "ERROR: $*" >&2; exit 1; } [ -n "$1" ] || die "Usage: $0 " PCI_DEVS=/sys/bus/pci/devices PCI_SLOTS=/sys/bus/pci/slots syspath=$(readlink -f "/sys/$1/device" 2>/dev/null || readlink -f "/sys/$1" 2>/dev/null) [ -n "$syspath" ] || die "cannot resolve sysfs path for: $1" dev=$(basename "$syspath") [ -e "$PCI_DEVS/$dev" ] || die "not a PCI device: $dev" echo "device : $dev" slot="" walk=$(dirname "$(readlink -f "$PCI_DEVS/$dev")") while true; do ancestor=$(basename "$walk") case "$ancestor" in pci*) break ;; esac # reached the virtual bus root ancestor_nofn=${ancestor%.*} # strip function: 0000:03:01.0 -> 0000:03:01 for f in "$PCI_SLOTS"/*/address; do [ -f "$f" ] || continue addr=$(cat "$f") case "$ancestor_nofn" in *"$addr") slot=$(basename "$(dirname "$f")"); break ;; esac done if [ -n "$slot" ] && [ -e "$PCI_SLOTS/$slot/power" ]; then echo "slot : $slot (port $ancestor)" break fi slot="" walk=$(dirname "$walk") done [ -n "$slot" ] || die "no hotplug slot with power control found in PCIe topology" # Cold reset: remove the device, cut slot power, restore power, rescan. echo "Removing $dev..." [ -e "$PCI_DEVS/$dev" ] && echo 1 > "$PCI_DEVS/$dev/remove" echo "Powering off slot $slot..." echo 0 > "$PCI_SLOTS/$slot/power" echo "Powering on slot $slot..." echo 1 > "$PCI_SLOTS/$slot/power" echo "Rescanning PCI bus..." echo 1 > /sys/bus/pci/rescan if [ -e "$PCI_DEVS/$dev" ]; then echo "Done: $dev is back online." else echo "WARNING: $dev did not re-appear after rescan." fi}hj&sbah}(h]h ]h"]h$]h&]hhuh1jhhhM+hj&hhubeh}(h]jah ]h"]example - cold-resetah$]h&]uh1hhj!hhhhhM"ubh)}(hhh](h)}(h Customizationh]h Customization}(hj&hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj&hhhhhMiubh)}(hXAlthough basic recovery is possible with a simple script, consumers can define custom policies around recovery. For example, if the driver supports multiple recovery methods, consumers can opt for the suitable one depending on scenarios like repeat offences or vendor specific failures. Consumers can also choose to have the device available for debugging or telemetry collection and base their recovery decision on the findings. This is useful especially when the driver is unsure about recovery or method is unknown.h]hXAlthough basic recovery is possible with a simple script, consumers can define custom policies around recovery. For example, if the driver supports multiple recovery methods, consumers can opt for the suitable one depending on scenarios like repeat offences or vendor specific failures. Consumers can also choose to have the device available for debugging or telemetry collection and base their recovery decision on the findings. This is useful especially when the driver is unsure about recovery or method is unknown.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMkhj&hhubj)}(h.. _drm_driver_ioctl:h]h}(h]h ]h"]h$]h&]h݌drm-driver-ioctluh1jhMshj&hhhhubeh}(h]jah ]h"] customizationah$]h&]uh1hhj!hhhhhMiubeh}(h]jah ]h"]device wedgingah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hIOCTL Support on Device Nodesh]hIOCTL Support on Device Nodes}(hj'hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj'hhhhhMvubh)}(hX6First things first, driver private IOCTLs should only be needed for drivers supporting rendering. Kernel modesetting is all standardized, and extended through properties. There are a few exceptions in some existing drivers, which define IOCTL for use by the display DRM master, but they all predate properties.h]hX6First things first, driver private IOCTLs should only be needed for drivers supporting rendering. Kernel modesetting is all standardized, and extended through properties. There are a few exceptions in some existing drivers, which define IOCTL for use by the display DRM master, but they all predate properties.}(hj''hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubh)}(hNow if you do have a render driver you always have to support it through driver private properties. There's a few steps needed to wire all the things up.h]hNow if you do have a render driver you always have to support it through driver private properties. There’s a few steps needed to wire all the things up.}(hj6'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubh)}(hFirst you need to define the structure for your IOCTL in your driver private UAPI header in ``include/uapi/drm/my_driver_drm.h``::h](h\First you need to define the structure for your IOCTL in your driver private UAPI header in }(hjE'hhhNhNubj)}(h$``include/uapi/drm/my_driver_drm.h``h]h include/uapi/drm/my_driver_drm.h}(hjM'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE'ubh:}(hjE'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubj)}(hRstruct my_driver_operation { u32 some_thing; u32 another_thing; };h]hRstruct my_driver_operation { u32 some_thing; u32 another_thing; };}hjf'sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubh)}(hX Please make sure that you follow all the best practices from ``Documentation/process/botching-up-ioctls.rst``. Note that drm_ioctl() automatically zero-extends structures, hence make sure you can add more stuff at the end, i.e. don't put a variable sized array there.h](h=Please make sure that you follow all the best practices from }(hju'hhhNhNubj)}(h0``Documentation/process/botching-up-ioctls.rst``h]h,Documentation/process/botching-up-ioctls.rst}(hj}'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhju'ubh. Note that drm_ioctl() automatically zero-extends structures, hence make sure you can add more stuff at the end, i.e. don’t put a variable sized array there.}(hju'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubh)}(hThen you need to define your IOCTL number, using one of DRM_IO(), DRM_IOR(), DRM_IOW() or DRM_IOWR(). It must start with the DRM_IOCTL\_ prefix::h]hThen you need to define your IOCTL number, using one of DRM_IO(), DRM_IOR(), DRM_IOW() or DRM_IOWR(). It must start with the DRM_IOCTL_ prefix:}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubj)}(hb##define DRM_IOCTL_MY_DRIVER_OPERATION \ DRM_IOW(DRM_COMMAND_BASE, struct my_driver_operation)h]hb##define DRM_IOCTL_MY_DRIVER_OPERATION \ DRM_IOW(DRM_COMMAND_BASE, struct my_driver_operation)}hj'sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chM hj'hhubh)}(hDRM driver private IOCTL must be in the range from DRM_COMMAND_BASE to DRM_COMMAND_END. Finally you need an array of :c:type:`struct drm_ioctl_desc ` to wire up the handlers and set the access rights::h](huDRM driver private IOCTL must be in the range from DRM_COMMAND_BASE to DRM_COMMAND_END. Finally you need an array of }(hj'hhhNhNubh)}(h0:c:type:`struct drm_ioctl_desc `h]j)}(hj'h]hstruct drm_ioctl_desc}(hj'hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_descuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'ubh3 to wire up the handlers and set the access rights:}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj'hMhj'hhubj)}(hstatic const struct drm_ioctl_desc my_driver_ioctls[] = { DRM_IOCTL_DEF_DRV(MY_DRIVER_OPERATION, my_driver_operation, DRM_AUTH|DRM_RENDER_ALLOW), };h]hstatic const struct drm_ioctl_desc my_driver_ioctls[] = { DRM_IOCTL_DEF_DRV(MY_DRIVER_OPERATION, my_driver_operation, DRM_AUTH|DRM_RENDER_ALLOW), };}hj'sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'hhubh)}(hdAnd then assign this to the :c:type:`drm_driver.ioctls ` field in your driver structure.h](hAnd then assign this to the }(hj'hhhNhNubh)}(h(:c:type:`drm_driver.ioctls `h]j)}(hj'h]hdrm_driver.ioctls}(hj(hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_driveruh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'ubh field in your driver structure.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj(hMhj'hhubh)}(htSee the separate chapter on :ref:`file operations` for how the driver-specific IOCTLs are wired up.h](hSee the separate chapter on }(hj'(hhhNhNubh)}(h':ref:`file operations`h]j~)}(hj1(h]hfile operations}(hj3(hhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hj/(ubah}(h]h ]h"]h$]h&]refdocj refdomainj=(reftyperef refexplicitrefwarnj drm_driver_fopsuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:632: ./drivers/gpu/drm/drm_ioctl.chMhj'(ubh1 for how the driver-specific IOCTLs are wired up.}(hj'(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjO(hMhj'hhubh)}(hhh](h)}(hRecommended IOCTL Return Valuesh]hRecommended IOCTL Return Values}(hj](hhhNhNubah}(h]h ]h"]h$]h&]hj.uh1hhjZ(hhhhhM|ubh)}(hIn theory a driver's IOCTL callback is only allowed to return very few error codes. In practice it's good to abuse a few more. This section documents common practice within the DRM subsystem:h]hIn theory a driver’s IOCTL callback is only allowed to return very few error codes. In practice it’s good to abuse a few more. This section documents common practice within the DRM subsystem:}(hjk(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hjZ(hhubjs )}(hhh](jx )}(hENOENT: Strictly this should only be used when a file doesn't exist e.g. when calling the open() syscall. We reuse that to signal any kind of object lookup failure, e.g. for unknown GEM buffer object handles, unknown KMS object handles and similar cases. h](j~ )}(hENOENT:h]hENOENT:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj|(ubj )}(hhh]h)}(hStrictly this should only be used when a file doesn't exist e.g. when calling the open() syscall. We reuse that to signal any kind of object lookup failure, e.g. for unknown GEM buffer object handles, unknown KMS object handles and similar cases.h]hStrictly this should only be used when a file doesn’t exist e.g. when calling the open() syscall. We reuse that to signal any kind of object lookup failure, e.g. for unknown GEM buffer object handles, unknown KMS object handles and similar cases.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(ubah}(h]h ]h"]h$]h&]uh1j hj|(ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(ubjx )}(hXENOSPC: Some drivers use this to differentiate "out of kernel memory" from "out of VRAM". Sometimes also applies to other limited gpu resources used for rendering (e.g. when you have a special limited compression buffer). Sometimes resource allocation/reservation issues in command submission IOCTLs are also signalled through EDEADLK. Simply running out of kernel/system memory is signalled through ENOMEM. h](j~ )}(hENOSPC:h]hENOSPC:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj(ubj )}(hhh](h)}(hXGSome drivers use this to differentiate "out of kernel memory" from "out of VRAM". Sometimes also applies to other limited gpu resources used for rendering (e.g. when you have a special limited compression buffer). Sometimes resource allocation/reservation issues in command submission IOCTLs are also signalled through EDEADLK.h]hXOSome drivers use this to differentiate “out of kernel memory” from “out of VRAM”. Sometimes also applies to other limited gpu resources used for rendering (e.g. when you have a special limited compression buffer). Sometimes resource allocation/reservation issues in command submission IOCTLs are also signalled through EDEADLK.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(ubh)}(hGSimply running out of kernel/system memory is signalled through ENOMEM.h]hGSimply running out of kernel/system memory is signalled through ENOMEM.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(ubeh}(h]h ]h"]h$]h&]uh1j hj(ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hEPERM/EACCES: Returned for an operation that is valid, but needs more privileges. E.g. root-only or much more common, DRM master-only operations return this when called by unprivileged clients. There's no clear difference between EACCES and EPERM. h](j~ )}(h EPERM/EACCES:h]h EPERM/EACCES:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj(ubj )}(hhh]h)}(hReturned for an operation that is valid, but needs more privileges. E.g. root-only or much more common, DRM master-only operations return this when called by unprivileged clients. There's no clear difference between EACCES and EPERM.h]hReturned for an operation that is valid, but needs more privileges. E.g. root-only or much more common, DRM master-only operations return this when called by unprivileged clients. There’s no clear difference between EACCES and EPERM.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(ubah}(h]h ]h"]h$]h&]uh1j hj(ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hKENODEV: The device is not present anymore or is not yet fully initialized. h](j~ )}(hENODEV:h]hENODEV:}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj)ubj )}(hhh]h)}(hBThe device is not present anymore or is not yet fully initialized.h]hBThe device is not present anymore or is not yet fully initialized.}(hj,)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj))ubah}(h]h ]h"]h$]h&]uh1j hj)ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hSEOPNOTSUPP: Feature (like PRIME, modesetting, GEM) is not supported by the driver. h](j~ )}(h EOPNOTSUPP:h]h EOPNOTSUPP:}(hjJ)hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhjF)ubj )}(hhh]h)}(hFFeature (like PRIME, modesetting, GEM) is not supported by the driver.h]hFFeature (like PRIME, modesetting, GEM) is not supported by the driver.}(hj[)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjX)ubah}(h]h ]h"]h$]h&]uh1j hjF)ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hENXIO: Remote failure, either a hardware transaction (like i2c), but also used when the exporting driver of a shared dma-buf or fence doesn't support a feature needed. h](j~ )}(hENXIO:h]hENXIO:}(hjy)hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhju)ubj )}(hhh]h)}(hRemote failure, either a hardware transaction (like i2c), but also used when the exporting driver of a shared dma-buf or fence doesn't support a feature needed.h]hRemote failure, either a hardware transaction (like i2c), but also used when the exporting driver of a shared dma-buf or fence doesn’t support a feature needed.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj)ubah}(h]h ]h"]h$]h&]uh1j hju)ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hEINTR: DRM drivers assume that userspace restarts all IOCTLs. Any DRM IOCTL can return EINTR and in such a case should be restarted with the IOCTL parameters left unchanged. h](j~ )}(hEINTR:h]hEINTR:}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj)ubj )}(hhh]h)}(hDRM drivers assume that userspace restarts all IOCTLs. Any DRM IOCTL can return EINTR and in such a case should be restarted with the IOCTL parameters left unchanged.h]hDRM drivers assume that userspace restarts all IOCTLs. Any DRM IOCTL can return EINTR and in such a case should be restarted with the IOCTL parameters left unchanged.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj)ubah}(h]h ]h"]h$]h&]uh1j hj)ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hEIO: The GPU died and couldn't be resurrected through a reset. Modesetting hardware failures are signalled through the "link status" connector property. h](j~ )}(hEIO:h]hEIO:}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj)ubj )}(hhh]h)}(hThe GPU died and couldn't be resurrected through a reset. Modesetting hardware failures are signalled through the "link status" connector property.h]hThe GPU died and couldn’t be resurrected through a reset. Modesetting hardware failures are signalled through the “link status” connector property.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj)ubah}(h]h ]h"]h$]h&]uh1j hj)ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubjx )}(hZEINVAL: Catch-all for anything that is an invalid argument combination which cannot work. h](j~ )}(hEINVAL:h]hEINVAL:}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hhhMhj*ubj )}(hhh]h)}(hQCatch-all for anything that is an invalid argument combination which cannot work.h]hQCatch-all for anything that is an invalid argument combination which cannot work.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*ubah}(h]h ]h"]h$]h&]uh1j hj*ubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjy(hhubeh}(h]h ]h"]h$]h&]uh1jr hjZ(hhhhhNubh)}(hX.IOCTL also use other error codes like ETIME, EFAULT, EBUSY, ENOTTY but their usage is in line with the common meanings. The above list tries to just document DRM specific patterns. Note that ENOTTY has the slightly unintuitive meaning of "this IOCTL does not exist", and is used exactly as such in DRM.h]hX2IOCTL also use other error codes like ETIME, EFAULT, EBUSY, ENOTTY but their usage is in line with the common meanings. The above list tries to just document DRM specific patterns. Note that ENOTTY has the slightly unintuitive meaning of “this IOCTL does not exist”, and is used exactly as such in DRM.}(hj7*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZ(hhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl_t (C macro) c.drm_ioctl_thNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(h drm_ioctl_th]j. )}(h drm_ioctl_th]jW )}(h drm_ioctl_th]j] )}(hjX*h]h drm_ioctl_t}(hjb*hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj^*ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjZ*hhhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK-ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjV*hhhju*hK-ubah}(h]jQ*ah ](j j eh"]h$]h&]j j )j huh1j' hju*hK-hjS*hhubj )}(hhh]h)}(h%**Typedef**: DRM ioctl function type.h](j' )}(h **Typedef**h]hTypedef}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj*ubh: DRM ioctl function type.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK/hj*hhubah}(h]h ]h"]h$]h&]uh1j hjS*hhhju*hK-ubeh}(h]h ](j macroeh"]h$]h&]jN j jO j*jP j*jQ jR jS uh1j" hhhjZ(hNhNubh)}(h **Syntax**h]j' )}(hj*h]hSyntax}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj*ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK2hjZ(hhubjm)}(h]``typedef int drm_ioctl_t (struct drm_device *dev, void *data, struct drm_file *file_priv)`` h]h)}(h\``typedef int drm_ioctl_t (struct drm_device *dev, void *data, struct drm_file *file_priv)``h]j)}(hj*h]hXtypedef int drm_ioctl_t (struct drm_device *dev, void *data, struct drm_file *file_priv)}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK4hj*ubah}(h]h ]h"]h$]h&]uh1jlhj*hK4hjZ(hhubjU )}(hX**Parameters** ``struct drm_device *dev`` DRM device inode ``void *data`` private pointer of the ioctl call ``struct drm_file *file_priv`` DRM file this ioctl was made on **Description** This is the DRM ioctl typedef. Note that drm_ioctl() has alrady copied **data** into kernel-space, and will also copy it back, depending upon the read/write settings in the ioctl command code.h](h)}(h**Parameters**h]j' )}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj*ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK8hj*ubjs )}(hhh](jx )}(h,``struct drm_device *dev`` DRM device inode 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&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK.hj+ubj )}(hhh]h)}(hDRM device inodeh]hDRM device inode}(hj'+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#+hK.hj$+ubah}(h]h ]h"]h$]h&]uh1j hj+ubeh}(h]h ]h"]h$]h&]uh1jw hj#+hK.hj+ubjx )}(h1``void *data`` private pointer of the ioctl call h](j~ )}(h``void *data``h]j)}(hjG+h]h void *data}(hjI+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE+ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK/hjA+ubj )}(hhh]h)}(h!private pointer of the ioctl callh]h!private pointer of the ioctl call}(hj`+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\+hK/hj]+ubah}(h]h ]h"]h$]h&]uh1j hjA+ubeh}(h]h ]h"]h$]h&]uh1jw hj\+hK/hj+ubjx )}(h?``struct drm_file *file_priv`` DRM file this ioctl was made on h](j~ )}(h``struct drm_file *file_priv``h]j)}(hj+h]hstruct drm_file *file_priv}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~+ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK0hjz+ubj )}(hhh]h)}(hDRM file this ioctl was made onh]hDRM file this ioctl was made on}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hK0hj+ubah}(h]h ]h"]h$]h&]uh1j hjz+ubeh}(h]h ]h"]h$]h&]uh1jw hj+hK0hj+ubeh}(h]h ]h"]h$]h&]uh1jr hj*ubh)}(h**Description**h]j' )}(hj+h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj+ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK2hj*ubh)}(hThis is the DRM ioctl typedef. Note that drm_ioctl() has alrady copied **data** into kernel-space, and will also copy it back, depending upon the read/write settings in the ioctl command code.h](hGThis is the DRM ioctl typedef. Note that drm_ioctl() has alrady copied }(hj+hhhNhNubj' )}(h**data**h]hdata}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj+ubhq into kernel-space, and will also copy it back, depending upon the read/write settings in the ioctl command code.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK1hj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl_compat_t (C macro)c.drm_ioctl_compat_thNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hdrm_ioctl_compat_th]j. )}(hdrm_ioctl_compat_th]jW )}(hdrm_ioctl_compat_th]j] )}(hj ,h]hdrm_ioctl_compat_t}(hj,hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj,ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj,hhhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK:ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj ,hhhj),hK:ubah}(h]j,ah ](j j eh"]h$]h&]j j )j huh1j' hj),hK:hj,hhubj )}(hhh]h)}(h3**Typedef**: compatibility DRM ioctl function type.h](j' )}(h **Typedef**h]hTypedef}(hj=,hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj9,ubh(: compatibility DRM ioctl function type.}(hj9,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl_flags (C enum)c.drm_ioctl_flagshNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hdrm_ioctl_flagsh]j. )}(henum drm_ioctl_flagsh](j )}(henumh]henum}(hj-hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj-hhhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKEubjF )}(h h]h }(hj-hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj-hhhj-hKEubjW )}(hdrm_ioctl_flagsh]j] )}(hj-h]hdrm_ioctl_flags}(hj-hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj-ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj-hhhj-hKEubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj-hhhj-hKEubah}(h]j-ah ](j j eh"]h$]h&]j j )j huh1j' hj-hKEhj-hhubj )}(hhh]h)}(hDRM ioctl flagsh]hDRM ioctl flags}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKKhj-hhubah}(h]h ]h"]h$]h&]uh1j hj-hhhj-hKEubeh}(h]h ](j enumeh"]h$]h&]jN j jO j.jP j.jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hX**Constants** ``DRM_AUTH`` This is for ioctl which are used for rendering, and require that the file descriptor is either for a render node, or if it's a legacy/primary node, then it must be authenticated. ``DRM_MASTER`` This must be set for any ioctl which can change the modeset or display state. Userspace must call the ioctl through a primary node, while it is the active master. Note that read-only modeset ioctl can also be called by unauthenticated clients, or when a master is not the currently active one. ``DRM_ROOT_ONLY`` Anything that could potentially wreak a master file descriptor needs to have this flag set. Current that's only for the SETMASTER and DROPMASTER ioctl, which e.g. logind can call to force a non-behaving master (display compositor) into compliance. This is equivalent to callers with the SYSADMIN capability. ``DRM_RENDER_ALLOW`` This is used for all ioctl needed for rendering only, for drivers which support render nodes. This should be all new render drivers, and hence it should be always set for any ioctl with DRM_AUTH set. Note though that read-only query ioctl might have this set, but have not set DRM_AUTH because they do not require authentication.h](h)}(h **Constants**h]j' )}(hj.h]h Constants}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj.ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKOhj.ubjs )}(hhh](jx )}(h``DRM_AUTH`` This is for ioctl which are used for rendering, and require that the file descriptor is either for a render node, or if it's a legacy/primary node, then it must be authenticated. h](j~ )}(h ``DRM_AUTH``h]j)}(hj8.h]hDRM_AUTH}(hj:.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6.ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKThj2.ubj )}(hhh]h)}(hThis is for ioctl which are used for rendering, and require that the file descriptor is either for a render node, or if it's a legacy/primary node, then it must be authenticated.h]hThis is for ioctl which are used for rendering, and require that the file descriptor is either for a render node, or if it’s a legacy/primary node, then it must be authenticated.}(hjQ.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKRhjN.ubah}(h]h ]h"]h$]h&]uh1j hj2.ubeh}(h]h ]h"]h$]h&]uh1jw hjM.hKThj/.ubjx )}(hX6``DRM_MASTER`` This must be set for any ioctl which can change the modeset or display state. Userspace must call the ioctl through a primary node, while it is the active master. Note that read-only modeset ioctl can also be called by unauthenticated clients, or when a master is not the currently active one. h](j~ )}(h``DRM_MASTER``h]j)}(hjr.h]h DRM_MASTER}(hjt.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp.ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK]hjl.ubj )}(hhh](h)}(hThis must be set for any ioctl which can change the modeset or display state. Userspace must call the ioctl through a primary node, while it is the active master.h]hThis must be set for any ioctl which can change the modeset or display state. Userspace must call the ioctl through a primary node, while it is the active master.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKWhj.ubh)}(hNote that read-only modeset ioctl can also be called by unauthenticated clients, or when a master is not the currently active one.h]hNote that read-only modeset ioctl can also be called by unauthenticated clients, or when a master is not the currently active one.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK[hj.ubeh}(h]h ]h"]h$]h&]uh1j hjl.ubeh}(h]h ]h"]h$]h&]uh1jw hj.hK]hj/.ubjx )}(hXG``DRM_ROOT_ONLY`` Anything that could potentially wreak a master file descriptor needs to have this flag set. Current that's only for the SETMASTER and DROPMASTER ioctl, which e.g. logind can call to force a non-behaving master (display compositor) into compliance. This is equivalent to callers with the SYSADMIN capability. h](j~ )}(h``DRM_ROOT_ONLY``h]j)}(hj.h]h DRM_ROOT_ONLY}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKehj.ubj )}(hhh](h)}(hAnything that could potentially wreak a master file descriptor needs to have this flag set. Current that's only for the SETMASTER and DROPMASTER ioctl, which e.g. logind can call to force a non-behaving master (display compositor) into compliance.h]hAnything that could potentially wreak a master file descriptor needs to have this flag set. Current that’s only for the SETMASTER and DROPMASTER ioctl, which e.g. logind can call to force a non-behaving master (display compositor) into compliance.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK`hj.ubh)}(h;This is equivalent to callers with the SYSADMIN capability.h]h;This is equivalent to callers with the SYSADMIN capability.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hKehj.ubeh}(h]h ]h"]h$]h&]uh1j hj.ubeh}(h]h ]h"]h$]h&]uh1jw hj.hKehj/.ubjx )}(hX^``DRM_RENDER_ALLOW`` This is used for all ioctl needed for rendering only, for drivers which support render nodes. This should be all new render drivers, and hence it should be always set for any ioctl with DRM_AUTH set. Note though that read-only query ioctl might have this set, but have not set DRM_AUTH because they do not require authentication.h](j~ )}(h``DRM_RENDER_ALLOW``h]j)}(hj/h]hDRM_RENDER_ALLOW}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKkhj.ubj )}(hhh]h)}(hXIThis is used for all ioctl needed for rendering only, for drivers which support render nodes. This should be all new render drivers, and hence it should be always set for any ioctl with DRM_AUTH set. Note though that read-only query ioctl might have this set, but have not set DRM_AUTH because they do not require authentication.h]hXIThis is used for all ioctl needed for rendering only, for drivers which support render nodes. This should be all new render drivers, and hence it should be always set for any ioctl with DRM_AUTH set. Note though that read-only query ioctl might have this set, but have not set DRM_AUTH because they do not require authentication.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhhj/ubah}(h]h ]h"]h$]h&]uh1j hj.ubeh}(h]h ]h"]h$]h&]uh1jw hj/hKkhj/.ubeh}(h]h ]h"]h$]h&]uh1jr hj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubh)}(h**Description**h]j' )}(hjF/h]h Description}(hjH/hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjD/ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKnhjZ(hhubh)}(hVarious flags that can be set in :c:type:`drm_ioctl_desc.flags ` to control how userspace can use a given ioctl.h](h!Various flags that can be set in }(hj\/hhhNhNubh)}(h/:c:type:`drm_ioctl_desc.flags `h]j)}(hjf/h]hdrm_ioctl_desc.flags}(hjh/hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjd/ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_descuh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKLhj\/ubh0 to control how userspace can use a given ioctl.}(hj\/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj/hKLhjZ(hhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl_desc (C struct)c.drm_ioctl_deschNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hdrm_ioctl_desch]j. )}(hstruct drm_ioctl_desch](j )}(hj h]hstruct}(hj/hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj/hhhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKRubjF )}(h h]h }(hj/hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj/hhhj/hKRubjW )}(hdrm_ioctl_desch]j] )}(hj/h]hdrm_ioctl_desc}(hj/hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj/ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj/hhhj/hKRubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj/hhhj/hKRubah}(h]j/ah ](j j eh"]h$]h&]j j )j huh1j' hj/hKRhj/hhubj )}(hhh]h)}(hDRM driver ioctl entryh]hDRM driver ioctl entry}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhK}hj/hhubah}(h]h ]h"]h$]h&]uh1j hj/hhhj/hKRubeh}(h]h ](j structeh"]h$]h&]jN j jO j0jP j0jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hXu**Definition**:: struct drm_ioctl_desc { unsigned int cmd; enum drm_ioctl_flags flags; drm_ioctl_t *func; const char *name; }; **Members** ``cmd`` ioctl command number, without flags ``flags`` a bitmask of :c:type:`enum drm_ioctl_flags ` ``func`` handler for this ioctl ``name`` user-readable name for debug outputh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj 0hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj 0ubh:}(hj 0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj0ubj)}(h}struct drm_ioctl_desc { unsigned int cmd; enum drm_ioctl_flags flags; drm_ioctl_t *func; const char *name; };h]h}struct drm_ioctl_desc { unsigned int cmd; enum drm_ioctl_flags flags; drm_ioctl_t *func; const char *name; };}hj&0sbah}(h]h ]h"]h$]h&]hhuh1jhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj0ubh)}(h **Members**h]j' )}(hj70h]hMembers}(hj90hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj50ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj0ubjs )}(hhh](jx )}(h,``cmd`` ioctl command number, without flags h](j~ )}(h``cmd``h]j)}(hjV0h]hcmd}(hjX0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT0ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhjP0ubj )}(hhh]h)}(h#ioctl command number, without flagsh]h#ioctl command number, without flags}(hjo0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjk0hKhjl0ubah}(h]h ]h"]h$]h&]uh1j hjP0ubeh}(h]h ]h"]h$]h&]uh1jw hjk0hKhjM0ubjx )}(hH``flags`` a bitmask of :c:type:`enum drm_ioctl_flags ` h](j~ )}(h ``flags``h]j)}(hj0h]hflags}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj0ubj )}(hhh]h)}(h=a bitmask of :c:type:`enum drm_ioctl_flags `h](h a bitmask of }(hj0hhhNhNubh)}(h0:c:type:`enum drm_ioctl_flags `h]j)}(hj0h]henum drm_ioctl_flags}(hj0hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_flagsuh1hhj0hKhj0ubeh}(h]h ]h"]h$]h&]uh1hhj0hKhj0ubah}(h]h ]h"]h$]h&]uh1j hj0ubeh}(h]h ]h"]h$]h&]uh1jw hj0hKhjM0ubjx )}(h ``func`` handler for this ioctl h](j~ )}(h``func``h]j)}(hj0h]hfunc}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj0ubj )}(hhh]h)}(hhandler for this ioctlh]hhandler for this ioctl}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hKhj0ubah}(h]h ]h"]h$]h&]uh1j hj0ubeh}(h]h ]h"]h$]h&]uh1jw hj0hKhjM0ubjx )}(h,``name`` user-readable name for debug outputh](j~ )}(h``name``h]j)}(hj 1h]hname}(hj"1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj1ubj )}(hhh]h)}(h#user-readable name for debug outputh]h#user-readable name for debug output}(hj91hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj61ubah}(h]h ]h"]h$]h&]uh1j hj1ubeh}(h]h ]h"]h$]h&]uh1jw hj51hKhjM0ubeh}(h]h ]h"]h$]h&]uh1jr hj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubh)}(h**Description**h]j' )}(hjc1h]h Description}(hje1hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hja1ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhjZ(hhubh)}(hPFor convenience it's easier to create these using the DRM_IOCTL_DEF_DRV() macro.h]hRFor convenience it’s easier to create these using the DRM_IOCTL_DEF_DRV() macro.}(hjy1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhjZ(hhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_IOCTL_DEF_DRV (C macro)c.DRM_IOCTL_DEF_DRVhNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hDRM_IOCTL_DEF_DRVh]j. )}(hDRM_IOCTL_DEF_DRVh]jW )}(hDRM_IOCTL_DEF_DRVh]j] )}(hj1h]hDRM_IOCTL_DEF_DRV}(hj1hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj1ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj1hhhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj1hhhj1hKubah}(h]j1ah ](j j eh"]h$]h&]j j )j huh1j' hj1hKhj1hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj1hhhj1hKubeh}(h]h ](j macroeh"]h$]h&]jN j jO j1jP j1jQ jR jS uh1j" hhhjZ(hNhNubh)}(h,``DRM_IOCTL_DEF_DRV (ioctl, _func, _flags)``h]j)}(hj1h]h(DRM_IOCTL_DEF_DRV (ioctl, _func, _flags)}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhjZ(hhubjm)}(hLhelper macro to fill out a :c:type:`struct drm_ioctl_desc ` h]h)}(hKhelper macro to fill out a :c:type:`struct drm_ioctl_desc `h](hhelper macro to fill out a }(hj1hhhNhNubh)}(h0:c:type:`struct drm_ioctl_desc `h]j)}(hj1h]hstruct drm_ioctl_desc}(hj1hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_descuh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj1ubeh}(h]h ]h"]h$]h&]uh1hhj2hKhj1ubah}(h]h ]h"]h$]h&]uh1jlhj2hKhjZ(hhubjU )}(hXr**Parameters** ``ioctl`` ioctl command suffix ``_func`` handler for the ioctl ``_flags`` a bitmask of :c:type:`enum drm_ioctl_flags ` **Description** Small helper macro to create a :c:type:`struct drm_ioctl_desc ` entry. The ioctl command number is constructed by prepending ``DRM_IOCTL\_`` and passing that to DRM_IOCTL_NR().h](h)}(h**Parameters**h]j' )}(hj+2h]h Parameters}(hj-2hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj)2ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj%2ubjs )}(hhh](jx )}(h``ioctl`` ioctl command suffix h](j~ )}(h ``ioctl``h]j)}(hjJ2h]hioctl}(hjL2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjH2ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhjD2ubj )}(hhh]h)}(hioctl command suffixh]hioctl command suffix}(hjc2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_2hKhj`2ubah}(h]h ]h"]h$]h&]uh1j hjD2ubeh}(h]h ]h"]h$]h&]uh1jw hj_2hKhjA2ubjx )}(h ``_func`` handler for the ioctl h](j~ )}(h ``_func``h]j)}(hj2h]h_func}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj}2ubj )}(hhh]h)}(hhandler for the ioctlh]hhandler for the ioctl}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hKhj2ubah}(h]h ]h"]h$]h&]uh1j hj}2ubeh}(h]h ]h"]h$]h&]uh1jw hj2hKhjA2ubjx )}(hI``_flags`` a bitmask of :c:type:`enum drm_ioctl_flags ` h](j~ )}(h ``_flags``h]j)}(hj2h]h_flags}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1j} hU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj2ubj )}(hhh]h)}(h=a bitmask of :c:type:`enum drm_ioctl_flags `h](h a bitmask of }(hj2hhhNhNubh)}(h0:c:type:`enum drm_ioctl_flags `h]j)}(hj2h]henum drm_ioctl_flags}(hj2hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_flagsuh1hhj2hKhj2ubeh}(h]h ]h"]h$]h&]uh1hhj2hKhj2ubah}(h]h ]h"]h$]h&]uh1j hj2ubeh}(h]h ]h"]h$]h&]uh1jw hj2hKhjA2ubeh}(h]h ]h"]h$]h&]uh1jr hj%2ubh)}(h**Description**h]j' )}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj3ubah}(h]h ]h"]h$]h&]uh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj%2ubh)}(hSmall helper macro to create a :c:type:`struct drm_ioctl_desc ` entry. The ioctl command number is constructed by prepending ``DRM_IOCTL\_`` and passing that to DRM_IOCTL_NR().h](hSmall helper macro to create a }(hj,3hhhNhNubh)}(h0:c:type:`struct drm_ioctl_desc `h]j)}(hj63h]hstruct drm_ioctl_desc}(hj83hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj43ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_ioctl_descuh1hhU/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:693: ./include/drm/drm_ioctl.hhKhj,3ubh> entry. The ioctl command number is constructed by prepending }(hj,3hhhNhNubj)}(h``DRM_IOCTL\_``h]h DRM_IOCTL\_}(hjX3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,3ubh$ and passing that to DRM_IOCTL_NR().}(hj,3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjS3hKhj%2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_noop (C function) c.drm_noophNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hMint drm_noop (struct drm_device *dev, void *data, struct drm_file *file_priv)h]j. )}(hLint drm_noop(struct drm_device *dev, void *data, struct drm_file *file_priv)h](j4 )}(hinth]hint}(hj3hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj3hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMubjF )}(h h]h }(hj3hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj3hhhj3hMubjW )}(hdrm_nooph]j] )}(hdrm_nooph]hdrm_noop}(hj3hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj3ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj3hhhj3hMubjv )}(h@(struct drm_device *dev, void *data, struct drm_file *file_priv)h](j| )}(hstruct drm_device *devh](j )}(hj h]hstruct}(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj3ubjF )}(h h]h }(hj3hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj3ubh)}(hhh]j] )}(h drm_deviceh]h drm_device}(hj3hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj3ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj3modnameN classnameNj j )}j ]j )}j j3sb c.drm_noopasbuh1hhj3ubjF )}(h h]h }(hj 4hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj3ubj )}(hj h]h*}(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj3ubj] )}(hdevh]hdev}(hj&4hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj3ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj3ubj| )}(h void *datah](j4 )}(hvoidh]hvoid}(hj?4hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj;4ubjF )}(h h]h }(hjM4hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj;4ubj )}(hj h]h*}(hj[4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj;4ubj] )}(hdatah]hdata}(hjh4hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj;4ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj3ubj| )}(hstruct drm_file *file_privh](j )}(hj h]hstruct}(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj}4ubjF )}(h h]h }(hj4hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj}4ubh)}(hhh]j] )}(hdrm_fileh]hdrm_file}(hj4hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj4ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj4modnameN classnameNj j )}j ]j4 c.drm_noopasbuh1hhj}4ubjF )}(h h]h }(hj4hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj}4ubj )}(hj h]h*}(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj}4ubj] )}(h file_privh]h file_priv}(hj4hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj}4ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj3ubeh}(h]h ]h"]h$]h&]hhuh1ju hj3hhhj3hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj3hhhj3hMubah}(h]j3ah ](j j eh"]h$]h&]j j )j huh1j' hj3hMhj3hhubj )}(hhh]h)}(hDRM no-op ioctl implementationh]hDRM no-op ioctl implementation}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj4hhubah}(h]h ]h"]h$]h&]uh1j hj3hhhj3hMubeh}(h]h ](j functioneh"]h$]h&]jN j jO j5jP j5jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hX**Parameters** ``struct drm_device *dev`` DRM device for the ioctl ``void *data`` data pointer for the ioctl ``struct drm_file *file_priv`` DRM file for the ioctl call **Description** This no-op implementation for drm ioctls is useful for deprecated functionality where we can't return a failure code because existing userspace checks the result of the ioctl, but doesn't care about the action. Always returns successfully with 0.h](h)}(h**Parameters**h]j' )}(hj$5h]h Parameters}(hj&5hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj"5ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj5ubjs )}(hhh](jx )}(h4``struct drm_device *dev`` DRM device for the ioctl h](j~ )}(h``struct drm_device *dev``h]j)}(hjC5h]hstruct drm_device *dev}(hjE5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjA5ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj=5ubj )}(hhh]h)}(hDRM device for the ioctlh]hDRM device for the ioctl}(hj\5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjX5hMhjY5ubah}(h]h ]h"]h$]h&]uh1j hj=5ubeh}(h]h ]h"]h$]h&]uh1jw hjX5hMhj:5ubjx )}(h*``void *data`` data pointer for the ioctl h](j~ )}(h``void *data``h]j)}(hj|5h]h void *data}(hj~5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz5ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhjv5ubj )}(hhh]h)}(hdata pointer for the ioctlh]hdata pointer for the ioctl}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj5ubah}(h]h ]h"]h$]h&]uh1j hjv5ubeh}(h]h ]h"]h$]h&]uh1jw hj5hMhj:5ubjx )}(h;``struct drm_file *file_priv`` DRM file for the ioctl call h](j~ )}(h``struct drm_file *file_priv``h]j)}(hj5h]hstruct drm_file *file_priv}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj5ubj )}(hhh]h)}(hDRM file for the ioctl callh]hDRM file for the ioctl call}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj5ubah}(h]h ]h"]h$]h&]uh1j hj5ubeh}(h]h ]h"]h$]h&]uh1jw hj5hMhj:5ubeh}(h]h ]h"]h$]h&]uh1jr hj5ubh)}(h**Description**h]j' )}(hj5h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj5ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj5ubh)}(hThis no-op implementation for drm ioctls is useful for deprecated functionality where we can't return a failure code because existing userspace checks the result of the ioctl, but doesn't care about the action.h]hThis no-op implementation for drm ioctls is useful for deprecated functionality where we can’t return a failure code because existing userspace checks the result of the ioctl, but doesn’t care about the action.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj5ubh)}(h#Always returns successfully with 0.h]h#Always returns successfully with 0.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_invalid_op (C function)c.drm_invalid_ophNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hSint drm_invalid_op (struct drm_device *dev, void *data, struct drm_file *file_priv)h]j. )}(hRint drm_invalid_op(struct drm_device *dev, void *data, struct drm_file *file_priv)h](j4 )}(hinth]hint}(hjD6hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj@6hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMubjF )}(h h]h }(hjS6hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj@6hhhjR6hMubjW )}(hdrm_invalid_oph]j] )}(hdrm_invalid_oph]hdrm_invalid_op}(hje6hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hja6ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj@6hhhjR6hMubjv )}(h@(struct drm_device *dev, void *data, struct drm_file *file_priv)h](j| )}(hstruct drm_device *devh](j )}(hj h]hstruct}(hj6hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj}6ubjF )}(h h]h }(hj6hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj}6ubh)}(hhh]j] )}(h drm_deviceh]h drm_device}(hj6hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj6ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj6modnameN classnameNj j )}j ]j )}j jg6sbc.drm_invalid_opasbuh1hhj}6ubjF )}(h h]h }(hj6hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj}6ubj )}(hj h]h*}(hj6hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj}6ubj] )}(hdevh]hdev}(hj6hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj}6ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjy6ubj| )}(h void *datah](j4 )}(hvoidh]hvoid}(hj6hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj6ubjF )}(h h]h }(hj7hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj6ubj )}(hj h]h*}(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj6ubj] )}(hdatah]hdata}(hj7hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj6ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjy6ubj| )}(hstruct drm_file *file_privh](j )}(hj h]hstruct}(hj57hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj17ubjF )}(h h]h }(hjB7hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj17ubh)}(hhh]j] )}(hdrm_fileh]hdrm_file}(hjS7hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjP7ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjU7modnameN classnameNj j )}j ]j6c.drm_invalid_opasbuh1hhj17ubjF )}(h h]h }(hjq7hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj17ubj )}(hj h]h*}(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj17ubj] )}(h file_privh]h file_priv}(hj7hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj17ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjy6ubeh}(h]h ]h"]h$]h&]hhuh1ju hj@6hhhjR6hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj<6hhhjR6hMubah}(h]j76ah ](j j eh"]h$]h&]j j )j huh1j' hjR6hMhj96hhubj )}(hhh]h)}(h DRM invalid ioctl implementationh]h DRM invalid ioctl implementation}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7hhubah}(h]h ]h"]h$]h&]uh1j hj96hhhjR6hMubeh}(h]h ](j functioneh"]h$]h&]jN j jO j7jP j7jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hXp**Parameters** ``struct drm_device *dev`` DRM device for the ioctl ``void *data`` data pointer for the ioctl ``struct drm_file *file_priv`` DRM file for the ioctl call **Description** This no-op implementation for drm ioctls is useful for deprecated functionality where we really don't want to allow userspace to call the ioctl any more. This is the case for old ums interfaces for drivers that transitioned to kms gradually and so kept the old legacy tables around. This only applies to radeon and i915 kms drivers, other drivers shouldn't need to use this function. Always fails with a return value of -EINVAL.h](h)}(h**Parameters**h]j' )}(hj7h]h Parameters}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj7ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7ubjs )}(hhh](jx )}(h4``struct drm_device *dev`` DRM device for the ioctl h](j~ )}(h``struct drm_device *dev``h]j)}(hj7h]hstruct drm_device *dev}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7ubj )}(hhh]h)}(hDRM device for the ioctlh]hDRM device for the ioctl}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 8hMhj 8ubah}(h]h ]h"]h$]h&]uh1j hj7ubeh}(h]h ]h"]h$]h&]uh1jw hj 8hMhj7ubjx )}(h*``void *data`` data pointer for the ioctl h](j~ )}(h``void *data``h]j)}(hj08h]h void *data}(hj28hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.8ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj*8ubj )}(hhh]h)}(hdata pointer for the ioctlh]hdata pointer for the ioctl}(hjI8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjE8hMhjF8ubah}(h]h ]h"]h$]h&]uh1j hj*8ubeh}(h]h ]h"]h$]h&]uh1jw hjE8hMhj7ubjx )}(h;``struct drm_file *file_priv`` DRM file for the ioctl call h](j~ )}(h``struct drm_file *file_priv``h]j)}(hji8h]hstruct drm_file *file_priv}(hjk8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjg8ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhjc8ubj )}(hhh]h)}(hDRM file for the ioctl callh]hDRM file for the ioctl call}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~8hMhj8ubah}(h]h ]h"]h$]h&]uh1j hjc8ubeh}(h]h ]h"]h$]h&]uh1jw hj~8hMhj7ubeh}(h]h ]h"]h$]h&]uh1jr hj7ubh)}(h**Description**h]j' )}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj8ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7ubh)}(hXThis no-op implementation for drm ioctls is useful for deprecated functionality where we really don't want to allow userspace to call the ioctl any more. This is the case for old ums interfaces for drivers that transitioned to kms gradually and so kept the old legacy tables around. This only applies to radeon and i915 kms drivers, other drivers shouldn't need to use this function.h]hXThis no-op implementation for drm ioctls is useful for deprecated functionality where we really don’t want to allow userspace to call the ioctl any more. This is the case for old ums interfaces for drivers that transitioned to kms gradually and so kept the old legacy tables around. This only applies to radeon and i915 kms drivers, other drivers shouldn’t need to use this function.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7ubh)}(h,Always fails with a return value of -EINVAL.h]h,Always fails with a return value of -EINVAL.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl (C function) c.drm_ioctlhNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hGlong drm_ioctl (struct file *filp, unsigned int cmd, unsigned long arg)h]j. )}(hFlong drm_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)h](j4 )}(hlongh]hlong}(hj8hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj8hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM6ubjF )}(h h]h }(hj9hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj8hhhj9hM6ubjW )}(h drm_ioctlh]j] )}(h drm_ioctlh]h drm_ioctl}(hj9hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj9ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj8hhhj9hM6ubjv )}(h8(struct file *filp, unsigned int cmd, unsigned long arg)h](j| )}(hstruct file *filph](j )}(hj h]hstruct}(hj59hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj19ubjF )}(h h]h }(hjB9hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj19ubh)}(hhh]j] )}(hfileh]hfile}(hjS9hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjP9ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjU9modnameN classnameNj j )}j ]j )}j j9sb c.drm_ioctlasbuh1hhj19ubjF )}(h h]h }(hjs9hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj19ubj )}(hj h]h*}(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj19ubj] )}(hfilph]hfilp}(hj9hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj19ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj-9ubj| )}(hunsigned int cmdh](j4 )}(hunsignedh]hunsigned}(hj9hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj9ubjF )}(h h]h }(hj9hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj9ubj4 )}(hinth]hint}(hj9hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj9ubjF )}(h h]h }(hj9hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj9ubj] )}(hcmdh]hcmd}(hj9hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj9ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj-9ubj| )}(hunsigned long argh](j4 )}(hunsignedh]hunsigned}(hj9hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj9ubjF )}(h h]h }(hj:hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj9ubj4 )}(hlongh]hlong}(hj:hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj9ubjF )}(h h]h }(hj":hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj9ubj] )}(hargh]harg}(hj0:hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj9ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj-9ubeh}(h]h ]h"]h$]h&]hhuh1ju hj8hhhj9hM6ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj8hhhj9hM6ubah}(h]j8ah ](j j eh"]h$]h&]j j )j huh1j' hj9hM6hj8hhubj )}(hhh]h)}(h-ioctl callback implementation for DRM driversh]h-ioctl callback implementation for DRM drivers}(hjZ:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM6hjW:hhubah}(h]h ]h"]h$]h&]uh1j hj8hhhj9hM6ubeh}(h]h ](j functioneh"]h$]h&]jN j jO jr:jP jr:jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hX**Parameters** ``struct file *filp`` file this ioctl is called on ``unsigned int cmd`` ioctl cmd number ``unsigned long arg`` user argument **Description** Looks up the ioctl function in the DRM core and the driver dispatch table, stored in :c:type:`drm_driver.ioctls `. It checks for necessary permission by calling drm_ioctl_permit(), and dispatches to the respective function. **Return** Zero on success, negative error code on failure.h](h)}(h**Parameters**h]j' )}(hj|:h]h Parameters}(hj~:hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjz:ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM:hjv:ubjs )}(hhh](jx )}(h3``struct file *filp`` file this ioctl is called on 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&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM7hj:ubj )}(hhh]h)}(hfile this ioctl is called onh]hfile this ioctl is called on}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM7hj:ubah}(h]h ]h"]h$]h&]uh1j hj:ubeh}(h]h ]h"]h$]h&]uh1jw hj:hM7hj:ubjx )}(h&``unsigned int cmd`` ioctl cmd number h](j~ )}(h``unsigned int cmd``h]j)}(hj:h]hunsigned int cmd}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM8hj:ubj )}(hhh]h)}(hioctl cmd numberh]hioctl cmd number}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM8hj:ubah}(h]h ]h"]h$]h&]uh1j hj:ubeh}(h]h ]h"]h$]h&]uh1jw hj:hM8hj:ubjx )}(h$``unsigned long arg`` user argument h](j~ )}(h``unsigned long arg``h]j)}(hj ;h]hunsigned long arg}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ;ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM9hj;ubj )}(hhh]h)}(h user argumenth]h user argument}(hj&;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj";hM9hj#;ubah}(h]h ]h"]h$]h&]uh1j hj;ubeh}(h]h ]h"]h$]h&]uh1jw hj";hM9hj:ubeh}(h]h ]h"]h$]h&]uh1jr hjv:ubh)}(h**Description**h]j' )}(hjH;h]h Description}(hjJ;hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjF;ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM;hjv:ubh)}(hLooks up the ioctl function in the DRM core and the driver dispatch table, stored in :c:type:`drm_driver.ioctls `. It checks for necessary permission by calling drm_ioctl_permit(), and dispatches to the respective function.h](hULooks up the ioctl function in the DRM core and the driver dispatch table, stored in }(hj^;hhhNhNubh)}(h(:c:type:`drm_driver.ioctls `h]j)}(hjh;h]hdrm_driver.ioctls}(hjj;hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjf;ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_driveruh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM:hj^;ubhn. It checks for necessary permission by calling drm_ioctl_permit(), and dispatches to the respective function.}(hj^;hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj;hM:hjv:ubh)}(h **Return**h]j' )}(hj;h]hReturn}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj;ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM>hjv:ubh)}(h0Zero on success, negative error code on failure.h]h0Zero on success, negative error code on failure.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chM?hjv:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_ioctl_flags (C function)c.drm_ioctl_flagshNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(h;bool drm_ioctl_flags (unsigned int nr, unsigned int *flags)h]j. )}(h:bool drm_ioctl_flags(unsigned int nr, unsigned int *flags)h](j4 )}(hj7 h]hbool}(hj;hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj;hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMubjF )}(h h]h }(hj;hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj;hhhj;hMubjW )}(hdrm_ioctl_flagsh]j] )}(hdrm_ioctl_flagsh]hdrm_ioctl_flags}(hj;hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj;ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj;hhhj;hMubjv )}(h&(unsigned int nr, unsigned int *flags)h](j| )}(hunsigned int nrh](j4 )}(hunsignedh]hunsigned}(hj<hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj<ubjF )}(h h]h }(hj!<hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj<ubj4 )}(hinth]hint}(hj/<hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj<ubjF )}(h h]h }(hj=<hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj<ubj] )}(hnrh]hnr}(hjK<hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj<ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj <ubj| )}(hunsigned int *flagsh](j4 )}(hunsignedh]hunsigned}(hjd<hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj`<ubjF )}(h h]h }(hjr<hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj`<ubj4 )}(hinth]hint}(hj<hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj`<ubjF )}(h h]h }(hj<hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj`<ubj )}(hj h]h*}(hj<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj`<ubj] )}(hflagsh]hflags}(hj<hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj`<ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj <ubeh}(h]h ]h"]h$]h&]hhuh1ju hj;hhhj;hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj;hhhj;hMubah}(h]h ](j j eh"]h$]h&]j j )j huh1j' hj;hMhj;hhubj )}(hhh]h)}(h6Check for core ioctl and return ioctl permission flagsh]h6Check for core ioctl and return ioctl permission flags}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<hhubah}(h]h ]h"]h$]h&]uh1j hj;hhhj;hMubeh}(h]h ](j functioneh"]h$]h&]jN j jO j<jP j<jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hX**Parameters** ``unsigned int nr`` ioctl number ``unsigned int *flags`` where to return the ioctl permission flags **Description** This ioctl is only used by the vmwgfx driver to augment the access checks done by the drm core and insofar a pretty decent layering violation. This shouldn't be used by any drivers. **Return** True if the **nr** corresponds to a DRM core ioctl number, false otherwise.h](h)}(h**Parameters**h]j' )}(hj<h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj<ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<ubjs )}(hhh](jx )}(h!``unsigned int nr`` ioctl number h](j~ )}(h``unsigned int nr``h]j)}(hj=h]hunsigned int nr}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj=ubj )}(hhh]h)}(h ioctl numberh]h ioctl number}(hj-=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)=hMhj*=ubah}(h]h ]h"]h$]h&]uh1j hj=ubeh}(h]h ]h"]h$]h&]uh1jw hj)=hMhj =ubjx )}(hC``unsigned int *flags`` where to return the ioctl permission flags h](j~ )}(h``unsigned int *flags``h]j)}(hjM=h]hunsigned int *flags}(hjO=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjK=ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhjG=ubj )}(hhh]h)}(h*where to return the ioctl permission flagsh]h*where to return the ioctl permission flags}(hjf=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjb=hMhjc=ubah}(h]h ]h"]h$]h&]uh1j hjG=ubeh}(h]h ]h"]h$]h&]uh1jw hjb=hMhj =ubeh}(h]h ]h"]h$]h&]uh1jr hj<ubh)}(h**Description**h]j' )}(hj=h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj=ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<ubh)}(hThis ioctl is only used by the vmwgfx driver to augment the access checks done by the drm core and insofar a pretty decent layering violation. This shouldn't be used by any drivers.h]hThis ioctl is only used by the vmwgfx driver to augment the access checks done by the drm core and insofar a pretty decent layering violation. This shouldn’t be used by any drivers.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<ubh)}(h **Return**h]j' )}(hj=h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj=ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<ubh)}(hKTrue if the **nr** corresponds to a DRM core ioctl number, false otherwise.h](h True if the }(hj=hhhNhNubj' )}(h**nr**h]hnr}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj=ubh9 corresponds to a DRM core ioctl number, false otherwise.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:696: ./drivers/gpu/drm/drm_ioctl.chMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_compat_ioctl (C function)c.drm_compat_ioctlhNtauh1j hjZ(hhhNhNubj# )}(hhh](j( )}(hNlong drm_compat_ioctl (struct file *filp, unsigned int cmd, unsigned long arg)h]j. )}(hMlong drm_compat_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)h](j4 )}(hlongh]hlong}(hj>hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj>hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chM^ubjF )}(h h]h }(hj>hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>hhhj>hM^ubjW )}(hdrm_compat_ioctlh]j] )}(hdrm_compat_ioctlh]hdrm_compat_ioctl}(hj'>hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj#>ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj>hhhj>hM^ubjv )}(h8(struct file *filp, unsigned int cmd, unsigned long arg)h](j| )}(hstruct file *filph](j )}(hj h]hstruct}(hjC>hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj?>ubjF )}(h h]h }(hjP>hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj?>ubh)}(hhh]j] )}(hfileh]hfile}(hja>hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj^>ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjc>modnameN classnameNj j )}j ]j )}j j)>sbc.drm_compat_ioctlasbuh1hhj?>ubjF )}(h h]h }(hj>hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj?>ubj )}(hj h]h*}(hj>hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj?>ubj] )}(hfilph]hfilp}(hj>hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj?>ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj;>ubj| )}(hunsigned int cmdh](j4 )}(hunsignedh]hunsigned}(hj>hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj>ubjF )}(h h]h }(hj>hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>ubj4 )}(hinth]hint}(hj>hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj>ubjF )}(h h]h }(hj>hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>ubj] )}(hcmdh]hcmd}(hj>hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj>ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj;>ubj| )}(hunsigned long argh](j4 )}(hunsignedh]hunsigned}(hj?hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj?ubjF )}(h h]h }(hj?hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj?ubj4 )}(hlongh]hlong}(hj"?hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj?ubjF )}(h h]h }(hj0?hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj?ubj] )}(hargh]harg}(hj>?hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj?ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj;>ubeh}(h]h ]h"]h$]h&]hhuh1ju hj>hhhj>hM^ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj=hhhj>hM^ubah}(h]j=ah ](j j eh"]h$]h&]j j )j huh1j' hj>hM^hj=hhubj )}(hhh]h)}(h132bit IOCTL compatibility handler for DRM driversh]h132bit IOCTL compatibility handler for DRM drivers}(hjh?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chM^hje?hhubah}(h]h ]h"]h$]h&]uh1j hj=hhhj>hM^ubeh}(h]h ](j functioneh"]h$]h&]jN j jO j?jP j?jQ jR jS uh1j" hhhjZ(hNhNubjU )}(hX**Parameters** ``struct file *filp`` file this ioctl is called on ``unsigned int cmd`` ioctl cmd number ``unsigned long arg`` user argument **Description** Compatibility handler for 32 bit userspace running on 64 kernels. All actual IOCTL handling is forwarded to drm_ioctl(), while marshalling structures as appropriate. Note that this only handles DRM core IOCTLs, if the driver has botched IOCTL itself, it must handle those by wrapping this function. **Return** Zero on success, negative error code on failure.h](h)}(h**Parameters**h]j' )}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj?ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMbhj?ubjs )}(hhh](jx )}(h3``struct file *filp`` file this ioctl is called on 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&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chM_hj?ubj )}(hhh]h)}(hfile this ioctl is called onh]hfile this ioctl is called on}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hM_hj?ubah}(h]h ]h"]h$]h&]uh1j hj?ubeh}(h]h ]h"]h$]h&]uh1jw hj?hM_hj?ubjx )}(h&``unsigned int cmd`` ioctl cmd number h](j~ )}(h``unsigned int cmd``h]j)}(hj?h]hunsigned int cmd}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chM`hj?ubj )}(hhh]h)}(hioctl cmd numberh]hioctl cmd number}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hM`hj?ubah}(h]h ]h"]h$]h&]uh1j hj?ubeh}(h]h ]h"]h$]h&]uh1jw hj?hM`hj?ubjx )}(h$``unsigned long arg`` user argument h](j~ )}(h``unsigned long arg``h]j)}(hj@h]hunsigned long arg}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMahj@ubj )}(hhh]h)}(h user argumenth]h user argument}(hj4@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0@hMahj1@ubah}(h]h ]h"]h$]h&]uh1j hj@ubeh}(h]h ]h"]h$]h&]uh1jw hj0@hMahj?ubeh}(h]h ]h"]h$]h&]uh1jr hj?ubh)}(h**Description**h]j' )}(hjV@h]h Description}(hjX@hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjT@ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMchj?ubh)}(hX*Compatibility handler for 32 bit userspace running on 64 kernels. All actual IOCTL handling is forwarded to drm_ioctl(), while marshalling structures as appropriate. Note that this only handles DRM core IOCTLs, if the driver has botched IOCTL itself, it must handle those by wrapping this function.h]hX*Compatibility handler for 32 bit userspace running on 64 kernels. All actual IOCTL handling is forwarded to drm_ioctl(), while marshalling structures as appropriate. Note that this only handles DRM core IOCTLs, if the driver has botched IOCTL itself, it must handle those by wrapping this function.}(hjl@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMbhj?ubh)}(h **Return**h]j' )}(hj}@h]hReturn}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj{@ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMghj?ubh)}(h0Zero on success, negative error code on failure.h]h0Zero on success, negative error code on failure.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:699: ./drivers/gpu/drm/drm_ioc32.chMhhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjZ(hhhNhNubeh}(h]j4ah ]h"]recommended ioctl return valuesah$]h&]uh1hhj'hhhhhM|ubeh}(h](jj'eh ]h"](ioctl support on device nodesdrm_driver_ioctleh$]h&]uh1hhhhhhhhMvj}j@j&sj}j'j&subh)}(hhh](h)}(hTesting and validationh]hTesting and validation}(hj@hhhNhNubah}(h]h ]h"]h$]h&]hj\uh1hhj@hhhhhMubh)}(hhh](h)}(h&Testing Requirements for userspace APIh]h&Testing Requirements for userspace API}(hj@hhhNhNubah}(h]h ]h"]h$]h&]hj{uh1hhj@hhhhhMubh)}(hXNew cross-driver userspace interface extensions, like new IOCTL, new KMS properties, new files in sysfs or anything else that constitutes an API change should have driver-agnostic testcases in IGT for that feature, if such a test can be reasonably made using IGT for the target hardware.h]hXNew cross-driver userspace interface extensions, like new IOCTL, new KMS properties, new files in sysfs or anything else that constitutes an API change should have driver-agnostic testcases in IGT for that feature, if such a test can be reasonably made using IGT for the target hardware.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj@hhubeh}(h]jah ]h"]&testing requirements for userspace apiah$]h&]uh1hhj@hhhhhMubh)}(hhh](h)}(hValidating changes with IGTh]hValidating changes with IGT}(hj@hhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj@hhhhhMubh)}(hXSThere's a collection of tests that aims to cover the whole functionality of DRM drivers and that can be used to check that changes to DRM drivers or the core don't regress existing functionality. This test suite is called IGT and its code and instructions to build and run can be found in https://gitlab.freedesktop.org/drm/igt-gpu-tools/.h](hX%There’s a collection of tests that aims to cover the whole functionality of DRM drivers and that can be used to check that changes to DRM drivers or the core don’t regress existing functionality. This test suite is called IGT and its code and instructions to build and run can be found in }(hjAhhhNhNubj-)}(h1https://gitlab.freedesktop.org/drm/igt-gpu-tools/h]h1https://gitlab.freedesktop.org/drm/igt-gpu-tools/}(hj AhhhNhNubah}(h]h ]h"]h$]h&]refurij Auh1j,hjAubh.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj@hhubeh}(h]jah ]h"]validating changes with igtah$]h&]uh1hhj@hhhhhMubh)}(hhh](h)}(hUsing VKMS to test DRM APIh]hUsing VKMS to test DRM API}(hj-AhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj*AhhhhhMubh)}(hXVKMS is a software-only model of a KMS driver that is useful for testing and for running compositors. VKMS aims to enable a virtual display without the need for a hardware display capability. These characteristics made VKMS a perfect tool for validating the DRM core behavior and also support the compositor developer. VKMS makes it possible to test DRM functions in a virtual machine without display, simplifying the validation of some of the core changes.h]hXVKMS is a software-only model of a KMS driver that is useful for testing and for running compositors. VKMS aims to enable a virtual display without the need for a hardware display capability. These characteristics made VKMS a perfect tool for validating the DRM core behavior and also support the compositor developer. VKMS makes it possible to test DRM functions in a virtual machine without display, simplifying the validation of some of the core changes.}(hj;AhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubh)}(hXBTo Validate changes in DRM API with VKMS, start setting the kernel: make sure to enable VKMS module; compile the kernel with the VKMS enabled and install it in the target machine. VKMS can be run in a Virtual Machine (QEMU, virtme or similar). It's recommended the use of KVM with the minimum of 1GB of RAM and four cores.h]hXDTo Validate changes in DRM API with VKMS, start setting the kernel: make sure to enable VKMS module; compile the kernel with the VKMS enabled and install it in the target machine. VKMS can be run in a Virtual Machine (QEMU, virtme or similar). It’s recommended the use of KVM with the minimum of 1GB of RAM and four cores.}(hjIAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubh)}(h7It's possible to run the IGT-tests in a VM in two ways:h]h9It’s possible to run the IGT-tests in a VM in two ways:}(hjWAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubjm)}(he1. Use IGT inside a VM 2. Use IGT from the host machine and write the results in a shared directory. h]j)}(hhh](j%)}(hUse IGT inside a VMh]h)}(hjnAh]hUse IGT inside a VM}(hjpAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjlAubah}(h]h ]h"]h$]h&]uh1j$hjiAubj%)}(hKUse IGT from the host machine and write the results in a shared directory. h]h)}(hJUse IGT from the host machine and write the results in a shared directory.h]hJUse IGT from the host machine and write the results in a shared directory.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjAubah}(h]h ]h"]h$]h&]uh1j$hjiAubeh}(h]h ]h"]h$]h&]jQjRjShjTjUuh1jhjeAubah}(h]h ]h"]h$]h&]uh1jlhhhMhj*Ahhubh)}(hFollowing is an example of using a VM with a shared directory with the host machine to run igt-tests. This example uses virtme::h]hFollowing is an example of using a VM with a shared directory with the host machine to run igt-tests. This example uses virtme:}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubj)}(hV$ virtme-run --rwdir /path/for/shared_dir --kdir=path/for/kernel/directory --mods=autoh]hV$ virtme-run --rwdir /path/for/shared_dir --kdir=path/for/kernel/directory --mods=auto}hjAsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj*Ahhubh)}(hPRun the igt-tests in the guest machine. This example runs the 'kms_flip' tests::h]hSRun the igt-tests in the guest machine. This example runs the ‘kms_flip’ tests:}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubj)}(hG$ /path/for/igt-gpu-tools/scripts/run-tests.sh -p -s -t "kms_flip.*" -vh]hG$ /path/for/igt-gpu-tools/scripts/run-tests.sh -p -s -t "kms_flip.*" -v}hjAsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj*Ahhubh)}(hIn this example, instead of building the igt_runner, Piglit is used (-p option). It creates an HTML summary of the test results and saves them in the folder "igt-gpu-tools/results". It executes only the igt-tests matching the -t option.h]hIn this example, instead of building the igt_runner, Piglit is used (-p option). It creates an HTML summary of the test results and saves them in the folder “igt-gpu-tools/results”. It executes only the igt-tests matching the -t option.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*Ahhubeh}(h]jah ]h"]using vkms to test drm apiah$]h&]uh1hhj@hhhhhMubh)}(hhh](h)}(hDisplay CRC Supporth]hDisplay CRC Support}(hjAhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjAhhhhhMubh)}(hDRM device drivers can provide to userspace CRC information of each frame as it reached a given hardware component (a CRC sampling "source").h]hDRM device drivers can provide to userspace CRC information of each frame as it reached a given hardware component (a CRC sampling “source”).}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:762: ./drivers/gpu/drm/drm_debugfs_crc.chK,hjAhhubh)}(hXOUserspace can control generation of CRCs in a given CRTC by writing to the file dri/0/crtc-N/crc/control in debugfs, with N being the :ref:`index of the CRTC`. Accepted values are source names (which are driver-specific) and the "auto" keyword, which will let the driver select a default source of frame CRCs for this CRTC.h](hUserspace can control generation of CRCs in a given CRTC by writing to the file dri/0/crtc-N/crc/control in debugfs, with N being the }(hjBhhhNhNubh)}(h$:ref:`index of the CRTC`h]j~)}(hjBh]hindex of the CRTC}(hj BhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjBubah}(h]h ]h"]h$]h&]refdocj refdomainj*Breftyperef refexplicitrefwarnj crtc_indexuh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:762: ./drivers/gpu/drm/drm_debugfs_crc.chK/hjBubh. Accepted values are source names (which are driver-specific) and the “auto” keyword, which will let the driver select a default source of frame CRCs for this CRTC.}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj` and :c:type:`drm_crtc_funcs.verify_crc_source `. The debugfs files are automatically set up if those vfuncs are set. CRC samples need to be captured in the driver by calling drm_crtc_add_crc_entry(). Depending on the driver and HW requirements, :c:type:`drm_crtc_funcs.set_crc_source ` may result in a commit (even a full modeset).h](hXOn the driver side the implementation effort is minimal, drivers only need to implement }(hjeBhhhNhNubh)}(h8:c:type:`drm_crtc_funcs.set_crc_source `h]j)}(hjoBh]hdrm_crtc_funcs.set_crc_source}(hjqBhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjmBubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_crtc_funcsuh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:762: ./drivers/gpu/drm/drm_debugfs_crc.chKChjeBubh and }(hjeBhhhNhNubh)}(h;:c:type:`drm_crtc_funcs.verify_crc_source `h]j)}(hjBh]h drm_crtc_funcs.verify_crc_source}(hjBhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_crtc_funcsuh1hhjBhKChjeBubh. The debugfs files are automatically set up if those vfuncs are set. CRC samples need to be captured in the driver by calling drm_crtc_add_crc_entry(). Depending on the driver and HW requirements, }(hjeBhhhNhNubh)}(h8:c:type:`drm_crtc_funcs.set_crc_source `h]j)}(hjBh]hdrm_crtc_funcs.set_crc_source}(hjBhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_crtc_funcsuh1hhjBhKChjeBubh. may result in a commit (even a full modeset).}(hjeBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjBhKChjAhhubh)}(hXCRC results must be reliable across non-full-modeset atomic commits, so if a commit via DRM_IOCTL_MODE_ATOMIC would disable or otherwise interfere with CRC generation, then the driver must mark that commit as a full modeset (drm_atomic_crtc_needs_modeset() should return true). As a result, to ensure consistent results, generic userspace must re-setup CRC generation after a legacy SETCRTC or an atomic commit with DRM_MODE_ATOMIC_ALLOW_MODESET.h]hXCRC results must be reliable across non-full-modeset atomic commits, so if a commit via DRM_IOCTL_MODE_ATOMIC would disable or otherwise interfere with CRC generation, then the driver must mark that commit as a full modeset (drm_atomic_crtc_needs_modeset() should return true). As a result, to ensure consistent results, generic userspace must re-setup CRC generation after a legacy SETCRTC or an atomic commit with DRM_MODE_ATOMIC_ALLOW_MODESET.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:762: ./drivers/gpu/drm/drm_debugfs_crc.chKJhjAhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j #drm_crtc_add_crc_entry (C function)c.drm_crtc_add_crc_entryhNtauh1j hjAhhhNhNubj# )}(hhh](j( )}(hbint drm_crtc_add_crc_entry (struct drm_crtc *crtc, bool has_frame, uint32_t frame, uint32_t *crcs)h]j. )}(haint drm_crtc_add_crc_entry(struct drm_crtc *crtc, bool has_frame, uint32_t frame, uint32_t *crcs)h](j4 )}(hinth]hint}(hjChhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjChhh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMubjF )}(h h]h }(hjChhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjChhhjChMubjW )}(hdrm_crtc_add_crc_entryh]j] )}(hdrm_crtc_add_crc_entryh]hdrm_crtc_add_crc_entry}(hj&ChhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj"Cubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjChhhjChMubjv )}(hG(struct drm_crtc *crtc, bool has_frame, uint32_t frame, uint32_t *crcs)h](j| )}(hstruct drm_crtc *crtch](j )}(hj h]hstruct}(hjBChhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>CubjF )}(h h]h }(hjOChhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>Cubh)}(hhh]j] )}(hdrm_crtch]hdrm_crtc}(hj`ChhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj]Cubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjbCmodnameN classnameNj j )}j ]j )}j j(Csbc.drm_crtc_add_crc_entryasbuh1hhj>CubjF )}(h h]h }(hjChhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>Cubj )}(hj h]h*}(hjChhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>Cubj] )}(hcrtch]hcrtc}(hjChhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj>Cubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj:Cubj| )}(hbool has_frameh](j4 )}(hj7 h]hbool}(hjChhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjCubjF )}(h h]h }(hjChhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjCubj] )}(h has_frameh]h has_frame}(hjChhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjCubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj:Cubj| )}(huint32_t frameh](h)}(hhh]j] )}(huint32_th]huint32_t}(hjChhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjCubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjCmodnameN classnameNj j )}j ]j|Cc.drm_crtc_add_crc_entryasbuh1hhjCubjF )}(h h]h }(hj DhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjCubj] )}(hframeh]hframe}(hjDhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjCubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj:Cubj| )}(huint32_t *crcsh](h)}(hhh]j] )}(huint32_th]huint32_t}(hj3DhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj0Dubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj5DmodnameN classnameNj j )}j ]j|Cc.drm_crtc_add_crc_entryasbuh1hhj,DubjF )}(h h]h }(hjQDhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj,Dubj )}(hj h]h*}(hj_DhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj,Dubj] )}(hcrcsh]hcrcs}(hjlDhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj,Dubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj:Cubeh}(h]h ]h"]h$]h&]hhuh1ju hjChhhjChMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjBhhhjChMubah}(h]jBah ](j j eh"]h$]h&]j j )j huh1j' hjChMhjBhhubj )}(hhh]h)}(h*Add entry with CRC information for a frameh]h*Add entry with CRC information for a frame}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjDhhubah}(h]h ]h"]h$]h&]uh1j hjBhhhjChMubeh}(h]h ](j functioneh"]h$]h&]jN j jO jDjP jDjQ jR jS uh1j" hhhjAhNhNubjU )}(hX**Parameters** ``struct drm_crtc *crtc`` CRTC to which the frame belongs ``bool has_frame`` whether this entry has a frame number to go with ``uint32_t frame`` number of the frame these CRCs are about ``uint32_t *crcs`` array of CRC values, with length matching #drm_crtc_crc.values_cnt **Description** For each frame, the driver polls the source of CRCs for new data and calls this function to add them to the buffer from where userspace reads.h](h)}(h**Parameters**h]j' )}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjDubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjDubjs )}(hhh](jx )}(h:``struct drm_crtc *crtc`` CRTC to which the frame belongs h](j~ )}(h``struct drm_crtc *crtc``h]j)}(hjDh]hstruct drm_crtc *crtc}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1j} h_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjDubj )}(hhh]h)}(hCRTC to which the frame belongsh]hCRTC to which the frame belongs}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhMhjDubah}(h]h ]h"]h$]h&]uh1j hjDubeh}(h]h ]h"]h$]h&]uh1jw hjDhMhjDubjx )}(hD``bool has_frame`` whether this entry has a frame number to go with h](j~ )}(h``bool has_frame``h]j)}(hjEh]hbool has_frame}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1j} h_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhj Eubj )}(hhh]h)}(h0whether this entry has a frame number to go withh]h0whether this entry has a frame number to go with}(hj)EhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%EhMhj&Eubah}(h]h ]h"]h$]h&]uh1j hj Eubeh}(h]h ]h"]h$]h&]uh1jw hj%EhMhjDubjx )}(h<``uint32_t frame`` number of the frame these CRCs are about h](j~ )}(h``uint32_t frame``h]j)}(hjIEh]huint32_t frame}(hjKEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGEubah}(h]h ]h"]h$]h&]uh1j} h_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjCEubj )}(hhh]h)}(h(number of the frame these CRCs are abouth]h(number of the frame these CRCs are about}(hjbEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^EhMhj_Eubah}(h]h ]h"]h$]h&]uh1j hjCEubeh}(h]h ]h"]h$]h&]uh1jw hj^EhMhjDubjx )}(hV``uint32_t *crcs`` array of CRC values, with length matching #drm_crtc_crc.values_cnt h](j~ )}(h``uint32_t *crcs``h]j)}(hjEh]huint32_t *crcs}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1j} h_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhj|Eubj )}(hhh]h)}(hBarray of CRC values, with length matching #drm_crtc_crc.values_cnth]hBarray of CRC values, with length matching #drm_crtc_crc.values_cnt}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhMhjEubah}(h]h ]h"]h$]h&]uh1j hj|Eubeh}(h]h ]h"]h$]h&]uh1jw hjEhMhjDubeh}(h]h ]h"]h$]h&]uh1jr hjDubh)}(h**Description**h]j' )}(hjEh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjEubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjDubh)}(hFor each frame, the driver polls the source of CRCs for new data and calls this function to add them to the buffer from where userspace reads.h]hFor each frame, the driver polls the source of CRCs for new data and calls this function to add them to the buffer from where userspace reads.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:765: ./drivers/gpu/drm/drm_debugfs_crc.chMhjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjAhhhNhNubeh}(h]jah ]h"]display crc supportah$]h&]uh1hhj@hhhhhMubh)}(hhh](h)}(hDebugfs Supporth]hDebugfs Support}(hjEhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhjEhhhhhMubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_DEBUGFS_GPUVA_INFO (C macro)c.DRM_DEBUGFS_GPUVA_INFOhNtauh1j hjEhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhNubj# )}(hhh](j( )}(hDRM_DEBUGFS_GPUVA_INFOh]j. )}(hDRM_DEBUGFS_GPUVA_INFOh]jW )}(hDRM_DEBUGFS_GPUVA_INFOh]j] )}(hjFh]hDRM_DEBUGFS_GPUVA_INFO}(hjFhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjFubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjFhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK)ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjFhhhj2FhK)ubah}(h]j Fah ](j j eh"]h$]h&]j j )j huh1j' hj2FhK)hjFhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjFhhhj2FhK)ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jKFjP jKFjQ jR jS uh1j" hhhjEhjFhNubh)}(h'``DRM_DEBUGFS_GPUVA_INFO (show, data)``h]j)}(hjQFh]h#DRM_DEBUGFS_GPUVA_INFO (show, data)}(hjSFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOFubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK+hjEhhubjm)}(h5:c:type:`drm_info_list` entry to dump a GPU VA space h]h)}(h4:c:type:`drm_info_list` entry to dump a GPU VA spaceh](h)}(h:c:type:`drm_info_list`h]j)}(hjqFh]h drm_info_list}(hjsFhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjoFubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK)hjkFubh entry to dump a GPU VA space}(hjkFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjFhK)hjgFubah}(h]h ]h"]h$]h&]uh1jlhjFhK)hjEhhubjU )}(hXs**Parameters** ``show`` the :c:type:`drm_info_list`'s show callback ``data`` driver private data **Description** Drivers should use this macro to define a :c:type:`drm_info_list` entry to provide a debugfs file for dumping the GPU VA space regions and mappings. For each DRM GPU VA space drivers should call drm_debugfs_gpuva_info() from their **show** callback.h](h)}(h**Parameters**h]j' )}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjFubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK-hjFubjs )}(hhh](jx )}(h5``show`` the :c:type:`drm_info_list`'s show callback h](j~ )}(h``show``h]j)}(hjFh]hshow}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK*hjFubj )}(hhh]h)}(h+the :c:type:`drm_info_list`'s show callbackh](hthe }(hjFhhhNhNubh)}(h:c:type:`drm_info_list`h]j)}(hjFh]h drm_info_list}(hjFhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hhjFhK*hjFubh’s show callback}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjFhK*hjFubah}(h]h ]h"]h$]h&]uh1j hjFubeh}(h]h ]h"]h$]h&]uh1jw hjFhK*hjFubjx )}(h``data`` driver private data h](j~ )}(h``data``h]j)}(hj Gh]hdata}(hj"GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK+hjGubj )}(hhh]h)}(hdriver private datah]hdriver private data}(hj9GhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5GhK+hj6Gubah}(h]h ]h"]h$]h&]uh1j hjGubeh}(h]h ]h"]h$]h&]uh1jw hj5GhK+hjFubeh}(h]h ]h"]h$]h&]uh1jr hjFubh)}(h**Description**h]j' )}(hj[Gh]h Description}(hj]GhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYGubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK-hjFubh)}(hDrivers should use this macro to define a :c:type:`drm_info_list` entry to provide a debugfs file for dumping the GPU VA space regions and mappings.h](h*Drivers should use this macro to define a }(hjqGhhhNhNubh)}(h:c:type:`drm_info_list`h]j)}(hj{Gh]h drm_info_list}(hj}GhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjyGubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK,hjqGubhS entry to provide a debugfs file for dumping the GPU VA space regions and mappings.}(hjqGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjGhK,hjFubh)}(hdFor each DRM GPU VA space drivers should call drm_debugfs_gpuva_info() from their **show** callback.h](hRFor each DRM GPU VA space drivers should call drm_debugfs_gpuva_info() from their }(hjGhhhNhNubj' )}(h**show**h]hshow}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjGubh callback.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK/hjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhjFhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_info_list (C struct)c.drm_info_listhNtauh1j hjEhhhjFhNubj# )}(hhh](j( )}(h drm_info_listh]j. )}(hstruct drm_info_listh](j )}(hj h]hstruct}(hjGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjGhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK5ubjF )}(h h]h }(hjGhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjGhhhjGhK5ubjW )}(h drm_info_listh]j] )}(hjGh]h drm_info_list}(hjHhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjHubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjGhhhjGhK5ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjGhhhjGhK5ubah}(h]jGah ](j j eh"]h$]h&]j j )j huh1j' hjGhK5hjGhhubj )}(hhh]h)}(hdebugfs info list entryh]hdebugfs info list entry}(hj&HhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK6hj#Hhhubah}(h]h ]h"]h$]h&]uh1j hjGhhhjGhK5ubeh}(h]h ](j structeh"]h$]h&]jN j jO j>HjP j>HjQ jR jS uh1j" hhhjEhjFhNubjU )}(hX(**Definition**:: struct drm_info_list { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; }; **Members** ``name`` file name ``show`` Show callback. :c:type:`seq_file->private ` will be set to the :c:type:`struct drm_info_node ` corresponding to the instance of this info on a given :c:type:`struct drm_minor `. ``driver_features`` Required driver features for this entry ``data`` Driver-private data, should not be device-specific.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjJHhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjFHubh:}(hjFHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK:hjBHubj)}(hstruct drm_info_list { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; };h]hstruct drm_info_list { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; };}hjcHsbah}(h]h ]h"]h$]h&]hhuh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKprivate ` will be set to the :c:type:`struct drm_info_node ` corresponding to the instance of this info on a given :c:type:`struct drm_minor `. h](j~ )}(h``show``h]j)}(hjHh]hshow}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKBhjHubj )}(hhh]h)}(hShow callback. :c:type:`seq_file->private ` will be set to the :c:type:`struct drm_info_node ` corresponding to the instance of this info on a given :c:type:`struct drm_minor `.h](hShow callback. }(hjHhhhNhNubh)}(h&:c:type:`seq_file->private `h]j)}(hjHh]hseq_file->private}(hjHhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j seq_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK@hjHubh will be set to the }(hjHhhhNhNubh)}(h.:c:type:`struct drm_info_node `h]j)}(hjIh]hstruct drm_info_node}(hjIhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_nodeuh1hhj IhK@hjHubh7 corresponding to the instance of this info on a given }(hjHhhhNhNubh)}(h&:c:type:`struct drm_minor `h]j)}(hj6Ih]hstruct drm_minor}(hj8IhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj4Iubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_minoruh1hhj IhK@hjHubh.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj IhK@hjHubah}(h]h ]h"]h$]h&]uh1j hjHubeh}(h]h ]h"]h$]h&]uh1jw hjHhKBhjHubjx )}(h<``driver_features`` Required driver features for this entry h](j~ )}(h``driver_features``h]j)}(hjoIh]hdriver_features}(hjqIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmIubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKGhjiIubj )}(hhh]h)}(h'Required driver features for this entryh]h'Required driver features for this entry}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhKGhjIubah}(h]h ]h"]h$]h&]uh1j hjiIubeh}(h]h ]h"]h$]h&]uh1jw hjIhKGhjHubjx )}(h<``data`` Driver-private data, should not be device-specific.h](j~ )}(h``data``h]j)}(hjIh]hdata}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKHhjIubj )}(hhh]h)}(h3Driver-private data, should not be device-specific.h]h3Driver-private data, should not be device-specific.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKIhjIubah}(h]h ]h"]h$]h&]uh1j hjIubeh}(h]h ]h"]h$]h&]uh1jw hjIhKHhjHubeh}(h]h ]h"]h$]h&]uh1jr hjBHubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhjFhNubh)}(h**Description**h]j' )}(hjIh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjIubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKLhjEhhubh)}(hGThis structure represents a debugfs file to be created by the drm core.h]hGThis structure represents a debugfs file to be created by the drm core.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK7hjEhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_info_node (C struct)c.drm_info_nodehNtauh1j hjEhhhjFhNubj# )}(hhh](j( )}(h drm_info_nodeh]j. )}(hstruct drm_info_nodeh](j )}(hj h]hstruct}(hj)JhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj%JhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK=ubjF )}(h h]h }(hj7JhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj%Jhhhj6JhK=ubjW )}(h drm_info_nodeh]j] )}(hj#Jh]h drm_info_node}(hjIJhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjEJubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj%Jhhhj6JhK=ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj!Jhhhj6JhK=ubah}(h]jJah ](j j eh"]h$]h&]j j )j huh1j' hj6JhK=hjJhhubj )}(hhh]h)}(h Per-minor debugfs node structureh]h Per-minor debugfs node structure}(hjkJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKMhjhJhhubah}(h]h ]h"]h$]h&]uh1j hjJhhhj6JhK=ubeh}(h]h ](j structeh"]h$]h&]jN j jO jJjP jJjQ jR jS uh1j" hhhjEhjFhNubjU )}(h**Definition**:: struct drm_info_node { struct drm_minor *minor; const struct drm_info_list *info_ent; }; **Members** ``minor`` :c:type:`struct drm_minor ` for this node. ``info_ent`` template for this node.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjJubh:}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKQhjJubj)}(h`struct drm_info_node { struct drm_minor *minor; const struct drm_info_list *info_ent; };h]h`struct drm_info_node { struct drm_minor *minor; const struct drm_info_list *info_ent; };}hjJsbah}(h]h ]h"]h$]h&]hhuh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKShjJubh)}(h **Members**h]j' )}(hjJh]hMembers}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjJubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKXhjJubjs )}(hhh](jx )}(h@``minor`` :c:type:`struct drm_minor ` for this node. h](j~ )}(h ``minor``h]j)}(hjJh]hminor}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKZhjJubj )}(hhh]h)}(h5:c:type:`struct drm_minor ` for this node.h](h)}(h&:c:type:`struct drm_minor `h]j)}(hjJh]hstruct drm_minor}(hjJhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_minoruh1hhjJhKZhjJubh for this node.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjJhKZhjJubah}(h]h ]h"]h$]h&]uh1j hjJubeh}(h]h ]h"]h$]h&]uh1jw hjJhKZhjJubjx )}(h$``info_ent`` template for this node.h](j~ )}(h ``info_ent``h]j)}(hj0Kh]hinfo_ent}(hj2KhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.Kubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK[hj*Kubj )}(hhh]h)}(htemplate for this node.h]htemplate for this node.}(hjIKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK\hjFKubah}(h]h ]h"]h$]h&]uh1j hj*Kubeh}(h]h ]h"]h$]h&]uh1jw hjEKhK[hjJubeh}(h]h ]h"]h$]h&]uh1jr hjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhjFhNubh)}(h**Description**h]j' )}(hjsKh]h Description}(hjuKhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjqKubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK_hjEhhubh)}(hThis structure represents a debugfs file, as an instantiation of a :c:type:`struct drm_info_list ` on a :c:type:`struct drm_minor `.h](hCThis structure represents a debugfs file, as an instantiation of a }(hjKhhhNhNubh)}(h.:c:type:`struct drm_info_list `h]j)}(hjKh]hstruct drm_info_list}(hjKhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKNhjKubh on a }(hjKhhhNhNubh)}(h&:c:type:`struct drm_minor `h]j)}(hjKh]hstruct drm_minor}(hjKhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_minoruh1hhjKhKNhjKubh.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjKhKNhjEhhubh)}(hFIXME:h]hFIXME:}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKQhjEhhubh)}(hNo it doesn't make a hole lot of sense that we duplicate debugfs entries for both the render and the primary nodes, but that's how this has organically grown. It should probably be fixed, with a compatibility link, if needed.h]hNo it doesn’t make a hole lot of sense that we duplicate debugfs entries for both the render and the primary nodes, but that’s how this has organically grown. It should probably be fixed, with a compatibility link, if needed.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKShjEhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_debugfs_info (C struct)c.drm_debugfs_infohNtauh1j hjEhhhjFhNubj# )}(hhh](j( )}(hdrm_debugfs_infoh]j. )}(hstruct drm_debugfs_infoh](j )}(hj h]hstruct}(hjLhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjLhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKZubjF )}(h h]h }(hj#LhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjLhhhj"LhKZubjW )}(hdrm_debugfs_infoh]j] )}(hjLh]hdrm_debugfs_info}(hj5LhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj1Lubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjLhhhj"LhKZubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj Lhhhj"LhKZubah}(h]jLah ](j j eh"]h$]h&]j j )j huh1j' hj"LhKZhj Lhhubj )}(hhh]h)}(hdebugfs info list entryh]hdebugfs info list entry}(hjWLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKchjTLhhubah}(h]h ]h"]h$]h&]uh1j hj Lhhhj"LhKZubeh}(h]h ](j structeh"]h$]h&]jN j jO joLjP joLjQ jR jS uh1j" hhhjEhjFhNubjU )}(hX6**Definition**:: struct drm_debugfs_info { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; }; **Members** ``name`` File name ``show`` Show callback. :c:type:`seq_file->private ` will be set to the :c:type:`struct drm_debugfs_entry ` corresponding to the instance of this info on a given :c:type:`struct drm_device `. ``driver_features`` Required driver features for this entry. ``data`` Driver-private data, should not be device-specific.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj{LhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjwLubh:}(hjwLhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKghjsLubj)}(hstruct drm_debugfs_info { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; };h]hstruct drm_debugfs_info { const char *name; int (*show)(struct seq_file*, void*); u32 driver_features; void *data; };}hjLsbah}(h]h ]h"]h$]h&]hhuh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKihjsLubh)}(h **Members**h]j' )}(hjLh]hMembers}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjLubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKphjsLubjs )}(hhh](jx )}(h``name`` File name h](j~ )}(h``name``h]j)}(hjLh]hname}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKjhjLubj )}(hhh]h)}(h File nameh]h File name}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhKjhjLubah}(h]h ]h"]h$]h&]uh1j hjLubeh}(h]h ]h"]h$]h&]uh1jw hjLhKjhjLubjx )}(h``show`` Show callback. :c:type:`seq_file->private ` will be set to the :c:type:`struct drm_debugfs_entry ` corresponding to the instance of this info on a given :c:type:`struct drm_device `. h](j~ )}(h``show``h]j)}(hjLh]hshow}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKphjLubj )}(hhh]h)}(hShow callback. :c:type:`seq_file->private ` will be set to the :c:type:`struct drm_debugfs_entry ` corresponding to the instance of this info on a given :c:type:`struct drm_device `.h](hShow callback. }(hjMhhhNhNubh)}(h&:c:type:`seq_file->private `h]j)}(hj Mh]hseq_file->private}(hj"MhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j seq_fileuh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKnhjMubh will be set to the }(hjMhhhNhNubh)}(h6:c:type:`struct drm_debugfs_entry `h]j)}(hjDMh]hstruct drm_debugfs_entry}(hjFMhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjBMubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_debugfs_entryuh1hhj=MhKnhjMubh7 corresponding to the instance of this info on a given }(hjMhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hjgMh]hstruct drm_device}(hjiMhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjeMubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhj=MhKnhjMubh.}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj=MhKnhjMubah}(h]h ]h"]h$]h&]uh1j hjLubeh}(h]h ]h"]h$]h&]uh1jw hjMhKphjLubjx )}(h=``driver_features`` Required driver features for this entry. h](j~ )}(h``driver_features``h]j)}(hjMh]hdriver_features}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKvhjMubj )}(hhh]h)}(h(Required driver features for this entry.h]h(Required driver features for this entry.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKvhjMubah}(h]h ]h"]h$]h&]uh1j hjMubeh}(h]h ]h"]h$]h&]uh1jw hjMhKvhjLubjx )}(h<``data`` Driver-private data, should not be device-specific.h](j~ )}(h``data``h]j)}(hjMh]hdata}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKxhjMubj )}(hhh]h)}(h3Driver-private data, should not be device-specific.h]h3Driver-private data, should not be device-specific.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKyhjMubah}(h]h ]h"]h$]h&]uh1j hjMubeh}(h]h ]h"]h$]h&]uh1jw hjMhKxhjLubeh}(h]h ]h"]h$]h&]uh1jr hjsLubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhjFhNubh)}(h**Description**h]j' )}(hjNh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK|hjEhhubh)}(hGThis structure represents a debugfs file to be created by the drm core.h]hGThis structure represents a debugfs file to be created by the drm core.}(hj2NhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKdhjEhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_debugfs_entry (C struct)c.drm_debugfs_entryhNtauh1j hjEhhhjFhNubj# )}(hhh](j( )}(hdrm_debugfs_entryh]j. )}(hstruct drm_debugfs_entryh](j )}(hj h]hstruct}(hjZNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjVNhhhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKjubjF )}(h h]h }(hjhNhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjVNhhhjgNhKjubjW )}(hdrm_debugfs_entryh]j] )}(hjTNh]hdrm_debugfs_entry}(hjzNhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjvNubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjVNhhhjgNhKjubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjRNhhhjgNhKjubah}(h]jMNah ](j j eh"]h$]h&]j j )j huh1j' hjgNhKjhjONhhubj )}(hhh]h)}(h!Per-device debugfs node structureh]h!Per-device debugfs node structure}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK}hjNhhubah}(h]h ]h"]h$]h&]uh1j hjONhhhjgNhKjubeh}(h]h ](j structeh"]h$]h&]jN j jO jNjP jNjQ jR jS uh1j" hhhjEhjFhNubjU )}(hX3**Definition**:: struct drm_debugfs_entry { struct drm_device *dev; struct drm_debugfs_info file; struct list_head list; }; **Members** ``dev`` :c:type:`struct drm_device ` for this node. ``file`` Template for this node. ``list`` Linked list of all device nodes.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjNubh:}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjNubj)}(hvstruct drm_debugfs_entry { struct drm_device *dev; struct drm_debugfs_info file; struct list_head list; };h]hvstruct drm_debugfs_entry { struct drm_device *dev; struct drm_debugfs_info file; struct list_head list; };}hjNsbah}(h]h ]h"]h$]h&]hhuh1jhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjNubh)}(h **Members**h]j' )}(hjNh]hMembers}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjNubjs )}(hhh](jx )}(h@``dev`` :c:type:`struct drm_device ` for this node. h](j~ )}(h``dev``h]j)}(hj Oh]hdev}(hj OhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjOubj )}(hhh]h)}(h7:c:type:`struct drm_device ` for this node.h](h)}(h(:c:type:`struct drm_device `h]j)}(hj(Oh]hstruct drm_device}(hj*OhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj&Oubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhjOhKhj"Oubh for this node.}(hj"OhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjOhKhjOubah}(h]h ]h"]h$]h&]uh1j hjOubeh}(h]h ]h"]h$]h&]uh1jw hjOhKhjOubjx )}(h!``file`` Template for this node. h](j~ )}(h``file``h]j)}(hjaOh]hfile}(hjcOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_Oubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhj[Oubj )}(hhh]h)}(hTemplate for this node.h]hTemplate for this node.}(hjzOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvOhKhjwOubah}(h]h ]h"]h$]h&]uh1j hj[Oubeh}(h]h ]h"]h$]h&]uh1jw hjvOhKhjOubjx )}(h)``list`` Linked list of all device nodes.h](j~ )}(h``list``h]j)}(hjOh]hlist}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1j} hW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjOubj )}(hhh]h)}(h Linked list of all device nodes.h]h Linked list of all device nodes.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjOubah}(h]h ]h"]h$]h&]uh1j hjOubeh}(h]h ]h"]h$]h&]uh1jw hjOhKhjOubeh}(h]h ]h"]h$]h&]uh1jr hjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhjFhNubh)}(h**Description**h]j' )}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjOubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhKhjEhhubh)}(hThis structure represents a debugfs file, as an instantiation of a :c:type:`struct drm_debugfs_info ` on a :c:type:`struct drm_device `.h](hCThis structure represents a debugfs file, as an instantiation of a }(hjOhhhNhNubh)}(h4:c:type:`struct drm_debugfs_info `h]j)}(hjOh]hstruct drm_debugfs_info}(hjOhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_debugfs_infouh1hhW/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:771: ./include/drm/drm_debugfs.hhK~hjOubh on a }(hjOhhhNhNubh)}(h(:c:type:`struct drm_device `h]j)}(hj!Ph]hstruct drm_device}(hj#PhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhjPhK~hjOubh.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjPhK~hjEhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j #drm_debugfs_gpuva_info (C function)c.drm_debugfs_gpuva_infohNtauh1j hjEhhhNhNubj# )}(hhh](j( )}(hHint drm_debugfs_gpuva_info (struct seq_file *m, struct drm_gpuvm *gpuvm)h]j. )}(hGint drm_debugfs_gpuva_info(struct seq_file *m, struct drm_gpuvm *gpuvm)h](j4 )}(hinth]hint}(hjaPhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj]Phhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKubjF )}(h h]h }(hjpPhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj]PhhhjoPhKubjW )}(hdrm_debugfs_gpuva_infoh]j] )}(hdrm_debugfs_gpuva_infoh]hdrm_debugfs_gpuva_info}(hjPhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj~Pubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj]PhhhjoPhKubjv )}(h-(struct seq_file *m, struct drm_gpuvm *gpuvm)h](j| )}(hstruct seq_file *mh](j )}(hj h]hstruct}(hjPhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjPubjF )}(h h]h }(hjPhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjPubh)}(hhh]j] )}(hseq_fileh]hseq_file}(hjPhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjPubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjPmodnameN classnameNj j )}j ]j )}j jPsbc.drm_debugfs_gpuva_infoasbuh1hhjPubjF )}(h h]h }(hjPhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjPubj )}(hj h]h*}(hjPhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjPubj] )}(hmh]hm}(hjPhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjPubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjPubj| )}(hstruct drm_gpuvm *gpuvmh](j )}(hj h]hstruct}(hjQhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj QubjF )}(h h]h }(hjQhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj Qubh)}(hhh]j] )}(h drm_gpuvmh]h drm_gpuvm}(hj.QhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj+Qubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj0QmodnameN classnameNj j )}j ]jPc.drm_debugfs_gpuva_infoasbuh1hhj QubjF )}(h h]h }(hjLQhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj Qubj )}(hj h]h*}(hjZQhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj Qubj] )}(hgpuvmh]hgpuvm}(hjgQhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj Qubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjPubeh}(h]h ]h"]h$]h&]hhuh1ju hj]PhhhjoPhKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjYPhhhjoPhKubah}(h]jTPah ](j j eh"]h$]h&]j j )j huh1j' hjoPhKhjVPhhubj )}(hhh]h)}(hdump the given DRM GPU VA spaceh]hdump the given DRM GPU VA space}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQhhubah}(h]h ]h"]h$]h&]uh1j hjVPhhhjoPhKubeh}(h]h ](j functioneh"]h$]h&]jN j jO jQjP jQjQ jR jS uh1j" hhhjEhNhNubjU )}(hX**Parameters** ``struct seq_file *m`` pointer to the :c:type:`seq_file` to write ``struct drm_gpuvm *gpuvm`` the :c:type:`drm_gpuvm` representing the GPU VA space **Description** Dumps the GPU VA mappings of a given DRM GPU VA manager. For each DRM GPU VA space drivers should call this function from their :c:type:`drm_info_list`'s show callback. **Return** 0 on success, -ENODEV if the :c:type:`gpuvm` is not initializedh](h)}(h**Parameters**h]j' )}(hjQh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjQubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQubjs )}(hhh](jx )}(hB``struct seq_file *m`` pointer to the :c:type:`seq_file` to write h](j~ )}(h``struct seq_file *m``h]j)}(hjQh]hstruct seq_file *m}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQubj )}(hhh]h)}(h*pointer to the :c:type:`seq_file` to writeh](hpointer to the }(hjQhhhNhNubh)}(h:c:type:`seq_file`h]j)}(hjQh]hseq_file}(hjQhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j seq_fileuh1hhjQhKhjQubh to write}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjQhKhjQubah}(h]h ]h"]h$]h&]uh1j hjQubeh}(h]h ]h"]h$]h&]uh1jw hjQhKhjQubjx )}(hR``struct drm_gpuvm *gpuvm`` the :c:type:`drm_gpuvm` representing the GPU VA space h](j~ )}(h``struct drm_gpuvm *gpuvm``h]j)}(hj.Rh]hstruct drm_gpuvm *gpuvm}(hj0RhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,Rubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhj(Rubj )}(hhh]h)}(h5the :c:type:`drm_gpuvm` representing the GPU VA spaceh](hthe }(hjGRhhhNhNubh)}(h:c:type:`drm_gpuvm`h]j)}(hjQRh]h drm_gpuvm}(hjSRhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjORubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_gpuvmuh1hhjCRhKhjGRubh representing the GPU VA space}(hjGRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjCRhKhjDRubah}(h]h ]h"]h$]h&]uh1j hj(Rubeh}(h]h ]h"]h$]h&]uh1jw hjCRhKhjQubeh}(h]h ]h"]h$]h&]uh1jr hjQubh)}(h**Description**h]j' )}(hjRh]h Description}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjRubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQubh)}(h8Dumps the GPU VA mappings of a given DRM GPU VA manager.h]h8Dumps the GPU VA mappings of a given DRM GPU VA manager.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQubh)}(hoFor each DRM GPU VA space drivers should call this function from their :c:type:`drm_info_list`'s show callback.h](hGFor each DRM GPU VA space drivers should call this function from their }(hjRhhhNhNubh)}(h:c:type:`drm_info_list`h]j)}(hjRh]h drm_info_list}(hjRhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjRubh’s show callback.}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjRhKhjQubh)}(h **Return**h]j' )}(hjRh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjRubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjQubh)}(h?0 on success, -ENODEV if the :c:type:`gpuvm` is not initializedh](h0 on success, -ENODEV if the }(hjRhhhNhNubh)}(h:c:type:`gpuvm`h]j)}(hjSh]hgpuvm}(hjShhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j gpuvmuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjRubh is not initialized}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj"ShKhjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j %drm_debugfs_create_files (C function)c.drm_debugfs_create_fileshNtauh1j hjEhhhNhNubj# )}(hhh](j( )}(hzvoid drm_debugfs_create_files (const struct drm_info_list *files, int count, struct dentry *root, struct drm_minor *minor)h]j. )}(hyvoid drm_debugfs_create_files(const struct drm_info_list *files, int count, struct dentry *root, struct drm_minor *minor)h](j4 )}(hvoidh]hvoid}(hjMShhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjIShhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKubjF )}(h h]h }(hj\ShhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjIShhhj[ShKubjW )}(hdrm_debugfs_create_filesh]j] )}(hdrm_debugfs_create_filesh]hdrm_debugfs_create_files}(hjnShhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjjSubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjIShhhj[ShKubjv )}(h\(const struct drm_info_list *files, int count, struct dentry *root, struct drm_minor *minor)h](j| )}(h!const struct drm_info_list *filesh](j )}(hconsth]hconst}(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjSubjF )}(h h]h }(hjShhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjSubj )}(hj h]hstruct}(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjSubjF )}(h h]h }(hjShhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjSubh)}(hhh]j] )}(h drm_info_listh]h drm_info_list}(hjShhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjSubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjSmodnameN classnameNj j )}j ]j )}j jpSsbc.drm_debugfs_create_filesasbuh1hhjSubjF )}(h h]h }(hjShhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjSubj )}(hj h]h*}(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjSubj] )}(hfilesh]hfiles}(hjShhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjSubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSubj| )}(h int counth](j4 )}(hinth]hint}(hjThhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjTubjF )}(h h]h }(hj&ThhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjTubj] )}(hcounth]hcount}(hj4ThhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjTubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSubj| )}(hstruct dentry *rooth](j )}(hj h]hstruct}(hjMThhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjITubjF )}(h h]h }(hjZThhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjITubh)}(hhh]j] )}(hdentryh]hdentry}(hjkThhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjhTubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjmTmodnameN classnameNj j )}j ]jSc.drm_debugfs_create_filesasbuh1hhjITubjF )}(h h]h }(hjThhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjITubj )}(hj h]h*}(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjITubj] )}(hrooth]hroot}(hjThhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjITubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSubj| )}(hstruct drm_minor *minorh](j )}(hj h]hstruct}(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjTubjF )}(h h]h }(hjThhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjTubh)}(hhh]j] )}(h drm_minorh]h drm_minor}(hjThhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjTubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjTmodnameN classnameNj j )}j ]jSc.drm_debugfs_create_filesasbuh1hhjTubjF )}(h h]h }(hjThhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjTubj )}(hj h]h*}(hjUhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjTubj] )}(hminorh]hminor}(hjUhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjTubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSubeh}(h]h ]h"]h$]h&]hhuh1ju hjIShhhj[ShKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjEShhhj[ShKubah}(h]j@Sah ](j j eh"]h$]h&]j j )j huh1j' hj[ShKhjBShhubj )}(hhh]h)}(h5Initialize a given set of debugfs files for DRM minorh]h5Initialize a given set of debugfs files for DRM minor}(hj>UhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhj;Uhhubah}(h]h ]h"]h$]h&]uh1j hjBShhhj[ShKubeh}(h]h ](j functioneh"]h$]h&]jN j jO jVUjP jVUjQ jR jS uh1j" hhhjEhNhNubjU )}(hX**Parameters** ``const struct drm_info_list *files`` The array of files to create ``int count`` The number of files given ``struct dentry *root`` DRI debugfs dir entry. ``struct drm_minor *minor`` device minor number **Description** Create a given set of debugfs files represented by an array of :c:type:`struct drm_info_list ` in the given root directory. These files will be removed automatically on drm_debugfs_dev_fini().h](h)}(h**Parameters**h]j' )}(hj`Uh]h Parameters}(hjbUhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj^Uubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjZUubjs )}(hhh](jx )}(hC``const struct drm_info_list *files`` The array of files to create h](j~ )}(h%``const struct drm_info_list *files``h]j)}(hjUh]h!const struct drm_info_list *files}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}Uubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjyUubj )}(hhh]h)}(hThe array of files to createh]hThe array of files to create}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhKhjUubah}(h]h ]h"]h$]h&]uh1j hjyUubeh}(h]h ]h"]h$]h&]uh1jw hjUhKhjvUubjx )}(h(``int count`` The number of files given h](j~ )}(h ``int count``h]j)}(hjUh]h int count}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjUubj )}(hhh]h)}(hThe number of files givenh]hThe number of files given}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhKhjUubah}(h]h ]h"]h$]h&]uh1j hjUubeh}(h]h ]h"]h$]h&]uh1jw hjUhKhjvUubjx )}(h/``struct dentry *root`` DRI debugfs dir entry. h](j~ )}(h``struct dentry *root``h]j)}(hjUh]hstruct dentry *root}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjUubj )}(hhh]h)}(hDRI debugfs dir entry.h]hDRI debugfs dir entry.}(hj VhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhKhjVubah}(h]h ]h"]h$]h&]uh1j hjUubeh}(h]h ]h"]h$]h&]uh1jw hjVhKhjvUubjx )}(h0``struct drm_minor *minor`` device minor number h](j~ )}(h``struct drm_minor *minor``h]j)}(hj*Vh]hstruct drm_minor *minor}(hj,VhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(Vubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhj$Vubj )}(hhh]h)}(hdevice minor numberh]hdevice minor number}(hjCVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?VhKhj@Vubah}(h]h ]h"]h$]h&]uh1j hj$Vubeh}(h]h ]h"]h$]h&]uh1jw hj?VhKhjvUubeh}(h]h ]h"]h$]h&]uh1jr hjZUubh)}(h**Description**h]j' )}(hjeVh]h Description}(hjgVhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjcVubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhjZUubh)}(hCreate a given set of debugfs files represented by an array of :c:type:`struct drm_info_list ` in the given root directory. These files will be removed automatically on drm_debugfs_dev_fini().h](h?Create a given set of debugfs files represented by an array of }(hj{VhhhNhNubh)}(h.:c:type:`struct drm_info_list `h]j)}(hjVh]hstruct drm_info_list}(hjVhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_info_listuh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chKhj{Vubhb in the given root directory. These files will be removed automatically on drm_debugfs_dev_fini().}(hj{VhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjVhKhjZUubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !drm_debugfs_add_file (C function)c.drm_debugfs_add_filehNtauh1j hjEhhhNhNubj# )}(hhh](j( )}(hvvoid drm_debugfs_add_file (struct drm_device *dev, const char *name, int (*show)(struct seq_file*, void*), void *data)h]j. )}(huvoid drm_debugfs_add_file(struct drm_device *dev, const char *name, int (*show)(struct seq_file*, void*), void *data)h](j4 )}(hvoidh]hvoid}(hjVhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjVhhh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMubjF )}(h h]h }(hjVhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjVhhhjVhMubjW )}(hdrm_debugfs_add_fileh]j] )}(hdrm_debugfs_add_fileh]hdrm_debugfs_add_file}(hjVhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjVubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjVhhhjVhMubjv )}(h\(struct drm_device *dev, const char *name, int (*show)(struct seq_file*, void*), void *data)h](j| )}(hstruct drm_device *devh](j )}(hj h]hstruct}(hj WhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubjF )}(h h]h }(hjWhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWubh)}(hhh]j] )}(h drm_deviceh]h drm_device}(hj(WhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj%Wubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj*WmodnameN classnameNj j )}j ]j )}j jVsbc.drm_debugfs_add_fileasbuh1hhjWubjF )}(h h]h }(hjHWhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWubj )}(hj h]h*}(hjVWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj] )}(hdevh]hdev}(hjcWhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjWubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjWubj| )}(hconst char *nameh](j )}(hjSh]hconst}(hj|WhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjxWubjF )}(h h]h }(hjWhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjxWubj4 )}(hcharh]hchar}(hjWhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjxWubjF )}(h h]h }(hjWhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjxWubj )}(hj h]h*}(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjxWubj] )}(hnameh]hname}(hjWhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjxWubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjWubj| )}(h$int (*show)(struct seq_file*, void*)h](j4 )}(hinth]hint}(hjWhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjWubjF )}(h h]h }(hjWhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWubj )}(h(h]h(}(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj )}(hj h]h*}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj] )}(hshowh]hshow}(hjXhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjWubj )}(h)h]h)}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj )}(hjWh]h(}(hj,XhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj )}(hj h]hstruct}(hj9XhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubjF )}(h h]h }(hjFXhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWubh)}(hhh]j] )}(hseq_fileh]hseq_file}(hjWXhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjTXubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjYXmodnameN classnameNj j )}j ]jDWc.drm_debugfs_add_fileasbuh1hhjWubj )}(hj h]h*}(hjuXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj )}(h,h]h,}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubjF )}(h h]h }(hjXhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWubj4 )}(hvoidh]hvoid}(hjXhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjWubj )}(hj h]h*}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubj )}(hj Xh]h)}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjWubj| )}(h void *datah](j4 )}(hvoidh]hvoid}(hjXhhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjXubjF )}(h h]h }(hjXhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjXubj )}(hj h]h*}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjXubj] )}(hdatah]hdata}(hjXhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjXubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjWubeh}(h]h ]h"]h$]h&]hhuh1ju hjVhhhjVhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjVhhhjVhMubah}(h]jVah ](j j eh"]h$]h&]j j )j huh1j' hjVhMhjVhhubj )}(hhh]h)}(h4Add a given file to the DRM device debugfs file listh]h4Add a given file to the DRM device debugfs file list}(hj$YhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj!Yhhubah}(h]h ]h"]h$]h&]uh1j hjVhhhjVhMubeh}(h]h ](j functioneh"]h$]h&]jN j jO j` in the DRM device debugfs file list.h](h)}(h**Parameters**h]j' )}(hj2\h]h Parameters}(hj4\hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj0\ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj,\ubjs )}(hhh](jx )}(h4``struct drm_device *dev`` drm device for the ioctl h](j~ )}(h``struct drm_device *dev``h]j)}(hjQ\h]hstruct drm_device *dev}(hjS\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjO\ubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhjK\ubj )}(hhh]h)}(hdrm device for the ioctlh]hdrm device for the ioctl}(hjj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjf\hMhjg\ubah}(h]h ]h"]h$]h&]uh1j hjK\ubeh}(h]h ]h"]h$]h&]uh1jw hjf\hMhjH\ubjx )}(hF``const struct drm_debugfs_info *files`` The array of files to create h](j~ )}(h(``const struct drm_debugfs_info *files``h]j)}(hj\h]h$const struct drm_debugfs_info *files}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj\ubj )}(hhh]h)}(hThe array of files to createh]hThe array of files to create}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1j hj\ubeh}(h]h ]h"]h$]h&]uh1jw hj\hMhjH\ubjx )}(h(``int count`` The number of files given h](j~ )}(h ``int count``h]j)}(hj\h]h int count}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1j} h[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj\ubj )}(hhh]h)}(hThe number of files givenh]hThe number of files given}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\hMhj\ubah}(h]h ]h"]h$]h&]uh1j hj\ubeh}(h]h ]h"]h$]h&]uh1jw hj\hMhjH\ubeh}(h]h ]h"]h$]h&]uh1jr hj,\ubh)}(h**Description**h]j' )}(hj\h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj\ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj,\ubh)}(hAdd a given set of debugfs files represented by an array of :c:type:`struct drm_debugfs_info ` in the DRM device debugfs file list.h](h`h]j)}(hj]h]hstruct drm_debugfs_info}(hj ]hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_debugfs_infouh1hh[/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:774: ./drivers/gpu/drm/drm_debugfs.chMhj]ubh% in the DRM device debugfs file list.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj;]hMhj,\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hjEhhhNhNubeh}(h]j ah ]h"]debugfs supportah$]h&]uh1hhj@hhhhhMubeh}(h]jbah ]h"]testing and validationah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(h Sysfs Supporth]h Sysfs Support}(hj^]hhhNhNubah}(h]h ]h"]h$]h&]hj1uh1hhj[]hhhhhM ubh)}(hX.DRM provides very little additional support to drivers for sysfs interactions, beyond just all the standard stuff. Drivers who want to expose additional sysfs properties and property groups can attach them at either :c:type:`drm_device.dev ` or :c:type:`drm_connector.kdev `.h](hDRM provides very little additional support to drivers for sysfs interactions, beyond just all the standard stuff. Drivers who want to expose additional sysfs properties and property groups can attach them at either }(hjl]hhhNhNubh)}(h%:c:type:`drm_device.dev `h]j)}(hjv]h]hdrm_device.dev}(hjx]hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjt]ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_deviceuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:780: ./drivers/gpu/drm/drm_sysfs.chK+hjl]ubh or }(hjl]hhhNhNubh)}(h,:c:type:`drm_connector.kdev `h]j)}(hj]h]hdrm_connector.kdev}(hj]hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_connectoruh1hhj]hK+hjl]ubh.}(hjl]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj]hK+hj[]hhubh)}(hRegistration is automatically handled when calling drm_dev_register(), or drm_connector_register() in case of hot-plugged connectors. Unregistration is also automatically handled by drm_dev_unregister() and drm_connector_unregister().h]hRegistration is automatically handled when calling drm_dev_register(), or drm_connector_register() in case of hot-plugged connectors. Unregistration is also automatically handled by drm_dev_unregister() and drm_connector_unregister().}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:780: ./drivers/gpu/drm/drm_sysfs.chK0hj[]hhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j $drm_sysfs_hotplug_event (C function)c.drm_sysfs_hotplug_eventhNtauh1j hj[]hhhNhNubj# )}(hhh](j( )}(h5void drm_sysfs_hotplug_event (struct drm_device *dev)h]j. )}(h4void drm_sysfs_hotplug_event(struct drm_device *dev)h](j4 )}(hvoidh]hvoid}(hj]hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj]hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMubjF )}(h h]h }(hj]hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj]hhhj]hMubjW )}(hdrm_sysfs_hotplug_eventh]j] )}(hdrm_sysfs_hotplug_eventh]hdrm_sysfs_hotplug_event}(hj ^hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj^ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj]hhhj]hMubjv )}(h(struct drm_device *dev)h]j| )}(hstruct drm_device *devh](j )}(hj h]hstruct}(hj&^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"^ubjF )}(h h]h }(hj3^hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj"^ubh)}(hhh]j] )}(h drm_deviceh]h drm_device}(hjD^hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjA^ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjF^modnameN classnameNj j )}j ]j )}j j ^sbc.drm_sysfs_hotplug_eventasbuh1hhj"^ubjF )}(h h]h }(hjd^hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj"^ubj )}(hj h]h*}(hjr^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"^ubj] )}(hdevh]hdev}(hj^hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj"^ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj^ubah}(h]h ]h"]h$]h&]hhuh1ju hj]hhhj]hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj]hhhj]hMubah}(h]j]ah ](j j eh"]h$]h&]j j )j huh1j' hj]hMhj]hhubj )}(hhh]h)}(hgenerate a DRM ueventh]hgenerate a DRM uevent}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj^hhubah}(h]h ]h"]h$]h&]uh1j hj]hhhj]hMubeh}(h]h ](j functioneh"]h$]h&]jN j jO j^jP j^jQ jR jS uh1j" hhhj[]hNhNubjU )}(hXh**Parameters** ``struct drm_device *dev`` DRM device **Description** Send a uevent for the DRM device specified by **dev**. Currently we only set HOTPLUG=1 in the uevent environment, but this could be expanded to deal with other types of events. Any new uapi should be using the drm_sysfs_connector_status_event() for uevents on connector status change.h](h)}(h**Parameters**h]j' )}(hj^h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj^ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj^ubjs )}(hhh]jx )}(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&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.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&]uh1j hj^ubeh}(h]h ]h"]h$]h&]uh1jw hj^hMhj^ubah}(h]h ]h"]h$]h&]uh1jr hj^ubh)}(h**Description**h]j' )}(hj%_h]h Description}(hj'_hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj#_ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj^ubh)}(hSend a uevent for the DRM device specified by **dev**. Currently we only set HOTPLUG=1 in the uevent environment, but this could be expanded to deal with other types of events.h](h.Send a uevent for the DRM device specified by }(hj;_hhhNhNubj' )}(h**dev**h]hdev}(hjC_hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj;_ubh|. Currently we only set HOTPLUG=1 in the uevent environment, but this could be expanded to deal with other types of events.}(hj;_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj^ubh)}(hkAny new uapi should be using the drm_sysfs_connector_status_event() for uevents on connector status change.h]hkAny new uapi should be using the drm_sysfs_connector_status_event() for uevents on connector status change.}(hj\_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj[]hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j .drm_sysfs_connector_hotplug_event (C function)#c.drm_sysfs_connector_hotplug_eventhNtauh1j hj[]hhhNhNubj# )}(hhh](j( )}(hHvoid drm_sysfs_connector_hotplug_event (struct drm_connector *connector)h]j. )}(hGvoid drm_sysfs_connector_hotplug_event(struct drm_connector *connector)h](j4 )}(hvoidh]hvoid}(hj_hhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hj_hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMubjF )}(h h]h }(hj_hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj_hhhj_hMubjW )}(h!drm_sysfs_connector_hotplug_eventh]j] )}(h!drm_sysfs_connector_hotplug_eventh]h!drm_sysfs_connector_hotplug_event}(hj_hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj_ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj_hhhj_hMubjv )}(h!(struct drm_connector *connector)h]j| )}(hstruct drm_connector *connectorh](j )}(hj h]hstruct}(hj_hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj_ubjF )}(h h]h }(hj_hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj_ubh)}(hhh]j] )}(h drm_connectorh]h drm_connector}(hj_hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj_ubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj_modnameN classnameNj j )}j ]j )}j j_sb#c.drm_sysfs_connector_hotplug_eventasbuh1hhj_ubjF )}(h h]h }(hj`hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj_ubj )}(hj h]h*}(hj`hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj_ubj] )}(h connectorh]h connector}(hj!`hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj_ubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hj_ubah}(h]h ]h"]h$]h&]hhuh1ju hj_hhhj_hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj_hhhj_hMubah}(h]j~_ah ](j j eh"]h$]h&]j j )j huh1j' hj_hMhj_hhubj )}(hhh]h)}(h.generate a DRM uevent for any connector changeh]h.generate a DRM uevent for any connector change}(hjK`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjH`hhubah}(h]h ]h"]h$]h&]uh1j hj_hhhj_hMubeh}(h]h ](j functioneh"]h$]h&]jN j jO jc`jP jc`jQ jR jS uh1j" hhhj[]hNhNubjU )}(h**Parameters** ``struct drm_connector *connector`` connector which has changed **Description** Send a uevent for the DRM connector specified by **connector**. This will send a uevent with the properties HOTPLUG=1 and CONNECTOR.h](h)}(h**Parameters**h]j' )}(hjm`h]h Parameters}(hjo`hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjk`ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjg`ubjs )}(hhh]jx )}(h@``struct drm_connector *connector`` connector which has changed h](j~ )}(h#``struct drm_connector *connector``h]j)}(hj`h]hstruct drm_connector *connector}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhj`ubj )}(hhh]h)}(hconnector which has changedh]hconnector which has changed}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1j hj`ubeh}(h]h ]h"]h$]h&]uh1jw hj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jr hjg`ubh)}(h**Description**h]j' )}(hj`h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj`ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjg`ubh)}(hSend a uevent for the DRM connector specified by **connector**. This will send a uevent with the properties HOTPLUG=1 and CONNECTOR.h](h1Send a uevent for the DRM connector specified by }(hj`hhhNhNubj' )}(h **connector**h]h connector}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj`ubhF. This will send a uevent with the properties HOTPLUG=1 and CONNECTOR.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjg`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj[]hhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j /drm_sysfs_connector_property_event (C function)$c.drm_sysfs_connector_property_eventhNtauh1j hj[]hhhNhNubj# )}(hhh](j( )}(hhvoid drm_sysfs_connector_property_event (struct drm_connector *connector, struct drm_property *property)h]j. )}(hgvoid drm_sysfs_connector_property_event(struct drm_connector *connector, struct drm_property *property)h](j4 )}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]j@ ah"]h$]h&]uh1j3 hjahhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMubjF )}(h h]h }(hj-ahhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjahhhj,ahMubjW )}(h"drm_sysfs_connector_property_eventh]j] )}(h"drm_sysfs_connector_property_eventh]h"drm_sysfs_connector_property_event}(hj?ahhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj;aubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjahhhj,ahMubjv )}(h@(struct drm_connector *connector, struct drm_property *property)h](j| )}(hstruct drm_connector *connectorh](j )}(hj h]hstruct}(hj[ahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWaubjF )}(h h]h }(hjhahhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWaubh)}(hhh]j] )}(h drm_connectorh]h drm_connector}(hjyahhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjvaubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetj{amodnameN classnameNj j )}j ]j )}j jAasb$c.drm_sysfs_connector_property_eventasbuh1hhjWaubjF )}(h h]h }(hjahhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjWaubj )}(hj h]h*}(hjahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjWaubj] )}(h connectorh]h connector}(hjahhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjWaubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSaubj| )}(hstruct drm_property *propertyh](j )}(hj h]hstruct}(hjahhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjaubjF )}(h h]h }(hjahhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjaubh)}(hhh]j] )}(h drm_propertyh]h drm_property}(hjahhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjaubah}(h]h ]h"]h$]h&] refdomainj reftypej reftargetjamodnameN classnameNj j )}j ]ja$c.drm_sysfs_connector_property_eventasbuh1hhjaubjF )}(h h]h }(hj bhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjaubj )}(hj h]h*}(hjbhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjaubj] )}(hpropertyh]hproperty}(hj$bhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjaubeh}(h]h ]h"]h$]h&]noemphhhuh1j{ hjSaubeh}(h]h ]h"]h$]h&]hhuh1ju hjahhhj,ahMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjahhhj,ahMubah}(h]jaah ](j j eh"]h$]h&]j j )j huh1j' hj,ahMhjahhubj )}(hhh]h)}(h3generate a DRM uevent for connector property changeh]h3generate a DRM uevent for connector property change}(hjNbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjKbhhubah}(h]h ]h"]h$]h&]uh1j hjahhhj,ahMubeh}(h]h ](j functioneh"]h$]h&]jN j jO jfbjP jfbjQ jR jS uh1j" hhhj[]hNhNubjU )}(hXZ**Parameters** ``struct drm_connector *connector`` connector on which property changed ``struct drm_property *property`` connector property which has changed. **Description** Send a uevent for the specified DRM connector and property. Currently we set HOTPLUG=1 and connector id along with the attached property id related to the change.h](h)}(h**Parameters**h]j' )}(hjpbh]h Parameters}(hjrbhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjnbubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjjbubjs )}(hhh](jx )}(hH``struct drm_connector *connector`` connector on which property changed h](j~ )}(h#``struct drm_connector *connector``h]j)}(hjbh]hstruct drm_connector *connector}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjbubj )}(hhh]h)}(h#connector on which property changedh]h#connector on which property changed}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1j hjbubeh}(h]h ]h"]h$]h&]uh1jw hjbhMhjbubjx )}(hH``struct drm_property *property`` connector property which has changed. h](j~ )}(h!``struct drm_property *property``h]j)}(hjbh]hstruct drm_property *property}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjbubj )}(hhh]h)}(h%connector property which has changed.h]h%connector property which has changed.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjbubah}(h]h ]h"]h$]h&]uh1j hjbubeh}(h]h ]h"]h$]h&]uh1jw hjbhMhjbubeh}(h]h ]h"]h$]h&]uh1jr hjjbubh)}(h**Description**h]j' )}(hjch]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjcubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjjbubh)}(hSend a uevent for the specified DRM connector and property. Currently we set HOTPLUG=1 and connector id along with the attached property id related to the change.h]hSend a uevent for the specified DRM connector and property. Currently we set HOTPLUG=1 and connector id along with the attached property id related to the change.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:783: ./drivers/gpu/drm/drm_sysfs.chMhjjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj[]hhhNhNubeh}(h]j7ah ]h"] sysfs supportah$]h&]uh1hhhhhhhhM ubh)}(hhh](h)}(hVBlank event handlingh]hVBlank event handling}(hj9chhhNhNubah}(h]h ]h"]h$]h&]hjSuh1hhj6chhhhhMubh)}(h7The DRM core exposes two vertical blank related ioctls:h]h7The DRM core exposes two vertical blank related ioctls:}(hjGchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj6chhubjs )}(hhh](jx )}(h:c:macro:`DRM_IOCTL_WAIT_VBLANK` This takes a struct drm_wait_vblank structure as its argument, and it is used to block or request a signal when a specified vblank event occurs. h](j~ )}(h :c:macro:`DRM_IOCTL_WAIT_VBLANK`h]h)}(hj^ch]j)}(hj^ch]hDRM_IOCTL_WAIT_VBLANK}(hjcchhhNhNubah}(h]h ](j j c-macroeh"]h$]h&]uh1jhj`cubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypemacro refexplicitrefwarnj j j DRM_IOCTL_WAIT_VBLANKuh1hhhhMhj\cubah}(h]h ]h"]h$]h&]uh1j} hhhMhjXcubj )}(hhh]h)}(hThis takes a struct drm_wait_vblank structure as its argument, and it is used to block or request a signal when a specified vblank event occurs.h]hThis takes a struct drm_wait_vblank structure as its argument, and it is used to block or request a signal when a specified vblank event occurs.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjcubah}(h]h ]h"]h$]h&]uh1j hjXcubeh}(h]h ]h"]h$]h&]uh1jw hhhMhjUcubjx )}(hXl:c:macro:`DRM_IOCTL_MODESET_CTL` This was only used for user-mode-settind drivers around modesetting changes to allow the kernel to update the vblank interrupt after mode setting, since on many devices the vertical blank counter is reset to 0 at some point during modeset. Modern drivers should not call this any more since with kernel mode setting it is a no-op. h](j~ )}(h :c:macro:`DRM_IOCTL_MODESET_CTL`h]h)}(hjch]j)}(hjch]hDRM_IOCTL_MODESET_CTL}(hjchhhNhNubah}(h]h ](j j c-macroeh"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypemacro refexplicitrefwarnj j j DRM_IOCTL_MODESET_CTLuh1hhhhM"hjcubah}(h]h ]h"]h$]h&]uh1j} hhhM"hjcubj )}(hhh]h)}(hXJThis was only used for user-mode-settind drivers around modesetting changes to allow the kernel to update the vblank interrupt after mode setting, since on many devices the vertical blank counter is reset to 0 at some point during modeset. Modern drivers should not call this any more since with kernel mode setting it is a no-op.h]hXJThis was only used for user-mode-settind drivers around modesetting changes to allow the kernel to update the vblank interrupt after mode setting, since on many devices the vertical blank counter is reset to 0 at some point during modeset. Modern drivers should not call this any more since with kernel mode setting it is a no-op.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjcubah}(h]h ]h"]h$]h&]uh1j hjcubeh}(h]h ]h"]h$]h&]uh1jw hhhM"hjUchhubeh}(h]h ]h"]h$]h&]uh1jr hj6chhhhhNubeh}(h]jYah ]h"]vblank event handlingah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hUserspace API Structuresh]hUserspace API Structures}(hjchhhNhNubah}(h]h ]h"]h$]h&]hjuuh1hhjchhhhhM%ubh)}(hDRM exposes many UAPI and structure definitions to have a consistent and standardized interface with users. Userspace can refer to these structure definitions and UAPI formats to communicate to drivers.h]hDRM exposes many UAPI and structure definitions to have a consistent and standardized interface with users. Userspace can refer to these structure definitions and UAPI formats to communicate to drivers.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:807: ./include/uapi/drm/drm_mode.hhKhjchhubj)}(h.. _crtc_index:h]h}(h]h ]h"]h$]h&]hjuh1jhM*hjchhhhubh)}(hhh](h)}(h CRTC indexh]h CRTC index}(hj$dhhhNhNubah}(h]h ]h"]h$]h&]hjuh1hhj!dhhhhhM-ubh)}(hXCRTC's have both an object ID and an index, and they are not the same thing. The index is used in cases where a densely packed identifier for a CRTC is needed, for instance a bitmask of CRTC's. The member possible_crtcs of struct drm_mode_get_plane is an example.h]hX CRTC’s have both an object ID and an index, and they are not the same thing. The index is used in cases where a densely packed identifier for a CRTC is needed, for instance a bitmask of CRTC’s. The member possible_crtcs of struct drm_mode_get_plane is an example.}(hj2dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM/hj!dhhubh)}(h:c:macro:`DRM_IOCTL_MODE_GETRESOURCES` populates a structure with an array of CRTC ID's, and the CRTC index is its position in this array.h](h)}(h&:c:macro:`DRM_IOCTL_MODE_GETRESOURCES`h]j)}(hjFdh]hDRM_IOCTL_MODE_GETRESOURCES}(hjHdhhhNhNubah}(h]h ](j j c-macroeh"]h$]h&]uh1jhjDdubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypemacro refexplicitrefwarnj j j DRM_IOCTL_MODE_GETRESOURCESuh1hhhhM4hj@dubhf populates a structure with an array of CRTC ID’s, and the CRTC index is its position in this array.}(hj@dhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM4hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_gem_close (C struct)c.drm_gem_closehNtauh1j hj!dhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhNubj# )}(hhh](j( )}(h drm_gem_closeh]j. )}(hstruct drm_gem_closeh](j )}(hj h]hstruct}(hjdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjdhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhKubjF )}(h h]h }(hjdhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjdhhhjdhKubjW )}(h drm_gem_closeh]j] )}(hjdh]h drm_gem_close}(hjdhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjdubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjdhhhjdhKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjdhhhjdhKubah}(h]jydah ](j j eh"]h$]h&]j j )j huh1j' hjdhKhj|dhhubj )}(hhh]h)}(h1Argument for :c:type:`DRM_IOCTL_GEM_CLOSE` ioctl.h](h Argument for }(hjdhhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_CLOSE`h]j)}(hjdh]hDRM_IOCTL_GEM_CLOSE}(hjdhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]j )}j jdsbc.drm_gem_closeasbj DRM_IOCTL_GEM_CLOSEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhKhjdubh ioctl.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMGhjdhhubah}(h]h ]h"]h$]h&]uh1j hj|dhhhjdhKubeh}(h]h ](j structeh"]h$]h&]jN j jO j ejP j ejQ jR jS uh1j" hhhj!dhj{dhNubjU )}(h**Definition**:: struct drm_gem_close { __u32 handle; __u32 pad; }; **Members** ``handle`` Handle of the object to be closed. ``pad`` Padding.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjeubh:}(hjehhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMKhjeubj)}(h:struct drm_gem_close { __u32 handle; __u32 pad; };h]h:struct drm_gem_close { __u32 handle; __u32 pad; };}hj1esbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMMhjeubh)}(h **Members**h]j' )}(hjBeh]hMembers}(hjDehhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj@eubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMRhjeubjs )}(hhh](jx )}(h.``handle`` Handle of the object to be closed. h](j~ )}(h ``handle``h]j)}(hjaeh]hhandle}(hjcehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_eubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMIhj[eubj )}(hhh]h)}(h"Handle of the object to be closed.h]h"Handle of the object to be closed.}(hjzehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvehMIhjweubah}(h]h ]h"]h$]h&]uh1j hj[eubeh}(h]h ]h"]h$]h&]uh1jw hjvehMIhjXeubjx )}(h``pad`` Padding.h](j~ )}(h``pad``h]j)}(hjeh]hpad}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMIhjeubj )}(hhh]h)}(hPadding.h]hPadding.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMJhjeubah}(h]h ]h"]h$]h&]uh1j hjeubeh}(h]h ]h"]h$]h&]uh1jw hjehMIhjXeubeh}(h]h ]h"]h$]h&]uh1jr hjeubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjeh]h Description}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjeubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMMhj!dhhubh)}(h$Releases the handle to an mm object.h]h$Releases the handle to an mm object.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMJhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_gem_flink (C struct)c.drm_gem_flinkhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h drm_gem_flinkh]j. )}(hstruct drm_gem_flinkh](j )}(hj h]hstruct}(hjfhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjfhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMOubjF )}(h h]h }(hj)fhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjfhhhj(fhMOubjW )}(h drm_gem_flinkh]j] )}(hjfh]h drm_gem_flink}(hj;fhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj7fubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjfhhhj(fhMOubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjfhhhj(fhMOubah}(h]jfah ](j j eh"]h$]h&]j j )j huh1j' hj(fhMOhjfhhubj )}(hhh]h)}(h1Argument for :c:type:`DRM_IOCTL_GEM_FLINK` ioctl.h](h Argument for }(hj]fhhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_FLINK`h]j)}(hjgfh]hDRM_IOCTL_GEM_FLINK}(hjifhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjefubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]j )}j jfsbc.drm_gem_flinkasbj DRM_IOCTL_GEM_FLINKuh1hhjdhKhj]fubh ioctl.}(hj]fhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMShjZfhhubah}(h]h ]h"]h$]h&]uh1j hjfhhhj(fhMOubeh}(h]h ](j structeh"]h$]h&]jN j jO jfjP jfjQ jR jS uh1j" hhhj!dhj{dhNubjU )}(h**Definition**:: struct drm_gem_flink { __u32 handle; __u32 name; }; **Members** ``handle`` Handle for the object being named. ``name`` Returned global name.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjfubh:}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMWhjfubj)}(h;struct drm_gem_flink { __u32 handle; __u32 name; };h]h;struct drm_gem_flink { __u32 handle; __u32 name; };}hjfsbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhjfubh)}(h **Members**h]j' )}(hjfh]hMembers}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjfubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM^hjfubjs )}(hhh](jx )}(h.``handle`` Handle for the object being named. h](j~ )}(h ``handle``h]j)}(hjfh]hhandle}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMUhjfubj )}(hhh]h)}(h"Handle for the object being named.h]h"Handle for the object being named.}(hj ghhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ghMUhj gubah}(h]h ]h"]h$]h&]uh1j hjfubeh}(h]h ]h"]h$]h&]uh1jw hj ghMUhjfubjx )}(h``name`` Returned global name.h](j~ )}(h``name``h]j)}(hj-gh]hname}(hj/ghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+gubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMUhj'gubj )}(hhh]h)}(hReturned global name.h]hReturned global name.}(hjFghhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMVhjCgubah}(h]h ]h"]h$]h&]uh1j hj'gubeh}(h]h ]h"]h$]h&]uh1jw hjBghMUhjfubeh}(h]h ]h"]h$]h&]uh1jr hjfubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjpgh]h Description}(hjrghhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjngubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhj!dhhubh)}(h7Create a global name for an object, returning the name.h]h7Create a global name for an object, returning the name.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMVhj!dhhubh)}(h[Note that the name does not hold a reference; when the object is freed, the name goes away.h]h[Note that the name does not hold a reference; when the object is freed, the name goes away.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMXhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_gem_open (C struct)c.drm_gem_openhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h drm_gem_openh]j. )}(hstruct drm_gem_openh](j )}(hj h]hstruct}(hjghhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjghhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM^ubjF )}(h h]h }(hjghhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjghhhjghM^ubjW )}(h drm_gem_openh]j] )}(hjgh]h drm_gem_open}(hjghhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjgubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjghhhjghM^ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjghhhjghM^ubah}(h]jgah ](j j eh"]h$]h&]j j )j huh1j' hjghM^hjghhubj )}(hhh]h)}(h0Argument for :c:type:`DRM_IOCTL_GEM_OPEN` ioctl.h](h Argument for }(hjghhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_OPEN`h]j)}(hj hh]hDRM_IOCTL_GEM_OPEN}(hj hhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]j )}j jgsbc.drm_gem_openasbj DRM_IOCTL_GEM_OPENuh1hhjdhKhjgubh ioctl.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMbhjghhubah}(h]h ]h"]h$]h&]uh1j hjghhhjghM^ubeh}(h]h ](j structeh"]h$]h&]jN j jO jAhjP jAhjQ jR jS uh1j" hhhj!dhj{dhNubjU )}(h**Definition**:: struct drm_gem_open { __u32 name; __u32 handle; __u64 size; }; **Members** ``name`` Name of object being opened. ``handle`` Returned handle for the object. ``size`` Returned size of the objecth](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjMhhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjIhubh:}(hjIhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMfhjEhubj)}(hJstruct drm_gem_open { __u32 name; __u32 handle; __u64 size; };h]hJstruct drm_gem_open { __u32 name; __u32 handle; __u64 size; };}hjfhsbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhhjEhubh)}(h **Members**h]j' )}(hjwhh]hMembers}(hjyhhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjuhubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMnhjEhubjs )}(hhh](jx )}(h&``name`` Name of object being opened. h](j~ )}(h``name``h]j)}(hjhh]hname}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMdhjhubj )}(hhh]h)}(hName of object being opened.h]hName of object being opened.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMdhjhubah}(h]h ]h"]h$]h&]uh1j hjhubeh}(h]h ]h"]h$]h&]uh1jw hjhhMdhjhubjx )}(h+``handle`` Returned handle for the object. h](j~ )}(h ``handle``h]j)}(hjhh]hhandle}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMehjhubj )}(hhh]h)}(hReturned handle for the object.h]hReturned handle for the object.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMehjhubah}(h]h ]h"]h$]h&]uh1j hjhubeh}(h]h ]h"]h$]h&]uh1jw hjhhMehjhubjx )}(h$``size`` Returned size of the objecth](j~ )}(h``size``h]j)}(hjih]hsize}(hj ihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMehjiubj )}(hhh]h)}(hReturned size of the objecth]hReturned size of the object}(hj!ihhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMfhjiubah}(h]h ]h"]h$]h&]uh1j hjiubeh}(h]h ]h"]h$]h&]uh1jw hjihMehjhubeh}(h]h ]h"]h$]h&]uh1jr hjEhubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjKih]h Description}(hjMihhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjIiubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMihj!dhhubh)}(hFOpen an object using the global name, returning a handle and the size.h]hFOpen an object using the global name, returning a handle and the size.}(hjaihhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMfhj!dhhubh)}(htThis handle (of course) holds a reference to the object, so the object will not go away until the handle is deleted.h]htThis handle (of course) holds a reference to the object, so the object will not go away until the handle is deleted.}(hjpihhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_gem_change_handle (C struct)c.drm_gem_change_handlehNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hdrm_gem_change_handleh]j. )}(hstruct drm_gem_change_handleh](j )}(hj h]hstruct}(hjihhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjihhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMnubjF )}(h h]h }(hjihhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjihhhjihMnubjW )}(hdrm_gem_change_handleh]j] )}(hjih]hdrm_gem_change_handle}(hjihhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjiubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjihhhjihMnubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjihhhjihMnubah}(h]jiah ](j j eh"]h$]h&]j j )j huh1j' hjihMnhjihhubj )}(hhh]h)}(h9Argument for :c:type:`DRM_IOCTL_GEM_CHANGE_HANDLE` ioctl.h](h Argument for }(hjihhhNhNubh)}(h%:c:type:`DRM_IOCTL_GEM_CHANGE_HANDLE`h]j)}(hjih]hDRM_IOCTL_GEM_CHANGE_HANDLE}(hjihhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j )}j ]j )}j jisbc.drm_gem_change_handleasbj DRM_IOCTL_GEM_CHANGE_HANDLEuh1hhjdhKhjiubh ioctl.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMshjihhubah}(h]h ]h"]h$]h&]uh1j hjihhhjihMnubeh}(h]h ](j structeh"]h$]h&]jN j jO jjjP jjjQ jR jS uh1j" hhhj!dhj{dhNubjU )}(h**Definition**:: struct drm_gem_change_handle { __u32 handle; __u32 new_handle; }; **Members** ``handle`` The handle of a gem object. ``new_handle`` An available gem handle.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj(jhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj$jubh:}(hj$jhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMwhj jubj)}(hIstruct drm_gem_change_handle { __u32 handle; __u32 new_handle; };h]hIstruct drm_gem_change_handle { __u32 handle; __u32 new_handle; };}hjAjsbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMyhj jubh)}(h **Members**h]j' )}(hjRjh]hMembers}(hjTjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjPjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hj jubjs )}(hhh](jx )}(h'``handle`` The handle of a gem object. h](j~ )}(h ``handle``h]j)}(hjqjh]hhandle}(hjsjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjojubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMuhjkjubj )}(hhh]h)}(hThe handle of a gem object.h]hThe handle of a gem object.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhMuhjjubah}(h]h ]h"]h$]h&]uh1j hjkjubeh}(h]h ]h"]h$]h&]uh1jw hjjhMuhjhjubjx )}(h'``new_handle`` An available gem handle.h](j~ )}(h``new_handle``h]j)}(hjjh]h new_handle}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMuhjjubj )}(hhh]h)}(hAn available gem handle.h]hAn available gem handle.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMvhjjubah}(h]h ]h"]h$]h&]uh1j hjjubeh}(h]h ]h"]h$]h&]uh1jw hjjhMuhjhjubeh}(h]h ]h"]h$]h&]uh1jr hj jubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjjh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMyhj!dhhubh)}(hXThis ioctl changes the handle of a GEM object to the specified one. The new handle must be unused. On success the old handle is closed and all further IOCTL should refer to the new handle only. Calls to DRM_IOCTL_PRIME_FD_TO_HANDLE will return the new handle.h]hXThis ioctl changes the handle of a GEM object to the specified one. The new handle must be unused. On success the old handle is closed and all further IOCTL should refer to the new handle only. Calls to DRM_IOCTL_PRIME_FD_TO_HANDLE will return the new handle.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMvhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_CAP_DUMB_BUFFER (C macro)c.DRM_CAP_DUMB_BUFFERhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_DUMB_BUFFERh]j. )}(hDRM_CAP_DUMB_BUFFERh]jW )}(hDRM_CAP_DUMB_BUFFERh]j] )}(hj%kh]hDRM_CAP_DUMB_BUFFER}(hj/khhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj+kubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj'khhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj#khhhjBkhMubah}(h]jkah ](j j eh"]h$]h&]j j )j huh1j' hjBkhMhj khhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj khhhjBkhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO j[kjP j[kjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_DUMB_BUFFER``h]j)}(hjakh]hDRM_CAP_DUMB_BUFFER}(hjckhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_kubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(h}**Description** If set to 1, the driver supports creating dumb buffers via the :c:type:`DRM_IOCTL_MODE_CREATE_DUMB` ioctl. h](h)}(h**Description**h]j' )}(hj}kh]h Description}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj{kubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjwkubh)}(hjIf set to 1, the driver supports creating dumb buffers via the :c:type:`DRM_IOCTL_MODE_CREATE_DUMB` ioctl.h](h?If set to 1, the driver supports creating dumb buffers via the }(hjkhhhNhNubh)}(h$:c:type:`DRM_IOCTL_MODE_CREATE_DUMB`h]j)}(hjkh]hDRM_IOCTL_MODE_CREATE_DUMB}(hjkhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_CREATE_DUMBuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjkubh ioctl.}(hjkhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjkhMhjwkubeh}(h]h ]h"]h$]h&]uh1jlhjkhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_CAP_VBLANK_HIGH_CRTC (C macro)c.DRM_CAP_VBLANK_HIGH_CRTChNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_VBLANK_HIGH_CRTCh]j. )}(hDRM_CAP_VBLANK_HIGH_CRTCh]jW )}(hDRM_CAP_VBLANK_HIGH_CRTCh]j] )}(hjkh]hDRM_CAP_VBLANK_HIGH_CRTC}(hjkhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjkubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjkhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjkhhhjkhMubah}(h]jkah ](j j eh"]h$]h&]j j )j huh1j' hjkhMhjkhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjkhhhjkhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jljP jljQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_VBLANK_HIGH_CRTC``h]j)}(hjlh]hDRM_CAP_VBLANK_HIGH_CRTC}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(h**Description** If set to 1, the kernel supports specifying a :ref:`CRTC index` in the high bits of :c:type:`drm_wait_vblank_request.type `. Starting kernel version 2.6.39, this capability is always set to 1. h](h)}(h**Description**h]j' )}(hj6lh]h Description}(hj8lhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj4lubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj0lubh)}(hIf set to 1, the kernel supports specifying a :ref:`CRTC index` in the high bits of :c:type:`drm_wait_vblank_request.type `.h](h.If set to 1, the kernel supports specifying a }(hjLlhhhNhNubh)}(h:ref:`CRTC index`h]j~)}(hjVlh]h CRTC index}(hjXlhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjTlubah}(h]h ]h"]h$]h&]refdocj refdomainjblreftyperef refexplicitrefwarnj crtc_indexuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjLlubh in the high bits of }(hjLlhhhNhNubh)}(h@:c:type:`drm_wait_vblank_request.type `h]j)}(hj{lh]hdrm_wait_vblank_request.type}(hj}lhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjylubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_wait_vblank_requestuh1hhjtlhMhjLlubh.}(hjLlhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjtlhMhj0lubh)}(hCStarting kernel version 2.6.39, this capability is always set to 1.h]hCStarting kernel version 2.6.39, this capability is always set to 1.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj0lubeh}(h]h ]h"]h$]h&]uh1jlhjKlhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j &DRM_CAP_DUMB_PREFERRED_DEPTH (C macro)c.DRM_CAP_DUMB_PREFERRED_DEPTHhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_DUMB_PREFERRED_DEPTHh]j. )}(hDRM_CAP_DUMB_PREFERRED_DEPTHh]jW )}(hDRM_CAP_DUMB_PREFERRED_DEPTHh]j] )}(hjlh]hDRM_CAP_DUMB_PREFERRED_DEPTH}(hjlhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjlubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjlhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjlhhhjlhMubah}(h]jlah ](j j eh"]h$]h&]j j )j huh1j' hjlhMhjlhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjlhhhjlhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jmjP jmjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h ``DRM_CAP_DUMB_PREFERRED_DEPTH``h]j)}(hjmh]hDRM_CAP_DUMB_PREFERRED_DEPTH}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hX**Description** The preferred bit depth for dumb buffers. The bit depth is the number of bits used to indicate the color of a single pixel excluding any padding. This is different from the number of bits per pixel. For instance, XRGB8888 has a bit depth of 24 but has 32 bits per pixel. Note that this preference only applies to dumb buffers, it's irrelevant for other types of buffers. h](h)}(h**Description**h]j' )}(hj"mh]h Description}(hj$mhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj mubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh)}(h)The preferred bit depth for dumb buffers.h]h)The preferred bit depth for dumb buffers.}(hj8mhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh)}(hThe bit depth is the number of bits used to indicate the color of a single pixel excluding any padding. This is different from the number of bits per pixel. For instance, XRGB8888 has a bit depth of 24 but has 32 bits per pixel.h]hThe bit depth is the number of bits used to indicate the color of a single pixel excluding any padding. This is different from the number of bits per pixel. For instance, XRGB8888 has a bit depth of 24 but has 32 bits per pixel.}(hjGmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh)}(hcNote that this preference only applies to dumb buffers, it's irrelevant for other types of buffers.h]heNote that this preference only applies to dumb buffers, it’s irrelevant for other types of buffers.}(hjVmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubeh}(h]h ]h"]h$]h&]uh1jlhj7mhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j $DRM_CAP_DUMB_PREFER_SHADOW (C macro)c.DRM_CAP_DUMB_PREFER_SHADOWhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_DUMB_PREFER_SHADOWh]j. )}(hDRM_CAP_DUMB_PREFER_SHADOWh]jW )}(hDRM_CAP_DUMB_PREFER_SHADOWh]j] )}(hj~mh]hDRM_CAP_DUMB_PREFER_SHADOW}(hjmhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjmubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjmhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj|mhhhjmhMubah}(h]jwmah ](j j eh"]h$]h&]j j )j huh1j' hjmhMhjymhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjymhhhjmhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jmjP jmjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_DUMB_PREFER_SHADOW``h]j)}(hjmh]hDRM_CAP_DUMB_PREFER_SHADOW}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hX_**Description** If set to 1, the driver prefers userspace to render to a shadow buffer instead of directly rendering to a dumb buffer. For best speed, userspace should do streaming ordered memory copies into the dumb buffer and never read from it. Note that this preference only applies to dumb buffers, it's irrelevant for other types of buffers. h](h)}(h**Description**h]j' )}(hjmh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjmubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh)}(hIf set to 1, the driver prefers userspace to render to a shadow buffer instead of directly rendering to a dumb buffer. For best speed, userspace should do streaming ordered memory copies into the dumb buffer and never read from it.h]hIf set to 1, the driver prefers userspace to render to a shadow buffer instead of directly rendering to a dumb buffer. For best speed, userspace should do streaming ordered memory copies into the dumb buffer and never read from it.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh)}(hcNote that this preference only applies to dumb buffers, it's irrelevant for other types of buffers.h]heNote that this preference only applies to dumb buffers, it’s irrelevant for other types of buffers.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubeh}(h]h ]h"]h$]h&]uh1jlhjmhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_CAP_PRIME (C macro)c.DRM_CAP_PRIMEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h DRM_CAP_PRIMEh]j. )}(h DRM_CAP_PRIMEh]jW )}(h DRM_CAP_PRIMEh]j] )}(hj#nh]h DRM_CAP_PRIME}(hj-nhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj)nubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj%nhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj!nhhhj@nhMubah}(h]jnah ](j j eh"]h$]h&]j j )j huh1j' hj@nhMhjnhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjnhhhj@nhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jYnjP jYnjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_PRIME``h]j)}(hj_nh]h DRM_CAP_PRIME}(hjanhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]nubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hXe**Description** Bitfield of supported PRIME sharing capabilities. See :c:type:`DRM_PRIME_CAP_IMPORT` and :c:type:`DRM_PRIME_CAP_EXPORT`. Starting from kernel version 6.6, both :c:type:`DRM_PRIME_CAP_IMPORT` and :c:type:`DRM_PRIME_CAP_EXPORT` are always advertised. PRIME buffers are exposed as dma-buf file descriptors. See :ref:`prime_buffer_sharing`. h](h)}(h**Description**h]j' )}(hj{nh]h Description}(hj}nhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjynubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjunubh)}(hxBitfield of supported PRIME sharing capabilities. See :c:type:`DRM_PRIME_CAP_IMPORT` and :c:type:`DRM_PRIME_CAP_EXPORT`.h](h6Bitfield of supported PRIME sharing capabilities. See }(hjnhhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_IMPORT`h]j)}(hjnh]hDRM_PRIME_CAP_IMPORT}(hjnhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_IMPORTuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjnubh and }(hjnhhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_EXPORT`h]j)}(hjnh]hDRM_PRIME_CAP_EXPORT}(hjnhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_EXPORTuh1hhjnhMhjnubh.}(hjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjnhMhjunubh)}(hStarting from kernel version 6.6, both :c:type:`DRM_PRIME_CAP_IMPORT` and :c:type:`DRM_PRIME_CAP_EXPORT` are always advertised.h](h'Starting from kernel version 6.6, both }(hjnhhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_IMPORT`h]j)}(hjnh]hDRM_PRIME_CAP_IMPORT}(hjnhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_IMPORTuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjnubh and }(hjnhhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_EXPORT`h]j)}(hjoh]hDRM_PRIME_CAP_EXPORT}(hjohhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_EXPORTuh1hhj ohMhjnubh are always advertised.}(hjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj ohMhjunubh)}(hWPRIME buffers are exposed as dma-buf file descriptors. See :ref:`prime_buffer_sharing`.h](h;PRIME buffers are exposed as dma-buf file descriptors. See }(hj;ohhhNhNubh)}(h:ref:`prime_buffer_sharing`h]j~)}(hjEoh]hprime_buffer_sharing}(hjGohhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjCoubah}(h]h ]h"]h$]h&]refdocj refdomainjQoreftyperef refexplicitrefwarnj prime_buffer_sharinguh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj;oubh.}(hj;ohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjcohMhjunubeh}(h]h ]h"]h$]h&]uh1jlhjnhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_PRIME_CAP_IMPORT (C macro)c.DRM_PRIME_CAP_IMPORThNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_PRIME_CAP_IMPORTh]j. )}(hDRM_PRIME_CAP_IMPORTh]jW )}(hDRM_PRIME_CAP_IMPORTh]j] )}(hjoh]hDRM_PRIME_CAP_IMPORT}(hjohhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjoubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjohhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjohhhjohMubah}(h]joah ](j j eh"]h$]h&]j j )j huh1j' hjohMhjohhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjohhhjohMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jojP jojQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_PRIME_CAP_IMPORT``h]j)}(hjoh]hDRM_PRIME_CAP_IMPORT}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(h**Description** If this bit is set in :c:type:`DRM_CAP_PRIME`, the driver supports importing PRIME buffers via the :c:type:`DRM_IOCTL_PRIME_FD_TO_HANDLE` ioctl. Starting from kernel version 6.6, this bit is always set in :c:type:`DRM_CAP_PRIME`. h](h)}(h**Description**h]j' )}(hjoh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjoubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjoubh)}(hIf this bit is set in :c:type:`DRM_CAP_PRIME`, the driver supports importing PRIME buffers via the :c:type:`DRM_IOCTL_PRIME_FD_TO_HANDLE` ioctl.h](hIf this bit is set in }(hjohhhNhNubh)}(h:c:type:`DRM_CAP_PRIME`h]j)}(hjoh]h DRM_CAP_PRIME}(hjphhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CAP_PRIMEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjoubh6, the driver supports importing PRIME buffers via the }(hjohhhNhNubh)}(h&:c:type:`DRM_IOCTL_PRIME_FD_TO_HANDLE`h]j)}(hj#ph]hDRM_IOCTL_PRIME_FD_TO_HANDLE}(hj%phhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj!pubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_PRIME_FD_TO_HANDLEuh1hhjphMhjoubh ioctl.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjphMhjoubh)}(hTStarting from kernel version 6.6, this bit is always set in :c:type:`DRM_CAP_PRIME`.h](hthhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:tubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(h6**Description** See :c:type:`DRM_CAP_CURSOR_WIDTH`. h](h)}(h**Description**h]j' )}(hjXth]h Description}(hjZthhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjVtubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjRtubh)}(h#See :c:type:`DRM_CAP_CURSOR_WIDTH`.h](hSee }(hjnthhhNhNubh)}(h:c:type:`DRM_CAP_CURSOR_WIDTH`h]j)}(hjxth]hDRM_CAP_CURSOR_WIDTH}(hjzthhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjvtubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CAP_CURSOR_WIDTHuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjntubh.}(hjnthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjthMhjRtubeh}(h]h ]h"]h$]h&]uh1jlhjmthMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_CAP_ADDFB2_MODIFIERS (C macro)c.DRM_CAP_ADDFB2_MODIFIERShNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_ADDFB2_MODIFIERSh]j. )}(hDRM_CAP_ADDFB2_MODIFIERSh]jW )}(hDRM_CAP_ADDFB2_MODIFIERSh]j] )}(hjth]hDRM_CAP_ADDFB2_MODIFIERS}(hjthhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjtubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjthhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjthhhjthMubah}(h]jtah ](j j eh"]h$]h&]j j )j huh1j' hjthMhjthhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjthhhjthMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jtjP jtjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_ADDFB2_MODIFIERS``h]j)}(hjth]hDRM_CAP_ADDFB2_MODIFIERS}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hu**Description** If set to 1, the driver supports supplying modifiers in the :c:type:`DRM_IOCTL_MODE_ADDFB2` ioctl. h](h)}(h**Description**h]j' )}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjuubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj uubh)}(hbIf set to 1, the driver supports supplying modifiers in the :c:type:`DRM_IOCTL_MODE_ADDFB2` ioctl.h](h` for the :c:type:`DRM_IOCTL_MODE_PAGE_FLIP` ioctl. h](h)}(h**Description**h]j' )}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjuubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjuubh)}(hX If set to 1, the driver supports the :c:type:`DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE` and :c:type:`DRM_MODE_PAGE_FLIP_TARGET_RELATIVE` flags in :c:type:`drm_mode_crtc_page_flip_target.flags ` for the :c:type:`DRM_IOCTL_MODE_PAGE_FLIP` ioctl.h](h%If set to 1, the driver supports the }(hjuhhhNhNubh)}(h,:c:type:`DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE`h]j)}(hjuh]h"DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE}(hjuhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j "DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjuubh and }(hjuhhhNhNubh)}(h,:c:type:`DRM_MODE_PAGE_FLIP_TARGET_RELATIVE`h]j)}(hjvh]h"DRM_MODE_PAGE_FLIP_TARGET_RELATIVE}(hjvhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj vubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j "DRM_MODE_PAGE_FLIP_TARGET_RELATIVEuh1hhjvhMhjuubh flags in }(hjuhhhNhNubh)}(hO:c:type:`drm_mode_crtc_page_flip_target.flags `h]j)}(hj1vh]h$drm_mode_crtc_page_flip_target.flags}(hj3vhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj/vubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_crtc_page_flip_targetuh1hhjvhMhjuubh for the }(hjuhhhNhNubh)}(h":c:type:`DRM_IOCTL_MODE_PAGE_FLIP`h]j)}(hjTvh]hDRM_IOCTL_MODE_PAGE_FLIP}(hjVvhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjRvubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_PAGE_FLIPuh1hhjvhMhjuubh ioctl.}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjvhMhjuubeh}(h]h ]h"]h$]h&]uh1jlhjuhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j &DRM_CAP_CRTC_IN_VBLANK_EVENT (C macro)c.DRM_CAP_CRTC_IN_VBLANK_EVENThNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_CRTC_IN_VBLANK_EVENTh]j. )}(hDRM_CAP_CRTC_IN_VBLANK_EVENTh]jW )}(hDRM_CAP_CRTC_IN_VBLANK_EVENTh]j] )}(hjvh]hDRM_CAP_CRTC_IN_VBLANK_EVENT}(hjvhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjvubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjvhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjvhhhjvhMubah}(h]jvah ](j j eh"]h$]h&]j j )j huh1j' hjvhMhjvhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjvhhhjvhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jvjP jvjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h ``DRM_CAP_CRTC_IN_VBLANK_EVENT``h]j)}(hjvh]hDRM_CAP_CRTC_IN_VBLANK_EVENT}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hX**Description** If set to 1, the kernel supports reporting the CRTC ID in :c:type:`drm_event_vblank.crtc_id ` for the :c:type:`DRM_EVENT_VBLANK` and :c:type:`DRM_EVENT_FLIP_COMPLETE` events. Starting kernel version 4.12, this capability is always set to 1. h](h)}(h**Description**h]j' )}(hjvh]h Description}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjvubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjvubh)}(hIf set to 1, the kernel supports reporting the CRTC ID in :c:type:`drm_event_vblank.crtc_id ` for the :c:type:`DRM_EVENT_VBLANK` and :c:type:`DRM_EVENT_FLIP_COMPLETE` events.h](h:If set to 1, the kernel supports reporting the CRTC ID in }(hjwhhhNhNubh)}(h5:c:type:`drm_event_vblank.crtc_id `h]j)}(hj wh]hdrm_event_vblank.crtc_id}(hjwhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj wubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_event_vblankuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjwubh for the }(hjwhhhNhNubh)}(h:c:type:`DRM_EVENT_VBLANK`h]j)}(hj0wh]hDRM_EVENT_VBLANK}(hj2whhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj.wubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_VBLANKuh1hhj)whMhjwubh and }(hjwhhhNhNubh)}(h!:c:type:`DRM_EVENT_FLIP_COMPLETE`h]j)}(hjSwh]hDRM_EVENT_FLIP_COMPLETE}(hjUwhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjQwubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_FLIP_COMPLETEuh1hhj)whMhjwubh events.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj)whMhjvubh)}(hAStarting kernel version 4.12, this capability is always set to 1.h]hAStarting kernel version 4.12, this capability is always set to 1.}(hjzwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjvubeh}(h]h ]h"]h$]h&]uh1jlhjwhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_CAP_SYNCOBJ (C macro)c.DRM_CAP_SYNCOBJhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_SYNCOBJh]j. )}(hDRM_CAP_SYNCOBJh]jW )}(hDRM_CAP_SYNCOBJh]j] )}(hjwh]hDRM_CAP_SYNCOBJ}(hjwhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjwubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjwhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjwhhhjwhM ubah}(h]jwah ](j j eh"]h$]h&]j j )j huh1j' hjwhM hjwhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjwhhhjwhM ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jwjP jwjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_SYNCOBJ``h]j)}(hjwh]hDRM_CAP_SYNCOBJ}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM hj!dhhubjm)}(h^**Description** If set to 1, the driver supports sync objects. See :ref:`drm_sync_objects`. h](h)}(h**Description**h]j' )}(hjwh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjwubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM hjwubh)}(hKIf set to 1, the driver supports sync objects. See :ref:`drm_sync_objects`.h](h3If set to 1, the driver supports sync objects. See }(hjxhhhNhNubh)}(h:ref:`drm_sync_objects`h]j~)}(hjxh]hdrm_sync_objects}(hjxhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjxubah}(h]h ]h"]h$]h&]refdocj refdomainj&xreftyperef refexplicitrefwarnj drm_sync_objectsuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM hjxubh.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj8xhM hjwubeh}(h]h ]h"]h$]h&]uh1jlhjxhM hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_CAP_SYNCOBJ_TIMELINE (C macro)c.DRM_CAP_SYNCOBJ_TIMELINEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_SYNCOBJ_TIMELINEh]j. )}(hDRM_CAP_SYNCOBJ_TIMELINEh]jW )}(hDRM_CAP_SYNCOBJ_TIMELINEh]j] )}(hj\xh]hDRM_CAP_SYNCOBJ_TIMELINE}(hjfxhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjbxubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj^xhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjZxhhhjyxhMubah}(h]jUxah ](j j eh"]h$]h&]j j )j huh1j' hjyxhMhjWxhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjWxhhhjyxhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jxjP jxjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CAP_SYNCOBJ_TIMELINE``h]j)}(hjxh]hDRM_CAP_SYNCOBJ_TIMELINE}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hu**Description** If set to 1, the driver supports timeline operations on sync objects. See :ref:`drm_sync_objects`. h](h)}(h**Description**h]j' )}(hjxh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjxubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjxubh)}(hbIf set to 1, the driver supports timeline operations on sync objects. See :ref:`drm_sync_objects`.h](hJIf set to 1, the driver supports timeline operations on sync objects. See }(hjxhhhNhNubh)}(h:ref:`drm_sync_objects`h]j~)}(hjxh]hdrm_sync_objects}(hjxhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjxubah}(h]h ]h"]h$]h&]refdocj refdomainjxreftyperef refexplicitrefwarnj drm_sync_objectsuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjxubh.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjxhMhjxubeh}(h]h ]h"]h$]h&]uh1jlhjxhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j (DRM_CAP_ATOMIC_ASYNC_PAGE_FLIP (C macro) c.DRM_CAP_ATOMIC_ASYNC_PAGE_FLIPhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CAP_ATOMIC_ASYNC_PAGE_FLIPh]j. )}(hDRM_CAP_ATOMIC_ASYNC_PAGE_FLIPh]jW )}(hDRM_CAP_ATOMIC_ASYNC_PAGE_FLIPh]j] )}(hjyh]hDRM_CAP_ATOMIC_ASYNC_PAGE_FLIP}(hj yhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjyubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjyhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjyhhhj3yhMubah}(h]jyah ](j j eh"]h$]h&]j j )j huh1j' hj3yhMhjyhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjyhhhj3yhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jLyjP jLyjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h"``DRM_CAP_ATOMIC_ASYNC_PAGE_FLIP``h]j)}(hjRyh]hDRM_CAP_ATOMIC_ASYNC_PAGE_FLIP}(hjTyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPyubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hj**Description** If set to 1, the driver supports :c:type:`DRM_MODE_PAGE_FLIP_ASYNC` for atomic commits. h](h)}(h**Description**h]j' )}(hjnyh]h Description}(hjpyhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjlyubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjhyubh)}(hWIf set to 1, the driver supports :c:type:`DRM_MODE_PAGE_FLIP_ASYNC` for atomic commits.h](h!If set to 1, the driver supports }(hjyhhhNhNubh)}(h":c:type:`DRM_MODE_PAGE_FLIP_ASYNC`h]j)}(hjyh]hDRM_MODE_PAGE_FLIP_ASYNC}(hjyhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PAGE_FLIP_ASYNCuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjyubh for atomic commits.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjyhMhjhyubeh}(h]h ]h"]h$]h&]uh1jlhjyhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_CLIENT_CAP_STEREO_3D (C macro)c.DRM_CLIENT_CAP_STEREO_3DhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CLIENT_CAP_STEREO_3Dh]j. )}(hDRM_CLIENT_CAP_STEREO_3Dh]jW )}(hDRM_CLIENT_CAP_STEREO_3Dh]j] )}(hjyh]hDRM_CLIENT_CAP_STEREO_3D}(hjyhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjyubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjyhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM%ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjyhhhjyhM%ubah}(h]jyah ](j j eh"]h$]h&]j j )j huh1j' hjyhM%hjyhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjyhhhjyhM%ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jzjP jzjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CLIENT_CAP_STEREO_3D``h]j)}(hj zh]hDRM_CLIENT_CAP_STEREO_3D}(hj zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj zubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM'hj!dhhubjm)}(hX(**Description** If set to 1, the DRM core will expose the stereo 3D capabilities of the monitor by advertising the supported 3D layouts in the flags of struct drm_mode_modeinfo. See ``DRM_MODE_FLAG_3D_*``. This capability is always supported for all drivers starting from kernel version 3.13. h](h)}(h**Description**h]j' )}(hj'zh]h Description}(hj)zhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj%zubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM'hj!zubh)}(hIf set to 1, the DRM core will expose the stereo 3D capabilities of the monitor by advertising the supported 3D layouts in the flags of struct drm_mode_modeinfo. See ``DRM_MODE_FLAG_3D_*``.h](hIf set to 1, the DRM core will expose the stereo 3D capabilities of the monitor by advertising the supported 3D layouts in the flags of struct drm_mode_modeinfo. See }(hj=zhhhNhNubj)}(h``DRM_MODE_FLAG_3D_*``h]hDRM_MODE_FLAG_3D_*}(hjEzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=zubh.}(hj=zhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM&hj!zubh)}(hVThis capability is always supported for all drivers starting from kernel version 3.13.h]hVThis capability is always supported for all drivers starting from kernel version 3.13.}(hj^zhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM*hj!zubeh}(h]h ]h"]h$]h&]uh1jlhjhj!dhhubjm)}(hX**Description** If set to 1, the DRM core will expose atomic properties to userspace. This implicitly enables :c:type:`DRM_CLIENT_CAP_UNIVERSAL_PLANES` and :c:type:`DRM_CLIENT_CAP_ASPECT_RATIO`. If the driver doesn't support atomic mode-setting, enabling this capability will fail with -EOPNOTSUPP. This capability has been introduced in kernel version 4.0. Starting from kernel version 4.2, this capability is always supported for atomic-capable drivers. h](h)}(h**Description**h]j' )}(hj{h]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj{ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM>hj}{ubh)}(hIf set to 1, the DRM core will expose atomic properties to userspace. This implicitly enables :c:type:`DRM_CLIENT_CAP_UNIVERSAL_PLANES` and :c:type:`DRM_CLIENT_CAP_ASPECT_RATIO`.h](h^If set to 1, the DRM core will expose atomic properties to userspace. This implicitly enables }(hj{hhhNhNubh)}(h):c:type:`DRM_CLIENT_CAP_UNIVERSAL_PLANES`h]j)}(hj{h]hDRM_CLIENT_CAP_UNIVERSAL_PLANES}(hj{hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_UNIVERSAL_PLANESuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM=hj{ubh and }(hj{hhhNhNubh)}(h%:c:type:`DRM_CLIENT_CAP_ASPECT_RATIO`h]j)}(hj{h]hDRM_CLIENT_CAP_ASPECT_RATIO}(hj{hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_ASPECT_RATIOuh1hhj{hM=hj{ubh.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj{hM=hj}{ubh)}(hgIf the driver doesn't support atomic mode-setting, enabling this capability will fail with -EOPNOTSUPP.h]hiIf the driver doesn’t support atomic mode-setting, enabling this capability will fail with -EOPNOTSUPP.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMAhj}{ubh)}(hThis capability has been introduced in kernel version 4.0. Starting from kernel version 4.2, this capability is always supported for atomic-capable drivers.h]hThis capability has been introduced in kernel version 4.0. Starting from kernel version 4.2, this capability is always supported for atomic-capable drivers.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMDhj}{ubeh}(h]h ]h"]h$]h&]uh1jlhj{hM>hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j %DRM_CLIENT_CAP_ASPECT_RATIO (C macro)c.DRM_CLIENT_CAP_ASPECT_RATIOhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_CLIENT_CAP_ASPECT_RATIOh]j. )}(hDRM_CLIENT_CAP_ASPECT_RATIOh]jW )}(hDRM_CLIENT_CAP_ASPECT_RATIOh]j] )}(hj%|h]hDRM_CLIENT_CAP_ASPECT_RATIO}(hj/|hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj+|ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj'|hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMLubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj#|hhhjB|hMLubah}(h]j|ah ](j j eh"]h$]h&]j j )j huh1j' hjB|hMLhj |hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj |hhhjB|hMLubeh}(h]h ](j macroeh"]h$]h&]jN j jO j[|jP j[|jQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_CLIENT_CAP_ASPECT_RATIO``h]j)}(hja|h]hDRM_CLIENT_CAP_ASPECT_RATIO}(hjc|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_|ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMNhj!dhhubjm)}(h**Description** If set to 1, the DRM core will provide aspect ratio information in modes. See ``DRM_MODE_FLAG_PIC_AR_*``. This capability is always supported for all drivers starting from kernel version 4.18. h](h)}(h**Description**h]j' )}(hj}|h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj{|ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMNhjw|ubh)}(hiIf set to 1, the DRM core will provide aspect ratio information in modes. See ``DRM_MODE_FLAG_PIC_AR_*``.h](hNIf set to 1, the DRM core will provide aspect ratio information in modes. See }(hj|hhhNhNubj)}(h``DRM_MODE_FLAG_PIC_AR_*``h]hDRM_MODE_FLAG_PIC_AR_*}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh.}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMMhjw|ubh)}(hVThis capability is always supported for all drivers starting from kernel version 4.18.h]hVThis capability is always supported for all drivers starting from kernel version 4.18.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMPhjw|ubeh}(h]h ]h"]h$]h&]uh1jlhj|hMNhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j -DRM_CLIENT_CAP_WRITEBACK_CONNECTORS (C macro)%c.DRM_CLIENT_CAP_WRITEBACK_CONNECTORShNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h#DRM_CLIENT_CAP_WRITEBACK_CONNECTORSh]j. )}(h#DRM_CLIENT_CAP_WRITEBACK_CONNECTORSh]jW )}(h#DRM_CLIENT_CAP_WRITEBACK_CONNECTORSh]j] )}(hj|h]h#DRM_CLIENT_CAP_WRITEBACK_CONNECTORS}(hj|hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj|ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj|hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMWubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj|hhhj|hMWubah}(h]j|ah ](j j eh"]h$]h&]j j )j huh1j' hj|hMWhj|hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj|hhhj|hMWubeh}(h]h ](j macroeh"]h$]h&]jN j jO j}jP j}jQ jR jS uh1j" hhhj!dhj{dhNubh)}(h'``DRM_CLIENT_CAP_WRITEBACK_CONNECTORS``h]j)}(hj}h]h#DRM_CLIENT_CAP_WRITEBACK_CONNECTORS}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhj!dhhubjm)}(hX1**Description** If set to 1, the DRM core will expose special connectors to be used for writing back to memory the scene setup in the commit. The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first. This capability is always supported for atomic-capable drivers starting from kernel version 4.19. h](h)}(h**Description**h]j' )}(hj4}h]h Description}(hj6}hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj2}ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhj.}ubh)}(hIf set to 1, the DRM core will expose special connectors to be used for writing back to memory the scene setup in the commit. The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first.h](hIf set to 1, the DRM core will expose special connectors to be used for writing back to memory the scene setup in the commit. The client must enable }(hjJ}hhhNhNubh)}(h:c:type:`DRM_CLIENT_CAP_ATOMIC`h]j)}(hjT}h]hDRM_CLIENT_CAP_ATOMIC}(hjV}hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjR}ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_ATOMICuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMXhjJ}ubh first.}(hjJ}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjq}hMXhj.}ubh)}(haThis capability is always supported for atomic-capable drivers starting from kernel version 4.19.h]haThis capability is always supported for atomic-capable drivers starting from kernel version 4.19.}(hj|}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM\hj.}ubeh}(h]h ]h"]h$]h&]uh1jlhjI}hMYhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j -DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT (C macro)%c.DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOThNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h#DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOTh]j. )}(h#DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOTh]jW )}(h#DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOTh]j] )}(hj}h]h#DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT}(hj}hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj}ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj}hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMcubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj}hhhj}hMcubah}(h]j}ah ](j j eh"]h$]h&]j j )j huh1j' hj}hMchj}hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj}hhhj}hMcubeh}(h]h ](j macroeh"]h$]h&]jN j jO j}jP j}jQ jR jS uh1j" hhhj!dhj{dhNubh)}(h'``DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT``h]j)}(hj}h]h#DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMehj!dhhubjm)}(hX **Description** Drivers for para-virtualized hardware (e.g. vmwgfx, qxl, virtio and virtualbox) have additional restrictions for cursor planes (thus making cursor planes on those drivers not truly universal,) e.g. they need cursor planes to act like one would expect from a mouse cursor and have correctly set hotspot properties. If this client cap is not set the DRM core will hide cursor plane on those virtualized drivers because not setting it implies that the client is not capable of dealing with those extra restictions. Clients which do set cursor hotspot and treat the cursor plane like a mouse cursor should set this property. The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first. Setting this property on drivers which do not special case cursor planes (i.e. non-virtualized drivers) will return EOPNOTSUPP, which can be used by userspace to gauge requirements of the hardware/drivers they're running on. This capability is always supported for atomic-capable virtualized drivers starting from kernel version 6.6. h](h)}(h**Description**h]j' )}(hj}h]h Description}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj}ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMehj}ubh)}(hXDrivers for para-virtualized hardware (e.g. vmwgfx, qxl, virtio and virtualbox) have additional restrictions for cursor planes (thus making cursor planes on those drivers not truly universal,) e.g. they need cursor planes to act like one would expect from a mouse cursor and have correctly set hotspot properties. If this client cap is not set the DRM core will hide cursor plane on those virtualized drivers because not setting it implies that the client is not capable of dealing with those extra restictions. Clients which do set cursor hotspot and treat the cursor plane like a mouse cursor should set this property. The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first.h](hXDrivers for para-virtualized hardware (e.g. vmwgfx, qxl, virtio and virtualbox) have additional restrictions for cursor planes (thus making cursor planes on those drivers not truly universal,) e.g. they need cursor planes to act like one would expect from a mouse cursor and have correctly set hotspot properties. If this client cap is not set the DRM core will hide cursor plane on those virtualized drivers because not setting it implies that the client is not capable of dealing with those extra restictions. Clients which do set cursor hotspot and treat the cursor plane like a mouse cursor should set this property. The client must enable }(hj~hhhNhNubh)}(h:c:type:`DRM_CLIENT_CAP_ATOMIC`h]j)}(hj~h]hDRM_CLIENT_CAP_ATOMIC}(hj~hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_ATOMICuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMdhj~ubh first.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj9~hMdhj}ubh)}(hSetting this property on drivers which do not special case cursor planes (i.e. non-virtualized drivers) will return EOPNOTSUPP, which can be used by userspace to gauge requirements of the hardware/drivers they're running on.h]hSetting this property on drivers which do not special case cursor planes (i.e. non-virtualized drivers) will return EOPNOTSUPP, which can be used by userspace to gauge requirements of the hardware/drivers they’re running on.}(hjD~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMphj}ubh)}(hlThis capability is always supported for atomic-capable virtualized drivers starting from kernel version 6.6.h]hlThis capability is always supported for atomic-capable virtualized drivers starting from kernel version 6.6.}(hjS~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMuhj}ubeh}(h]h ]h"]h$]h&]uh1jlhj~hMehj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j -DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE (C macro)%c.DRM_CLIENT_CAP_PLANE_COLOR_PIPELINEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h#DRM_CLIENT_CAP_PLANE_COLOR_PIPELINEh]j. )}(h#DRM_CLIENT_CAP_PLANE_COLOR_PIPELINEh]jW )}(h#DRM_CLIENT_CAP_PLANE_COLOR_PIPELINEh]j] )}(hj{~h]h#DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE}(hj~hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj~ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj}~hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM|ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjy~hhhj~hM|ubah}(h]jt~ah ](j j eh"]h$]h&]j j )j huh1j' hj~hM|hjv~hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjv~hhhj~hM|ubeh}(h]h ](j macroeh"]h$]h&]jN j jO j~jP j~jQ jR jS uh1j" hhhj!dhj{dhNubh)}(h'``DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE``h]j)}(hj~h]h#DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hj!dhhubjm)}(hXH**Description** If set to 1 the DRM core will allow setting the COLOR_PIPELINE property on a :c:type:`drm_plane`, as well as drm_colorop properties. Setting of these plane properties will be rejected when this client cap is set: - COLOR_ENCODING - COLOR_RANGE The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first. h](h)}(h**Description**h]j' )}(hj~h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj~ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hj~ubh)}(hIf set to 1 the DRM core will allow setting the COLOR_PIPELINE property on a :c:type:`drm_plane`, as well as drm_colorop properties.h](hMIf set to 1 the DRM core will allow setting the COLOR_PIPELINE property on a }(hj~hhhNhNubh)}(h:c:type:`drm_plane`h]j)}(hj~h]h drm_plane}(hj~hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_planeuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM}hj~ubh$, as well as drm_colorop properties.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM}hj~ubh)}(hnSetting of these plane properties will be rejected when this client cap is set: - COLOR_ENCODING - COLOR_RANGEh]hnSetting of these plane properties will be rejected when this client cap is set: - COLOR_ENCODING - COLOR_RANGE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj~ubh)}(h=The client must enable :c:type:`DRM_CLIENT_CAP_ATOMIC` first.h](hThe client must enable }(hj*hhhNhNubh)}(h:c:type:`DRM_CLIENT_CAP_ATOMIC`h]j)}(hj4h]hDRM_CLIENT_CAP_ATOMIC}(hj6hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_ATOMICuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj*ubh first.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjQhMhj~ubeh}(h]h ]h"]h$]h&]uh1jlhj~hM~hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_syncobj_eventfd (C struct)c.drm_syncobj_eventfdhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hdrm_syncobj_eventfdh]j. )}(hstruct drm_syncobj_eventfdh](j )}(hj h]hstruct}(hj{hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjwhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjwhhhjhMubjW )}(hdrm_syncobj_eventfdh]j] )}(hjuh]hdrm_syncobj_eventfd}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjwhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjshhhjhMubah}(h]jnah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjphhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjphhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubjU )}(hX**Definition**:: struct drm_syncobj_eventfd { __u32 handle; __u32 flags; __u64 point; __s32 fd; __u32 pad; }; **Members** ``handle`` syncobj handle. ``flags`` Zero to wait for the point to be signalled, or :c:type:`DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE` to wait for a fence to be available for the point. ``point`` syncobj timeline point (set to zero for binary syncobjs). ``fd`` Existing eventfd to sent events to. ``pad`` Must be zero.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubj)}(hpstruct drm_syncobj_eventfd { __u32 handle; __u32 flags; __u64 point; __s32 fd; __u32 pad; };h]hpstruct drm_syncobj_eventfd { __u32 handle; __u32 flags; __u64 point; __s32 fd; __u32 pad; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubjs )}(hhh](jx )}(h``handle`` syncobj handle. h](j~ )}(h ``handle``h]j)}(hjh]hhandle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubj )}(hhh]h)}(hsyncobj handle.h]hsyncobj handle.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj1ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj0hMhjubjx )}(h``flags`` Zero to wait for the point to be signalled, or :c:type:`DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE` to wait for a fence to be available for the point. h](j~ )}(h ``flags``h]j)}(hjTh]hflags}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjNubj )}(hhh]h)}(hZero to wait for the point to be signalled, or :c:type:`DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE` to wait for a fence to be available for the point.h](h/Zero to wait for the point to be signalled, or }(hjmhhhNhNubh)}(h/:c:type:`DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE`h]j)}(hjwh]h%DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE}(hjyhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j %DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjmubh3 to wait for a fence to be available for the point.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjjubah}(h]h ]h"]h$]h&]uh1j hjNubeh}(h]h ]h"]h$]h&]uh1jw hjihMhjubjx )}(hD``point`` syncobj timeline point (set to zero for binary syncobjs). h](j~ )}(h ``point``h]j)}(hjh]hpoint}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubj )}(hhh]h)}(h9syncobj timeline point (set to zero for binary syncobjs).h]h9syncobj timeline point (set to zero for binary syncobjs).}(hjʀhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjƀhMhjǀubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjƀhMhjubjx )}(h+``fd`` Existing eventfd to sent events to. h](j~ )}(h``fd``h]j)}(hjh]hfd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubj )}(hhh]h)}(h#Existing eventfd to sent events to.h]h#Existing eventfd to sent events to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h``pad`` Must be zero.h](j~ )}(h``pad``h]j)}(hj#h]hpad}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubj )}(hhh]h)}(h Must be zero.h]h Must be zero.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj9ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj8hMhjubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjfh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjdubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubh)}(haRegister an eventfd to be signalled by a syncobj. The eventfd counter will be incremented by one.h]haRegister an eventfd to be signalled by a syncobj. The eventfd counter will be incremented by one.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_IOCTL_GEM_CLOSE (C macro)c.DRM_IOCTL_GEM_CLOSEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_GEM_CLOSEh]j. )}(hDRM_IOCTL_GEM_CLOSEh]jW )}(hDRM_IOCTL_GEM_CLOSEh]j] )}(hjh]hDRM_IOCTL_GEM_CLOSE}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMDubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMDubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMDhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhMDubeh}(h]h ](j macroeh"]h$]h&]jN j jO jԁjP jԁjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_GEM_CLOSE``h]j)}(hjځh]hDRM_IOCTL_GEM_CLOSE}(hj܁hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj؁ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMFhj!dhhubjm)}(hX Close a GEM handle. **Description** GEM handles are not reference-counted by the kernel. User-space is responsible for managing their lifetime. For example, if user-space imports the same memory object twice on the same DRM file description, the same GEM handle is returned by both imports, and user-space needs to ensure :c:type:`DRM_IOCTL_GEM_CLOSE` is performed once only. The same situation can happen when a memory object is allocated, then exported and imported again on the same DRM file description. The :c:type:`DRM_IOCTL_MODE_GETFB2` IOCTL is an exception and always returns fresh new GEM handles even if an existing GEM handle already refers to the same memory object before the IOCTL is performed. h](jm)}(hClose a GEM handle. h]h)}(hClose a GEM handle.h]hClose a GEM handle.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMDhjubah}(h]h ]h"]h$]h&]uh1jlhjhMDhjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMFhjubh)}(hXGEM handles are not reference-counted by the kernel. User-space is responsible for managing their lifetime. For example, if user-space imports the same memory object twice on the same DRM file description, the same GEM handle is returned by both imports, and user-space needs to ensure :c:type:`DRM_IOCTL_GEM_CLOSE` is performed once only. The same situation can happen when a memory object is allocated, then exported and imported again on the same DRM file description. The :c:type:`DRM_IOCTL_MODE_GETFB2` IOCTL is an exception and always returns fresh new GEM handles even if an existing GEM handle already refers to the same memory object before the IOCTL is performed.h](hXGEM handles are not reference-counted by the kernel. User-space is responsible for managing their lifetime. For example, if user-space imports the same memory object twice on the same DRM file description, the same GEM handle is returned by both imports, and user-space needs to ensure }(hj%hhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_CLOSE`h]j)}(hj/h]hDRM_IOCTL_GEM_CLOSE}(hj1hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_GEM_CLOSEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMEhj%ubh is performed once only. The same situation can happen when a memory object is allocated, then exported and imported again on the same DRM file description. The }(hj%hhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_GETFB2`h]j)}(hjSh]hDRM_IOCTL_MODE_GETFB2}(hjUhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_GETFB2uh1hhjLhMEhj%ubh IOCTL is an exception and always returns fresh new GEM handles even if an existing GEM handle already refers to the same memory object before the IOCTL is performed.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjLhMEhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMDhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j &DRM_IOCTL_PRIME_HANDLE_TO_FD (C macro)c.DRM_IOCTL_PRIME_HANDLE_TO_FDhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_PRIME_HANDLE_TO_FDh]j. )}(hDRM_IOCTL_PRIME_HANDLE_TO_FDh]jW )}(hDRM_IOCTL_PRIME_HANDLE_TO_FDh]j] )}(hjh]hDRM_IOCTL_PRIME_HANDLE_TO_FD}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMyubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMyubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMyhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhMyubeh}(h]h ](j macroeh"]h$]h&]jN j jO jɂjP jɂjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h ``DRM_IOCTL_PRIME_HANDLE_TO_FD``h]j)}(hjςh]hDRM_IOCTL_PRIME_HANDLE_TO_FD}(hjтhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj͂ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM{hj!dhhubjm)}(hX Convert a GEM handle to a DMA-BUF FD. **Description** User-space sets :c:type:`drm_prime_handle.handle ` with the GEM handle to export and :c:type:`drm_prime_handle.flags `, and gets back a DMA-BUF file descriptor in :c:type:`drm_prime_handle.fd `. The export can fail for any driver-specific reason, e.g. because export is not supported for this specific GEM handle (but might be for others). Support for exporting DMA-BUFs is advertised via :c:type:`DRM_PRIME_CAP_EXPORT`. h](jm)}(h&Convert a GEM handle to a DMA-BUF FD. h]h)}(h%Convert a GEM handle to a DMA-BUF FD.h]h%Convert a GEM handle to a DMA-BUF FD.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMyhjubah}(h]h ]h"]h$]h&]uh1jlhjhMyhjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM{hjubh)}(hUser-space sets :c:type:`drm_prime_handle.handle ` with the GEM handle to export and :c:type:`drm_prime_handle.flags `, and gets back a DMA-BUF file descriptor in :c:type:`drm_prime_handle.fd `.h](hUser-space sets }(hjhhhNhNubh)}(h4:c:type:`drm_prime_handle.handle `h]j)}(hj$h]hdrm_prime_handle.handle}(hj&hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMzhjubh# with the GEM handle to export and }(hjhhhNhNubh)}(h3:c:type:`drm_prime_handle.flags `h]j)}(hjHh]hdrm_prime_handle.flags}(hjJhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhjAhMzhjubh-, and gets back a DMA-BUF file descriptor in }(hjhhhNhNubh)}(h0:c:type:`drm_prime_handle.fd `h]j)}(hjkh]hdrm_prime_handle.fd}(hjmhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhjAhMzhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjAhMzhjubh)}(hThe export can fail for any driver-specific reason, e.g. because export is not supported for this specific GEM handle (but might be for others).h]hThe export can fail for any driver-specific reason, e.g. because export is not supported for this specific GEM handle (but might be for others).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hjubh)}(hPSupport for exporting DMA-BUFs is advertised via :c:type:`DRM_PRIME_CAP_EXPORT`.h](h1Support for exporting DMA-BUFs is advertised via }(hjhhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_EXPORT`h]j)}(hjh]hDRM_PRIME_CAP_EXPORT}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_EXPORTuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjȃhMhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMyhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j &DRM_IOCTL_PRIME_FD_TO_HANDLE (C macro)c.DRM_IOCTL_PRIME_FD_TO_HANDLEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_PRIME_FD_TO_HANDLEh]j. )}(hDRM_IOCTL_PRIME_FD_TO_HANDLEh]jW )}(hDRM_IOCTL_PRIME_FD_TO_HANDLEh]j] )}(hjh]hDRM_IOCTL_PRIME_FD_TO_HANDLE}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhj hMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hj hMhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhj hMubeh}(h]h ](j macroeh"]h$]h&]jN j jO j"jP j"jQ jR jS uh1j" hhhj!dhj{dhNubh)}(h ``DRM_IOCTL_PRIME_FD_TO_HANDLE``h]j)}(hj(h]hDRM_IOCTL_PRIME_FD_TO_HANDLE}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hXP Convert a DMA-BUF FD to a GEM handle. **Description** User-space sets :c:type:`drm_prime_handle.fd ` with a DMA-BUF file descriptor to import, and gets back a GEM handle in :c:type:`drm_prime_handle.handle `. :c:type:`drm_prime_handle.flags ` is unused. If an existing GEM handle refers to the memory object backing the DMA-BUF, that GEM handle is returned. Therefore user-space which needs to handle arbitrary DMA-BUFs must have a user-space lookup data structure to manually reference-count duplicated GEM handles. For more information see :c:type:`DRM_IOCTL_GEM_CLOSE`. The import can fail for any driver-specific reason, e.g. because import is only supported for DMA-BUFs allocated on this DRM device. Support for importing DMA-BUFs is advertised via :c:type:`DRM_PRIME_CAP_IMPORT`. h](jm)}(h&Convert a DMA-BUF FD to a GEM handle. h]h)}(h%Convert a DMA-BUF FD to a GEM handle.h]h%Convert a DMA-BUF FD to a GEM handle.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjBubah}(h]h ]h"]h$]h&]uh1jlhjThMhj>ubh)}(h**Description**h]j' )}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj[ubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj>ubh)}(hUser-space sets :c:type:`drm_prime_handle.fd ` with a DMA-BUF file descriptor to import, and gets back a GEM handle in :c:type:`drm_prime_handle.handle `. :c:type:`drm_prime_handle.flags ` is unused.h](hUser-space sets }(hjshhhNhNubh)}(h0:c:type:`drm_prime_handle.fd `h]j)}(hj}h]hdrm_prime_handle.fd}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjsubhI with a DMA-BUF file descriptor to import, and gets back a GEM handle in }(hjshhhNhNubh)}(h4:c:type:`drm_prime_handle.handle `h]j)}(hjh]hdrm_prime_handle.handle}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhjhMhjsubh. }(hjshhhNhNubh)}(h3:c:type:`drm_prime_handle.flags `h]j)}(hjĄh]hdrm_prime_handle.flags}(hjƄhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj„ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_prime_handleuh1hhjhMhjsubh is unused.}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj>ubh)}(hX>If an existing GEM handle refers to the memory object backing the DMA-BUF, that GEM handle is returned. Therefore user-space which needs to handle arbitrary DMA-BUFs must have a user-space lookup data structure to manually reference-count duplicated GEM handles. For more information see :c:type:`DRM_IOCTL_GEM_CLOSE`.h](hX If an existing GEM handle refers to the memory object backing the DMA-BUF, that GEM handle is returned. Therefore user-space which needs to handle arbitrary DMA-BUFs must have a user-space lookup data structure to manually reference-count duplicated GEM handles. For more information see }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_CLOSE`h]j)}(hjh]hDRM_IOCTL_GEM_CLOSE}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_GEM_CLOSEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj>ubh)}(hThe import can fail for any driver-specific reason, e.g. because import is only supported for DMA-BUFs allocated on this DRM device.h]hThe import can fail for any driver-specific reason, e.g. because import is only supported for DMA-BUFs allocated on this DRM device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj>ubh)}(hPSupport for importing DMA-BUFs is advertised via :c:type:`DRM_PRIME_CAP_IMPORT`.h](h1Support for importing DMA-BUFs is advertised via }(hj,hhhNhNubh)}(h:c:type:`DRM_PRIME_CAP_IMPORT`h]j)}(hj6h]hDRM_PRIME_CAP_IMPORT}(hj8hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_PRIME_CAP_IMPORTuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj,ubh.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjShMhj>ubeh}(h]h ]h"]h$]h&]uh1jlhjThMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_IOCTL_MODE_RMFB (C macro)c.DRM_IOCTL_MODE_RMFBhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_MODE_RMFBh]j. )}(hDRM_IOCTL_MODE_RMFBh]jW )}(hDRM_IOCTL_MODE_RMFBh]j] )}(hjwh]hDRM_IOCTL_MODE_RMFB}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj}ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjyhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjuhhhjhMubah}(h]jpah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjrhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjrhhhjhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_MODE_RMFB``h]j)}(hjh]hDRM_IOCTL_MODE_RMFB}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hXO Remove a framebuffer. **Description** This removes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID. Warning: removing a framebuffer currently in-use on an enabled plane will disable that plane. The CRTC the plane is linked to may also be disabled (depending on driver capabilities). h](jm)}(hRemove a framebuffer. h]h)}(hRemove a framebuffer.h]hRemove a framebuffer.}(hjхhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjͅubah}(h]h ]h"]h$]h&]uh1jlhj߅hMhjɅubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjɅubh)}(hlThis removes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID.h]hlThis removes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjɅubh)}(hWarning: removing a framebuffer currently in-use on an enabled plane will disable that plane. The CRTC the plane is linked to may also be disabled (depending on driver capabilities).h]hWarning: removing a framebuffer currently in-use on an enabled plane will disable that plane. The CRTC the plane is linked to may also be disabled (depending on driver capabilities).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjɅubeh}(h]h ]h"]h$]h&]uh1jlhj߅hMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j $DRM_IOCTL_MODE_CREATE_DUMB (C macro)c.DRM_IOCTL_MODE_CREATE_DUMBhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_MODE_CREATE_DUMBh]j. )}(hDRM_IOCTL_MODE_CREATE_DUMBh]jW )}(hDRM_IOCTL_MODE_CREATE_DUMBh]j] )}(hj5h]hDRM_IOCTL_MODE_CREATE_DUMB}(hj?hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj;ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj7hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj3hhhjRhMubah}(h]j.ah ](j j eh"]h$]h&]j j )j huh1j' hjRhMhj0hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj0hhhjRhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jkjP jkjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_MODE_CREATE_DUMB``h]j)}(hjqh]hDRM_IOCTL_MODE_CREATE_DUMB}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hXk Create a new dumb buffer object. **Description** KMS dumb buffers provide a very primitive way to allocate a buffer object suitable for scanout and map it for software rendering. KMS dumb buffers are not suitable for hardware-accelerated rendering nor video decoding. KMS dumb buffers are not suitable to be displayed on any other device than the KMS device where they were allocated from. Also see :ref:`kms_dumb_buffer_objects`. The IOCTL argument is a struct drm_mode_create_dumb. User-space is expected to create a KMS dumb buffer via this IOCTL, then add it as a KMS framebuffer via :c:type:`DRM_IOCTL_MODE_ADDFB` and map it via :c:type:`DRM_IOCTL_MODE_MAP_DUMB`. :c:type:`DRM_CAP_DUMB_BUFFER` indicates whether this IOCTL is supported. :c:type:`DRM_CAP_DUMB_PREFERRED_DEPTH` and :c:type:`DRM_CAP_DUMB_PREFER_SHADOW` indicate driver preferences for dumb buffers. h](jm)}(h!Create a new dumb buffer object. h]h)}(h Create a new dumb buffer object.h]h Create a new dumb buffer object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubah}(h]h ]h"]h$]h&]uh1jlhjhMhjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh)}(hX}KMS dumb buffers provide a very primitive way to allocate a buffer object suitable for scanout and map it for software rendering. KMS dumb buffers are not suitable for hardware-accelerated rendering nor video decoding. KMS dumb buffers are not suitable to be displayed on any other device than the KMS device where they were allocated from. Also see :ref:`kms_dumb_buffer_objects`.h](hX^KMS dumb buffers provide a very primitive way to allocate a buffer object suitable for scanout and map it for software rendering. KMS dumb buffers are not suitable for hardware-accelerated rendering nor video decoding. KMS dumb buffers are not suitable to be displayed on any other device than the KMS device where they were allocated from. Also see }(hjhhhNhNubh)}(h:ref:`kms_dumb_buffer_objects`h]j~)}(hjƆh]hkms_dumb_buffer_objects}(hjȆhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjĆubah}(h]h ]h"]h$]h&]refdocj refdomainj҆reftyperef refexplicitrefwarnj kms_dumb_buffer_objectsuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(h4The IOCTL argument is a struct drm_mode_create_dumb.h]h4The IOCTL argument is a struct drm_mode_create_dumb.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh)}(hUser-space is expected to create a KMS dumb buffer via this IOCTL, then add it as a KMS framebuffer via :c:type:`DRM_IOCTL_MODE_ADDFB` and map it via :c:type:`DRM_IOCTL_MODE_MAP_DUMB`.h](hhUser-space is expected to create a KMS dumb buffer via this IOCTL, then add it as a KMS framebuffer via }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_ADDFB`h]j)}(hjh]hDRM_IOCTL_MODE_ADDFB}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_ADDFBuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh and map it via }(hjhhhNhNubh)}(h!:c:type:`DRM_IOCTL_MODE_MAP_DUMB`h]j)}(hj,h]hDRM_IOCTL_MODE_MAP_DUMB}(hj.hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_MAP_DUMBuh1hhj%hMhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj%hMhjubh)}(h:c:type:`DRM_CAP_DUMB_BUFFER` indicates whether this IOCTL is supported. :c:type:`DRM_CAP_DUMB_PREFERRED_DEPTH` and :c:type:`DRM_CAP_DUMB_PREFER_SHADOW` indicate driver preferences for dumb buffers.h](h)}(h:c:type:`DRM_CAP_DUMB_BUFFER`h]j)}(hjYh]hDRM_CAP_DUMB_BUFFER}(hj[hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CAP_DUMB_BUFFERuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjSubh, indicates whether this IOCTL is supported. }(hjShhhNhNubh)}(h&:c:type:`DRM_CAP_DUMB_PREFERRED_DEPTH`h]j)}(hj}h]hDRM_CAP_DUMB_PREFERRED_DEPTH}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CAP_DUMB_PREFERRED_DEPTHuh1hhjvhMhjSubh and }(hjShhhNhNubh)}(h$:c:type:`DRM_CAP_DUMB_PREFER_SHADOW`h]j)}(hjh]hDRM_CAP_DUMB_PREFER_SHADOW}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CAP_DUMB_PREFER_SHADOWuh1hhjvhMhjSubh. indicate driver preferences for dumb buffers.}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjvhMhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_IOCTL_MODE_GETFB2 (C macro)c.DRM_IOCTL_MODE_GETFB2hNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_MODE_GETFB2h]j. )}(hDRM_IOCTL_MODE_GETFB2h]jW )}(hDRM_IOCTL_MODE_GETFB2h]j] )}(hjh]hDRM_IOCTL_MODE_GETFB2}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjއhhhjhMubah}(h]jهah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjۇhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjۇhhhjhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_MODE_GETFB2``h]j)}(hjh]hDRM_IOCTL_MODE_GETFB2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(hXn Get framebuffer metadata. **Description** This queries metadata about a framebuffer. User-space fills :c:type:`drm_mode_fb_cmd2.fb_id ` as the input, and the kernels fills the rest of the struct as the output. If the client is DRM master or has :c:type:`CAP_SYS_ADMIN`, :c:type:`drm_mode_fb_cmd2.handles ` will be filled with GEM buffer handles. Fresh new GEM handles are always returned, even if another GEM handle referring to the same memory object already exists on the DRM file description. The caller is responsible for removing the new handles, e.g. via the :c:type:`DRM_IOCTL_GEM_CLOSE` IOCTL. The same new handle will be returned for multiple planes in case they use the same memory object. Planes are valid until one has a zero handle -- this can be used to compute the number of planes. Otherwise, :c:type:`drm_mode_fb_cmd2.handles ` will be zeroed and planes are valid until one has a zero :c:type:`drm_mode_fb_cmd2.pitches `. If the framebuffer has a format modifier, :c:type:`DRM_MODE_FB_MODIFIERS` will be set in :c:type:`drm_mode_fb_cmd2.flags ` and :c:type:`drm_mode_fb_cmd2.modifier ` will contain the modifier. Otherwise, user-space must ignore :c:type:`drm_mode_fb_cmd2.modifier `. To obtain DMA-BUF FDs for each plane without leaking GEM handles, user-space can export each handle via :c:type:`DRM_IOCTL_PRIME_HANDLE_TO_FD`, then immediately close each unique handle via :c:type:`DRM_IOCTL_GEM_CLOSE`, making sure to not double-close handles which are specified multiple times in the array. h](jm)}(hGet framebuffer metadata. h]h)}(hGet framebuffer metadata.h]hGet framebuffer metadata.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj6ubah}(h]h ]h"]h$]h&]uh1jlhjHhMhj2ubh)}(h**Description**h]j' )}(hjQh]h Description}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjOubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj2ubh)}(hThis queries metadata about a framebuffer. User-space fills :c:type:`drm_mode_fb_cmd2.fb_id ` as the input, and the kernels fills the rest of the struct as the output.h](h`h]j)}(hjqh]hdrm_mode_fb_cmd2.fb_id}(hjshhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjgubhJ as the input, and the kernels fills the rest of the struct as the output.}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj2ubh)}(hX]If the client is DRM master or has :c:type:`CAP_SYS_ADMIN`, :c:type:`drm_mode_fb_cmd2.handles ` will be filled with GEM buffer handles. Fresh new GEM handles are always returned, even if another GEM handle referring to the same memory object already exists on the DRM file description. The caller is responsible for removing the new handles, e.g. via the :c:type:`DRM_IOCTL_GEM_CLOSE` IOCTL. The same new handle will be returned for multiple planes in case they use the same memory object. Planes are valid until one has a zero handle -- this can be used to compute the number of planes.h](h#If the client is DRM master or has }(hjhhhNhNubh)}(h:c:type:`CAP_SYS_ADMIN`h]j)}(hjh]h CAP_SYS_ADMIN}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j CAP_SYS_ADMINuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh, }(hjhhhNhNubh)}(h5:c:type:`drm_mode_fb_cmd2.handles `h]j)}(hjLjh]hdrm_mode_fb_cmd2.handles}(hjɈhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjňubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhjhMhjubhX will be filled with GEM buffer handles. Fresh new GEM handles are always returned, even if another GEM handle referring to the same memory object already exists on the DRM file description. The caller is responsible for removing the new handles, e.g. via the }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_CLOSE`h]j)}(hjh]hDRM_IOCTL_GEM_CLOSE}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_GEM_CLOSEuh1hhjhMhjubh IOCTL. The same new handle will be returned for multiple planes in case they use the same memory object. Planes are valid until one has a zero handle -- this can be used to compute the number of planes.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj2ubh)}(hOtherwise, :c:type:`drm_mode_fb_cmd2.handles ` will be zeroed and planes are valid until one has a zero :c:type:`drm_mode_fb_cmd2.pitches `.h](h Otherwise, }(hjhhhNhNubh)}(h5:c:type:`drm_mode_fb_cmd2.handles `h]j)}(hjh]hdrm_mode_fb_cmd2.handles}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM hjubh: will be zeroed and planes are valid until one has a zero }(hjhhhNhNubh)}(h5:c:type:`drm_mode_fb_cmd2.pitches `h]j)}(hj?h]hdrm_mode_fb_cmd2.pitches}(hjAhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhj8hM hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj8hM hj2ubh)}(hX<If the framebuffer has a format modifier, :c:type:`DRM_MODE_FB_MODIFIERS` will be set in :c:type:`drm_mode_fb_cmd2.flags ` and :c:type:`drm_mode_fb_cmd2.modifier ` will contain the modifier. Otherwise, user-space must ignore :c:type:`drm_mode_fb_cmd2.modifier `.h](h*If the framebuffer has a format modifier, }(hjfhhhNhNubh)}(h:c:type:`DRM_MODE_FB_MODIFIERS`h]j)}(hjph]hDRM_MODE_FB_MODIFIERS}(hjrhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_FB_MODIFIERSuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjfubh will be set in }(hjfhhhNhNubh)}(h3:c:type:`drm_mode_fb_cmd2.flags `h]j)}(hjh]hdrm_mode_fb_cmd2.flags}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhjhMhjfubh and }(hjfhhhNhNubh)}(h6:c:type:`drm_mode_fb_cmd2.modifier `h]j)}(hjh]hdrm_mode_fb_cmd2.modifier}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhjhMhjfubh> will contain the modifier. Otherwise, user-space must ignore }(hjfhhhNhNubh)}(h6:c:type:`drm_mode_fb_cmd2.modifier `h]j)}(hjډh]hdrm_mode_fb_cmd2.modifier}(hj܉hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj؉ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_fb_cmd2uh1hhjhMhjfubh.}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj2ubh)}(hX5To obtain DMA-BUF FDs for each plane without leaking GEM handles, user-space can export each handle via :c:type:`DRM_IOCTL_PRIME_HANDLE_TO_FD`, then immediately close each unique handle via :c:type:`DRM_IOCTL_GEM_CLOSE`, making sure to not double-close handles which are specified multiple times in the array.h](hhTo obtain DMA-BUF FDs for each plane without leaking GEM handles, user-space can export each handle via }(hjhhhNhNubh)}(h&:c:type:`DRM_IOCTL_PRIME_HANDLE_TO_FD`h]j)}(hj h]hDRM_IOCTL_PRIME_HANDLE_TO_FD}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_PRIME_HANDLE_TO_FDuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh0, then immediately close each unique handle via }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_GEM_CLOSE`h]j)}(hj/h]hDRM_IOCTL_GEM_CLOSE}(hj1hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_GEM_CLOSEuh1hhj(hMhjubhZ, making sure to not double-close handles which are specified multiple times in the array.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj(hMhj2ubeh}(h]h ]h"]h$]h&]uh1jlhjHhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j #DRM_IOCTL_SYNCOBJ_EVENTFD (C macro)c.DRM_IOCTL_SYNCOBJ_EVENTFDhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_SYNCOBJ_EVENTFDh]j. )}(hDRM_IOCTL_SYNCOBJ_EVENTFDh]jW )}(hDRM_IOCTL_SYNCOBJ_EVENTFDh]j] )}(hjoh]hDRM_IOCTL_SYNCOBJ_EVENTFD}(hjyhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjuubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjqhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjmhhhjhMubah}(h]jhah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjjhhhjhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_SYNCOBJ_EVENTFD``h]j)}(hjh]hDRM_IOCTL_SYNCOBJ_EVENTFD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhj!dhhubjm)}(h Register an eventfd to be signalled by a syncobj. **Description** This can be used to integrate a syncobj in an event loop. The IOCTL argument is a struct drm_syncobj_eventfd. h](jm)}(h2Register an eventfd to be signalled by a syncobj. h]h)}(h1Register an eventfd to be signalled by a syncobj.h]h1Register an eventfd to be signalled by a syncobj.}(hjɊhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjŊubah}(h]h ]h"]h$]h&]uh1jlhj׊hMhjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjފubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh)}(h9This can be used to integrate a syncobj in an event loop.h]h9This can be used to integrate a syncobj in an event loop.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubh)}(h3The IOCTL argument is a struct drm_syncobj_eventfd.h]h3The IOCTL argument is a struct drm_syncobj_eventfd.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM hjubeh}(h]h ]h"]h$]h&]uh1jlhj׊hMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_IOCTL_MODE_CLOSEFB (C macro)c.DRM_IOCTL_MODE_CLOSEFBhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_MODE_CLOSEFBh]j. )}(hDRM_IOCTL_MODE_CLOSEFBh]jW )}(hDRM_IOCTL_MODE_CLOSEFBh]j] )}(hj-h]hDRM_IOCTL_MODE_CLOSEFB}(hj7hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj3ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj/hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM&ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj+hhhjJhM&ubah}(h]j&ah ](j j eh"]h$]h&]j j )j huh1j' hjJhM&hj(hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj(hhhjJhM&ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jcjP jcjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_MODE_CLOSEFB``h]j)}(hjih]hDRM_IOCTL_MODE_CLOSEFB}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM(hj!dhhubjm)}(hX Close a framebuffer. **Description** This closes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID. This IOCTL is similar to :c:type:`DRM_IOCTL_MODE_RMFB`, except it doesn't disable planes and CRTCs. As long as the framebuffer is used by a plane, it's kept alive. When the plane no longer uses the framebuffer (because the framebuffer is replaced with another one, or the plane is disabled), the framebuffer is cleaned up. This is useful to implement flicker-free transitions between two processes. Depending on the threat model, user-space may want to ensure that the framebuffer doesn't expose any sensitive user information: closed framebuffers attached to a plane can be read back by the next DRM master. h](jm)}(hClose a framebuffer. h]h)}(hClose a framebuffer.h]hClose a framebuffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM&hjubah}(h]h ]h"]h$]h&]uh1jlhjhM&hjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM(hjubh)}(hkThis closes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID.h]hkThis closes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL argument is a framebuffer object ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM'hjubh)}(hXBThis IOCTL is similar to :c:type:`DRM_IOCTL_MODE_RMFB`, except it doesn't disable planes and CRTCs. As long as the framebuffer is used by a plane, it's kept alive. When the plane no longer uses the framebuffer (because the framebuffer is replaced with another one, or the plane is disabled), the framebuffer is cleaned up.h](hThis IOCTL is similar to }(hjËhhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_RMFB`h]j)}(hj͋h]hDRM_IOCTL_MODE_RMFB}(hjϋhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjˋubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_RMFBuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM*hjËubhX, except it doesn’t disable planes and CRTCs. As long as the framebuffer is used by a plane, it’s kept alive. When the plane no longer uses the framebuffer (because the framebuffer is replaced with another one, or the plane is disabled), the framebuffer is cleaned up.}(hjËhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM*hjubh)}(hKThis is useful to implement flicker-free transitions between two processes.h]hKThis is useful to implement flicker-free transitions between two processes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM0hjubh)}(hDepending on the threat model, user-space may want to ensure that the framebuffer doesn't expose any sensitive user information: closed framebuffers attached to a plane can be read back by the next DRM master.h]hDepending on the threat model, user-space may want to ensure that the framebuffer doesn’t expose any sensitive user information: closed framebuffers attached to a plane can be read back by the next DRM master.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM2hjubeh}(h]h ]h"]h$]h&]uh1jlhjhM&hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j #DRM_IOCTL_SET_CLIENT_NAME (C macro)c.DRM_IOCTL_SET_CLIENT_NAMEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_SET_CLIENT_NAMEh]j. )}(hDRM_IOCTL_SET_CLIENT_NAMEh]jW )}(hDRM_IOCTL_SET_CLIENT_NAMEh]j] )}(hj,h]hDRM_IOCTL_SET_CLIENT_NAME}(hj6hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj2ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj.hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM:ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj*hhhjIhM:ubah}(h]j%ah ](j j eh"]h$]h&]j j )j huh1j' hjIhM:hj'hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj'hhhjIhM:ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jbjP jbjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_SET_CLIENT_NAME``h]j)}(hjhh]hDRM_IOCTL_SET_CLIENT_NAME}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM<hj!dhhubjm)}(hX  Attach a name to a drm_file **Description** Having a name allows for easier tracking and debugging. The length of the name (without null ending char) must be <= DRM_CLIENT_NAME_MAX_LEN. The call will fail if the name contains whitespaces or non-printable chars. h](jm)}(hAttach a name to a drm_file h]h)}(hAttach a name to a drm_fileh]hAttach a name to a drm_file}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM:hjubah}(h]h ]h"]h$]h&]uh1jlhjhM:hj~ubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM<hj~ubh)}(hHaving a name allows for easier tracking and debugging. The length of the name (without null ending char) must be <= DRM_CLIENT_NAME_MAX_LEN. The call will fail if the name contains whitespaces or non-printable chars.h]hHaving a name allows for easier tracking and debugging. The length of the name (without null ending char) must be <= DRM_CLIENT_NAME_MAX_LEN. The call will fail if the name contains whitespaces or non-printable chars.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM;hj~ubeh}(h]h ]h"]h$]h&]uh1jlhjhM:hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j %DRM_IOCTL_GEM_CHANGE_HANDLE (C macro)c.DRM_IOCTL_GEM_CHANGE_HANDLEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_IOCTL_GEM_CHANGE_HANDLEh]j. )}(hDRM_IOCTL_GEM_CHANGE_HANDLEh]jW )}(hDRM_IOCTL_GEM_CHANGE_HANDLEh]j] )}(hjیh]hDRM_IOCTL_GEM_CHANGE_HANDLE}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj݌hhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMDubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjٌhhhjhMDubah}(h]jԌah ](j j eh"]h$]h&]j j )j huh1j' hjhMDhj֌hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj֌hhhjhMDubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_IOCTL_GEM_CHANGE_HANDLE``h]j)}(hjh]hDRM_IOCTL_GEM_CHANGE_HANDLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMFhj!dhhubjm)}(h Move an object to a different handle **Description** Some applications (notably CRIU) need objects to have specific gem handles. This ioctl changes the object at one gem handle to use a new gem handle. h](jm)}(h%Move an object to a different handle h]h)}(h$Move an object to a different handleh]h$Move an object to a different handle}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMDhj1ubah}(h]h ]h"]h$]h&]uh1jlhjChMDhj-ubh)}(h**Description**h]j' )}(hjLh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjJubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMFhj-ubh)}(hSome applications (notably CRIU) need objects to have specific gem handles. This ioctl changes the object at one gem handle to use a new gem handle.h]hSome applications (notably CRIU) need objects to have specific gem handles. This ioctl changes the object at one gem handle to use a new gem handle.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMEhj-ubeh}(h]h ]h"]h$]h&]uh1jlhjChMDhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_event (C struct) c.drm_eventhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(h drm_eventh]j. )}(hstruct drm_eventh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMKubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMKubjW )}(h drm_eventh]j] )}(hjh]h drm_event}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMKubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMKhjhhubj )}(hhh]h)}(hHeader for DRM eventsh]hHeader for DRM events}(hjҍhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMWhjύhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMKubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubjU )}(h**Definition**:: struct drm_event { __u32 type; __u32 length; }; **Members** ``type`` event type. ``length`` total number of payload bytes (including header).h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM[hjubj)}(h7struct drm_event { __u32 type; __u32 length; };h]h7struct drm_event { __u32 type; __u32 length; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM]hjubh)}(h **Members**h]j' )}(hj h]hMembers}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMbhjubjs )}(hhh](jx )}(h``type`` event type. h](j~ )}(h``type``h]j)}(hj?h]htype}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhj9ubj )}(hhh]h)}(h event type.h]h event type.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMYhjUubah}(h]h ]h"]h$]h&]uh1j hj9ubeh}(h]h ]h"]h$]h&]uh1jw hjThMYhj6ubjx )}(h<``length`` total number of payload bytes (including header).h](j~ )}(h ``length``h]j)}(hjxh]hlength}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1j} hT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMYhjrubj )}(hhh]h)}(h1total number of payload bytes (including header).h]h1total number of payload bytes (including header).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMZhjubah}(h]h ]h"]h$]h&]uh1j hjrubeh}(h]h ]h"]h$]h&]uh1jw hjhMYhj6ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhj{dhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM]hj!dhhubh)}(hThis struct is a header for events written back to user-space on the DRM FD. A read on the DRM FD will always only return complete events: e.g. if the read buffer is 100 bytes large and there are two 64 byte events pending, only one will be returned.h]hThis struct is a header for events written back to user-space on the DRM FD. A read on the DRM FD will always only return complete events: e.g. if the read buffer is 100 bytes large and there are two 64 byte events pending, only one will be returned.}(hjюhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMZhj!dhhubh)}(hEvent types 0 - 0x7fffffff are generic DRM events, 0x80000000 and up are chipset specific. Generic DRM events include :c:type:`DRM_EVENT_VBLANK`, :c:type:`DRM_EVENT_FLIP_COMPLETE` and :c:type:`DRM_EVENT_CRTC_SEQUENCE`.h](hvEvent types 0 - 0x7fffffff are generic DRM events, 0x80000000 and up are chipset specific. Generic DRM events include }(hjhhhNhNubh)}(h:c:type:`DRM_EVENT_VBLANK`h]j)}(hjh]hDRM_EVENT_VBLANK}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_VBLANKuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM_hjubh, }(hjhhhNhNubh)}(h!:c:type:`DRM_EVENT_FLIP_COMPLETE`h]j)}(hjh]hDRM_EVENT_FLIP_COMPLETE}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_FLIP_COMPLETEuh1hhjhM_hjubh and }(hjhhhNhNubh)}(h!:c:type:`DRM_EVENT_CRTC_SEQUENCE`h]j)}(hj1h]hDRM_EVENT_CRTC_SEQUENCE}(hj3hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_CRTC_SEQUENCEuh1hhjhM_hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM_hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_EVENT_VBLANK (C macro)c.DRM_EVENT_VBLANKhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_EVENT_VBLANKh]j. )}(hDRM_EVENT_VBLANKh]jW )}(hDRM_EVENT_VBLANKh]j] )}(hjkh]hDRM_EVENT_VBLANK}(hjuhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjqubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjmhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMjubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjihhhjhMjubah}(h]jdah ](j j eh"]h$]h&]j j )j huh1j' hjhMjhjfhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjfhhhjhMjubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_EVENT_VBLANK``h]j)}(hjh]hDRM_EVENT_VBLANK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMlhj!dhhubjm)}(h vertical blanking event **Description** This event is sent in response to :c:type:`DRM_IOCTL_WAIT_VBLANK` with the :c:type:`_DRM_VBLANK_EVENT` flag set. The event payload is a struct drm_event_vblank. h](jm)}(hvertical blanking event h]h)}(hvertical blanking eventh]hvertical blanking event}(hjŏhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMjhjubah}(h]h ]h"]h$]h&]uh1jlhjӏhMjhjubh)}(h**Description**h]j' )}(hj܏h]h Description}(hjޏhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjڏubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMlhjubh)}(hpThis event is sent in response to :c:type:`DRM_IOCTL_WAIT_VBLANK` with the :c:type:`_DRM_VBLANK_EVENT` flag set.h](h"This event is sent in response to }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_WAIT_VBLANK`h]j)}(hjh]hDRM_IOCTL_WAIT_VBLANK}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_WAIT_VBLANKuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMkhjubh with the }(hjhhhNhNubh)}(h:c:type:`_DRM_VBLANK_EVENT`h]j)}(hj h]h_DRM_VBLANK_EVENT}(hj"hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j _DRM_VBLANK_EVENTuh1hhjhMkhjubh flag set.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMkhjubh)}(h/The event payload is a struct drm_event_vblank.h]h/The event payload is a struct drm_event_vblank.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMnhjubeh}(h]h ]h"]h$]h&]uh1jlhjӏhMjhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !DRM_EVENT_FLIP_COMPLETE (C macro)c.DRM_EVENT_FLIP_COMPLETEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_EVENT_FLIP_COMPLETEh]j. )}(hDRM_EVENT_FLIP_COMPLETEh]jW )}(hDRM_EVENT_FLIP_COMPLETEh]j] )}(hjoh]hDRM_EVENT_FLIP_COMPLETE}(hjyhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjuubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjqhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMsubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjmhhhjhMsubah}(h]jhah ](j j eh"]h$]h&]j j )j huh1j' hjhMshjjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjjhhhjhMsubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_EVENT_FLIP_COMPLETE``h]j)}(hjh]hDRM_EVENT_FLIP_COMPLETE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMuhj!dhhubjm)}(h page-flip completion event **Description** This event is sent in response to an atomic commit or legacy page-flip with the :c:type:`DRM_MODE_PAGE_FLIP_EVENT` flag set. The event payload is a struct drm_event_vblank. h](jm)}(hpage-flip completion event h]h)}(hpage-flip completion eventh]hpage-flip completion event}(hjɐhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMshjŐubah}(h]h ]h"]h$]h&]uh1jlhjאhMshjubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjސubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMuhjubh)}(h|This event is sent in response to an atomic commit or legacy page-flip with the :c:type:`DRM_MODE_PAGE_FLIP_EVENT` flag set.h](hPThis event is sent in response to an atomic commit or legacy page-flip with the }(hjhhhNhNubh)}(h":c:type:`DRM_MODE_PAGE_FLIP_EVENT`h]j)}(hjh]hDRM_MODE_PAGE_FLIP_EVENT}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PAGE_FLIP_EVENTuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMthjubh flag set.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMthjubh)}(h/The event payload is a struct drm_event_vblank.h]h/The event payload is a struct drm_event_vblank.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMwhjubeh}(h]h ]h"]h$]h&]uh1jlhjאhMshj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !DRM_EVENT_CRTC_SEQUENCE (C macro)c.DRM_EVENT_CRTC_SEQUENCEhNtauh1j hj!dhhhj{dhNubj# )}(hhh](j( )}(hDRM_EVENT_CRTC_SEQUENCEh]j. )}(hDRM_EVENT_CRTC_SEQUENCEh]jW )}(hDRM_EVENT_CRTC_SEQUENCEh]j] )}(hjPh]hDRM_EVENT_CRTC_SEQUENCE}(hjZhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjVubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjRhhhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM|ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjNhhhjmhM|ubah}(h]jIah ](j j eh"]h$]h&]j j )j huh1j' hjmhM|hjKhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjKhhhjmhM|ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhj{dhNubh)}(h``DRM_EVENT_CRTC_SEQUENCE``h]j)}(hjh]hDRM_EVENT_CRTC_SEQUENCE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hj!dhhubjm)}(h CRTC sequence event **Description** This event is sent in response to :c:type:`DRM_IOCTL_CRTC_QUEUE_SEQUENCE`. The event payload is a struct drm_event_crtc_sequence. h](jm)}(hCRTC sequence event h]h)}(hCRTC sequence eventh]hCRTC sequence event}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM|hjubah}(h]h ]h"]h$]h&]uh1jlhjhM|hjubh)}(h**Description**h]j' )}(hjh]h Description}(hjÑhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM~hjubh)}(hJThis event is sent in response to :c:type:`DRM_IOCTL_CRTC_QUEUE_SEQUENCE`.h](h"This event is sent in response to }(hjבhhhNhNubh)}(h':c:type:`DRM_IOCTL_CRTC_QUEUE_SEQUENCE`h]j)}(hjh]hDRM_IOCTL_CRTC_QUEUE_SEQUENCE}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjߑubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_CRTC_QUEUE_SEQUENCEuh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhM}hjבubh.}(hjבhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM}hjubh)}(h6The event payload is a struct drm_event_crtc_sequence.h]h6The event payload is a struct drm_event_crtc_sequence.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhT/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:823: ./include/uapi/drm/drm.hhMhjubeh}(h]h ]h"]h$]h&]uh1jlhjhM|hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_modeinfo (C struct)c.drm_mode_modeinfohNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_modeinfoh]j. )}(hstruct drm_mode_modeinfoh](j )}(hj h]hstruct}(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj3hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKubjF )}(h h]h }(hjEhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj3hhhjDhKubjW )}(hdrm_mode_modeinfoh]j] )}(hj1h]hdrm_mode_modeinfo}(hjWhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjSubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj3hhhjDhKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj/hhhjDhKubah}(h]j*ah ](j j eh"]h$]h&]j j )j huh1j' hjDhKhj,hhubj )}(hhh]h)}(hDisplay mode information.h]hDisplay mode information.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjvhhubah}(h]h ]h"]h$]h&]uh1j hj,hhhjDhKubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_modeinfo { __u32 clock; __u16 hdisplay; __u16 hsync_start; __u16 hsync_end; __u16 htotal; __u16 hskew; __u16 vdisplay; __u16 vsync_start; __u16 vsync_end; __u16 vtotal; __u16 vscan; __u32 vrefresh; __u32 flags; __u32 type; char name[DRM_DISPLAY_MODE_LEN]; }; **Members** ``clock`` pixel clock in kHz ``hdisplay`` horizontal display size ``hsync_start`` horizontal sync start ``hsync_end`` horizontal sync end ``htotal`` horizontal total size ``hskew`` horizontal skew ``vdisplay`` vertical display size ``vsync_start`` vertical sync start ``vsync_end`` vertical sync end ``vtotal`` vertical total size ``vscan`` vertical scan ``vrefresh`` approximate vertical refresh rate in Hz ``flags`` bitmask of misc. flags, see DRM_MODE_FLAG_* defines ``type`` bitmask of type flags, see DRM_MODE_TYPE_* defines ``name`` string describing the mode resolutionh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj)}(hXNstruct drm_mode_modeinfo { __u32 clock; __u16 hdisplay; __u16 hsync_start; __u16 hsync_end; __u16 htotal; __u16 hskew; __u16 vdisplay; __u16 vsync_start; __u16 vsync_end; __u16 vtotal; __u16 vscan; __u32 vrefresh; __u32 flags; __u32 type; char name[DRM_DISPLAY_MODE_LEN]; };h]hXNstruct drm_mode_modeinfo { __u32 clock; __u16 hdisplay; __u16 hsync_start; __u16 hsync_end; __u16 htotal; __u16 hskew; __u16 vdisplay; __u16 vsync_start; __u16 vsync_end; __u16 vtotal; __u16 vscan; __u32 vrefresh; __u32 flags; __u32 type; char name[DRM_DISPLAY_MODE_LEN]; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubh)}(h **Members**h]j' )}(hjǒh]hMembers}(hjɒhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjŒubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubjs )}(hhh](jx )}(h``clock`` pixel clock in kHz h](j~ )}(h ``clock``h]j)}(hjh]hclock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hpixel clock in kHzh]hpixel clock in kHz}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h%``hdisplay`` horizontal display size h](j~ )}(h ``hdisplay``h]j)}(hjh]hhdisplay}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hhorizontal display sizeh]hhorizontal display size}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hKhj5ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj4hKhjݒubjx )}(h&``hsync_start`` horizontal sync start h](j~ )}(h``hsync_start``h]j)}(hjXh]h hsync_start}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjRubj )}(hhh]h)}(hhorizontal sync starth]hhorizontal sync start}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhKhjnubah}(h]h ]h"]h$]h&]uh1j hjRubeh}(h]h ]h"]h$]h&]uh1jw hjmhKhjݒubjx )}(h"``hsync_end`` horizontal sync end h](j~ )}(h ``hsync_end``h]j)}(hjh]h hsync_end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hhorizontal sync endh]hhorizontal sync end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h!``htotal`` horizontal total size h](j~ )}(h ``htotal``h]j)}(hjʓh]hhtotal}(hj̓hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjȓubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjēubj )}(hhh]h)}(hhorizontal total sizeh]hhorizontal total size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjߓhKhjubah}(h]h ]h"]h$]h&]uh1j hjēubeh}(h]h ]h"]h$]h&]uh1jw hjߓhKhjݒubjx )}(h``hskew`` horizontal skew h](j~ )}(h ``hskew``h]j)}(hjh]hhskew}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hhorizontal skewh]hhorizontal skew}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h#``vdisplay`` vertical display size h](j~ )}(h ``vdisplay``h]j)}(hj<h]hvdisplay}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhj6ubj )}(hhh]h)}(hvertical display sizeh]hvertical display size}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhKhjRubah}(h]h ]h"]h$]h&]uh1j hj6ubeh}(h]h ]h"]h$]h&]uh1jw hjQhKhjݒubjx )}(h$``vsync_start`` vertical sync start h](j~ )}(h``vsync_start``h]j)}(hjuh]h vsync_start}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjoubj )}(hhh]h)}(hvertical sync starth]hvertical sync start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjoubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h ``vsync_end`` vertical sync end h](j~ )}(h ``vsync_end``h]j)}(hjh]h vsync_end}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hvertical sync endh]hvertical sync end}(hjǔhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjÔhKhjĔubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjÔhKhjݒubjx )}(h``vtotal`` vertical total size h](j~ )}(h ``vtotal``h]j)}(hjh]hvtotal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(hvertical total sizeh]hvertical total size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h``vscan`` vertical scan h](j~ )}(h ``vscan``h]j)}(hj h]hvscan}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(h vertical scanh]h vertical scan}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hKhj6ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj5hKhjݒubjx )}(h5``vrefresh`` approximate vertical refresh rate in Hz h](j~ )}(h ``vrefresh``h]j)}(hjYh]hvrefresh}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjSubj )}(hhh]h)}(h'approximate vertical refresh rate in Hzh]h'approximate vertical refresh rate in Hz}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhKhjoubah}(h]h ]h"]h$]h&]uh1j hjSubeh}(h]h ]h"]h$]h&]uh1jw hjnhKhjݒubjx )}(h>``flags`` bitmask of misc. flags, see DRM_MODE_FLAG_* defines h](j~ )}(h ``flags``h]j)}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(h3bitmask of misc. flags, see DRM_MODE_FLAG_* definesh]h3bitmask of misc. flags, see DRM_MODE_FLAG_* defines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h<``type`` bitmask of type flags, see DRM_MODE_TYPE_* defines h](j~ )}(h``type``h]j)}(hj˕h]htype}(hj͕hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɕubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjŕubj )}(hhh]h)}(h2bitmask of type flags, see DRM_MODE_TYPE_* definesh]h2bitmask of type flags, see DRM_MODE_TYPE_* defines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j hjŕubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubjx )}(h.``name`` string describing the mode resolutionh](j~ )}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(h%string describing the mode resolutionh]h%string describing the mode resolution}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhKhjݒubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjEubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhj!dhhubh)}(hrThis is the user-space API display mode information structure. For the kernel version see struct drm_display_mode.h]hrThis is the user-space API display mode information structure. For the kernel version see struct drm_display_mode.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_get_plane (C struct)c.drm_mode_get_planehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_get_planeh]j. )}(hstruct drm_mode_get_planeh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhKubjW )}(hdrm_mode_get_planeh]j] )}(hjh]hdrm_mode_get_plane}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhKubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj}hhhjhKubah}(h]jxah ](j j eh"]h$]h&]j j )j huh1j' hjhKhjzhhubj )}(hhh]h)}(hGet plane metadata.h]hGet plane metadata.}(hjǖhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM3hjĖhhubah}(h]h ]h"]h$]h&]uh1j hjzhhhjhKubeh}(h]h ](j structeh"]h$]h&]jN j jO jߖjP jߖjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX[**Definition**:: struct drm_mode_get_plane { __u32 plane_id; __u32 crtc_id; __u32 fb_id; __u32 possible_crtcs; __u32 gamma_size; __u32 count_format_types; __u64 format_type_ptr; }; **Members** ``plane_id`` Object ID of the plane whose information should be retrieved. Set by caller. ``crtc_id`` Object ID of the current CRTC. ``fb_id`` Object ID of the current fb. ``possible_crtcs`` Bitmask of CRTC's compatible with the plane. CRTC's are created and they receive an index, which corresponds to their position in the bitmask. Bit N corresponds to :ref:`CRTC index` N. ``gamma_size`` Never used. ``count_format_types`` Number of formats. ``format_type_ptr`` Pointer to ``__u32`` array of formats that are supported by the plane. These formats do not require modifiers.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM7hjubj)}(hstruct drm_mode_get_plane { __u32 plane_id; __u32 crtc_id; __u32 fb_id; __u32 possible_crtcs; __u32 gamma_size; __u32 count_format_types; __u64 format_type_ptr; };h]hstruct drm_mode_get_plane { __u32 plane_id; __u32 crtc_id; __u32 fb_id; __u32 possible_crtcs; __u32 gamma_size; __u32 count_format_types; __u64 format_type_ptr; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM9hjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMChjubjs )}(hhh](jx )}(hZ``plane_id`` Object ID of the plane whose information should be retrieved. Set by caller. h](j~ )}(h ``plane_id``h]j)}(hj4h]hplane_id}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMDhj.ubj )}(hhh]h)}(hLObject ID of the plane whose information should be retrieved. Set by caller.h]hLObject ID of the plane whose information should be retrieved. Set by caller.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMChjJubah}(h]h ]h"]h$]h&]uh1j hj.ubeh}(h]h ]h"]h$]h&]uh1jw hjIhMDhj+ubjx )}(h+``crtc_id`` Object ID of the current CRTC. h](j~ )}(h ``crtc_id``h]j)}(hjnh]hcrtc_id}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMHhjhubj )}(hhh]h)}(hObject ID of the current CRTC.h]hObject ID of the current CRTC.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMHhjubah}(h]h ]h"]h$]h&]uh1j hjhubeh}(h]h ]h"]h$]h&]uh1jw hjhMHhj+ubjx )}(h'``fb_id`` Object ID of the current fb. h](j~ )}(h ``fb_id``h]j)}(hjh]hfb_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMJhjubj )}(hhh]h)}(hObject ID of the current fb.h]hObject ID of the current fb.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMJhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMJhj+ubjx )}(h``possible_crtcs`` Bitmask of CRTC's compatible with the plane. CRTC's are created and they receive an index, which corresponds to their position in the bitmask. Bit N corresponds to :ref:`CRTC index` N. h](j~ )}(h``possible_crtcs``h]j)}(hjh]hpossible_crtcs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޗubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMQhjڗubj )}(hhh]h)}(hBitmask of CRTC's compatible with the plane. CRTC's are created and they receive an index, which corresponds to their position in the bitmask. Bit N corresponds to :ref:`CRTC index` N.h](hBitmask of CRTC’s compatible with the plane. CRTC’s are created and they receive an index, which corresponds to their position in the bitmask. Bit N corresponds to }(hjhhhNhNubh)}(h:ref:`CRTC index`h]j~)}(hjh]h CRTC index}(hjhhhNhNubah}(h]h ](j stdstd-refeh"]h$]h&]uh1j}hjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnj crtc_indexuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMNhjubh N.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj!hMNhjubah}(h]h ]h"]h$]h&]uh1j hjڗubeh}(h]h ]h"]h$]h&]uh1jw hjhMQhj+ubjx )}(h``gamma_size`` Never used. h](j~ )}(h``gamma_size``h]j)}(hj>h]h gamma_size}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMThj8ubj )}(hhh]h)}(h Never used.h]h Never used.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMThjTubah}(h]h ]h"]h$]h&]uh1j hj8ubeh}(h]h ]h"]h$]h&]uh1jw hjShMThj+ubjx )}(h*``count_format_types`` Number of formats. h](j~ )}(h``count_format_types``h]j)}(hjwh]hcount_format_types}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMWhjqubj )}(hhh]h)}(hNumber of formats.h]hNumber of formats.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMWhjubah}(h]h ]h"]h$]h&]uh1j hjqubeh}(h]h ]h"]h$]h&]uh1jw hjhMWhj+ubjx )}(h``format_type_ptr`` Pointer to ``__u32`` array of formats that are supported by the plane. These formats do not require modifiers.h](j~ )}(h``format_type_ptr``h]j)}(hjh]hformat_type_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMZhjubj )}(hhh]h)}(hnPointer to ``__u32`` array of formats that are supported by the plane. These formats do not require modifiers.h](h Pointer to }(hjɘhhhNhNubj)}(h ``__u32``h]h__u32}(hjјhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɘubhZ array of formats that are supported by the plane. These formats do not require modifiers.}(hjɘhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjŘhMZhjƘubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjŘhMZhj+ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM^hj!dhhubh)}(hMUserspace can perform a GETPLANE ioctl to retrieve information about a plane.h]hMUserspace can perform a GETPLANE ioctl to retrieve information about a plane.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM4hj!dhhubh)}(hTo retrieve the number of formats supported, set **count_format_types** to zero and call the ioctl. **count_format_types** will be updated with the value.h](h1To retrieve the number of formats supported, set }(hj)hhhNhNubj' )}(h**count_format_types**h]hcount_format_types}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj)ubh to zero and call the ioctl. }(hj)hhhNhNubj' )}(h**count_format_types**h]hcount_format_types}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj)ubh will be updated with the value.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM7hj!dhhubh)}(hXTo retrieve these formats, allocate an array with the memory needed to store **count_format_types** formats. Point **format_type_ptr** to this array and call the ioctl again (with **count_format_types** still set to the value returned in the first ioctl call).h](hMTo retrieve these formats, allocate an array with the memory needed to store }(hj\hhhNhNubj' )}(h**count_format_types**h]hcount_format_types}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj\ubh formats. Point }(hj\hhhNhNubj' )}(h**format_type_ptr**h]hformat_type_ptr}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj\ubh. to this array and call the ioctl again (with }(hj\hhhNhNubj' )}(h**count_format_types**h]hcount_format_types}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj\ubh: still set to the value returned in the first ioctl call).}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM:hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !drm_mode_get_connector (C struct)c.drm_mode_get_connectorhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_get_connectorh]j. )}(hstruct drm_mode_get_connectorh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMBubjF )}(h h]h }(hjșhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjǙhMBubjW )}(hdrm_mode_get_connectorh]j] )}(hjh]hdrm_mode_get_connector}(hjڙhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj֙ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjǙhMBubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjǙhMBubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjǙhMBhjhhubj )}(hhh]h)}(hGet connector metadata.h]hGet connector metadata.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjǙhMBubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_get_connector { __u64 encoders_ptr; __u64 modes_ptr; __u64 props_ptr; __u64 prop_values_ptr; __u32 count_modes; __u32 count_props; __u32 count_encoders; __u32 encoder_id; __u32 connector_id; __u32 connector_type; __u32 connector_type_id; __u32 connection; __u32 mm_width; __u32 mm_height; __u32 subpixel; __u32 pad; }; **Members** ``encoders_ptr`` Pointer to ``__u32`` array of object IDs. ``modes_ptr`` Pointer to struct drm_mode_modeinfo array. ``props_ptr`` Pointer to ``__u32`` array of property IDs. ``prop_values_ptr`` Pointer to ``__u64`` array of property values. ``count_modes`` Number of modes. ``count_props`` Number of properties. ``count_encoders`` Number of encoders. ``encoder_id`` Object ID of the current encoder. ``connector_id`` Object ID of the connector. ``connector_type`` Type of the connector. See DRM_MODE_CONNECTOR_* defines. ``connector_type_id`` Type-specific connector number. This is not an object ID. This is a per-type connector number. Each (type, type_id) combination is unique across all connectors of a DRM device. The (type, type_id) combination is not a stable identifier: the type_id can change depending on the driver probe order. ``connection`` Status of the connector. See enum drm_connector_status. ``mm_width`` Width of the connected sink in millimeters. ``mm_height`` Height of the connected sink in millimeters. ``subpixel`` Subpixel order of the connected sink. See enum subpixel_order. ``pad`` Padding, must be zero.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hXstruct drm_mode_get_connector { __u64 encoders_ptr; __u64 modes_ptr; __u64 props_ptr; __u64 prop_values_ptr; __u32 count_modes; __u32 count_props; __u32 count_encoders; __u32 encoder_id; __u32 connector_id; __u32 connector_type; __u32 connector_type_id; __u32 connection; __u32 mm_width; __u32 mm_height; __u32 subpixel; __u32 pad; };h]hXstruct drm_mode_get_connector { __u64 encoders_ptr; __u64 modes_ptr; __u64 props_ptr; __u64 prop_values_ptr; __u32 count_modes; __u32 count_props; __u32 count_encoders; __u32 encoder_id; __u32 connector_id; __u32 connector_type; __u32 connector_type_id; __u32 connection; __u32 mm_width; __u32 mm_height; __u32 subpixel; __u32 pad; };}hj9sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjJh]hMembers}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjHubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h;``encoders_ptr`` Pointer to ``__u32`` array of object IDs. h](j~ )}(h``encoders_ptr``h]j)}(hjih]h encoders_ptr}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjcubj )}(hhh]h)}(h)Pointer to ``__u32`` array of object IDs.h](h Pointer to }(hjhhhNhNubj)}(h ``__u32``h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh array of object IDs.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj~hMhjubah}(h]h ]h"]h$]h&]uh1j hjcubeh}(h]h ]h"]h$]h&]uh1jw hj~hMhj`ubjx )}(h9``modes_ptr`` Pointer to struct drm_mode_modeinfo array. h](j~ )}(h ``modes_ptr``h]j)}(hjh]h modes_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h*Pointer to struct drm_mode_modeinfo array.h]h*Pointer to struct drm_mode_modeinfo array.}(hj͚hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjɚhMhjʚubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjɚhMhj`ubjx )}(h:``props_ptr`` Pointer to ``__u32`` array of property IDs. h](j~ )}(h ``props_ptr``h]j)}(hjh]h props_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h+Pointer to ``__u32`` array of property IDs.h](h Pointer to }(hjhhhNhNubj)}(h ``__u32``h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh array of property IDs.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(hC``prop_values_ptr`` Pointer to ``__u64`` array of property values. h](j~ )}(h``prop_values_ptr``h]j)}(hj8h]hprop_values_ptr}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj2ubj )}(hhh]h)}(h.Pointer to ``__u64`` array of property values.h](h Pointer to }(hjQhhhNhNubj)}(h ``__u64``h]h__u64}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh array of property values.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjMhMhjNubah}(h]h ]h"]h$]h&]uh1j hj2ubeh}(h]h ]h"]h$]h&]uh1jw hjMhMhj`ubjx )}(h!``count_modes`` Number of modes. h](j~ )}(h``count_modes``h]j)}(hjh]h count_modes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj}ubj )}(hhh]h)}(hNumber of modes.h]hNumber of modes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hj}ubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(h&``count_props`` Number of properties. h](j~ )}(h``count_props``h]j)}(hjh]h count_props}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hNumber of properties.h]hNumber of properties.}(hj՛hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjћhMhjқubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjћhMhj`ubjx )}(h'``count_encoders`` Number of encoders. h](j~ )}(h``count_encoders``h]j)}(hjh]hcount_encoders}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hNumber of encoders.h]hNumber of encoders.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj hMhj`ubjx )}(h1``encoder_id`` Object ID of the current encoder. h](j~ )}(h``encoder_id``h]j)}(hj.h]h encoder_id}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj(ubj )}(hhh]h)}(h!Object ID of the current encoder.h]h!Object ID of the current encoder.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChMhjDubah}(h]h ]h"]h$]h&]uh1j hj(ubeh}(h]h ]h"]h$]h&]uh1jw hjChMhj`ubjx )}(h-``connector_id`` Object ID of the connector. h](j~ )}(h``connector_id``h]j)}(hjgh]h connector_id}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjaubj )}(hhh]h)}(hObject ID of the connector.h]hObject ID of the connector.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hMhj}ubah}(h]h ]h"]h$]h&]uh1j hjaubeh}(h]h ]h"]h$]h&]uh1jw hj|hMhj`ubjx )}(hM``connector_type`` Type of the connector. See DRM_MODE_CONNECTOR_* defines. h](j~ )}(h``connector_type``h]j)}(hjh]hconnector_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(hType of the connector.h]hType of the connector.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h!See DRM_MODE_CONNECTOR_* defines.h]h!See DRM_MODE_CONNECTOR_* defines.}(hjȜhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(hXA``connector_type_id`` Type-specific connector number. This is not an object ID. This is a per-type connector number. Each (type, type_id) combination is unique across all connectors of a DRM device. The (type, type_id) combination is not a stable identifier: the type_id can change depending on the driver probe order. h](j~ )}(h``connector_type_id``h]j)}(hjh]hconnector_type_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(hType-specific connector number.h]hType-specific connector number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(hThis is not an object ID. This is a per-type connector number. Each (type, type_id) combination is unique across all connectors of a DRM device.h]hThis is not an object ID. This is a per-type connector number. Each (type, type_id) combination is unique across all connectors of a DRM device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(hwThe (type, type_id) combination is not a stable identifier: the type_id can change depending on the driver probe order.h]hwThe (type, type_id) combination is not a stable identifier: the type_id can change depending on the driver probe order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(hH``connection`` Status of the connector. See enum drm_connector_status. h](j~ )}(h``connection``h]j)}(hj@h]h connection}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj:ubj )}(hhh](h)}(hStatus of the connector.h]hStatus of the connector.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjVubh)}(hSee enum drm_connector_status.h]hSee enum drm_connector_status.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhMhjVubeh}(h]h ]h"]h$]h&]uh1j hj:ubeh}(h]h ]h"]h$]h&]uh1jw hjUhMhj`ubjx )}(h9``mm_width`` Width of the connected sink in millimeters. h](j~ )}(h ``mm_width``h]j)}(hjh]hmm_width}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h+Width of the connected sink in millimeters.h]h+Width of the connected sink in millimeters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(h;``mm_height`` Height of the connected sink in millimeters. h](j~ )}(h ``mm_height``h]j)}(hjh]h mm_height}(hjÝhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h,Height of the connected sink in millimeters.h]h,Height of the connected sink in millimeters.}(hjڝhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj֝hMhjםubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj֝hMhj`ubjx )}(hM``subpixel`` Subpixel order of the connected sink. See enum subpixel_order. h](j~ )}(h ``subpixel``h]j)}(hjh]hsubpixel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(h%Subpixel order of the connected sink.h]h%Subpixel order of the connected sink.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(hSee enum subpixel_order.h]hSee enum subpixel_order.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj`ubjx )}(h``pad`` Padding, must be zero.h](j~ )}(h``pad``h]j)}(hjBh]hpad}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj<ubj )}(hhh]h)}(hPadding, must be zero.h]hPadding, must be zero.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjXubah}(h]h ]h"]h$]h&]uh1j hj<ubeh}(h]h ]h"]h$]h&]uh1jw hjWhMhj`ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hX)User-space can perform a GETCONNECTOR ioctl to retrieve information about a connector. User-space is expected to retrieve encoders, modes and properties by performing this ioctl at least twice: the first time to retrieve the number of elements, the second time to retrieve the elements themselves.h]hX)User-space can perform a GETCONNECTOR ioctl to retrieve information about a connector. User-space is expected to retrieve encoders, modes and properties by performing this ioctl at least twice: the first time to retrieve the number of elements, the second time to retrieve the elements themselves.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hTo retrieve the number of elements, set **count_props** and **count_encoders** to zero, set **count_modes** to 1, and set **modes_ptr** to a temporary struct drm_mode_modeinfo element.h](h(To retrieve the number of elements, set }(hjhhhNhNubj' )}(h**count_props**h]h count_props}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh and }(hjhhhNhNubj' )}(h**count_encoders**h]hcount_encoders}(hjĞhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh to zero, set }(hjhhhNhNubj' )}(h**count_modes**h]h count_modes}(hj֞hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh to 1, and set }(hjhhhNhNubj' )}(h **modes_ptr**h]h modes_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh1 to a temporary struct drm_mode_modeinfo element.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hTo retrieve the elements, allocate arrays for **encoders_ptr**, **modes_ptr**, **props_ptr** and **prop_values_ptr**, then set **count_modes**, **count_props** and **count_encoders** to their capacity.h](h.To retrieve the elements, allocate arrays for }(hjhhhNhNubj' )}(h**encoders_ptr**h]h encoders_ptr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh, }(hjhhhNhNubj' )}(h **modes_ptr**h]h modes_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh, }(hjhhhNhNubj' )}(h **props_ptr**h]h props_ptr}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh and }(hjhhhNhNubj' )}(h**prop_values_ptr**h]hprop_values_ptr}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh , then set }(hjhhhNhNubj' )}(h**count_modes**h]h count_modes}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh, }hjsbj' )}(h**count_props**h]h count_props}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh and }(hjhhhNhNubj' )}(h**count_encoders**h]hcount_encoders}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh to their capacity.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hX$Performing the ioctl only twice may be racy: the number of elements may have changed with a hotplug event in-between the two ioctls. User-space is expected to retry the last ioctl until the number of elements stabilizes. The kernel won't fill any array which doesn't have the expected length.h]hX(Performing the ioctl only twice may be racy: the number of elements may have changed with a hotplug event in-between the two ioctls. User-space is expected to retry the last ioctl until the number of elements stabilizes. The kernel won’t fill any array which doesn’t have the expected length.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(h**Force-probing a connector**h]j' )}(hjh]hForce-probing a connector}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hXIf the **count_modes** field is set to zero and the DRM client is the current DRM master, the kernel will perform a forced probe on the connector to refresh the connector status, modes and EDID. A forced-probe can be slow, might cause flickering and the ioctl will block.h](hIf the }(hjhhhNhNubj' )}(h**count_modes**h]h count_modes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh field is set to zero and the DRM client is the current DRM master, the kernel will perform a forced probe on the connector to refresh the connector status, modes and EDID. A forced-probe can be slow, might cause flickering and the ioctl will block.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hXUser-space needs to force-probe connectors to ensure their metadata is up-to-date at startup and after receiving a hot-plug event. User-space may perform a forced-probe when the user explicitly requests it. User-space shouldn't perform a forced-probe in other situations.h]hXUser-space needs to force-probe connectors to ensure their metadata is up-to-date at startup and after receiving a hot-plug event. User-space may perform a forced-probe when the user explicitly requests it. User-space shouldn’t perform a forced-probe in other situations.}(hj֟hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !drm_mode_property_enum (C struct)c.drm_mode_property_enumhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_property_enumh]j. )}(hstruct drm_mode_property_enumh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hj hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhj hMubjW )}(hdrm_mode_property_enumh]j] )}(hjh]hdrm_mode_property_enum}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhj hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhj hMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hj hMhjhhubj )}(hhh]h)}(h'Description for an enum/bitfield entry.h]h'Description for an enum/bitfield entry.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj=hhubah}(h]h ]h"]h$]h&]uh1j hjhhhj hMubeh}(h]h ](j structeh"]h$]h&]jN j jO jXjP jXjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Definition**:: struct drm_mode_property_enum { __u64 value; char name[DRM_PROP_NAME_LEN]; }; **Members** ``value`` numeric value for this enum entry. ``name`` symbolic name for this enum entry.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj`ubh:}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj\ubj)}(hUstruct drm_mode_property_enum { __u64 value; char name[DRM_PROP_NAME_LEN]; };h]hUstruct drm_mode_property_enum { __u64 value; char name[DRM_PROP_NAME_LEN]; };}hj}sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM!hj\ubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM&hj\ubjs )}(hhh](jx )}(h-``value`` numeric value for this enum entry. h](j~ )}(h ``value``h]j)}(hjh]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h"numeric value for this enum entry.h]h"numeric value for this enum entry.}(hjƠhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhjàubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj hMhjubjx )}(h+``name`` symbolic name for this enum entry.h](j~ )}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h"symbolic name for this enum entry.h]h"symbolic name for this enum entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubeh}(h]h ]h"]h$]h&]uh1jr hj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hj)h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj'ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM!hj!dhhubh)}(h)See struct drm_property_enum for details.h]h)See struct drm_property_enum for details.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_get_property (C struct)c.drm_mode_get_propertyhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_get_propertyh]j. )}(hstruct drm_mode_get_propertyh](j )}(hj h]hstruct}(hjghhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjchhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM#ubjF )}(h h]h }(hjuhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjchhhjthM#ubjW )}(hdrm_mode_get_propertyh]j] )}(hjah]hdrm_mode_get_property}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjchhhjthM#ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj_hhhjthM#ubah}(h]jZah ](j j eh"]h$]h&]j j )j huh1j' hjthM#hj\hhubj )}(hhh]h)}(hGet property metadata.h]hGet property metadata.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM'hjhhubah}(h]h ]h"]h$]h&]uh1j hj\hhhjthM#ubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX"**Definition**:: struct drm_mode_get_property { __u64 values_ptr; __u64 enum_blob_ptr; __u32 prop_id; __u32 flags; char name[DRM_PROP_NAME_LEN]; __u32 count_values; __u32 count_enum_blobs; }; **Members** ``values_ptr`` Pointer to a ``__u64`` array. ``enum_blob_ptr`` Pointer to a struct drm_mode_property_enum array. ``prop_id`` Object ID of the property which should be retrieved. Set by the caller. ``flags`` ``DRM_MODE_PROP_*`` bitfield. See :c:type:`drm_property.flags ` for a definition of the flags. ``name`` Symbolic property name. User-space should use this field to recognize properties. ``count_values`` Number of elements in **values_ptr**. ``count_enum_blobs`` Number of elements in **enum_blob_ptr**.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj͡hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjɡubh:}(hjɡhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM+hjšubj)}(hstruct drm_mode_get_property { __u64 values_ptr; __u64 enum_blob_ptr; __u32 prop_id; __u32 flags; char name[DRM_PROP_NAME_LEN]; __u32 count_values; __u32 count_enum_blobs; };h]hstruct drm_mode_get_property { __u64 values_ptr; __u64 enum_blob_ptr; __u32 prop_id; __u32 flags; char name[DRM_PROP_NAME_LEN]; __u32 count_values; __u32 count_enum_blobs; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM-hjšubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM7hjšubjs )}(hhh](jx )}(h-``values_ptr`` Pointer to a ``__u64`` array. h](j~ )}(h``values_ptr``h]j)}(hjh]h values_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMGhjubj )}(hhh]h)}(hPointer to a ``__u64`` array.h](h Pointer to a }(hj/hhhNhNubj)}(h ``__u64``h]h__u64}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubh array.}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj+hMGhj,ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj+hMGhj ubjx )}(hD``enum_blob_ptr`` Pointer to a struct drm_mode_property_enum array. h](j~ )}(h``enum_blob_ptr``h]j)}(hjah]h enum_blob_ptr}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMIhj[ubj )}(hhh]h)}(h1Pointer to a struct drm_mode_property_enum array.h]h1Pointer to a struct drm_mode_property_enum array.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMIhjwubah}(h]h ]h"]h$]h&]uh1j hj[ubeh}(h]h ]h"]h$]h&]uh1jw hjvhMIhj ubjx )}(hT``prop_id`` Object ID of the property which should be retrieved. Set by the caller. h](j~ )}(h ``prop_id``h]j)}(hjh]hprop_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMNhjubj )}(hhh]h)}(hGObject ID of the property which should be retrieved. Set by the caller.h]hGObject ID of the property which should be retrieved. Set by the caller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMNhj ubjx )}(hw``flags`` ``DRM_MODE_PROP_*`` bitfield. See :c:type:`drm_property.flags ` for a definition of the flags. h](j~ )}(h ``flags``h]j)}(hjԢh]hflags}(hj֢hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjҢubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMShj΢ubj )}(hhh]h)}(hl``DRM_MODE_PROP_*`` bitfield. See :c:type:`drm_property.flags ` for a definition of the flags.h](j)}(h``DRM_MODE_PROP_*``h]hDRM_MODE_PROP_*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh bitfield. See }(hjhhhNhNubh)}(h+:c:type:`drm_property.flags `h]j)}(hjh]hdrm_property.flags}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_propertyuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMRhjubh for a definition of the flags.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj"hMRhjubah}(h]h ]h"]h$]h&]uh1j hj΢ubeh}(h]h ]h"]h$]h&]uh1jw hjhMShj ubjx )}(h[``name`` Symbolic property name. User-space should use this field to recognize properties. h](j~ )}(h``name``h]j)}(hj?h]hname}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMXhj9ubj )}(hhh]h)}(hQSymbolic property name. User-space should use this field to recognize properties.h]hQSymbolic property name. User-space should use this field to recognize properties.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMWhjUubah}(h]h ]h"]h$]h&]uh1j hj9ubeh}(h]h ]h"]h$]h&]uh1jw hjThMXhj ubjx )}(h7``count_values`` Number of elements in **values_ptr**. h](j~ )}(h``count_values``h]j)}(hjyh]h count_values}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM\hjsubj )}(hhh]h)}(h%Number of elements in **values_ptr**.h](hNumber of elements in }(hjhhhNhNubj' )}(h**values_ptr**h]h values_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM\hjubah}(h]h ]h"]h$]h&]uh1j hjsubeh}(h]h ]h"]h$]h&]uh1jw hjhM\hj ubjx )}(h=``count_enum_blobs`` Number of elements in **enum_blob_ptr**.h](j~ )}(h``count_enum_blobs``h]j)}(hjģh]hcount_enum_blobs}(hjƣhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj£ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM]hjubj )}(hhh]h)}(h(Number of elements in **enum_blob_ptr**.h](hNumber of elements in }(hjݣhhhNhNubj' )}(h**enum_blob_ptr**h]h enum_blob_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjݣubh.}(hjݣhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM^hjڣubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj٣hM]hj ubeh}(h]h ]h"]h$]h&]uh1jr hjšubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMahj!dhhubh)}(hUser-space can perform a GETPROPERTY ioctl to retrieve information about a property. The same property may be attached to multiple objects, see "Modeset Base Object Abstraction".h]hUser-space can perform a GETPROPERTY ioctl to retrieve information about a property. The same property may be attached to multiple objects, see “Modeset Base Object Abstraction”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM(hj!dhhubh)}(hThe meaning of the **values_ptr** field changes depending on the property type. See :c:type:`drm_property.flags ` for more details.h](hThe meaning of the }(hj>hhhNhNubj' )}(h**values_ptr**h]h values_ptr}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj>ubh3 field changes depending on the property type. See }(hj>hhhNhNubh)}(h+:c:type:`drm_property.flags `h]j)}(hjZh]hdrm_property.flags}(hj\hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_propertyuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM,hj>ubh for more details.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjwhM,hj!dhhubh)}(hXThe **enum_blob_ptr** and **count_enum_blobs** fields are only meaningful when the property has the type :c:type:`DRM_MODE_PROP_ENUM` or :c:type:`DRM_MODE_PROP_BITMASK`. For backwards compatibility, the kernel will always set **count_enum_blobs** to zero when the property has the type :c:type:`DRM_MODE_PROP_BLOB`. User-space must ignore these two fields if the property has a different type.h](hThe }(hjhhhNhNubj' )}(h**enum_blob_ptr**h]h enum_blob_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh and }(hjhhhNhNubj' )}(h**count_enum_blobs**h]hcount_enum_blobs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh; fields are only meaningful when the property has the type }(hjhhhNhNubh)}(h:c:type:`DRM_MODE_PROP_ENUM`h]j)}(hjh]hDRM_MODE_PROP_ENUM}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_ENUMuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM/hjubh or }(hjhhhNhNubh)}(h:c:type:`DRM_MODE_PROP_BITMASK`h]j)}(hjԤh]hDRM_MODE_PROP_BITMASK}(hj֤hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjҤubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_BITMASKuh1hhjͤhM/hjubh:. For backwards compatibility, the kernel will always set }(hjhhhNhNubj' )}(h**count_enum_blobs**h]hcount_enum_blobs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh( to zero when the property has the type }(hjhhhNhNubh)}(h:c:type:`DRM_MODE_PROP_BLOB`h]j)}(hj h]hDRM_MODE_PROP_BLOB}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_BLOBuh1hhjͤhM/hjubhO. User-space must ignore these two fields if the property has a different type.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjͤhM/hj!dhhubh)}(hUser-space is expected to retrieve values and enums by performing this ioctl at least twice: the first time to retrieve the number of elements, the second time to retrieve the elements themselves.h]hUser-space is expected to retrieve values and enums by performing this ioctl at least twice: the first time to retrieve the number of elements, the second time to retrieve the elements themselves.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM5hj!dhhubh)}(hX9To retrieve the number of elements, set **count_values** and **count_enum_blobs** to zero, then call the ioctl. **count_values** will be updated with the number of elements. If the property has the type :c:type:`DRM_MODE_PROP_ENUM` or :c:type:`DRM_MODE_PROP_BITMASK`, **count_enum_blobs** will be updated as well.h](h(To retrieve the number of elements, set }(hj?hhhNhNubj' )}(h**count_values**h]h count_values}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj?ubh and }(hj?hhhNhNubj' )}(h**count_enum_blobs**h]hcount_enum_blobs}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj?ubh to zero, then call the ioctl. }(hj?hhhNhNubj' )}(h**count_values**h]h count_values}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj?ubhK will be updated with the number of elements. If the property has the type }(hj?hhhNhNubh)}(h:c:type:`DRM_MODE_PROP_ENUM`h]j)}(hjh]hDRM_MODE_PROP_ENUM}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_ENUMuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM9hj?ubh or }(hj?hhhNhNubh)}(h:c:type:`DRM_MODE_PROP_BITMASK`h]j)}(hjh]hDRM_MODE_PROP_BITMASK}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_BITMASKuh1hhjhM9hj?ubh, }(hj?hhhNhNubj' )}(h**count_enum_blobs**h]hcount_enum_blobs}(hjĥhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj?ubh will be updated as well.}(hj?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM9hj!dhhubh)}(hXUTo retrieve the elements themselves, allocate an array for **values_ptr** and set **count_values** to its capacity. If the property has the type :c:type:`DRM_MODE_PROP_ENUM` or :c:type:`DRM_MODE_PROP_BITMASK`, allocate an array for **enum_blob_ptr** and set **count_enum_blobs** to its capacity. Calling the ioctl again will fill the arrays.h](h;To retrieve the elements themselves, allocate an array for }(hjܥhhhNhNubj' )}(h**values_ptr**h]h values_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjܥubh and set }(hjܥhhhNhNubj' )}(h**count_values**h]h count_values}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjܥubh/ to its capacity. If the property has the type }(hjܥhhhNhNubh)}(h:c:type:`DRM_MODE_PROP_ENUM`h]j)}(hj h]hDRM_MODE_PROP_ENUM}(hj hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_ENUMuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM>hjܥubh or }(hjܥhhhNhNubh)}(h:c:type:`DRM_MODE_PROP_BITMASK`h]j)}(hj.h]hDRM_MODE_PROP_BITMASK}(hj0hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_PROP_BITMASKuh1hhj'hM>hjܥubh, allocate an array for }(hjܥhhhNhNubj' )}(h**enum_blob_ptr**h]h enum_blob_ptr}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjܥubh and set }(hjܥhhhNhNubj' )}(h**count_enum_blobs**h]hcount_enum_blobs}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjܥubh? to its capacity. Calling the ioctl again will fill the arrays.}(hjܥhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj'hM>hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_fb_cmd2 (C struct)c.drm_mode_fb_cmd2hNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_fb_cmd2h]j. )}(hstruct drm_mode_fb_cmd2h](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMGubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMGubjW )}(hdrm_mode_fb_cmd2h]j] )}(hjh]hdrm_mode_fb_cmd2}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMGubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMGubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMGhjhhubj )}(hhh]h)}(hFrame-buffer metadata.h]hFrame-buffer metadata.}(hjԦhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjѦhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMGubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX(**Definition**:: struct drm_mode_fb_cmd2 { __u32 fb_id; __u32 width; __u32 height; __u32 pixel_format; __u32 flags; __u32 handles[4]; __u32 pitches[4]; __u32 offsets[4]; __u64 modifier[4]; }; **Members** ``fb_id`` Object ID of the frame-buffer. ``width`` Width of the frame-buffer. ``height`` Height of the frame-buffer. ``pixel_format`` FourCC format code, see ``DRM_FORMAT_*`` constants in ``drm_fourcc.h``. ``flags`` Frame-buffer flags (see :c:type:`DRM_MODE_FB_INTERLACED` and :c:type:`DRM_MODE_FB_MODIFIERS`). ``handles`` GEM buffer handle, one per plane. Set to 0 if the plane is unused. The same handle can be used for multiple planes. ``pitches`` Pitch (aka. stride) in bytes, one per plane. ``offsets`` Offset into the buffer in bytes, one per plane. ``modifier`` Format modifier, one per plane. See ``DRM_FORMAT_MOD_*`` constants in ``drm_fourcc.h``. All planes must use the same modifier. Ignored unless :c:type:`DRM_MODE_FB_MODIFIERS` is set in **flags**.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hstruct drm_mode_fb_cmd2 { __u32 fb_id; __u32 width; __u32 height; __u32 pixel_format; __u32 flags; __u32 handles[4]; __u32 pitches[4]; __u32 offsets[4]; __u64 modifier[4]; };h]hstruct drm_mode_fb_cmd2 { __u32 fb_id; __u32 width; __u32 height; __u32 pixel_format; __u32 flags; __u32 handles[4]; __u32 pitches[4]; __u32 offsets[4]; __u64 modifier[4]; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hj"h]hMembers}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h)``fb_id`` Object ID of the frame-buffer. h](j~ )}(h ``fb_id``h]j)}(hjAh]hfb_id}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj;ubj )}(hhh]h)}(hObject ID of the frame-buffer.h]hObject ID of the frame-buffer.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjWubah}(h]h ]h"]h$]h&]uh1j hj;ubeh}(h]h ]h"]h$]h&]uh1jw hjVhMhj8ubjx )}(h%``width`` Width of the frame-buffer. h](j~ )}(h ``width``h]j)}(hjzh]hwidth}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjtubj )}(hhh]h)}(hWidth of the frame-buffer.h]hWidth of the frame-buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjtubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj8ubjx )}(h'``height`` Height of the frame-buffer. h](j~ )}(h ``height``h]j)}(hjh]hheight}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hHeight of the frame-buffer.h]hHeight of the frame-buffer.}(hj̧hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjȧhMhjɧubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjȧhMhj8ubjx )}(hY``pixel_format`` FourCC format code, see ``DRM_FORMAT_*`` constants in ``drm_fourcc.h``. h](j~ )}(h``pixel_format``h]j)}(hjh]h pixel_format}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hGFourCC format code, see ``DRM_FORMAT_*`` constants in ``drm_fourcc.h``.h](hFourCC format code, see }(hjhhhNhNubj)}(h``DRM_FORMAT_*``h]h DRM_FORMAT_*}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh constants in }(hjhhhNhNubj)}(h``drm_fourcc.h``h]h drm_fourcc.h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj8ubjx )}(hi``flags`` Frame-buffer flags (see :c:type:`DRM_MODE_FB_INTERLACED` and :c:type:`DRM_MODE_FB_MODIFIERS`). h](j~ )}(h ``flags``h]j)}(hjJh]hflags}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjDubj )}(hhh]h)}(h^Frame-buffer flags (see :c:type:`DRM_MODE_FB_INTERLACED` and :c:type:`DRM_MODE_FB_MODIFIERS`).h](hFrame-buffer flags (see }(hjchhhNhNubh)}(h :c:type:`DRM_MODE_FB_INTERLACED`h]j)}(hjmh]hDRM_MODE_FB_INTERLACED}(hjohhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_FB_INTERLACEDuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjcubh and }(hjchhhNhNubh)}(h:c:type:`DRM_MODE_FB_MODIFIERS`h]j)}(hjh]hDRM_MODE_FB_MODIFIERS}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_FB_MODIFIERSuh1hhjhMhjcubh).}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj`ubah}(h]h ]h"]h$]h&]uh1j hjDubeh}(h]h ]h"]h$]h&]uh1jw hj_hMhj8ubjx )}(h``handles`` GEM buffer handle, one per plane. Set to 0 if the plane is unused. The same handle can be used for multiple planes. h](j~ )}(h ``handles``h]j)}(hjʨh]hhandles}(hj̨hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjȨubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjĨubj )}(hhh]h)}(hsGEM buffer handle, one per plane. Set to 0 if the plane is unused. The same handle can be used for multiple planes.h]hsGEM buffer handle, one per plane. Set to 0 if the plane is unused. The same handle can be used for multiple planes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjĨubeh}(h]h ]h"]h$]h&]uh1jw hjߨhMhj8ubjx )}(h9``pitches`` Pitch (aka. stride) in bytes, one per plane. h](j~ )}(h ``pitches``h]j)}(hjh]hpitches}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h,Pitch (aka. stride) in bytes, one per plane.h]h,Pitch (aka. stride) in bytes, one per plane.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj8ubjx )}(h<``offsets`` Offset into the buffer in bytes, one per plane. h](j~ )}(h ``offsets``h]j)}(hj=h]hoffsets}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj7ubj )}(hhh]h)}(h/Offset into the buffer in bytes, one per plane.h]h/Offset into the buffer in bytes, one per plane.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRhMhjSubah}(h]h ]h"]h$]h&]uh1j hj7ubeh}(h]h ]h"]h$]h&]uh1jw hjRhMhj8ubjx )}(h``modifier`` Format modifier, one per plane. See ``DRM_FORMAT_MOD_*`` constants in ``drm_fourcc.h``. All planes must use the same modifier. Ignored unless :c:type:`DRM_MODE_FB_MODIFIERS` is set in **flags**.h](j~ )}(h ``modifier``h]j)}(hjvh]hmodifier}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjpubj )}(hhh]h)}(hFormat modifier, one per plane. See ``DRM_FORMAT_MOD_*`` constants in ``drm_fourcc.h``. All planes must use the same modifier. Ignored unless :c:type:`DRM_MODE_FB_MODIFIERS` is set in **flags**.h](h$Format modifier, one per plane. See }(hjhhhNhNubj)}(h``DRM_FORMAT_MOD_*``h]hDRM_FORMAT_MOD_*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh constants in }(hjhhhNhNubj)}(h``drm_fourcc.h``h]h drm_fourcc.h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh8. All planes must use the same modifier. Ignored unless }(hjhhhNhNubh)}(h:c:type:`DRM_MODE_FB_MODIFIERS`h]j)}(hjh]hDRM_MODE_FB_MODIFIERS}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_FB_MODIFIERSuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh is set in }(hjhhhNhNubj' )}(h **flags**h]hflags}(hjߩhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjکhMhjubah}(h]h ]h"]h$]h&]uh1j hjpubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj8ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hFThis struct holds frame-buffer metadata. There are two ways to use it:h]hFThis struct holds frame-buffer metadata. There are two ways to use it:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh](j%)}(hUser-space can fill this struct and perform a :c:type:`DRM_IOCTL_MODE_ADDFB2` ioctl to register a new frame-buffer. The new frame-buffer object ID will be set by the kernel in **fb_id**.h]h)}(hUser-space can fill this struct and perform a :c:type:`DRM_IOCTL_MODE_ADDFB2` ioctl to register a new frame-buffer. The new frame-buffer object ID will be set by the kernel in **fb_id**.h](h.User-space can fill this struct and perform a }(hj>hhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_ADDFB2`h]j)}(hjHh]hDRM_IOCTL_MODE_ADDFB2}(hjJhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_ADDFB2uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj>ubhc ioctl to register a new frame-buffer. The new frame-buffer object ID will be set by the kernel in }(hj>hhhNhNubj' )}(h **fb_id**h]hfb_id}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj>ubh.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjehMhj:ubah}(h]h ]h"]h$]h&]uh1j$hj7ubj%)}(hUser-space can set **fb_id** and perform a :c:type:`DRM_IOCTL_MODE_GETFB2` ioctl to fetch metadata about an existing frame-buffer. h]h)}(hUser-space can set **fb_id** and perform a :c:type:`DRM_IOCTL_MODE_GETFB2` ioctl to fetch metadata about an existing frame-buffer.h](hUser-space can set }(hjhhhNhNubj' )}(h **fb_id**h]hfb_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh and perform a }(hjhhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_GETFB2`h]j)}(hjh]hDRM_IOCTL_MODE_GETFB2}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_GETFB2uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh8 ioctl to fetch metadata about an existing frame-buffer.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjŪhMhjubah}(h]h ]h"]h$]h&]uh1j$hj7ubeh}(h]h ]h"]h$]h&]jjuh1jhjehMhj!dhhubh)}(hIn case of planar formats, this struct allows up to 4 buffer objects with offsets and pitches per plane. The pitch and offset order are dictated by the format FourCC as defined by ``drm_fourcc.h``, e.g. NV12 is described as:h](hIn case of planar formats, this struct allows up to 4 buffer objects with offsets and pitches per plane. The pitch and offset order are dictated by the format FourCC as defined by }(hjܪhhhNhNubj)}(h``drm_fourcc.h``h]h drm_fourcc.h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjܪubh, e.g. NV12 is described as:}(hjܪhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubjm)}(hYUV 4:2:0 image with a plane of 8-bit Y samples followed by an interleaved U/V plane containing 8-bit 2x2 subsampled colour difference samples. h]h)}(hYUV 4:2:0 image with a plane of 8-bit Y samples followed by an interleaved U/V plane containing 8-bit 2x2 subsampled colour difference samples.h]hYUV 4:2:0 image with a plane of 8-bit Y samples followed by an interleaved U/V plane containing 8-bit 2x2 subsampled colour difference samples.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1jlhjhMhj!dhhubh)}(hTSo it would consist of a Y plane at ``offsets[0]`` and a UV plane at ``offsets[1]``.h](h$So it would consist of a Y plane at }(hjhhhNhNubj)}(h``offsets[0]``h]h offsets[0]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and a UV plane at }(hjhhhNhNubj)}(h``offsets[1]``h]h offsets[1]}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hXzTo accommodate tiled, compressed, etc formats, a modifier can be specified. For more information see the "Format Modifiers" section. Note that even though it looks like we have a modifier per-plane, we in fact do not. The modifier for each plane must be identical. Thus all combinations of different data layouts for multi-plane formats must be enumerated as separate modifiers.h]hX~To accommodate tiled, compressed, etc formats, a modifier can be specified. For more information see the “Format Modifiers” section. Note that even though it looks like we have a modifier per-plane, we in fact do not. The modifier for each plane must be identical. Thus all combinations of different data layouts for multi-plane formats must be enumerated as separate modifiers.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hX>All of the entries in **handles**, **pitches**, **offsets** and **modifier** must be zero when unused. Warning, for **offsets** and **modifier** zero can't be used to figure out whether the entry is used or not since it's a valid value (a zero offset is common, and a zero modifier is :c:type:`DRM_FORMAT_MOD_LINEAR`).h](hAll of the entries in }(hjXhhhNhNubj' )}(h **handles**h]hhandles}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh, }(hjXhhhNhNubj' )}(h **pitches**h]hpitches}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh, }hjXsbj' )}(h **offsets**h]hoffsets}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh and }(hjXhhhNhNubj' )}(h **modifier**h]hmodifier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh( must be zero when unused. Warning, for }(hjXhhhNhNubj' )}(h **offsets**h]hoffsets}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh and }hjXsbj' )}(h **modifier**h]hmodifier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjXubh zero can’t be used to figure out whether the entry is used or not since it’s a valid value (a zero offset is common, and a zero modifier is }(hjXhhhNhNubh)}(h:c:type:`DRM_FORMAT_MOD_LINEAR`h]j)}(hjΫh]hDRM_FORMAT_MOD_LINEAR}(hjЫhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj̫ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_FORMAT_MOD_LINEARuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjXubh).}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_colorop_type (C enum)c.drm_colorop_typehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_colorop_typeh]j. )}(henum drm_colorop_typeh](j )}(hj-h]henum}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj hhhjhMubjW )}(hdrm_colorop_typeh]j] )}(hj h]hdrm_colorop_type}(hj/hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj+ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj hhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(hType of color operationh]hType of color operation}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMohjNhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j enumeh"]h$]h&]jN j jO jijP jijQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Constants** ``DRM_COLOROP_1D_CURVE`` enum string "1D Curve" A 1D curve that is being applied to all color channels. The curve is specified via the CURVE_1D_TYPE colorop property. ``DRM_COLOROP_1D_LUT`` enum string "1D LUT" A simple 1D LUT of uniformly spaced :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property. The DATA blob is an array of struct drm_color_lut32 with size of "size". ``DRM_COLOROP_CTM_3X4`` enum string "3x4 Matrix" A 3x4 matrix. Its values are specified via the :c:type:`drm_color_ctm_3x4` struct provided via the DATA property. The DATA blob is a float[12]: out matrix in | R | | 0 1 2 3 | | R | | G | = | 4 5 6 7 | x | G | | B | | 8 9 10 12 | | B | ``DRM_COLOROP_MULTIPLIER`` enum string "Multiplier" A simple multiplier, applied to all color values. The multiplier is specified as a S31.32 via the MULTIPLIER property. ``DRM_COLOROP_3D_LUT`` enum string "3D LUT" A 3D LUT of :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property, i.e., a 3D LUT with 17x17x17 entries will have SIZE set to 17. The DATA blob is a 3D array of struct drm_color_lut32 with dimension length of "size". The LUT elements are traversed like so: for B in range 0..n for G in range 0..n for R in range 0..n index = R + n * (G + n * B) color = lut3d[index] ``DRM_COLOROP_FIXED_MATRIX`` enum string "Fixed Matrix" A Colorop block that performs a pre-defined matrix operation selected via the FIXED_MATRIX_TYPE enum property. The driver advertises the supported operations through this property.h](h)}(h **Constants**h]j' )}(hjsh]h Constants}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjqubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMshjmubjs )}(hhh](jx )}(h``DRM_COLOROP_1D_CURVE`` enum string "1D Curve" A 1D curve that is being applied to all color channels. The curve is specified via the CURVE_1D_TYPE colorop property. h](j~ )}(h``DRM_COLOROP_1D_CURVE``h]j)}(hjh]hDRM_COLOROP_1D_CURVE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMyhjubj )}(hhh](h)}(henum string "1D Curve"h]henum string “1D Curve”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMvhjubh)}(hvA 1D curve that is being applied to all color channels. The curve is specified via the CURVE_1D_TYPE colorop property.h]hvA 1D curve that is being applied to all color channels. The curve is specified via the CURVE_1D_TYPE colorop property.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMxhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMyhjubjx )}(hX,``DRM_COLOROP_1D_LUT`` enum string "1D LUT" A simple 1D LUT of uniformly spaced :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property. The DATA blob is an array of struct drm_color_lut32 with size of "size". h](j~ )}(h``DRM_COLOROP_1D_LUT``h]j)}(hj۬h]hDRM_COLOROP_1D_LUT}(hjݬhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj٬ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjլubj )}(hhh](h)}(henum string "1D LUT"h]henum string “1D LUT”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM|hjubh)}(hA simple 1D LUT of uniformly spaced :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property.h](h$A simple 1D LUT of uniformly spaced }(hjhhhNhNubh)}(h:c:type:`drm_color_lut32`h]j)}(hj h]hdrm_color_lut32}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_color_lut32uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM~hjubhy entries, packed into a blob via the DATA property. The driver’s expected LUT size is advertised via the SIZE property.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj*hM~hjubh)}(hHThe DATA blob is an array of struct drm_color_lut32 with size of "size".h]hLThe DATA blob is an array of struct drm_color_lut32 with size of “size”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hjլubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(hX<``DRM_COLOROP_CTM_3X4`` enum string "3x4 Matrix" A 3x4 matrix. Its values are specified via the :c:type:`drm_color_ctm_3x4` struct provided via the DATA property. The DATA blob is a float[12]: out matrix in | R | | 0 1 2 3 | | R | | G | = | 4 5 6 7 | x | G | | B | | 8 9 10 12 | | B | h](j~ )}(h``DRM_COLOROP_CTM_3X4``h]j)}(hjVh]hDRM_COLOROP_CTM_3X4}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjPubj )}(hhh](h)}(henum string "3x4 Matrix"h]henum string “3x4 Matrix”}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjlubh)}(hqA 3x4 matrix. Its values are specified via the :c:type:`drm_color_ctm_3x4` struct provided via the DATA property.h](h/A 3x4 matrix. Its values are specified via the }(hj~hhhNhNubh)}(h:c:type:`drm_color_ctm_3x4`h]j)}(hjh]hdrm_color_ctm_3x4}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_color_ctm_3x4uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj~ubh' struct provided via the DATA property.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjlubh)}(hThe DATA blob is a float[12]: out matrix in | R | | 0 1 2 3 | | R | | G | = | 4 5 6 7 | x | G | | B | | 8 9 10 12 | | B |h]hThe DATA blob is a float[12]: out matrix in | R | | 0 1 2 3 | | R | | G | = | 4 5 6 7 | x | G | | B | | 8 9 10 12 | | B |}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjlubeh}(h]h ]h"]h$]h&]uh1j hjPubeh}(h]h ]h"]h$]h&]uh1jw hjkhMhjubjx )}(h``DRM_COLOROP_MULTIPLIER`` enum string "Multiplier" A simple multiplier, applied to all color values. The multiplier is specified as a S31.32 via the MULTIPLIER property. h](j~ )}(h``DRM_COLOROP_MULTIPLIER``h]j)}(hjѭh]hDRM_COLOROP_MULTIPLIER}(hjӭhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjϭubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj˭ubj )}(hhh](h)}(henum string "Multiplier"h]henum string “Multiplier”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(hvA simple multiplier, applied to all color values. The multiplier is specified as a S31.32 via the MULTIPLIER property.h]hvA simple multiplier, applied to all color values. The multiplier is specified as a S31.32 via the MULTIPLIER property.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hj˭ubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(hX``DRM_COLOROP_3D_LUT`` enum string "3D LUT" A 3D LUT of :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property, i.e., a 3D LUT with 17x17x17 entries will have SIZE set to 17. The DATA blob is a 3D array of struct drm_color_lut32 with dimension length of "size". The LUT elements are traversed like so: for B in range 0..n for G in range 0..n for R in range 0..n index = R + n * (G + n * B) color = lut3d[index] h](j~ )}(h``DRM_COLOROP_3D_LUT``h]j)}(hjh]hDRM_COLOROP_3D_LUT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(henum string "3D LUT"h]henum string “3D LUT”}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj0ubh)}(hA 3D LUT of :c:type:`drm_color_lut32` entries, packed into a blob via the DATA property. The driver's expected LUT size is advertised via the SIZE property, i.e., a 3D LUT with 17x17x17 entries will have SIZE set to 17.h](h A 3D LUT of }(hjBhhhNhNubh)}(h:c:type:`drm_color_lut32`h]j)}(hjLh]hdrm_color_lut32}(hjNhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_color_lut32uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjBubh entries, packed into a blob via the DATA property. The driver’s expected LUT size is advertised via the SIZE property, i.e., a 3D LUT with 17x17x17 entries will have SIZE set to 17.}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjihMhj0ubh)}(h~The DATA blob is a 3D array of struct drm_color_lut32 with dimension length of "size". The LUT elements are traversed like so:h]hThe DATA blob is a 3D array of struct drm_color_lut32 with dimension length of “size”. The LUT elements are traversed like so:}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj0ubjm)}(h~for B in range 0..n for G in range 0..n for R in range 0..n index = R + n * (G + n * B) color = lut3d[index] h]js )}(hhh]jx )}(hvfor B in range 0..n for G in range 0..n for R in range 0..n index = R + n * (G + n * B) color = lut3d[index] h](j~ )}(hfor B in range 0..nh]hfor B in range 0..n}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j} hj/hMhjubj )}(hhh]js )}(hhh]jx )}(h\for G in range 0..n for R in range 0..n index = R + n * (G + n * B) color = lut3d[index] h](j~ )}(hfor G in range 0..nh]hfor G in range 0..n}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j} hj/hMhjubj )}(hhh]js )}(hhh]jx )}(hFfor R in range 0..n index = R + n * (G + n * B) color = lut3d[index] h](j~ )}(hfor R in range 0..nh]hfor R in range 0..n}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j} hj/hMhjubj )}(hhh]js )}(hhh]jx )}(h1index = R + n * (G + n * B) color = lut3d[index] h](j~ )}(hindex = R + n * (G + n * B)h]hindex = R + n * (G + n * B)}(hj֮hhhNhNubah}(h]h ]h"]h$]h&]uh1j} hj/hMhjҮubj )}(hhh]h)}(hcolor = lut3d[index]h]hcolor = lut3d[index]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMhjubah}(h]h ]h"]h$]h&]uh1j hjҮubeh}(h]h ]h"]h$]h&]uh1jw hj/hMhjϮubah}(h]h ]h"]h$]h&]uh1jr hj̮ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj/hMhjubah}(h]h ]h"]h$]h&]uh1jr hjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj/hMhjubah}(h]h ]h"]h$]h&]uh1jr hjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj/hMhjubah}(h]h ]h"]h$]h&]uh1jr hjubah}(h]h ]h"]h$]h&]uh1jlhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj0ubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj/hMhjubjx )}(h``DRM_COLOROP_FIXED_MATRIX`` enum string "Fixed Matrix" A Colorop block that performs a pre-defined matrix operation selected via the FIXED_MATRIX_TYPE enum property. The driver advertises the supported operations through this property.h](j~ )}(h``DRM_COLOROP_FIXED_MATRIX``h]j)}(hjVh]hDRM_COLOROP_FIXED_MATRIX}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjPubj )}(hhh](h)}(henum string "Fixed Matrix"h]henum string “Fixed Matrix”}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjlubh)}(hA Colorop block that performs a pre-defined matrix operation selected via the FIXED_MATRIX_TYPE enum property. The driver advertises the supported operations through this property.h]hA Colorop block that performs a pre-defined matrix operation selected via the FIXED_MATRIX_TYPE enum property. The driver advertises the supported operations through this property.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjlubeh}(h]h ]h"]h$]h&]uh1j hjPubeh}(h]h ]h"]h$]h&]uh1jw hjkhMhjubeh}(h]h ]h"]h$]h&]uh1jr hjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hdrm_colorops can be of many different types. Each type behaves differently and defines a different set of properties. This enum defines all types and gives a high-level description.h]hdrm_colorops can be of many different types. Each type behaves differently and defines a different set of properties. This enum defines all types and gives a high-level description.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMphj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j -drm_colorop_lut3d_interpolation_type (C enum)&c.drm_colorop_lut3d_interpolation_typehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(h$drm_colorop_lut3d_interpolation_typeh]j. )}(h)enum drm_colorop_lut3d_interpolation_typeh](j )}(hj-h]henum}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMwubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMwubjW )}(h$drm_colorop_lut3d_interpolation_typeh]j] )}(hjh]h$drm_colorop_lut3d_interpolation_type}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMwubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjޯhhhjhMwubah}(h]jٯah ](j j eh"]h$]h&]j j )j huh1j' hjhMwhjۯhhubj )}(hhh]h)}(htype of 3DLUT interpolationh]htype of 3DLUT interpolation}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj%hhubah}(h]h ]h"]h$]h&]uh1j hjۯhhhjhMwubeh}(h]h ](j enumeh"]h$]h&]jN j jO j@jP j@jQ jR jS uh1j" hhhj!dhNhNubjU )}(h`**Constants** ``DRM_COLOROP_LUT3D_INTERPOLATION_TETRAHEDRAL`` Tetrahedral 3DLUT interpolationh](h)}(h **Constants**h]j' )}(hjJh]h Constants}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjHubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjDubjs )}(hhh]jx )}(hO``DRM_COLOROP_LUT3D_INTERPOLATION_TETRAHEDRAL`` Tetrahedral 3DLUT interpolationh](j~ )}(h/``DRM_COLOROP_LUT3D_INTERPOLATION_TETRAHEDRAL``h]j)}(hjih]h+DRM_COLOROP_LUT3D_INTERPOLATION_TETRAHEDRAL}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjcubj )}(hhh]h)}(hTetrahedral 3DLUT interpolationh]hTetrahedral 3DLUT interpolation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjcubeh}(h]h ]h"]h$]h&]uh1jw hj~hMhj`ubah}(h]h ]h"]h$]h&]uh1jr hjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j -drm_colorop_lut1d_interpolation_type (C enum)&c.drm_colorop_lut1d_interpolation_typehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(h$drm_colorop_lut1d_interpolation_typeh]j. )}(h)enum drm_colorop_lut1d_interpolation_typeh](j )}(hj-h]henum}(hjðhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjѰhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjаhMubjW )}(h$drm_colorop_lut1d_interpolation_typeh]j] )}(hjh]h$drm_colorop_lut1d_interpolation_type}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj߰ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjаhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjаhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjаhMhjhhubj )}(hhh]h)}(h!type of interpolation for 1D LUTsh]h!type of interpolation for 1D LUTs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjаhMubeh}(h]h ](j enumeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Constants** ``DRM_COLOROP_LUT1D_INTERPOLATION_LINEAR`` Linear interpolation. Values between points of the LUT will be linearly interpolated.h](h)}(h **Constants**h]j' )}(hj'h]h Constants}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj%ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!ubjs )}(hhh]jx )}(h``DRM_COLOROP_LUT1D_INTERPOLATION_LINEAR`` Linear interpolation. Values between points of the LUT will be linearly interpolated.h](j~ )}(h*``DRM_COLOROP_LUT1D_INTERPOLATION_LINEAR``h]j)}(hjFh]h&DRM_COLOROP_LUT1D_INTERPOLATION_LINEAR}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj@ubj )}(hhh]h)}(hULinear interpolation. Values between points of the LUT will be linearly interpolated.h]hULinear interpolation. Values between points of the LUT will be linearly interpolated.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj\ubah}(h]h ]h"]h$]h&]uh1j hj@ubeh}(h]h ]h"]h$]h&]uh1jw hj[hMhj=ubah}(h]h ]h"]h$]h&]uh1jr hj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_plane_size_hint (C struct)c.drm_plane_size_hinthNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_plane_size_hinth]j. )}(hstruct drm_plane_size_hinth](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMubjW )}(hdrm_plane_size_hinth]j] )}(hjh]hdrm_plane_size_hint}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(hPlane size hintsh]hPlane size hints}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjޱhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Definition**:: struct drm_plane_size_hint { __u16 width; __u16 height; }; **Members** ``width`` The width of the plane in pixel ``height`` The height of the plane in pixelh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hBstruct drm_plane_size_hint { __u16 width; __u16 height; };h]hBstruct drm_plane_size_hint { __u16 width; __u16 height; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hj/h]hMembers}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj-ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h*``width`` The width of the plane in pixel h](j~ )}(h ``width``h]j)}(hjNh]hwidth}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjHubj )}(hhh]h)}(hThe width of the plane in pixelh]hThe width of the plane in pixel}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMhjdubah}(h]h ]h"]h$]h&]uh1j hjHubeh}(h]h ]h"]h$]h&]uh1jw hjchMhjEubjx )}(h+``height`` The height of the plane in pixelh](j~ )}(h ``height``h]j)}(hjh]hheight}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h The height of the plane in pixelh]h The height of the plane in pixel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjEubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjʲh]h Description}(hj̲hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjȲubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hSThe plane SIZE_HINTS property blob contains an array of struct drm_plane_size_hint.h]hSThe plane SIZE_HINTS property blob contains an array of struct drm_plane_size_hint.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j !hdr_metadata_infoframe (C struct)c.hdr_metadata_infoframehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hhdr_metadata_infoframeh]j. )}(hstruct hdr_metadata_infoframeh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMubjW )}(hhdr_metadata_infoframeh]j] )}(hjh]hhdr_metadata_infoframe}(hj(hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj$ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(hHDR Metadata Infoframe Data.h]hHDR Metadata Infoframe Data.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjGhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jbjP jbjQ jR jS uh1j" hhhj!dhNhNubjU )}(hXv**Definition**:: struct hdr_metadata_infoframe { __u8 eotf; __u8 metadata_type; struct { __u16 x, y; } display_primaries[3]; struct { __u16 x, y; } white_point; __u16 max_display_mastering_luminance; __u16 min_display_mastering_luminance; __u16 max_cll; __u16 max_fall; }; **Members** ``eotf`` Electro-Optical Transfer Function (EOTF) used in the stream. ``metadata_type`` Static_Metadata_Descriptor_ID. ``display_primaries`` Color Primaries of the Data. These are coded as unsigned 16-bit values in units of 0.00002, where 0x0000 represents zero and 0xC350 represents 1.0000. **display_primaries.x**: X coordinate of color primary. **display_primaries.y**: Y coordinate of color primary. ``white_point`` White Point of Colorspace Data. These are coded as unsigned 16-bit values in units of 0.00002, where 0x0000 represents zero and 0xC350 represents 1.0000. **white_point.x**: X coordinate of whitepoint of color primary. **white_point.y**: Y coordinate of whitepoint of color primary. ``max_display_mastering_luminance`` Max Mastering Display Luminance. This value is coded as an unsigned 16-bit value in units of 1 cd/m2, where 0x0001 represents 1 cd/m2 and 0xFFFF represents 65535 cd/m2. ``min_display_mastering_luminance`` Min Mastering Display Luminance. This value is coded as an unsigned 16-bit value in units of 0.0001 cd/m2, where 0x0001 represents 0.0001 cd/m2 and 0xFFFF represents 6.5535 cd/m2. ``max_cll`` Max Content Light Level. This value is coded as an unsigned 16-bit value in units of 1 cd/m2, where 0x0001 represents 1 cd/m2 and 0xFFFF represents 65535 cd/m2. ``max_fall`` Max Frame Average Light Level. This value is coded as an unsigned 16-bit value in units of 1 cd/m2, where 0x0001 represents 1 cd/m2 and 0xFFFF represents 65535 cd/m2.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjjubh:}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjfubj)}(hX7struct hdr_metadata_infoframe { __u8 eotf; __u8 metadata_type; struct { __u16 x, y; } display_primaries[3]; struct { __u16 x, y; } white_point; __u16 max_display_mastering_luminance; __u16 min_display_mastering_luminance; __u16 max_cll; __u16 max_fall; };h]hX7struct hdr_metadata_infoframe { __u8 eotf; __u8 metadata_type; struct { __u16 x, y; } display_primaries[3]; struct { __u16 x, y; } white_point; __u16 max_display_mastering_luminance; __u16 min_display_mastering_luminance; __u16 max_cll; __u16 max_fall; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjfubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjfubjs )}(hhh](jx )}(hF``eotf`` Electro-Optical Transfer Function (EOTF) used in the stream. h](j~ )}(h``eotf``h]j)}(hjh]heotf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hhjͶubj )}(hhh]h)}(hStatic_Metadata_Descriptor_ID.h]hStatic_Metadata_Descriptor_ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM>hjubah}(h]h ]h"]h$]h&]uh1j hjͶubeh}(h]h ]h"]h$]h&]uh1jw hjhM>hjʶubjx )}(h``{unnamed_union}`` anonymous h](j~ )}(h``{unnamed_union}``h]j)}(hj h]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhKhjubj )}(hhh]h)}(h anonymoush]h anonymous}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hKhj"ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj!hKhjʶubjx )}(h/``hdmi_metadata_type1`` HDR Metadata Infoframe.h](j~ )}(h``hdmi_metadata_type1``h]j)}(hjEh]hhdmi_metadata_type1}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMAhj?ubj )}(hhh]h)}(hHDR Metadata Infoframe.h]hHDR Metadata Infoframe.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMBhj[ubah}(h]h ]h"]h$]h&]uh1j hj?ubeh}(h]h ]h"]h$]h&]uh1jw hjZhMAhjʶubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMEhj!dhhubh)}(h0Metadata Information to be passed from userspaceh]h0Metadata Information to be passed from userspace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM8hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_MODE_PAGE_FLIP_EVENT (C macro)c.DRM_MODE_PAGE_FLIP_EVENThNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_PAGE_FLIP_EVENTh]j. )}(hDRM_MODE_PAGE_FLIP_EVENTh]jW )}(hDRM_MODE_PAGE_FLIP_EVENTh]j] )}(hjh]hDRM_MODE_PAGE_FLIP_EVENT}(hjʷhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjƷubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj·hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMIubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjݷhMIubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjݷhMIhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjݷhMIubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_PAGE_FLIP_EVENT``h]j)}(hjh]hDRM_MODE_PAGE_FLIP_EVENT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMKhj!dhhubjm)}(hX|**Description** Request that the kernel sends back a vblank event (see struct drm_event_vblank) with the :c:type:`DRM_EVENT_FLIP_COMPLETE` type when the page-flip is done. When used with atomic uAPI, one event will be delivered per CRTC included in the atomic commit. A CRTC is included in an atomic commit if one of its properties is set, or if a property is set on a connector or plane linked via the CRTC_ID property to the CRTC. At least one CRTC must be included, and all pulled in CRTCs must be either previously or newly powered on (in other words, a powered off CRTC which stays off cannot be included in the atomic commit). h](h)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMKhjubh)}(hRequest that the kernel sends back a vblank event (see struct drm_event_vblank) with the :c:type:`DRM_EVENT_FLIP_COMPLETE` type when the page-flip is done.h](hYRequest that the kernel sends back a vblank event (see struct drm_event_vblank) with the }(hj.hhhNhNubh)}(h!:c:type:`DRM_EVENT_FLIP_COMPLETE`h]j)}(hj8h]hDRM_EVENT_FLIP_COMPLETE}(hj:hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_EVENT_FLIP_COMPLETEuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMJhj.ubh! type when the page-flip is done.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjUhMJhjubh)}(hXWhen used with atomic uAPI, one event will be delivered per CRTC included in the atomic commit. A CRTC is included in an atomic commit if one of its properties is set, or if a property is set on a connector or plane linked via the CRTC_ID property to the CRTC. At least one CRTC must be included, and all pulled in CRTCs must be either previously or newly powered on (in other words, a powered off CRTC which stays off cannot be included in the atomic commit).h]hXWhen used with atomic uAPI, one event will be delivered per CRTC included in the atomic commit. A CRTC is included in an atomic commit if one of its properties is set, or if a property is set on a connector or plane linked via the CRTC_ID property to the CRTC. At least one CRTC must be included, and all pulled in CRTCs must be either previously or newly powered on (in other words, a powered off CRTC which stays off cannot be included in the atomic commit).}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMNhjubeh}(h]h ]h"]h$]h&]uh1jlhj-hMKhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_MODE_PAGE_FLIP_ASYNC (C macro)c.DRM_MODE_PAGE_FLIP_ASYNChNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_PAGE_FLIP_ASYNCh]j. )}(hDRM_MODE_PAGE_FLIP_ASYNCh]jW )}(hDRM_MODE_PAGE_FLIP_ASYNCh]j] )}(hjh]hDRM_MODE_PAGE_FLIP_ASYNC}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMYubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMYubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMYhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhMYubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_PAGE_FLIP_ASYNC``h]j)}(hjĸh]hDRM_MODE_PAGE_FLIP_ASYNC}(hjƸhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj¸ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM[hj!dhhubjm)}(hXw**Description** Request that the page-flip is performed as soon as possible, ie. with no delay due to waiting for vblank. This may cause tearing to be visible on the screen. When used with atomic uAPI, the driver will return an error if the hardware doesn't support performing an asynchronous page-flip for this update. User-space should handle this, e.g. by falling back to a regular page-flip. Note, some hardware might need to perform one last synchronous page-flip before being able to switch to asynchronous page-flips. As an exception, the driver will return success even though that first page-flip is not asynchronous. h](h)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj޸ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM[hjڸubh)}(hRequest that the page-flip is performed as soon as possible, ie. with no delay due to waiting for vblank. This may cause tearing to be visible on the screen.h]hRequest that the page-flip is performed as soon as possible, ie. with no delay due to waiting for vblank. This may cause tearing to be visible on the screen.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMZhjڸubh)}(hWhen used with atomic uAPI, the driver will return an error if the hardware doesn't support performing an asynchronous page-flip for this update. User-space should handle this, e.g. by falling back to a regular page-flip.h]hWhen used with atomic uAPI, the driver will return an error if the hardware doesn’t support performing an asynchronous page-flip for this update. User-space should handle this, e.g. by falling back to a regular page-flip.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM^hjڸubh)}(hNote, some hardware might need to perform one last synchronous page-flip before being able to switch to asynchronous page-flips. As an exception, the driver will return success even though that first page-flip is not asynchronous.h]hNote, some hardware might need to perform one last synchronous page-flip before being able to switch to asynchronous page-flips. As an exception, the driver will return success even though that first page-flip is not asynchronous.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMbhjڸubeh}(h]h ]h"]h$]h&]uh1jlhjhM[hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_MODE_PAGE_FLIP_FLAGS (C macro)c.DRM_MODE_PAGE_FLIP_FLAGShNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_PAGE_FLIP_FLAGSh]j. )}(hDRM_MODE_PAGE_FLIP_FLAGSh]jW )}(hDRM_MODE_PAGE_FLIP_FLAGSh]j] )}(hj<h]hDRM_MODE_PAGE_FLIP_FLAGS}(hjFhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjBubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj>hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMnubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj:hhhjYhMnubah}(h]j5ah ](j j eh"]h$]h&]j j )j huh1j' hjYhMnhj7hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj7hhhjYhMnubeh}(h]h ](j macroeh"]h$]h&]jN j jO jrjP jrjQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_PAGE_FLIP_FLAGS``h]j)}(hjxh]hDRM_MODE_PAGE_FLIP_FLAGS}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMphj!dhhubjm)}(h**Description** Bitmask of flags suitable for :c:type:`drm_mode_crtc_page_flip_target.flags `. h](h)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMphjubh)}(hnBitmask of flags suitable for :c:type:`drm_mode_crtc_page_flip_target.flags `.h](hBitmask of flags suitable for }(hjhhhNhNubh)}(hO:c:type:`drm_mode_crtc_page_flip_target.flags `h]j)}(hjh]h$drm_mode_crtc_page_flip_target.flags}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_crtc_page_flip_targetuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMohjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjѹhMohjubeh}(h]h ]h"]h$]h&]uh1jlhjhMphj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_create_dumb (C struct)c.drm_mode_create_dumbhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_create_dumbh]j. )}(hstruct drm_mode_create_dumbh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMtubjF )}(h h]h }(hj hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMtubjW )}(hdrm_mode_create_dumbh]j] )}(hjh]hdrm_mode_create_dumb}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMtubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMtubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMthjhhubj )}(hhh]h)}(h%Create a KMS dumb buffer for scanout.h]h%Create a KMS dumb buffer for scanout.}(hj=hhhNhNubah}(h]h ]h"-]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj:hhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMtubeh}(h]h ](j structeh"]h$]h&]jN j jO jUjP jUjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_create_dumb { __u32 height; __u32 width; __u32 bpp; __u32 flags; __u32 handle; __u32 pitch; __u64 size; }; **Members** ``height`` buffer height in pixels ``width`` buffer width in pixels ``bpp`` color mode ``flags`` must be zero ``handle`` buffer object handle ``pitch`` number of bytes between two consecutive lines ``size`` size of the whole buffer in bytesh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj]ubh:}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjYubj)}(hstruct drm_mode_create_dumb { __u32 height; __u32 width; __u32 bpp; __u32 flags; __u32 handle; __u32 pitch; __u64 size; };h]hstruct drm_mode_create_dumb { __u32 height; __u32 width; __u32 bpp; __u32 flags; __u32 handle; __u32 pitch; __u64 size; };}hjzsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjYubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjYubjs )}(hhh](jx )}(h#``height`` buffer height in pixels h](j~ )}(h ``height``h]j)}(hjh]hheight}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hbuffer height in pixelsh]hbuffer height in pixels}(hjúhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h!``width`` buffer width in pixels h](j~ )}(h ``width``h]j)}(hjh]hwidth}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjݺubj )}(hhh]h)}(hbuffer width in pixelsh]hbuffer width in pixels}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjݺubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h``bpp`` color mode h](j~ )}(h``bpp``h]j)}(hjh]hbpp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h color modeh]h color mode}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj2ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj1hMhjubjx )}(h``flags`` must be zero h](j~ )}(h ``flags``h]j)}(hjUh]hflags}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjOubj )}(hhh]h)}(h must be zeroh]h must be zero}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhMhjkubah}(h]h ]h"]h$]h&]uh1j hjOubeh}(h]h ]h"]h$]h&]uh1jw hjjhMhjubjx )}(h ``handle`` buffer object handle h](j~ )}(h ``handle``h]j)}(hjh]hhandle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hbuffer object handleh]hbuffer object handle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h8``pitch`` number of bytes between two consecutive lines h](j~ )}(h ``pitch``h]j)}(hjǻh]hpitch}(hjɻhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjŻubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h-number of bytes between two consecutive linesh]h-number of bytes between two consecutive lines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjܻhMhjݻubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjܻhMhjubjx )}(h*``size`` size of the whole buffer in bytesh](j~ )}(h``size``h]j)}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h!size of the whole buffer in bytesh]h!size of the whole buffer in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubeh}(h]h ]h"]h$]h&]uh1jr hjYubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjCh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjAubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hUser-space fills **height**, **width**, **bpp** and **flags**. If the IOCTL succeeds, the kernel fills **handle**, **pitch** and **size**.h](hUser-space fills }(hjYhhhNhNubj' )}(h **height**h]hheight}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh, }(hjYhhhNhNubj' )}(h **width**h]hwidth}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh, }hjYsbj' )}(h**bpp**h]hbpp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh and }(hjYhhhNhNubj' )}(h **flags**h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh*. If the IOCTL succeeds, the kernel fills }(hjYhhhNhNubj' )}(h **handle**h]hhandle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh, }hjYsbj' )}(h **pitch**h]hpitch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh and }hjYsbj' )}(h**size**h]hsize}(hjͼhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjYubh.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hXEThe value of **bpp** is a color-mode number describing a specific format or a variant thereof. The value often corresponds to the number of bits per pixel for most modes, although there are exceptions. Each color mode maps to a DRM format plus a number of modes with similar pixel layout. Framebuffer layout is always linear.h](h The value of }(hjhhhNhNubj' )}(h**bpp**h]hbpp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubhX1 is a color-mode number describing a specific format or a variant thereof. The value often corresponds to the number of bits per pixel for most modes, although there are exceptions. Each color mode maps to a DRM format plus a number of modes with similar pixel layout. Framebuffer layout is always linear.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hX"Support for all modes and formats is optional. Even if dumb-buffer creation with a certain color mode succeeds, it is not guaranteed that the DRM driver supports any of the related formats. Most drivers support a color mode of 32 with a format of DRM_FORMAT_XRGB8888 on their primary plane.h]hX"Support for all modes and formats is optional. Even if dumb-buffer creation with a certain color mode succeeds, it is not guaranteed that the DRM driver supports any of the related formats. Most drivers support a color mode of 32 with a format of DRM_FORMAT_XRGB8888 on their primary plane.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubjZ")}(hhh]j_")}(hhh](jd")}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jc"hjubjd")}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jc"hjubjd")}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jc"hjubjz")}(hhh]j")}(hhh](j")}(hhh]h)}(h Color modeh]h Color mode}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj@ubah}(h]h ]h"]h$]h&]uh1j"hj=ubj")}(hhh]h)}(hFramebuffer formath]hFramebuffer format}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhMhjXubah}(h]h ]h"]h$]h&]uh1j"hj=ubj")}(hhh]h)}(hCompatible formatsh]hCompatible formats}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhMhjoubah}(h]h ]h"]h$]h&]uh1j"hj=ubeh}(h]h ]h"]h$]h&]uh1j~"hj:ubah}(h]h ]h"]h$]h&]uh1jy"hjubj")}(hhh](j")}(hhh](j")}(hhh]h)}(h32h]h32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_XRGB8888 h]h)}(hDRM_FORMAT_XRGB8888h]hDRM_FORMAT_XRGB8888}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh](j%)}(hDRM_FORMAT_BGRX8888h]h)}(hjh]hDRM_FORMAT_BGRX8888}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j$hjݽubj%)}(hDRM_FORMAT_RGBX8888h]h)}(hjh]hDRM_FORMAT_RGBX8888}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjݽubj%)}(hDRM_FORMAT_XBGR8888h]h)}(hjh]hDRM_FORMAT_XBGR8888}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjݽubeh}(h]h ]h"]h$]h&]jj uh1jhjhMhjڽubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h24h]h24}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj<ubah}(h]h ]h"]h$]h&]uh1j"hj9ubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_RGB888h]h)}(hj\h]hDRM_FORMAT_RGB888}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjZubah}(h]h ]h"]h$]h&]uh1j$hjWubah}(h]h ]h"]h$]h&]jj uh1jhjMhMhjTubah}(h]h ]h"]h$]h&]uh1j"hj9ubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_BGR888h]h)}(hjh]hDRM_FORMAT_BGR888}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhjMhMhj}ubah}(h]h ]h"]h$]h&]uh1j"hj9ubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h16h]h16}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_RGB565h]h)}(hjϾh]hDRM_FORMAT_RGB565}(hjѾhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj;ubah}(h]h ]h"]h$]h&]uh1j$hjʾubah}(h]h ]h"]h$]h&]jj uh1jhjhMhjǾubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_BGR565h]h)}(hjh]hDRM_FORMAT_BGR565}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h15h]h15}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj"ubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_XRGB1555 h]h)}(hDRM_FORMAT_XRGB1555h]hDRM_FORMAT_XRGB1555}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj@ubah}(h]h ]h"]h$]h&]uh1j$hj=ubah}(h]h ]h"]h$]h&]jj uh1jhj3hMhj:ubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh](j%)}(hDRM_FORMAT_BGRX1555h]h)}(hjlh]hDRM_FORMAT_BGRX1555}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhjjubah}(h]h ]h"]h$]h&]uh1j$hjgubj%)}(hDRM_FORMAT_RGBX1555h]h)}(hjh]hDRM_FORMAT_RGBX1555}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjgubj%)}(hDRM_FORMAT_XBGR1555h]h)}(hjh]hDRM_FORMAT_XBGR1555}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjgubeh}(h]h ]h"]h$]h&]jj uh1jhj3hMhjdubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h8h]h8}(hjɿhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjƿubah}(h]h ]h"]h$]h&]uh1j"hjÿubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_C8 h]h)}(h DRM_FORMAT_C8h]h DRM_FORMAT_C8}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj׿hMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhj׿hMhj޿ubah}(h]h ]h"]h$]h&]uh1j"hjÿubj")}(hhh]j )}(hhh](j%)}(h DRM_FORMAT_D8h]h)}(hjh]h DRM_FORMAT_D8}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj׿hMhjubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(h DRM_FORMAT_R8h]h)}(hj'h]h DRM_FORMAT_R8}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj%ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]jj uh1jhj׿hMhjubah}(h]h ]h"]h$]h&]uh1j"hjÿubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h4h]h4}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjRubah}(h]h ]h"]h$]h&]uh1j"hjOubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_C4 h]h)}(h DRM_FORMAT_C4h]h DRM_FORMAT_C4}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMhjpubah}(h]h ]h"]h$]h&]uh1j$hjmubah}(h]h ]h"]h$]h&]jj uh1jhjchMhjjubah}(h]h ]h"]h$]h&]uh1j"hjOubj")}(hhh]j )}(hhh](j%)}(h DRM_FORMAT_D4h]h)}(hjh]h DRM_FORMAT_D4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(h DRM_FORMAT_R4h]h)}(hjh]h DRM_FORMAT_R4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]jj uh1jhjchMhjubah}(h]h ]h"]h$]h&]uh1j"hjOubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h2h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_C2 h]h)}(h DRM_FORMAT_C2h]h DRM_FORMAT_C2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubj")}(hhh]j )}(hhh](j%)}(h DRM_FORMAT_D2h]h)}(hj(h]h DRM_FORMAT_D2}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj&ubah}(h]h ]h"]h$]h&]uh1j$hj#ubj%)}(h DRM_FORMAT_R2h]h)}(hj?h]h DRM_FORMAT_R2}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj=ubah}(h]h ]h"]h$]h&]uh1j$hj#ubeh}(h]h ]h"]h$]h&]jj uh1jhjhMhj ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1j~"hjubj")}(hhh](j")}(hhh]h)}(h1h]h1}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjjubah}(h]h ]h"]h$]h&]uh1j"hjgubj")}(hhh]j )}(hhh]j%)}(hDRM_FORMAT_C1 h]h)}(h DRM_FORMAT_C1h]h DRM_FORMAT_C1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hMhjubah}(h]h ]h"]h$]h&]uh1j$hjubah}(h]h ]h"]h$]h&]jj uh1jhj{hMhjubah}(h]h ]h"]h$]h&]uh1j"hjgubj")}(hhh]j )}(hhh](j%)}(h DRM_FORMAT_D1h]h)}(hjh]h DRM_FORMAT_D1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hMhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(h DRM_FORMAT_R1h]h)}(hjh]h DRM_FORMAT_R1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]jj uh1jhj{hMhjubah}(h]h ]h"]h$]h&]uh1j"hjgubeh}(h]h ]h"]h$]h&]uh1j~"hjubeh}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]colsKuh1j^"hjubah}(h]h ]h"]h$]h&]uh1jY"hj!dhhhNhNubh)}(hColor modes of 10, 12, 15, 30 and 64 are only supported for use by legacy user space. Please don't use them in new code. Other modes are not support.h]hColor modes of 10, 12, 15, 30 and 64 are only supported for use by legacy user space. Please don’t use them in new code. Other modes are not support.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hDo not attempt to allocate anything but linear framebuffer memory with single-plane RGB data. Allocation of other framebuffer layouts requires dedicated ioctls in the respective DRM driver.h]hDo not attempt to allocate anything but linear framebuffer memory with single-plane RGB data. Allocation of other framebuffer layouts requires dedicated ioctls in the respective DRM driver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j #DRM_MODE_ATOMIC_TEST_ONLY (C macro)c.DRM_MODE_ATOMIC_TEST_ONLYhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_ATOMIC_TEST_ONLYh]j. )}(hDRM_MODE_ATOMIC_TEST_ONLYh]jW )}(hDRM_MODE_ATOMIC_TEST_ONLYh]j] )}(hj7h]hDRM_MODE_ATOMIC_TEST_ONLY}(hjAhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj=ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj9hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hj5hhhjThM ubah}(h]j0ah ](j j eh"]h$]h&]j j )j huh1j' hjThM hj2hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj2hhhjThM ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jmjP jmjQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_ATOMIC_TEST_ONLY``h]j)}(hjsh]hDRM_MODE_ATOMIC_TEST_ONLY}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubjm)}(h**Description** Do not apply the atomic commit, instead check whether the hardware supports this configuration. See :c:type:`drm_mode_config_funcs.atomic_check ` for more details on test-only commits. h](h)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h_Do not apply the atomic commit, instead check whether the hardware supports this configuration.h]h_Do not apply the atomic commit, instead check whether the hardware supports this configuration.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM hjubh)}(hoSee :c:type:`drm_mode_config_funcs.atomic_check ` for more details on test-only commits.h](hSee }(hjhhhNhNubh)}(hD:c:type:`drm_mode_config_funcs.atomic_check `h]j)}(hjh]h"drm_mode_config_funcs.atomic_check}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_config_funcsuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh' for more details on test-only commits.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubeh}(h]h ]h"]h$]h&]uh1jlhjhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j "DRM_MODE_ATOMIC_NONBLOCK (C macro)c.DRM_MODE_ATOMIC_NONBLOCKhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_ATOMIC_NONBLOCKh]j. )}(hDRM_MODE_ATOMIC_NONBLOCKh]jW )}(hDRM_MODE_ATOMIC_NONBLOCKh]j] )}(hjh]hDRM_MODE_ATOMIC_NONBLOCK}(hj hhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO j5jP j5jQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_ATOMIC_NONBLOCK``h]j)}(hj;h]hDRM_MODE_ATOMIC_NONBLOCK}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubjm)}(hX**Description** Do not block while applying the atomic commit. The :c:type:`DRM_IOCTL_MODE_ATOMIC` IOCTL returns immediately instead of waiting for the changes to be applied in hardware. Note, the driver will still check that the update can be applied before retuning. h](h)}(h**Description**h]j' )}(hjWh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjUubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjQubh)}(hDo not block while applying the atomic commit. The :c:type:`DRM_IOCTL_MODE_ATOMIC` IOCTL returns immediately instead of waiting for the changes to be applied in hardware. Note, the driver will still check that the update can be applied before retuning.h](h3Do not block while applying the atomic commit. The }(hjmhhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_ATOMIC`h]j)}(hjwh]hDRM_IOCTL_MODE_ATOMIC}(hjyhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_ATOMICuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjmubh IOCTL returns immediately instead of waiting for the changes to be applied in hardware. Note, the driver will still check that the update can be applied before retuning.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjQubeh}(h]h ]h"]h$]h&]uh1jlhjlhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j 'DRM_MODE_ATOMIC_ALLOW_MODESET (C macro)c.DRM_MODE_ATOMIC_ALLOW_MODESEThNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_ATOMIC_ALLOW_MODESETh]j. )}(hDRM_MODE_ATOMIC_ALLOW_MODESETh]jW )}(hDRM_MODE_ATOMIC_ALLOW_MODESETh]j] )}(hjh]hDRM_MODE_ATOMIC_ALLOW_MODESET}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubh)}(h!``DRM_MODE_ATOMIC_ALLOW_MODESET``h]j)}(hjh]hDRM_MODE_ATOMIC_ALLOW_MODESET}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM!hj!dhhubjm)}(hX**Description** Allow the update to result in temporary or transient visible artifacts while the update is being applied. Applying the update may also take significantly more time than a page flip. All visual artifacts will disappear by the time the update is completed, as signalled through the vblank event's timestamp (see struct drm_event_vblank). This flag must be set when the KMS update might cause visible artifacts. Without this flag such KMS update will return a EINVAL error. What kind of update may cause visible artifacts depends on the driver and the hardware. User-space that needs to know beforehand if an update might cause visible artifacts can use :c:type:`DRM_MODE_ATOMIC_TEST_ONLY` without :c:type:`DRM_MODE_ATOMIC_ALLOW_MODESET` to see if it fails. To the best of the driver's knowledge, visual artifacts are guaranteed to not appear when this flag is not set. Some sinks might display visual artifacts outside of the driver's control. h](h)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM!hj ubh)}(hXOAllow the update to result in temporary or transient visible artifacts while the update is being applied. Applying the update may also take significantly more time than a page flip. All visual artifacts will disappear by the time the update is completed, as signalled through the vblank event's timestamp (see struct drm_event_vblank).h]hXQAllow the update to result in temporary or transient visible artifacts while the update is being applied. Applying the update may also take significantly more time than a page flip. All visual artifacts will disappear by the time the update is completed, as signalled through the vblank event’s timestamp (see struct drm_event_vblank).}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM hj ubh)}(hXThis flag must be set when the KMS update might cause visible artifacts. Without this flag such KMS update will return a EINVAL error. What kind of update may cause visible artifacts depends on the driver and the hardware. User-space that needs to know beforehand if an update might cause visible artifacts can use :c:type:`DRM_MODE_ATOMIC_TEST_ONLY` without :c:type:`DRM_MODE_ATOMIC_ALLOW_MODESET` to see if it fails.h](hX;This flag must be set when the KMS update might cause visible artifacts. Without this flag such KMS update will return a EINVAL error. What kind of update may cause visible artifacts depends on the driver and the hardware. User-space that needs to know beforehand if an update might cause visible artifacts can use }(hj5hhhNhNubh)}(h#:c:type:`DRM_MODE_ATOMIC_TEST_ONLY`h]j)}(hj?h]hDRM_MODE_ATOMIC_TEST_ONLY}(hjAhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_ATOMIC_TEST_ONLYuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM&hj5ubh without }(hj5hhhNhNubh)}(h':c:type:`DRM_MODE_ATOMIC_ALLOW_MODESET`h]j)}(hjch]hDRM_MODE_ATOMIC_ALLOW_MODESET}(hjehhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_MODE_ATOMIC_ALLOW_MODESETuh1hhj\hM&hj5ubh to see if it fails.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj\hM&hj ubh)}(hTo the best of the driver's knowledge, visual artifacts are guaranteed to not appear when this flag is not set. Some sinks might display visual artifacts outside of the driver's control.h]hTo the best of the driver’s knowledge, visual artifacts are guaranteed to not appear when this flag is not set. Some sinks might display visual artifacts outside of the driver’s control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM-hj ubeh}(h]h ]h"]h$]h&]uh1jlhj%hM!hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j DRM_MODE_ATOMIC_FLAGS (C macro)c.DRM_MODE_ATOMIC_FLAGShNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hDRM_MODE_ATOMIC_FLAGSh]j. )}(hDRM_MODE_ATOMIC_FLAGSh]jW )}(hDRM_MODE_ATOMIC_FLAGSh]j] )}(hjh]hDRM_MODE_ATOMIC_FLAGS}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM5ubah}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhM5ubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhM5hjhhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hjhhhjhM5ubeh}(h]h ](j macroeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubh)}(h``DRM_MODE_ATOMIC_FLAGS``h]j)}(hjh]hDRM_MODE_ATOMIC_FLAGS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM7hj!dhhubjm)}(h**Description** Bitfield of flags accepted by the :c:type:`DRM_IOCTL_MODE_ATOMIC` IOCTL in :c:type:`drm_mode_atomic.flags `. h](h)}(h**Description**h]j' )}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM7hjubh)}(h}Bitfield of flags accepted by the :c:type:`DRM_IOCTL_MODE_ATOMIC` IOCTL in :c:type:`drm_mode_atomic.flags `.h](h"Bitfield of flags accepted by the }(hj hhhNhNubh)}(h:c:type:`DRM_IOCTL_MODE_ATOMIC`h]j)}(hj*h]hDRM_IOCTL_MODE_ATOMIC}(hj,hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_IOCTL_MODE_ATOMICuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM6hj ubh IOCTL in }(hj hhhNhNubh)}(h1:c:type:`drm_mode_atomic.flags `h]j)}(hjNh]hdrm_mode_atomic.flags}(hjPhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_mode_atomicuh1hhjGhM6hj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjGhM6hjubeh}(h]h ]h"]h$]h&]uh1jlhjhM7hj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_create_blob (C struct)c.drm_mode_create_blobhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_create_blobh]j. )}(hstruct drm_mode_create_blobh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM<ubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhM<ubjW )}(hdrm_mode_create_blobh]j] )}(hjh]hdrm_mode_create_blob}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhM<ubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhM<ubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhM<hjhhubj )}(hhh]h)}(hCreate New blob propertyh]hCreate New blob property}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhM<ubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Definition**:: struct drm_mode_create_blob { __u64 data; __u32 length; __u32 blob_id; }; **Members** ``data`` Pointer to data to copy. ``length`` Length of data to copy. ``blob_id`` Return: new property ID.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hUstruct drm_mode_create_blob { __u64 data; __u32 length; __u32 blob_id; };h]hUstruct drm_mode_create_blob { __u64 data; __u32 length; __u32 blob_id; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hj$h]hMembers}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj"ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h"``data`` Pointer to data to copy. h](j~ )}(h``data``h]j)}(hjCh]hdata}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj=ubj )}(hhh]h)}(hPointer to data to copy.h]hPointer to data to copy.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMhjYubah}(h]h ]h"]h$]h&]uh1j hj=ubeh}(h]h ]h"]h$]h&]uh1jw hjXhMhj:ubjx )}(h#``length`` Length of data to copy. h](j~ )}(h ``length``h]j)}(hj|h]hlength}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjvubj )}(hhh]h)}(hLength of data to copy.h]hLength of data to copy.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjvubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj:ubjx )}(h$``blob_id`` Return: new property ID.h](j~ )}(h ``blob_id``h]j)}(hjh]hblob_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hReturn: new property ID.h]hReturn: new property ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj:ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(heCreate a new 'blob' data property, copying length bytes from data pointer, and returning new blob ID.h]hiCreate a new ‘blob’ data property, copying length bytes from data pointer, and returning new blob ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_destroy_blob (C struct)c.drm_mode_destroy_blobhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_destroy_blobh]j. )}(hstruct drm_mode_destroy_blobh](j )}(hj h]hstruct}(hj6hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj2hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjDhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj2hhhjChMubjW )}(hdrm_mode_destroy_blobh]j] )}(hj0h]hdrm_mode_destroy_blob}(hjVhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjRubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj2hhhjChMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj.hhhjChMubah}(h]j)ah ](j j eh"]h$]h&]j j )j huh1j' hjChMhj+hhubj )}(hhh]h)}(hDestroy user blobh]hDestroy user blob}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjuhhubah}(h]h ]h"]h$]h&]uh1j hj+hhhjChMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h{**Definition**:: struct drm_mode_destroy_blob { __u32 blob_id; }; **Members** ``blob_id`` blob_id to destroyh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(h4struct drm_mode_destroy_blob { __u32 blob_id; };h]h4struct drm_mode_destroy_blob { __u32 blob_id; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh]jx )}(h``blob_id`` blob_id to destroyh](j~ )}(h ``blob_id``h]j)}(hjh]hblob_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hblob_id to destroyh]hblob_id to destroy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubah}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hj(h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj&ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(h%Destroy a user-created blob property.h]h%Destroy a user-created blob property.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hXDUser-space can release blobs as soon as they do not need to refer to them by their blob object ID. For instance, if you are using a MODE_ID blob in an atomic commit and you will not make another commit re-using the same ID, you can destroy the blob as soon as the commit has been issued, without waiting for it to complete.h]hXDUser-space can release blobs as soon as they do not need to refer to them by their blob object ID. For instance, if you are using a MODE_ID blob in an atomic commit and you will not make another commit re-using the same ID, you can destroy the blob as soon as the commit has been issued, without waiting for it to complete.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_create_lease (C struct)c.drm_mode_create_leasehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_create_leaseh]j. )}(hstruct drm_mode_create_leaseh](j )}(hj h]hstruct}(hjuhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjqhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjqhhhjhMubjW )}(hdrm_mode_create_leaseh]j] )}(hjoh]hdrm_mode_create_lease}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjqhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjmhhhjhMubah}(h]jhah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjjhhubj )}(hhh]h)}(h Create leaseh]h Create lease}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjjhhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_create_lease { __u64 object_ids; __u32 object_count; __u32 flags; __u32 lessee_id; __u32 fd; }; **Members** ``object_ids`` Pointer to array of object ids (__u32) ``object_count`` Number of object ids ``flags`` flags for new FD (O_CLOEXEC, etc) ``lessee_id`` Return: unique identifier for lessee. ``fd`` Return: file descriptor to new drm_master fileh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hstruct drm_mode_create_lease { __u64 object_ids; __u32 object_count; __u32 flags; __u32 lessee_id; __u32 fd; };h]hstruct drm_mode_create_lease { __u64 object_ids; __u32 object_count; __u32 flags; __u32 lessee_id; __u32 fd; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h6``object_ids`` Pointer to array of object ids (__u32) h](j~ )}(h``object_ids``h]j)}(hj$h]h object_ids}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h&Pointer to array of object ids (__u32)h]h&Pointer to array of object ids (__u32)}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hj9hMhjubjx )}(h&``object_count`` Number of object ids h](j~ )}(h``object_count``h]j)}(hj]h]h object_count}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjWubj )}(hhh]h)}(hNumber of object idsh]hNumber of object ids}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubah}(h]h ]h"]h$]h&]uh1j hjWubeh}(h]h ]h"]h$]h&]uh1jw hjrhMhjubjx )}(h,``flags`` flags for new FD (O_CLOEXEC, etc) h](j~ )}(h ``flags``h]j)}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h!flags for new FD (O_CLOEXEC, etc)h]h!flags for new FD (O_CLOEXEC, etc)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h4``lessee_id`` Return: unique identifier for lessee. h](j~ )}(h ``lessee_id``h]j)}(hjh]h lessee_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h%Return: unique identifier for lessee.h]h%Return: unique identifier for lessee.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h5``fd`` Return: file descriptor to new drm_master fileh](j~ )}(h``fd``h]j)}(hjh]hfd}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h.Return: file descriptor to new drm_master fileh]h.Return: file descriptor to new drm_master file}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjKh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjIubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(h2Lease mode resources, creating another drm_master.h]h2Lease mode resources, creating another drm_master.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hThe **object_ids** array must reference at least one CRTC, one connector and one plane if :c:type:`DRM_CLIENT_CAP_UNIVERSAL_PLANES` is enabled. Alternatively, the lease can be completely empty.h](hThe }(hjphhhNhNubj' )}(h**object_ids**h]h object_ids}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjpubhH array must reference at least one CRTC, one connector and one plane if }(hjphhhNhNubh)}(h):c:type:`DRM_CLIENT_CAP_UNIVERSAL_PLANES`h]j)}(hjh]hDRM_CLIENT_CAP_UNIVERSAL_PLANES}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j DRM_CLIENT_CAP_UNIVERSAL_PLANESuh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjpubh> is enabled. Alternatively, the lease can be completely empty.}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_list_lessees (C struct)c.drm_mode_list_lesseeshNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_list_lesseesh]j. )}(hstruct drm_mode_list_lesseesh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMubjW )}(hdrm_mode_list_lesseesh]j] )}(hjh]hdrm_mode_list_lessees}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(h List lesseesh]h List lessees}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj hhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO j'jP j'jQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_list_lessees { __u32 count_lessees; __u32 pad; __u64 lessees_ptr; }; **Members** ``count_lessees`` Number of lessees. On input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data. ``pad`` Padding. ``lessees_ptr`` Pointer to lessees. Pointer to __u64 array of lessee idsh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj/ubh:}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj+ubj)}(h`struct drm_mode_list_lessees { __u32 count_lessees; __u32 pad; __u64 lessees_ptr; };h]h`struct drm_mode_list_lessees { __u32 count_lessees; __u32 pad; __u64 lessees_ptr; };}hjLsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj+ubh)}(h **Members**h]j' )}(hj]h]hMembers}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hj[ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj+ubjs )}(hhh](jx )}(h``count_lessees`` Number of lessees. On input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data. h](j~ )}(h``count_lessees``h]j)}(hj|h]h count_lessees}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjvubj )}(hhh](h)}(hNumber of lessees.h]hNumber of lessees.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(hOn input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data.h]hOn input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hjvubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjsubjx )}(h``pad`` Padding. h](j~ )}(h``pad``h]j)}(hjh]hpad}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hPadding.h]hPadding.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjsubjx )}(hI``lessees_ptr`` Pointer to lessees. Pointer to __u64 array of lessee idsh](j~ )}(h``lessees_ptr``h]j)}(hjh]h lessees_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(hPointer to lessees.h]hPointer to lessees.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h$Pointer to __u64 array of lessee idsh]h$Pointer to __u64 array of lessee ids}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjsubeh}(h]h ]h"]h$]h&]uh1jr hj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjPh]h Description}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hList lesses from a drm_master.h]hList lesses from a drm_master.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_get_lease (C struct)c.drm_mode_get_leasehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_get_leaseh]j. )}(hstruct drm_mode_get_leaseh](j )}(hj h]hstruct}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjhhhjhMubjW )}(hdrm_mode_get_leaseh]j] )}(hjh]hdrm_mode_get_lease}(hjhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjhhhjhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjhhhjhMubah}(h]jah ](j j eh"]h$]h&]j j )j huh1j' hjhMhjhhubj )}(hhh]h)}(h Get Leaseh]h Get Lease}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjhhhjhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hX**Definition**:: struct drm_mode_get_lease { __u32 count_objects; __u32 pad; __u64 objects_ptr; }; **Members** ``count_objects`` Number of leased objects. On input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data. ``pad`` Padding. ``objects_ptr`` Pointer to objects. Pointer to __u32 array of object ids.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(h]struct drm_mode_get_lease { __u32 count_objects; __u32 pad; __u64 objects_ptr; };h]h]struct drm_mode_get_lease { __u32 count_objects; __u32 pad; __u64 objects_ptr; };}hj sbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h``count_objects`` Number of leased objects. On input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data. h](j~ )}(h``count_objects``h]j)}(hj=h]h count_objects}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj7ubj )}(hhh](h)}(hNumber of leased objects.h]hNumber of leased objects.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjSubh)}(hOn input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data.h]hOn input, provides length of the array. On output, provides total number. No more than the input number will be written back, so two calls can be used to get the size and then the data.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hwhMhjSubeh}(h]h ]h"]h$]h&]uh1j hj7ubeh}(h]h ]h"]h$]h&]uh1jw hjRhMhj4ubjx )}(h``pad`` Padding. h](j~ )}(h``pad``h]j)}(hjh]hpad}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hPadding.h]hPadding.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj4ubjx )}(hJ``objects_ptr`` Pointer to objects. Pointer to __u32 array of object ids.h](j~ )}(h``objects_ptr``h]j)}(hjh]h objects_ptr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh](h)}(hPointer to objects.h]hPointer to objects.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h%Pointer to __u32 array of object ids.h]h%Pointer to __u32 array of object ids.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhj4ubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(hGet leased objects.h]hGet leased objects.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_revoke_lease (C struct)c.drm_mode_revoke_leasehNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_revoke_leaseh]j. )}(hstruct drm_mode_revoke_leaseh](j )}(hj h]hstruct}(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjKhhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hj]hhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjKhhhj\hMubjW )}(hdrm_mode_revoke_leaseh]j] )}(hjIh]hdrm_mode_revoke_lease}(hjohhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjkubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjKhhhj\hMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjGhhhj\hMubah}(h]jBah ](j j eh"]h$]h&]j j )j huh1j' hj\hMhjDhhubj )}(hhh]h)}(h Revoke leaseh]h Revoke lease}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjDhhhj\hMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Definition**:: struct drm_mode_revoke_lease { __u32 lessee_id; }; **Members** ``lessee_id`` Unique ID of lesseeh](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(h6struct drm_mode_revoke_lease { __u32 lessee_id; };h]h6struct drm_mode_revoke_lease { __u32 lessee_id; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh]jx )}(h!``lessee_id`` Unique ID of lesseeh](j~ )}(h ``lessee_id``h]j)}(hjh]h lessee_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(hUnique ID of lesseeh]hUnique ID of lessee}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubah}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_rect (C struct)c.drm_mode_recthNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(h drm_mode_recth]j. )}(hstruct drm_mode_recth](j )}(hj h]hstruct}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjThhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjfhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hjThhhjehMubjW )}(h drm_mode_recth]j] )}(hjRh]h drm_mode_rect}(hjxhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hjtubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hjThhhjehMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hjPhhhjehMubah}(h]jKah ](j j eh"]h$]h&]j j )j huh1j' hjehMhjMhhubj )}(hhh]h)}(hTwo dimensional rectangle.h]hTwo dimensional rectangle.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j hjMhhhjehMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(hXL**Definition**:: struct drm_mode_rect { __s32 x1; __s32 y1; __s32 x2; __s32 y2; }; **Members** ``x1`` Horizontal starting coordinate (inclusive). ``y1`` Vertical starting coordinate (inclusive). ``x2`` Horizontal ending coordinate (exclusive). ``y2`` Vertical ending coordinate (exclusive).h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj)}(hQstruct drm_mode_rect { __s32 x1; __s32 y1; __s32 x2; __s32 y2; };h]hQstruct drm_mode_rect { __s32 x1; __s32 y1; __s32 x2; __s32 y2; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubh)}(h **Members**h]j' )}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubjs )}(hhh](jx )}(h3``x1`` Horizontal starting coordinate (inclusive). h](j~ )}(h``x1``h]j)}(hjh]hx1}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h+Horizontal starting coordinate (inclusive).h]h+Horizontal starting coordinate (inclusive).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h1``y1`` Vertical starting coordinate (inclusive). h](j~ )}(h``y1``h]j)}(hj@h]hy1}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj:ubj )}(hhh]h)}(h)Vertical starting coordinate (inclusive).h]h)Vertical starting coordinate (inclusive).}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhMhjVubah}(h]h ]h"]h$]h&]uh1j hj:ubeh}(h]h ]h"]h$]h&]uh1jw hjUhMhjubjx )}(h1``x2`` Horizontal ending coordinate (exclusive). h](j~ )}(h``x2``h]j)}(hjyh]hx2}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjsubj )}(hhh]h)}(h)Horizontal ending coordinate (exclusive).h]h)Horizontal ending coordinate (exclusive).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j hjsubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubjx )}(h.``y2`` Vertical ending coordinate (exclusive).h](j~ )}(h``y2``h]j)}(hjh]hy2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j} hY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubj )}(hhh]h)}(h'Vertical ending coordinate (exclusive).h]h'Vertical ending coordinate (exclusive).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jw hjhMhjubeh}(h]h ]h"]h$]h&]uh1jr hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jT hj!dhhhNhNubh)}(h**Description**h]j' )}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(haWith drm subsystem using struct drm_rect to manage rectangular area this export it to user-space.h]haWith drm subsystem using struct drm_rect to manage rectangular area this export it to user-space.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubh)}(h@Currently used by drm_mode_atomic blob property FB_DAMAGE_CLIPS.h]h@Currently used by drm_mode_atomic blob property FB_DAMAGE_CLIPS.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMhj!dhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j drm_mode_closefb (C struct)c.drm_mode_closefbhNtauh1j hj!dhhhNhNubj# )}(hhh](j( )}(hdrm_mode_closefbh]j. )}(hstruct drm_mode_closefbh](j )}(hj h]hstruct}(hjBhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj>hhhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhMubjF )}(h h]h }(hjPhhhNhNubah}(h]h ]jR ah"]h$]h&]uh1jE hj>hhhjOhMubjW )}(hdrm_mode_closefbh]j] )}(hj<h]hdrm_mode_closefb}(hjbhhhNhNubah}(h]h ]ji ah"]h$]h&]uh1j\ hj^ubah}(h]h ](jp jq eh"]h$]h&]hhuh1jV hj>hhhjOhMubeh}(h]h ]h"]h$]h&]hhj uh1j- j j hj:hhhjOhMubah}(h]j5ah ](j j eh"]h$]h&]j j )j huh1j' hjOhMhj7hhubj )}(hhh]h}(h]h ]h"]h$]h&]uh1j hj7hhhjOhMubeh}(h]h ](j structeh"]h$]h&]jN j jO jjP jjQ jR jS uh1j" hhhj!dhNhNubjU )}(h**Definition**:: struct drm_mode_closefb { __u32 fb_id; __u32 pad; }; **Members** ``fb_id`` Framebuffer ID. ``pad`` Must be zero.h](h)}(h**Definition**::h](j' )}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j& hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:826: ./include/uapi/drm/drm_mode.hhM hjubj)}(h it uniquely identifies where the job is going to be executed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhm/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:852: ./drivers/gpu/drm/scheduler/gpu_scheduler_trace.hhK,hj~ubah}(h]h ]h"]h$]h&]uh1j$hjTubj%)}(h``fence`` - the :c:type:`struct dma_fence `.context and the :c:type:`struct dma_fence `.seqno of :c:type:`struct drm_sched_fence `.finished h]h)}(h``fence`` - the :c:type:`struct dma_fence `.context and the :c:type:`struct dma_fence `.seqno of :c:type:`struct drm_sched_fence `.finishedh](j)}(h ``fence``h]hfence}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh - the }(hjhhhNhNubh)}(h&:c:type:`struct dma_fence `h]j)}(hjh]hstruct dma_fence}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j dma_fenceuh1hhm/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:852: ./drivers/gpu/drm/scheduler/gpu_scheduler_trace.hhK/hjubh.context and the }(hjhhhNhNubh)}(h&:c:type:`struct dma_fence `h]j)}(hjh]hstruct dma_fence}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j dma_fenceuh1hhjhK/hjubh .seqno of }(hjhhhNhNubh)}(h2:c:type:`struct drm_sched_fence `h]j)}(hjh]hstruct drm_sched_fence}(hjhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_sched_fenceuh1hhjhK/hjubh .finished}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK/hjubah}(h]h ]h"]h$]h&]uh1j$hjTubeh}(h]h ]h"]h$]h&]jj uh1jhjwhK*hjhhubh)}(hAll the events depends on drm_sched_job_arm() having been called already for the job because they use :c:type:`struct drm_sched_job `.sched or :c:type:`struct drm_sched_job `.s_fence.h](hfAll the events depends on drm_sched_job_arm() having been called already for the job because they use }(hjMhhhNhNubh)}(h.:c:type:`struct drm_sched_job `h]j)}(hjWh]hstruct drm_sched_job}(hjYhhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_sched_jobuh1hhm/var/lib/git/docbuild/linux/Documentation/gpu/drm-uapi:852: ./drivers/gpu/drm/scheduler/gpu_scheduler_trace.hhK2hjMubh .sched or }(hjMhhhNhNubh)}(h.:c:type:`struct drm_sched_job `h]j)}(hj{h]hstruct drm_sched_job}(hj}hhhNhNubah}(h]h ](j j c-typeeh"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]refdocj refdomainj reftypetype refexplicitrefwarnj j j drm_sched_jobuh1hhjthK2hjMubh .s_fence.}(hjMhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjthK2hjhhubeh}(h]j ah ]h"]stable uapi eventsah$]h&]uh1hhjhhhhhMPubeh}(h]jah ]h"] trace eventsah$]h&]uh1hhhhhhhhMFubeh}(h]j<ah ]h"]userland interfacesah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj"footnote_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_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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}(gl_khr_robustness]javulkan]javendor specific recovery]j "aurefids}(j]jaj]jajK]jAaj']j&aj]jdaunameids}(jj<j:j6jj[jjjj}jjjjjPjjjKjjjjjj$jjFjjjjjjhj!jjm jj jjI!jj !jj!jhj'jj!jj+$jjc$jj$jjy%j=j%j_j;&jj&jj&jj 'jj@j'j@jj@j4jX]jbj@jj'AjjAjjEjjQ]j j3cj7jcjYjkj{jbjjaj^jjjjjj u nametypes}(jj:jjjjjjPjjjjjjjjj!jm j jI!j !j!j'j!j+$jc$j$jy%j%j;&j&j&j 'j@j@j@jX]j@j'AjAjEjQ]j3cjcjkjbjajjjuh}(j<hj6j j[j=jjj}jj j) j j jjjjjjjjjjjjjKjSjjSjjj$j3jFjjjjjjhjjjjj jjp jj jj j:j !jhjL!jj!jj!jj!jj.$jjf$j=j$j_j|%jj%jj>&jj&jj&j'j'jj'j4jZ(jQ*jV*j,j ,j-j-j/j/j1j1j3j3j76j<6j8j8j=j=jbj@jj@jj@jj*AjjAjBjBj jEj FjFjGjGjJj!JjLj LjMNjRNjTPjYPj@SjESjVjVjZjZj7j[]j]j]j~_j_jajajYj6cj{jcjj!dj^j!djydjdjfjfjgjgjijijkj#kjkjkjljljwmj|mjnj!njojojpjpjqjqjwrj|rj0sj5sjsjsjtjtjkujpujvjvjwjwjUxjZxjyjyjyjyjzjzj${j){j|j#|j|j|j}j}jt~jy~jnjsjjjjjjjpjuj.j3jهjއjhjmj&j+j%j*jԌjٌjjjdjijhjmjIjNj*j/jxj}jjjjjZj_jjjjjٯjޯjjjjjjjjjjjjj5j:jjj0j5jjjjjjjjj)j.jhjmjjjjjBjGjKjPj5j:jjnjjj jhj.jUjLjwjnjjjjjjjjjjj@j7jbjYjjjjjjjjjj j4j+jbjYjjjjjjjjjj j7j.jYjPj{jrjjjjjjjjj.j%j\jSj{jrjjjjjjjjj1j(jSjJjujljjjjjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jK-sRparse_messages]hsystem_message)}(hhh]h)}(h)Duplicate implicit target name: "vulkan".h]h-Duplicate implicit target name: “vulkan”.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHubah}(h]h ]h"]h$]h&]j:alevelKtypeINFOsourcehnjlineMquh1jFhj !hhhhhMqubatransform_messages](jG)}(hhh]h)}(hhh]h6Hyperlink target "drm-primary-node" is not referenced.}hjisbah}(h]h ]h"]h$]h&]uh1hhjfubah}(h]h ]h"]h$]h&]levelKtypejasourcehnjlineKuh1jFubjG)}(hhh]h)}(hhh]h1Hyperlink target "drm-leasing" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejasourcehnjlineK+uh1jFubjG)}(hhh]h)}(hhh]h5Hyperlink target "drm-render-node" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejasourcehnjlineKuh1jFubjG)}(hhh]h)}(hhh]h6Hyperlink target "drm-driver-ioctl" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejasourcehnjlineMsuh1jFubjG)}(hhh]h)}(hhh]h0Hyperlink target "crtc-index" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejasourcehnjlineM*uh1jFube transformerN include_log] decorationNhhub.