glfs/x/installing/x7proto.xml
Bruce Dubbs ba58642eb9 Update description of how to execute a command as root in a small script.
Used in several xorg sections.


git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10728 af4574ff-66df-0310-9fd7-8a98e5e911e0
2012-10-10 21:35:16 +00:00

259 lines
9.9 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY x7proto-download-http "http://xorg.freedesktop.org/releases/individual/proto/">
<!ENTITY x7proto-download-ftp "ftp://ftp.x.org/pub/individual/proto/">
<!ENTITY x7proto-size "3.0 MB">
<!-- Editors note: Because we recommend a scripted build that removes
the source directories after installation, the xorg buildsizes are
determined by the sum of all package source tarballs, the size of
installed files, and the size of the largest package's build
directory after running make install. -->
<!ENTITY x7proto-buildsize "21 MB">
<!ENTITY x7proto-time "0.8 SBU">
<!ENTITY bigreqsproto-version "1.1.2">
<!ENTITY bigreqsproto-md5sum "1a05fb01fa1d5198894c931cf925c025">
<!ENTITY compositeproto-version "0.4.2">
<!ENTITY compositeproto-md5sum "98482f65ba1e74a08bf5b056a4031ef0">
<!ENTITY damageproto-version "1.2.1">
<!ENTITY damageproto-md5sum "998e5904764b82642cc63d97b4ba9e95">
<!ENTITY dmxproto-version "2.3.1">
<!ENTITY dmxproto-md5sum "4ee175bbd44d05c34d43bb129be5098a">
<!ENTITY dri2proto-version "2.6">
<!ENTITY dri2proto-md5sum "2eb74959684f47c862081099059a11ab">
<!ENTITY fixesproto-version "5.0">
<!ENTITY fixesproto-md5sum "e7431ab84d37b2678af71e29355e101d">
<!ENTITY fontsproto-version "2.1.2">
<!ENTITY fontsproto-md5sum "c5f4f1fb4ba7766eedbc9489e81f3be2">
<!ENTITY glproto-version "1.4.15">
<!ENTITY glproto-md5sum "d1ff0c1acc605689919c1ee2fc9b5582">
<!ENTITY inputproto-version "2.2">
<!ENTITY inputproto-md5sum "13c8aedaf98a92e282b7e456c0a5bed9">
<!ENTITY kbproto-version "1.0.6">
<!ENTITY kbproto-md5sum "677ea8523eec6caca86121ad2dca0b71">
<!ENTITY randrproto-version "1.3.2">
<!ENTITY randrproto-md5sum "597491c0d8055e2a66f11350c4985775">
<!ENTITY recordproto-version "1.14.2">
<!ENTITY recordproto-md5sum "1b4e5dede5ea51906f1530ca1e21d216">
<!ENTITY renderproto-version "0.11.1">
<!ENTITY renderproto-md5sum "a914ccc1de66ddeb4b611c6b0686e274">
<!ENTITY resourceproto-version "1.2.0">
<!ENTITY resourceproto-md5sum "cfdb57dae221b71b2703f8e2980eaaf4">
<!ENTITY scrnsaverproto-version "1.2.2">
<!ENTITY scrnsaverproto-md5sum "edd8a73775e8ece1d69515dd17767bfb">
<!ENTITY videoproto-version "2.3.1">
<!ENTITY videoproto-md5sum "c3b348c6e2031b72b11ae63fc7f805c2">
<!ENTITY xcmiscproto-version "1.2.2">
<!ENTITY xcmiscproto-md5sum "5f4847c78e41b801982c8a5e06365b24">
<!ENTITY xextproto-version "7.2.1">
<!ENTITY xextproto-md5sum "eaac343af094e6b608cf15cfba0f77c5">
<!ENTITY xf86bigfontproto-version "1.2.0">
<!ENTITY xf86bigfontproto-md5sum "120e226ede5a4687b25dd357cc9b8efe">
<!ENTITY xf86dgaproto-version "2.1">
<!ENTITY xf86dgaproto-md5sum "a036dc2fcbf052ec10621fd48b68dbb1">
<!ENTITY xf86driproto-version "2.1.1">
<!ENTITY xf86driproto-md5sum "1d716d0dac3b664e5ee20c69d34bc10e">
<!ENTITY xf86vidmodeproto-version "2.3.1">
<!ENTITY xf86vidmodeproto-md5sum "e793ecefeaecfeabd1aed6a01095174e">
<!ENTITY xineramaproto-version "1.2.1">
<!ENTITY xineramaproto-md5sum "9959fe0bfb22a0e7260433b8d199590a">
<!ENTITY xproto-version "7.0.23">
<!ENTITY xproto-md5sum "d4d241a4849167e4e694fe73371c328c">
]>
<sect1 id="xorg7-proto" xreflabel="Xorg Protocol Headers">
<?dbhtml filename="x7proto.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Xorg Protocol Headers</title>
<indexterm zone="xorg7-proto">
<primary sortas="a-xorg7-proto">Xorg Protocol Headers</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Protocol Headers</title>
<para>The <application>Xorg</application> protocol headers provide the
header files required to build the system, and to allow other
applications to build against the installed X Window system.</para>
&lfs72_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&x7proto-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&x7proto-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download size: &x7proto-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &x7proto-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &x7proto-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Protocol Headers Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"> <xref linkend="util-macros"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="required"> <xref linkend="sudo"/> and
<xref linkend="wget"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"> <xref linkend="fop"/> and <xref linkend="xmlto"/>
(to build additional documentation)</para>
<note><para>There is a reciprocal dependency with <xref linkend="fop"/>. If
you wish to build the documentation, you'll need to re-install the
Protocol Headers after the installation is complete and
<xref linkend="fop"/> has been installed.</para></note>
<para condition="html" role="usernotes">User Notes:
<ulink url='&blfs-wiki;/Xorg7ProtocolHeaders'/></para>
</sect2>
<sect2>
<title>Downloading Xorg Protocol Headers</title>
<para>First, create a list of files to be downloaded. This file will also
be used to verify the integrity of the downloads when complete:</para>
<screen><userinput>cat &gt; proto-&xorg-version;.md5 &lt;&lt; "EOF"
&bigreqsproto-md5sum; bigreqsproto-&bigreqsproto-version;.tar.bz2
&compositeproto-md5sum; compositeproto-&compositeproto-version;.tar.bz2
&damageproto-md5sum; damageproto-&damageproto-version;.tar.bz2
&dmxproto-md5sum; dmxproto-&dmxproto-version;.tar.bz2
&dri2proto-md5sum; dri2proto-&dri2proto-version;.tar.bz2
&fixesproto-md5sum; fixesproto-&fixesproto-version;.tar.bz2
&fontsproto-md5sum; fontsproto-&fontsproto-version;.tar.bz2
&glproto-md5sum; glproto-&glproto-version;.tar.bz2
&inputproto-md5sum; inputproto-&inputproto-version;.tar.bz2
&kbproto-md5sum; kbproto-&kbproto-version;.tar.bz2
&randrproto-md5sum; randrproto-&randrproto-version;.tar.bz2
&recordproto-md5sum; recordproto-&recordproto-version;.tar.bz2
&renderproto-md5sum; renderproto-&renderproto-version;.tar.bz2
&resourceproto-md5sum; resourceproto-&resourceproto-version;.tar.bz2
&scrnsaverproto-md5sum; scrnsaverproto-&scrnsaverproto-version;.tar.bz2
&videoproto-md5sum; videoproto-&videoproto-version;.tar.bz2
&xcmiscproto-md5sum; xcmiscproto-&xcmiscproto-version;.tar.bz2
&xextproto-md5sum; xextproto-&xextproto-version;.tar.bz2
&xf86bigfontproto-md5sum; xf86bigfontproto-&xf86bigfontproto-version;.tar.bz2
&xf86dgaproto-md5sum; xf86dgaproto-&xf86dgaproto-version;.tar.bz2
&xf86driproto-md5sum; xf86driproto-&xf86driproto-version;.tar.bz2
&xf86vidmodeproto-md5sum; xf86vidmodeproto-&xf86vidmodeproto-version;.tar.bz2
&xineramaproto-md5sum; xineramaproto-&xineramaproto-version;.tar.bz2
&xproto-md5sum; xproto-&xproto-version;.tar.bz2
EOF</userinput></screen>
<para>To download the needed files using <application>wget</application>,
use the following commands:</para>
<screen><userinput>mkdir proto &amp;&amp;
cd proto &amp;&amp;
grep -v '^#' ../proto-&xorg-version;.md5 | awk '{print $2}' | wget -i- -c \
-B http://xorg.freedesktop.org/releases/individual/proto/ &amp;&amp;
md5sum -c ../proto-&xorg-version;.md5</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Protocol Headers</title>
&as_root;
<para>First, start a subshell that will exit on error:</para>
<screen><userinput>bash -e</userinput></screen>
<para>Install all of the applications by running the following
commands:</para>
<screen><userinput>for package in $(grep -v '^#' ../proto-&xorg-version;.md5 | awk '{print $2}')
do
packagedir=${package%.tar.bz2}
tar -xf $package
pushd $packagedir
./configure $XORG_CONFIG
as_root make install
popd
rm -r $packagedir
done</userinput></screen>
<para>Finally, exit the shell that was started earlier:</para>
<screen><userinput>exit</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>bash -e</command>: This command starts a subshell that will
exit if any command returns a value other than 0, causing the for loop to
exit immediately if an error occurs. This also eliminates the need for the
<command>&amp;&amp;</command> construct used elsewhere in the book.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>The following subdirectories of <envar>$XORG_PREFIX</envar>/:
include/X11, include/GL, and lib/pkgconfig</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>