head 1.1; branch 1.1.1; access; symbols netbsd-11-0-RC6:1.1.1.2.4.1 netbsd-11-0-RC5:1.1.1.2.4.1 libdrm-2-4-134:1.1.1.3 netbsd-11-0-RC4:1.1.1.2 netbsd-11-0-RC3:1.1.1.2 netbsd-11-0-RC2:1.1.1.2 netbsd-11-0-RC1:1.1.1.2 netbsd-11:1.1.1.2.0.4 netbsd-11-base:1.1.1.2 libdrm-2-4-124:1.1.1.2 netbsd-10-1-RELEASE:1.1.1.2 libdrm-2-4-122:1.1.1.2 netbsd-10-0-RELEASE:1.1.1.2 netbsd-10-0-RC6:1.1.1.2 netbsd-10-0-RC5:1.1.1.2 netbsd-10-0-RC4:1.1.1.2 netbsd-10-0-RC3:1.1.1.2 netbsd-10-0-RC2:1.1.1.2 netbsd-10-0-RC1:1.1.1.2 netbsd-10:1.1.1.2.0.2 netbsd-10-base:1.1.1.2 libdrm-2-4-114:1.1.1.2 libdrm-2-4-112:1.1.1.2 libdrm-2-4-109:1.1.1.1 libdrm-2-4-107:1.1.1.1 libdrm-2-4-105:1.1.1.1 xorg:1.1.1; locks; strict; comment @# @; 1.1 date 2021.04.27.03.01.49; author mrg; state Exp; branches 1.1.1.1; next ; commitid bnhxFHsntjvsvSQC; 1.1.1.1 date 2021.04.27.03.01.49; author mrg; state Exp; branches; next 1.1.1.2; commitid bnhxFHsntjvsvSQC; 1.1.1.2 date 2022.07.11.19.19.23; author mrg; state Exp; branches 1.1.1.2.4.1; next 1.1.1.3; commitid wjQfX0qND1IWLvLD; 1.1.1.3 date 2026.06.10.05.26.46; author mrg; state Exp; branches; next ; commitid G4AFnpuJae0tcdJG; 1.1.1.2.4.1 date 2026.06.15.19.01.17; author martin; state Exp; branches; next ; commitid k60aEdEWX1t2xVJG; desc @@ 1.1 log @Initial revision @ text @=== drm === ------------------------ Direct Rendering Manager ------------------------ :Date: September 2012 :Manual section: 7 :Manual group: Direct Rendering Manager Synopsis ======== ``#include `` Description =========== The *Direct Rendering Manager* (DRM) is a framework to manage *Graphics Processing Units* (GPUs). It is designed to support the needs of complex graphics devices, usually containing programmable pipelines well suited to 3D graphics acceleration. Furthermore, it is responsible for memory management, interrupt handling and DMA to provide a uniform interface to applications. In earlier days, the kernel framework was solely used to provide raw hardware access to privileged user-space processes which implement all the hardware abstraction layers. But more and more tasks were moved into the kernel. All these interfaces are based on **ioctl**\ (2) commands on the DRM character device. The *libdrm* library provides wrappers for these system-calls and many helpers to simplify the API. When a GPU is detected, the DRM system loads a driver for the detected hardware type. Each connected GPU is then presented to user-space via a character-device that is usually available as ``/dev/dri/card0`` and can be accessed with **open**\ (2) and **close**\ (2). However, it still depends on the graphics driver which interfaces are available on these devices. If an interface is not available, the syscalls will fail with ``EINVAL``. Authentication -------------- All DRM devices provide authentication mechanisms. Only a DRM master is allowed to perform mode-setting or modify core state and only one user can be DRM master at a time. See **drmSetMaster**\ (3) for information on how to become DRM master and what the limitations are. Other DRM users can be authenticated to the DRM-Master via **drmAuthMagic**\ (3) so they can perform buffer allocations and rendering. Mode-Setting ------------ Managing connected monitors and displays and changing the current modes is called *Mode-Setting*. This is restricted to the current DRM master. Historically, this was implemented in user-space, but new DRM drivers implement a kernel interface to perform mode-setting called *Kernel Mode Setting* (KMS). If your hardware-driver supports it, you can use the KMS API provided by DRM. This includes allocating framebuffers, selecting modes and managing CRTCs and encoders. See **drm-kms**\ (7) for more. Memory Management ----------------- The most sophisticated tasks for GPUs today is managing memory objects. Textures, framebuffers, command-buffers and all other kinds of commands for the GPU have to be stored in memory. The DRM driver takes care of managing all memory objects, flushing caches, synchronizing access and providing CPU access to GPU memory. All memory management is hardware driver dependent. However, two generic frameworks are available that are used by most DRM drivers. These are the *Translation Table Manager* (TTM) and the *Graphics Execution Manager* (GEM). They provide generic APIs to create, destroy and access buffers from user-space. However, there are still many differences between the drivers so driver-depedent code is still needed. Many helpers are provided in *libgbm* (Graphics Buffer Manager) from the *Mesa* project. For more information on DRM memory management, see **drm-memory**\ (7). Reporting Bugs ============== Bugs in this manual should be reported to https://gitlab.freedesktop.org/mesa/drm/-/issues. See Also ======== **drm-kms**\ (7), **drm-memory**\ (7), **drmSetMaster**\ (3), **drmAuthMagic**\ (3), **drmAvailable**\ (3), **drmOpen**\ (3) @ 1.1.1.1 log @initial import of libdrm-2.4.105 @ text @@ 1.1.1.2 log @initial import of libdrm-2.4.112 @ text @d76 1 a76 1 there are still many differences between the drivers so driver-dependent @ 1.1.1.2.4.1 log @Pull up the following revisions, requested by mrg in ticket #310: external/mit/libdrm/dist/amdgpu/amdgpu_userq.c up to 1.2 external/mit/libdrm/dist/tests/amdgpu/amdgpu_test.c delete external/mit/libdrm/dist/tests/amdgpu/amdgpu_test.h delete external/mit/libdrm/dist/tests/amdgpu/basic_tests.c delete external/mit/libdrm/dist/tests/amdgpu/bo_tests.c delete external/mit/libdrm/dist/tests/amdgpu/cp_dma_tests.c delete external/mit/libdrm/dist/tests/amdgpu/cs_tests.c delete external/mit/libdrm/dist/tests/amdgpu/deadlock_tests.c delete external/mit/libdrm/dist/tests/amdgpu/decode_messages.h delete external/mit/libdrm/dist/tests/amdgpu/frame.h delete external/mit/libdrm/dist/tests/amdgpu/hotunplug_tests.c delete external/mit/libdrm/dist/tests/amdgpu/jpeg_tests.c delete external/mit/libdrm/dist/tests/amdgpu/ras_tests.c delete external/mit/libdrm/dist/tests/amdgpu/security_tests.c delete external/mit/libdrm/dist/tests/amdgpu/shader_code.h delete external/mit/libdrm/dist/tests/amdgpu/shader_code_gfx10.h delete external/mit/libdrm/dist/tests/amdgpu/shader_code_gfx11.h delete external/mit/libdrm/dist/tests/amdgpu/shader_code_gfx9.h delete external/mit/libdrm/dist/tests/amdgpu/shader_code_hang.h delete external/mit/libdrm/dist/tests/amdgpu/shader_test_util.c delete external/mit/libdrm/dist/tests/amdgpu/syncobj_tests.c delete external/mit/libdrm/dist/tests/amdgpu/uvd_enc_tests.c delete external/mit/libdrm/dist/tests/amdgpu/uve_ib.h delete external/mit/libdrm/dist/tests/amdgpu/vce_ib.h delete external/mit/libdrm/dist/tests/amdgpu/vce_tests.c delete external/mit/libdrm/dist/tests/amdgpu/vcn_tests.c delete external/mit/libdrm/dist/tests/amdgpu/vm_tests.c delete external/mit/libdrm/dist/.gitlab-ci.yml up to 1.1.1.5 external/mit/libdrm/dist/README.rst up to 1.1.1.3 external/mit/libdrm/dist/gen_table_fourcc.py up to 1.1.1.4 external/mit/libdrm/dist/meson.build up to 1.1.1.14 external/mit/libdrm/dist/meson_options.txt up to 1.1.1.4 external/mit/libdrm/dist/util_math.h up to 1.4 external/mit/libdrm/dist/xf86drm.c up to 1.35 external/mit/libdrm/dist/xf86drm.h up to 1.18 external/mit/libdrm/dist/amdgpu/amdgpu-symbols.txt up to 1.1.1.6 external/mit/libdrm/dist/amdgpu/amdgpu.h up to 1.6 external/mit/libdrm/dist/amdgpu/amdgpu_asic_id.c up to 1.1.1.4 external/mit/libdrm/dist/amdgpu/amdgpu_bo.c up to 1.8 external/mit/libdrm/dist/amdgpu/amdgpu_device.c up to 1.1.1.10 external/mit/libdrm/dist/amdgpu/amdgpu_gpu_info.c up to 1.1.1.7 external/mit/libdrm/dist/amdgpu/amdgpu_internal.h up to 1.1.1.7 external/mit/libdrm/dist/amdgpu/amdgpu_vamgr.c up to 1.6 external/mit/libdrm/dist/amdgpu/meson.build up to 1.1.1.9 external/mit/libdrm/dist/data/amdgpu.ids up to 1.1.1.13 external/mit/libdrm/dist/etnaviv/meson.build up to 1.1.1.9 external/mit/libdrm/dist/exynos/meson.build up to 1.1.1.9 external/mit/libdrm/dist/freedreno/meson.build up to 1.1.1.9 external/mit/libdrm/dist/include/drm/amdgpu_drm.h up to 1.1.1.14 external/mit/libdrm/dist/include/drm/drm.h up to 1.16 external/mit/libdrm/dist/include/drm/drm_fourcc.h up to 1.1.1.11 external/mit/libdrm/dist/include/drm/drm_mode.h up to 1.1.1.16 external/mit/libdrm/dist/include/drm/virtgpu_drm.h up to 1.1.1.4 external/mit/libdrm/dist/intel/meson.build up to 1.1.1.9 external/mit/libdrm/dist/man/drm-kms.7.rst up to 1.1.1.3 external/mit/libdrm/dist/man/drm-memory.7.rst up to 1.1.1.3 external/mit/libdrm/dist/man/drm.7.rst up to 1.1.1.3 external/mit/libdrm/dist/man/drmAvailable.3.rst up to 1.1.1.2 external/mit/libdrm/dist/man/drmHandleEvent.3.rst up to 1.1.1.2 external/mit/libdrm/dist/man/drmModeGetResources.3.rst up to 1.1.1.2 external/mit/libdrm/dist/nouveau/meson.build up to 1.1.1.9 external/mit/libdrm/dist/omap/meson.build up to 1.1.1.9 external/mit/libdrm/dist/omap/omap_drm.c up to 1.1.1.9 external/mit/libdrm/dist/radeon/meson.build up to 1.1.1.9 external/mit/libdrm/dist/tegra/meson.build up to 1.1.1.9 external/mit/libdrm/dist/tests/drmdevice.c up to 1.1.1.6 external/mit/libdrm/dist/tests/amdgpu/meson.build up to 1.1.1.9 external/mit/libdrm/dist/tests/modetest/buffers.c up to 1.1.1.11 external/mit/libdrm/dist/tests/modetest/buffers.h up to 1.1.1.5 external/mit/libdrm/dist/tests/modetest/modetest.c up to 1.21 external/mit/libdrm/dist/tests/util/pattern.c up to 1.1.1.9 external/mit/libdrm/dist/tests/util/pattern.h up to 1.1.1.4 Import libdrm 2.4.134. @ text @d85 1 a85 1 https://gitlab.freedesktop.org/mesa/libdrm/-/issues. @ 1.1.1.3 log @initial import of libdrm-2.4.134 @ text @d85 1 a85 1 https://gitlab.freedesktop.org/mesa/libdrm/-/issues. @