source: x/installing/x7lib.xml@ baf47952

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY x7libs-download-http "http://xorg.freedesktop.org/releases/individual/lib/">
  <!ENTITY x7libs-download-ftp  " ">
  <!ENTITY x7libs-md5sum        "http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/files/md5sums">
  <!ENTITY x7libs-size          "12 MB">
  <!ENTITY x7libs-buildsize     "186 MB">
  <!ENTITY x7libs-time          "6.6 SBU">

]>

<sect1 id="xorg7-lib" xreflabel="Xorg Libraries">
  <?dbhtml filename="x7lib.html"?>

  <sect1info>
    <othername>$LastChangedBy: dj $</othername>
    <date>$Date: 2006-04-15 23:04:51 -0500 (Sat, 15 Apr 2006) $</date>
  </sect1info>

  <title>Xorg Libraries</title>

  <indexterm zone="xorg7-lib">
    <primary sortas="a-xorg7-lib">Xorg Libraries</primary>
  </indexterm>

  <para>The <application>Xorg</application> libraries provide library
  routines that are used within all X Window applications.</para>

  <bridgehead renderas="sect3">Package Information</bridgehead>
  <itemizedlist spacing="compact">
    <listitem>
      <para>Download (HTTP): <ulink url="&x7libs-download-http;"/></para>
    </listitem>
    <listitem>
      <para>Download (FTP): <ulink url="&x7libs-download-ftp;"/></para>
    </listitem>
    <listitem>
      <para>Download MD5 sum: <ulink url="&x7libs-md5sum;"/></para>
    </listitem>
    <listitem>
      <para>Download size: &x7libs-size;</para>
    </listitem>
    <listitem>
      <para>Estimated disk space required: &x7libs-buildsize;</para>
    </listitem>
    <listitem>
      <para>Estimated build time: &x7libs-time;</para>
    </listitem>
  </itemizedlist>

  <!-- Following two patches are security related and should be
       fixed for Xorg-7.2 -->
  <bridgehead renderas="sect3">Additional Downloads</bridgehead>
  <itemizedlist spacing="compact">
    <listitem>
      <para>Required patch: <ulink
      url="&patch-root;/libX11-1.0.1-setuid-1.patch"/></para>
    </listitem>
    <listitem>
      <para>Required patch: <ulink
      url="&patch-root;/xtrans-1.0.0-setuid-1.patch"/></para>
    </listitem>
  </itemizedlist>

  <bridgehead renderas="sect3">Xorg Libraries Dependencies</bridgehead>

  <bridgehead renderas="sect4">Required</bridgehead>
  <para role="required"><xref linkend="ed"/>,
  <xref linkend="fontconfig"/>,
  <xref linkend="pkgconfig"/>, and
  <xref linkend="xorg7-proto"/></para>

  <bridgehead renderas="sect4">Optional</bridgehead>
  <para role="optional"><xref linkend="linux-pam"/></para>

  <para condition="html" role="usernotes">User Notes:
  <ulink url='&blfs-wiki;/Xorg7Libraries'/></para>

  <sect2>
    <title>Downloading Xorg Libraries</title>

    <para>To download the needed files using <application>wget</application>,
    use the following commands:</para>

<screen><userinput>wget http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/wget/lib-7.1.wget &amp;&amp;
mkdir lib &amp;&amp;
cd lib &amp;&amp;
wget -B http://xorg.freedesktop.org/releases/individual/lib/ -i ../lib-7.1.wget</userinput></screen>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Xorg Libraries</title>

    <para>A <ulink url='http://wiki.x.org/wiki/SecurityPage'>security
    vulnerability</ulink> has been identified in the libX11 and xtrans
    packages. Before building these packages with the commands shown below,
    be sure to apply the supplied patches. For libX11, this can be
    accomplished with with the following command:</para>

<screen><userinput>patch -Np1 -i ../libX11-1.0.1-setuid-1.patch</userinput></screen>

    <para>For xtrans, the patch can be applied with the following
    command:</para>

<screen><userinput>patch -Np1 -i ../xtrans-1.0.0-setuid-1.patch</userinput></screen>

    <para>Install the libraries by running the following commands for each
    of the chosen packages:</para>

<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>

    <para>These packages do not provide test suites.</para>

    <para>Now as the <systemitem class="username">root</systemitem>
    user:</para>

<screen><userinput role="root">make install &amp;&amp;
ldconfig</userinput></screen>

  </sect2>

  <sect2 role="configuration">
    <title>Configuration of Xorg Libraries</title>

    <para>If you've chosen to install <application>Xorg</application> into
    <filename class="directory">/usr</filename>, then no further
    configuration is necessary and you can skip the rest of this section.
    If you've opted for an alternate prefix, you should create two symlinks
    to satisfy the expected environment of several packages.
    Execute the following commands as the root user:</para>

<screen role="root"><userinput>ln -sv $XORG_PREFIX/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sv $XORG_PREFIX/include/X11 /usr/include/X11</userinput></screen>

  </sect2>

</sect1>