drm/README.rst

60 lines
2.0 KiB
ReStructuredText
Raw Normal View History

2009-11-20 15:08:28 -07:00
libdrm - userspace library for drm
2005-07-10 16:42:42 -06:00
2009-11-20 15:08:28 -07:00
This is libdrm, a userspace library for accessing the DRM, direct
rendering manager, on Linux, BSD and other operating systems that
2009-11-20 15:08:28 -07:00
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. libdrm is a low-level library, typically used by
graphics drivers such as the Mesa DRI drivers, the X drivers, libva
and similar projects. New functionality in the kernel DRM drivers
typically requires a new libdrm, but a new libdrm will always work
with an older kernel.
2007-04-25 14:52:29 -06:00
Compiling
---------
libdrm has two build systems, a legacy autotools build system, and a newer
meson build system. The meson build system is much faster, and offers a
slightly different interface, but otherwise provides an equivalent feature set.
To use it:
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.
Alternatively you can invoke autotools configure:
2007-04-25 14:52:29 -06:00
2009-11-20 15:08:28 -07:00
./configure
2007-04-25 14:52:29 -06:00
2009-11-20 15:08:28 -07:00
By default, libdrm will install into the /usr/local/ prefix. If you
want to install this DRM to replace your system copy, pass
--prefix=/usr and --exec-prefix=/ to configure. If you are building
libdrm from a git checkout, you first need to run the autogen.sh
script. You can pass any options to autogen.sh that you would other
wise pass to configure, or you can just re-run configure with the
options you need once autogen.sh finishes.
2007-04-25 14:52:29 -06:00
2009-11-20 15:08:28 -07:00
Next step is to build libdrm:
2007-04-25 14:52:29 -06:00
make
2009-11-20 15:08:28 -07:00
and once make finishes successfully, install the package using
2007-04-25 14:52:29 -06:00
2009-11-20 15:08:28 -07:00
make install
2007-04-25 14:52:29 -06:00
If you are installing into a system location, you will need to be root
to perform the install step.