Blame SOURCES/README.rst

e3be42
libdrm - userspace library for drm
e3be42
----------------------------------
e3be42
e3be42
This is libdrm, a userspace library for accessing the DRM, direct rendering
e3be42
manager, on Linux, BSD and other operating systems that support the ioctl
e3be42
interface.
e3be42
The library provides wrapper functions for the ioctls to avoid exposing the
e3be42
kernel interface directly, and for chipsets with drm memory manager, support
e3be42
for tracking relocations and buffers.
e3be42
New functionality in the kernel DRM drivers typically requires a new libdrm,
e3be42
but a new libdrm will always work with an older kernel.
e3be42
e3be42
libdrm is a low-level library, typically used by graphics drivers such as
e3be42
the Mesa drivers, the X drivers, libva and similar projects.
e3be42
e3be42
e3be42
Compiling
e3be42
---------
e3be42
e3be42
libdrm has two build systems, a legacy autotools build system, and a newer
e3be42
meson build system. The meson build system is much faster, and offers a
e3be42
slightly different interface, but otherwise provides an equivalent feature set.
e3be42
e3be42
To use it:
e3be42
e3be42
    meson builddir/
e3be42
e3be42
By default this will install into /usr/local, you can change your prefix
e3be42
with --prefix=/usr (or `meson configure builddir/ -Dprefix=/usr` after 
e3be42
the initial meson setup).
e3be42
e3be42
Then use ninja to build and install:
e3be42
e3be42
    ninja -C builddir/ install
e3be42
e3be42
If you are installing into a system location you will need to run install
e3be42
separately, and as root.
e3be42
e3be42
e3be42
Alternatively you can invoke autotools configure:
e3be42
e3be42
	./configure
e3be42
e3be42
By default, libdrm  will install into the /usr/local/  prefix.  If you
e3be42
want  to  install   this  DRM  to  replace  your   system  copy,  pass
e3be42
--prefix=/usr and  --exec-prefix=/ to configure.  If  you are building
e3be42
libdrm  from a  git checkout,  you first  need to  run  the autogen.sh
e3be42
script.  You can  pass any options to autogen.sh  that you would other
e3be42
wise  pass to configure,  or you  can just  re-run configure  with the
e3be42
options you need once autogen.sh finishes.
e3be42
e3be42
Next step is to build libdrm:
e3be42
e3be42
	make
e3be42
e3be42
and once make finishes successfully, install the package using
e3be42
e3be42
	make install
e3be42
e3be42
If you are installing into a system location, you will need to be root
e3be42
to perform the install step.