Blame SOURCES/README.rst

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