View source for Xorg7/Libraries

{| style="text-align: left; background-color: AliceBlue;"
|-
!Download Source:
| {{Xorg7-Mirror}}/lib/
|}

Back to [[Xorg7/Utilities|Utilities]]

{{Package-Introduction|There are 47 libraries.  Similar to the protocols, using wget and appending a *.bz2 or *.gz to the base URL above is probably the most efficient way to get the tarballs on your system.

Alternately, if you chose to use subdirectories, the tarballs can be retrieved as follows. This will prevent multiple versions from being downloaded when multiple versions exist.

 wget {{Filepathlink|Lib-{{Xorg7-Version}}.wget}} &&
 mkdir -p lib &&
 cd lib &&
 wget -B {{Xorg7-Mirror}}/lib/ -i ../Lib-{{Xorg7-Version}}.wget}}

== Dependencies ==

The X.org libraries require their respective protocols to be installed first.  Although not necessary, it is recommended that all of the protocol headers are installed before the libraries.

There are some dependency orders in the libraries.  xtrans, Xau, Xdmcp must be installed before anything else.  libXext must be installed before any other extension library.  The wget file above lists the libraries in the proper build order.  Additional, non-Xorg, dependencies are listed below for those libraries that require them..

{|style="text-align: left" border="0" cellspacing="0" width="85%" align="center" rules="all"
|-
!style="text-align: center" width="10%"|Xorg Library
!style="text-align: left" width="25%"|Required
!style="text-align: left" width="25%"|Recommended
!style="text-align: left" width="25%"|Optional
|-
|style="text-align: center; font-weight: bold"|libX11 || || [[XCB]] ||
|-
|style="text-align: center; font-weight: bold"|libXaw || [[ed]] || ||
|-
|style="text-align: center; font-weight: bold"|libXfont || [[FreeType]] || ||
|-
|style="text-align: center; font-weight: bold"|libXft ||[[FreeType]], [[FontConfig]] || ||
|-
|style="text-align: center; font-weight: bold"|libpciaccess ||[[PCI Utilities]] || ||
|-
|style="text-align: center; font-weight: bold"|pixman || || ||[[Gtk2]]
|}

== Configuration Information ==

Besides the 'standard' optional features, the following libraries have additional optional features that you may wish to enable or disable.

{|style="text-align: left" border="0" cellspacing="0" width="85%" align="center"
|-
!style="text-align: center" width="10%"|
!width="15%"|
!width="60%"|
|-
|style="text-align: center; font-weight: bold"|libXau||<i>--disable-xthreads</i>||disable libXau support for multithreading.
|-
|style="text-align: center; font-weight: bold"|libX11||<i>--enable-secure-rpc</i>||enable secure RPC.
|-
||||<i>--enable-loadable-i18n</i>||controls loadable i18n module support.
|-
||||<i>--disable-loadable-xcursor</i>||controls loadable xcursor library support.
|-
||||<i>--disable-xthreads</i>||disable Xlib support for multithreading.
|-
||||<i>--disable-xcms</i>||disable Xlib support for CMS <b>(EXPERIMENTAL)</b>
|-
||||<i>--disable-xlocale</i>||disable Xlib locale implementation <b>(EXPERIMENTAL)</b>
|-
||||<i>--enable-xlocaledir</i>||enable XLOCALEDIR environment variable support.
|-
||||<i>--disable-xf86bigfont</i>||disable XF86BigFont extension support.
|-
||||<i>--disable-xkb</i>||disable XKB support <b>(EXPERIMENTAL)</b>
|-
|style="text-align: center; font-weight: bold"|libFS||<i>--enable-tcp-transport</i>||enable TCP socket transport.
|-
||||<i>--enable-IPv6</i>||enable IPv6 support.
|-
|style="text-align: center; font-weight: bold"|libICE||<i>--enable-tcp-transport</i>||enable TCP socket transport.
|-
||||<i>--enable-IPv6</i>||enable IPv6 support.
|-
|style="text-align: center; font-weight: bold"|libSM||<i>--enable-tcp-transport</i>||enable TCP socket transport.
|-
||||<i>--enable-IPv6</i>||enable IPv6 support.
|-
|style="text-align: center; font-weight: bold"|libXt||<i>--disable-xkb</i>||disable XKB support.
|-
||||<i>--disable-install-makestrs</i>||disable installing makestrs.
|-
|style="text-align: center; font-weight: bold"|libXmu||<i>--enable-tcp-transport</i>||enable TCP socket transport.
|-
||||<i>--enable-IPv6</i>||enable IPv6 support.
|-
|style="text-align: center; font-weight: bold"|libXpm||<i>--enable-stat-zfile</i>||don't search for files with .Z & .gz extensions automatically.
|-
|style="text-align: center; font-weight: bold"|libXaw||<i>--disable-xaw6</i>||disable building of libXaw.so.6
|-
||||<i>--disable-xaw7</i>||disable building of libXaw.so.7
|-
||||<i>--disable-xaw8</i>||disable building of libXaw.so.8
|-
|style="text-align: center; font-weight: bold"|libXcursor||<i>--with-icondir=<path></i>||set default icon directory (default: ${datadir}/icons).
|-
||||<i>--with-cursorpath=<paths></i>||set default search path for cursors.
|-
|style="text-align: center; font-weight: bold"|libXfont||<i>--disable-freetype</i>||disable freetype support.
|-
||||<i>--enable-type1</i>||enable type1 font support.
|-
||||<i>--disable-speedo</i>||disable speedo font support.
|-
||||<i>--disable-pcfformat</i>||
|-
||||<i>--disable-bdfformat</i>||disable pcf, bdf, or snf font format.
|-
||||<i>--disable-snfformat</i>||
|-
||||<i>--enable-tcp-transport</i>||enable TCP socket transport.
|-
||||<i>--enable-IPv6</i>||enable IPv6 support.
|}

== Non-Multilib ==

Compile each library as follows:

 ./configure $XORG_CONFIG &&
 make

Install each library as follows:

 make install

{{Note|After installing all of the libraries run ldconfig.}}

== Multilib ==
{{note|On my system (AMD64) at least, xtrans installs it's pkg-config file to '$XORG_PREFX/share/pkg-config/' instead of '$XORG_PREFIX/lib{,64}/pkgconfig'. Moving the 'xtrans.pc' file to the correct location fixed some later errors.}}
=== 32Bit ===

Compile the library.

 PKG_CONFIG_PATH="${PKG_CONFIG_PATH32}" CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}" \
 ./configure $XORG_CONFIG32 &&
 make

Install the library.

 make install

For libXft

 mv ${XORG_PREFIX}/bin/xft-config{,-32}

=== N32 ===

Compile the library.

 PKG_CONFIG_PATH="${PKG_CONFIG_PATHN32}" CC="gcc ${BUILDN32}" CXX="g++ ${BUILDN32}" \
 ./configure $XORG_CONFIGN32 &&
 make

Install the library.

 make install

For libXFt

 mv ${XORG_PREFIX}/bin/xft-config{,-n32}

=== 64Bit ===

Compile the library.

 PKG_CONFIG_PATH="${PKG_CONFIG_PATH64}" CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
 ./configure $XORG_CONFIG64 &&
 make

Install the library.

 make install

For libXFt

 mv ${XORG_PREFIX}/bin/xft-config{,-64} &&
 ln -sv /usr/bin/multiarch_wrapper ${XORG_PREFIX}/bin/xft-config

{{Note|After installing all of the libraries run ldconfig.}}

== Semi-Automated Build ==

These automated build instructions assume that you are using subdirectories as discussed in the introduction.  You must also have an unaltered copy of Lib-{{Xorg7-Version}}.wget in the main working directory (xc).  This file lists each library in an order that ensures dependencies are satisfied.

=== Non Multilib ===

Install the Xorg libraries:

 top=$PWD
 cat ../Lib-{{Xorg7-Version}}.wget | while read package; do
   packagedir=$(sed -e "s/\.tar\.bz2//" <<< $package)
 
   cd $top || break;
 
   grep ^$packagedir$ done && continue;
 
   tar xvf $package &&
   cd $packagedir &&
 
   ./configure $XORG_CONFIG &&
   make &&
   make install &&
 
   cd .. &&
   rm -rfv $packagedir &&
 
   echo "$packagedir" >> done || break
 done
 rm done
 ldconfig

=== Multilib ===

Install the Xorg libraries:

 top=$PWD
 cat ../Lib-{{Xorg7-Version}}.wget | while read package; do
   packagedir=$(sed -e "s/\.tar\.bz2//" <<< $package)
 
   cd $top || break;
 
   grep ^$packagedir$ done && continue;
 
   tar xvf $package &&
   cd $packagedir &&
 
   PKG_CONFIG_PATH="${PKG_CONFIG_PATH32}" \
   CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}" \
   ./configure $XORG_CONFIG32 &&
   make &&
   make install || break
 
   if [ -f "${XORG_PREFIX}/bin/xft-config" ]; then
     mv "${XORG_PREFIX}/bin/xft-config"{,-32} || break
   fi
 
   cd .. &&
   rm -rfv $packagedir &&
 
   tar xfv $package &&
   cd $packagedir &&
 
   PKG_CONFIG_PATH="${PKG_CONFIG_PATH64}" \
   CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
   ./configure $XORG_CONFIG64 &&
   make &&
   make install || break
 
   if [ -f "${XORG_PREFIX}/bin/xft-config" ]; then
     mv "${XORG_PREFIX}/bin/xft-config"{,-64} || break
   fi
 
   cd .. &&
   rm -rfv $packagedir || break
 
   echo "$packagedir" >> done
 done
 ln -sv /usr/bin/multiarch_wrapper ${XORG_PREFIX}/bin/xft-config 
 rm done
 ldconfig

Next install [[Xorg7/libdrm|libdrm]]

= Contents =

Each Xorg library installs one or more set of libraries (*.so,la,a) files.  Rather than listing all of the files installed, a listing of the 47 library packages and a short description of each follows.  The 47 library packages, listed in build order, with a short description are: 

{|style="text-align: left" border="0" cellspacing="0" width="85%" align="center" rules="all"
|-
!width="15%" style="text-align: center"|Xorg Library
!width="70%" style="text-align: center"|Short Description
|-
|style="text-align: center; font-weight: bold"|xtrans ||Transport (protocol) table.  Contains a definition for every transport (protocol) family. All operations that can be made on the transport go through this table.
|-
|style="text-align: center; font-weight: bold"|libXau ||The main interface to the X11 authorization handling, which controls authorization for X connections, both client-side and server-side.
|-
|style="text-align: center; font-weight: bold"|libXdmcp ||The main interface to the X11 display manager control protocol library, which allows for remote logins to display managers.
|-
|style="text-align: center; font-weight: bold"|libX11 ||The main client interface to the X Window System and is otherwise known as 'Xlib'. It provides a complete API for the basic functions of the window system.
|-
|style="text-align: center; font-weight: bold"|libXext ||Provides an X Window System client interface to several extensions to the X protocol.  libXext also provides a small set of utility functions to aid authors of client APIs for X protocol extensions.
|-
|style="text-align: center; font-weight: bold"|libAppleWM ||
|-
|style="text-align: center; font-weight: bold"|libWindowsWM ||
|-
|style="text-align: center; font-weight: bold"|libdmx ||The interface to the DMX extension for X, which allows a single server to be set up as a proxy spanning multiple servers -- not unlike Xinerama across discrete physical machines. It can be reconfigured on the fly to change the layout, and it is presented as a single logical display to clients.  libdmx allows clients to configure the layout of DMX servers by adding and removing screens, input devices, et al.
|-
|style="text-align: center; font-weight: bold"|libfontenc ||The font encodings library.
|-
|style="text-align: center; font-weight: bold"|libFS ||Provides various functions useful to X11 font servers, and clients connecting to font servers. It is not used outside of these implementations.
|-
|style="text-align: center; font-weight: bold"|libICE ||The inter-client exchange library.
|-
|style="text-align: center; font-weight: bold"|liblbxutil ||Contains header files and documentation for the XFIXES extension.
|-
|style="text-align: center; font-weight: bold"|liboldX ||Association table libraries.
|-
|style="text-align: center; font-weight: bold"|libSM ||Provides the main interface to the X11 Session Management library, which allows for applications to both manage sessions, and make use of session managers to save and restore their state for later use.
|-
|style="text-align: center; font-weight: bold"|libXt ||Provides the X Toolkit Intrinsics, an abstract widget library upon which other toolkits are based. Xt is the basis for many toolkits, including the Athena widgets (Xaw), and LessTif (a Motif implementation).
|-
|style="text-align: center; font-weight: bold"|libXmu ||Provides a set of miscellaneous utility convenience functions for X libraries to use.
|-
|style="text-align: center; font-weight: bold"|libXpm ||Provides support and common operation for the XPM pixmap format, which is commonly used in legacy X applications. XPM is an extension of the monochrome XBM bitmap specified in the X protocol.
|-
|style="text-align: center; font-weight: bold"|libXp ||Provides public APIs to allow client applications to render to non-display devices, making use of the X Print Service.
|-
|style="text-align: center; font-weight: bold"|libXaw ||Provides the original version of Xaw, the Athena Widgets tookit, which is largely used by legacy X applications. Within the Xaw series, version 6 is itself considered deprecated; version 7 is in most common usage.  In general, use of a more modern toolkit such as GTK+ is recommended.
|-
|style="text-align: center; font-weight: bold"|libXfixes ||Provides an X Window System client interface to the 'XFIXES' extension to the X protocol.  It provides support for Region types, and some cursor functions.
|-
|style="text-align: center; font-weight: bold"|libXcomposite ||Provides an X Window System client interface to the Composite extension to the X protocol.  The Composite extension allows clients called compositing managers to control the final drawing of the screen. Rendering is done into an off-screen buffer.
|-
|style="text-align: center; font-weight: bold"|libXrender ||The X Rendering Extension (Render) introduces digital image composition as the foundation of a new rendering model within the X Window System. Rendering geometric figures is accomplished by client-side tesselation into either triangles or trapezoids. Text is drawn by loading glyphs into the server and rendering sets of them. The Xrender library exposes this extension to X clients.  This package provides a static library and C header files.
|-
|style="text-align: center; font-weight: bold"|libXdamage ||Provides an X Window System client interface to the DAMAGE extension to the X protocol.  The Damage extension provides for notification of when on-screen regions have been 'damaged' (altered).
|-
|style="text-align: center; font-weight: bold"|libXcursor ||The header files and a static version of the X cursor management library are provided by this package.
|-
|style="text-align: center; font-weight: bold"|libXevie ||Provides an X Window System client interface to the EvIE extension to the X protocol.  The EvIE (Event Interception Extension) allows for clients to be able to intercept all events coming through the server and then decide what to do with them, including being able to modify or discard events.
|-
|style="text-align: center; font-weight: bold"|libXfont ||Libraries for different font types.
|-
|style="text-align: center; font-weight: bold"|libXfontcache ||
|-
|style="text-align: center; font-weight: bold"|libXft ||Provides a client-side font API for X applications, making the FreeType font rasterizer available to X clients. Fontconfig is used for font specification resolution. Where available, the RENDER extension handles glyph drawing; otherwise, the core X protocol is used.
|-
|style="text-align: center; font-weight: bold"|libXi ||Provides an X Window System client interface to the XINPUT extension to the X protocol.  The Input extension allows setup and configuration of multiple input devices, and will soon allow hotplugging of input devices; to be added and removed on the fly.
|-
|style="text-align: center; font-weight: bold"|libXinerama ||Provides an X Window System client interface to the XINERAMA extension to the X protocol.  The Xinerama (also known as panoramiX) extension allows for multiple screens attached to a single display to be treated as belonging together, and to give desktop applications a better idea of the monitor layout.  Required for dual monitor support.
|-
|style="text-align: center; font-weight: bold"|libxkbfile ||Provides an interface to read and manipulate description files for XKB, the X11 keyboard configuration extension.
|-
|style="text-align: center; font-weight: bold"|libxkbui ||Provides an interface to easily present XKB layouts as graphical widgets.
|-
|style="text-align: center; font-weight: bold"|libXprintUtil ||Provides utility Xpu APIs allowing client applications to access and manipulate information about printer capabilities from an Xprint server.
|-
|style="text-align: center; font-weight: bold"|libXprintAppUtil ||Provides utility Xpau APIs allowing client applications to access information about and control Xprint jobs from an Xprint server.
|-
|style="text-align: center; font-weight: bold"|libXrandr ||Provides an X Window System client interface to the RandR extension to the X protocol.  The RandR extension allows for run-time configuration of display attributes such as resolution, rotation, and reflection.
|-
|style="text-align: center; font-weight: bold"|libXres ||Provides an X Window System client interface to the Resource extension to the X protocol.  The Resource extension allows for X clients to see and monitor the X resource usage of various clients (pixmaps, et al).
|-
|style="text-align: center; font-weight: bold"|libXScrnSaver ||
|-
|style="text-align: center; font-weight: bold"|libXTrap ||Provides an interface to the DEC-XTRAP extension, which allows for capture and synthesis of core input events.
|-
|style="text-align: center; font-weight: bold"|libXtst ||Provides an X Window System client interface to the Record extension to the X protocol.  The Record extension allows X clients to synthesise input events, which is useful for automated testing.
|-
|style="text-align: center; font-weight: bold"|libXv ||Provides an X Window System client interface to the XVideo extension to the X protocol.  The XVideo extension allows for accelerated drawing of videos. Hardware adaptors are exposed to clients, which may draw in a number of colourspaces, including YUV.
|-
|style="text-align: center; font-weight: bold"|libXvMC ||Provides an X Window System client interface to the XVideo-MotionCompensation extension to the X protocol.  The XVideo-MotionCompensation extension allows for further accelerated drawing of videos. Video data may be sent at earlier stages of the decoding pipeline than raw YUV data.
|-
|style="text-align: center; font-weight: bold"|libXxf86dga ||Provides the XFree86-DGA extension, which allows direct graphics access to a framebuffer-like region, and also allows relative mouse reporting, et al. It is mainly used by games and emulators for games.
|-
|style="text-align: center; font-weight: bold"|libXxf86misc ||Provides an interface to the XFree86-Misc extension, which allows client applications to query the current keyboard and mouse settings of the running XFree86-based (XFree86, Xorg) server.
|-
|style="text-align: center; font-weight: bold"|libXxf86vm ||Provides an interface to the XFree86-VidModeExtension extension, which allows client applications to get and set video mode timings in extensive detail. It is used by the xvidtune program in particular.
|}