Xorg7/Libraries

From CBLFS
Revision as of 18:40, 2 February 2008 by Oppiz (talk | contribs)
Jump to navigationJump to search
Download Source: http://xorg.freedesktop.org/releases/individual/lib/

Back to Protocol Headers

Introduction to Xorg7/Libraries

There are forty-four 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 https://cblfs.clfs.org/Special:Filepath/Lib-20101205.wget &&
cd lib &&
wget -B http://xorg.freedesktop.org/releases/individual/lib/ -i ../Lib-20101205.wget

Project Homepage: Unknown

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 list following is a successful build order for the Xorg libraries. Assuming all of the protocol headers were previously installed, additional dependencies, if they exist, are listed.

Xorg Library Required Recommended Optional
xtrans
libXau
libXdmcp
libX11 xtrans, libXdmcp, libXau XCB
libXext libX11
libAppleWM libX11, libXext
libFS xtrans
libICE xtrans
libSM libICE
libWindowsWM libX11
libXScrnSaver libX11, libXext
libXt libX11, libSM
libXTrap libX11, libXt
libXmu libX11, libXt
libXpm libXt
libXp libX11
libXaw libXext, libXmu, libXpm, libXp
libXfixes libX11
libXcomposite libXfixes
libXrender libX11
libXcursor libXrender
libXdamage libX11
libXevie
libfontenc
libXfont libfontenc, FreeType
libXfontcache libX11, libXext
libXft FreeType, FontConfig, libXrender
libXi
libXinerama libX11
libXprintUtil libX11, libXp
libXprintAppUtil libX11, libXprintUtil
libXrandr libX11
libXres libX11
libXtst libX11
libXv libX11
libXvMC libX11
libXxf86dga
libXxf86misc
libXxf86vm libX11, libXext
libdmx libX11
liblbxutil
liboldX libX11
libxkbfile libX11
libxkbui libX11

Configuration Information

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

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

Non-Multilib

Compile each library as follows:

./configure $XORG_CONFIG &&
make

Install each library as follows:

make install
Caution.png

Note

After installing all of the libraries run ldconfig.

Multilib

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 /usr/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 /usr/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 /usr/bin/xft-config{,-64}
ln -sv multiarch_wrapper /usr/bin/xft-config


Caution.png

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-20101205.wget in the main working directory (xc). This file lists each library in an order that ensures dependencies are satisfied.

After entering the lib subdirectory and downloading the tarballs, unpack the packages:

for i in *.tar.bz2; do
  tar xjvf $i;
done

Non-Multilib

Build and install each library:

for dir in `sed "s/.tar.bz2//g" ../Lib-20101205.wget`; do
  cd ${dir} &&
  ./configure $XORG_CONFIG &&
  make &&
  make install &&
  cd ..;
done

Multilib

Build and install each library:

for dir in `sed "s/.tar.bz2//g" ../Lib-20101205.wget`; do
   cd ${dir} &&
   PKG_CONFIG_PATH="${PKG_CONFIG_PATH32}" CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}" \
  ./configure $XORG_CONFIG32 &&
  make &&
  make install &&
  make distclean &&
  PKG_CONFIG_PATH="${PKG_CONFIG_PATH64}" CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
  ./configure $XORG_CONFIG64 &&
  make &&
  make install &&
  cd ..;
done

Next install 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 44 library packages and a short description of each follows. For the interested party, a link to a list of the directories, programs, and libraries installed by all Xorg-7.1 library packages is also provided. The 44 library packages, listed in build order, with a short description are:

Xorg Library File List Short Description
xtrans 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.
libXau libXau The main interface to the X11 authorization handling, which controls authorization for X connections, both client-side and server-side.
libXdmcp libXdmcp The main interface to the X11 display manager control protocol library, which allows for remote logins to display managers.
libX11 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.
libXext 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.
libAppleWM
libWindowsWM libWindowsWM
libdmx 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.
libfontenc libfontenc The font encodings library.
libFS libFS Provides various functions useful to X11 font servers, and clients connecting to font servers. It is not used outside of these implementations.
libICE libICE The inter-client exchange library.
liblbxutil liblbxutil Contains header files and documentation for the XFIXES extension.
liboldX liboldX Association table libraries.
libSM 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.
libXt 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).
libXmu libXmu Provides a set of miscellaneous utility convenience functions for X libraries to use.
libXpm 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.
libXp libXp Provides public APIs to allow client applications to render to non-display devices, making use of the X Print Service.
libXaw 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.
libXfixes 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.
libXcomposite 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.
libXrender 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.
libXdamage 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).
libXcursor libXcursor The header files and a static version of the X cursor management library are provided by this package.
libXevie 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.
libXfont libXfont Libraries for different font types.
libXfontcache libXfontcache
libXft 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.
libXi 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.
libXinerama 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.
libxkbfile libxkbfile Provides an interface to read and manipulate description files for XKB, the X11 keyboard configuration extension.
libxkbui libxkbui Provides an interface to easily present XKB layouts as graphical widgets.
libXprintUtil libXprintUtil Provides utility Xpu APIs allowing client applications to access and manipulate information about printer capabilities from an Xprint server.
libXprintAppUtil libXprintAppUtil Provides utility Xpau APIs allowing client applications to access information about and control Xprint jobs from an Xprint server.
libXrandr 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.
libXres 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).
libXScrnSaver libXScrnSaver
libXTrap libXTrap Provides an interface to the DEC-XTRAP extension, which allows for capture and synthesis of core input events.
libXtst 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.
libXv 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.
libXvMC 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.
libXxf86dga 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.
libXxf86misc 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.
libXxf86vm 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.