mirror of
https://gitlab.freedesktop.org/mesa/drm.git
synced 2025-12-20 04:40:09 +01:00
64ef303d70
When adding support for defining extra paths for the `amdgpu.ids`
file using an environment variable, the patch used a call to
secure_getenv(), which is only available in GNU. This breaks the
build in NetBSD systems.
This patch adds conditional compilation to use secure_getenv()
only when compiling against the GNU libraries.
Fix c3c7fb21aa (note_3229411)
Signed-off-by: Sergio Costas Rodriguez <sergio.costas@canonical.com>
63 lines
No EOL
2.5 KiB
ReStructuredText
63 lines
No EOL
2.5 KiB
ReStructuredText
libdrm - userspace library for drm
|
|
----------------------------------
|
|
|
|
This is libdrm, a userspace library for accessing the DRM, direct rendering
|
|
manager, on Linux, BSD and other operating systems that support the ioctl
|
|
interface.
|
|
The library provides wrapper functions for the ioctls to avoid exposing the
|
|
kernel interface directly, and for chipsets with drm memory manager, support
|
|
for tracking relocations and buffers.
|
|
New functionality in the kernel DRM drivers typically requires a new libdrm,
|
|
but a new libdrm will always work with an older kernel.
|
|
|
|
libdrm is a low-level library, typically used by graphics drivers such as
|
|
the Mesa drivers, the X drivers, libva and similar projects.
|
|
|
|
Syncing with the Linux kernel headers
|
|
-------------------------------------
|
|
|
|
The library should be regularly updated to match the recent changes in the
|
|
`include/uapi/drm/`.
|
|
|
|
libdrm maintains a human-readable version for the token format modifier, with
|
|
the simpler ones being extracted automatically from `drm_fourcc.h` header file
|
|
with the help of a python script. This might not always possible, as some of
|
|
the vendors require decoding/extracting them programmatically. For that
|
|
reason one can enhance the current vendor functions to include/provide the
|
|
newly added token formats, or, in case there's no such decoding
|
|
function, to add one that performs the tasks of extracting them.
|
|
|
|
For simpler format modifier tokens there's a script (gen_table_fourcc.py) that
|
|
creates a static table, by going over `drm_fourcc.h` header file. The script
|
|
could be further modified if it can't handle new (simpler) token format
|
|
modifiers instead of the generated static table.
|
|
|
|
Compiling
|
|
---------
|
|
|
|
To set up meson:
|
|
|
|
meson builddir/
|
|
|
|
By default this will install into /usr/local, you can change your prefix
|
|
with --prefix=/usr (or `meson configure builddir/ -Dprefix=/usr` after
|
|
the initial meson setup).
|
|
|
|
Then use ninja to build and install:
|
|
|
|
ninja -C builddir/ install
|
|
|
|
If you are installing into a system location you will need to run install
|
|
separately, and as root.
|
|
|
|
AMDGPU ASIC table file
|
|
----------------------
|
|
|
|
The AMDGPU driver requires the `amdgpu.ids` file. It is usually located at
|
|
`$PREFIX/share/libdrm`, but it is possible to specify a set of alternative
|
|
paths at runtime by setting the `AMDGPU_ASIC_ID_TABLE_PATHS` environment
|
|
variable with one or more colon-separated paths where to search for the
|
|
`amdgpu.ids` file.
|
|
|
|
For this option to be available, the C library must support secure_getenv()
|
|
function. In systems without it (like NetBSD), this option won't be available. |