source: x/installing/x7lib.xml@ 8f1faf9f

<?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  "ftp://ftp.x.org/pub/individual/lib/">
  <!ENTITY x7libs-md5sum        "&sources-anduin-http;/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$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Xorg Libraries</title>

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

  <sect2 role="package">
    <title>Introduction to Xorg Libraries</title>

    <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 three 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>
      <listitem>
        <para>Required patch: <ulink
        url="&patch-root;/libXfont-1.1.0-cidfonts-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>

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

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

<screen><userinput>wget &sources-anduin-ftp;/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><ulink url='http://wiki.x.org/wiki/SecurityPage'>Security
    vulnerabilities</ulink> have been identified in the libX11, xtrans
    and libXfont 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>For libXfont, the patch can be applied with the following
    command:</para>

<screen><userinput>patch -Np1 -i ../libXfont-1.1.0-cidfonts-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 role="root"><userinput>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>