[3f72a148] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[6732c094] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[3f72a148] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
| 7 | <!ENTITY x7proto-download-http "http://xorg.freedesktop.org/releases/individual/proto/">
|
---|
[8f1faf9f] | 8 | <!ENTITY x7proto-download-ftp "ftp://ftp.x.org/pub/individual/proto/">
|
---|
[7c472863] | 9 | <!ENTITY x7proto-size "3.0 MB">
|
---|
[9f12e36] | 10 | <!-- Editors note: Because we recommend a scripted build that removes
|
---|
| 11 | the source directories after installation, the xorg buildsizes are
|
---|
| 12 | determined by the sum of all package source tarballs, the size of
|
---|
| 13 | installed files, and the size of the largest package's build
|
---|
[3f72a148] | 14 | directory after running make install. -->
|
---|
[e03aea8] | 15 | <!ENTITY x7proto-buildsize "21 MB">
|
---|
| 16 | <!ENTITY x7proto-time "0.8 SBU">
|
---|
[3f72a148] | 17 |
|
---|
[5287b7c] | 18 | <!ENTITY bigreqsproto-version "1.1.2">
|
---|
| 19 | <!ENTITY bigreqsproto-md5sum "1a05fb01fa1d5198894c931cf925c025">
|
---|
| 20 |
|
---|
| 21 | <!ENTITY compositeproto-version "0.4.2">
|
---|
| 22 | <!ENTITY compositeproto-md5sum "98482f65ba1e74a08bf5b056a4031ef0">
|
---|
| 23 |
|
---|
| 24 | <!ENTITY damageproto-version "1.2.1">
|
---|
| 25 | <!ENTITY damageproto-md5sum "998e5904764b82642cc63d97b4ba9e95">
|
---|
| 26 |
|
---|
| 27 | <!ENTITY dmxproto-version "2.3.1">
|
---|
| 28 | <!ENTITY dmxproto-md5sum "4ee175bbd44d05c34d43bb129be5098a">
|
---|
| 29 |
|
---|
| 30 | <!ENTITY dri2proto-version "2.6">
|
---|
| 31 | <!ENTITY dri2proto-md5sum "2eb74959684f47c862081099059a11ab">
|
---|
| 32 |
|
---|
| 33 | <!ENTITY fixesproto-version "5.0">
|
---|
| 34 | <!ENTITY fixesproto-md5sum "e7431ab84d37b2678af71e29355e101d">
|
---|
| 35 |
|
---|
| 36 | <!ENTITY fontsproto-version "2.1.2">
|
---|
| 37 | <!ENTITY fontsproto-md5sum "c5f4f1fb4ba7766eedbc9489e81f3be2">
|
---|
| 38 |
|
---|
| 39 | <!ENTITY glproto-version "1.4.15">
|
---|
| 40 | <!ENTITY glproto-md5sum "d1ff0c1acc605689919c1ee2fc9b5582">
|
---|
| 41 |
|
---|
| 42 | <!ENTITY inputproto-version "2.2">
|
---|
| 43 | <!ENTITY inputproto-md5sum "13c8aedaf98a92e282b7e456c0a5bed9">
|
---|
| 44 |
|
---|
| 45 | <!ENTITY kbproto-version "1.0.6">
|
---|
| 46 | <!ENTITY kbproto-md5sum "677ea8523eec6caca86121ad2dca0b71">
|
---|
| 47 |
|
---|
| 48 | <!ENTITY randrproto-version "1.3.2">
|
---|
| 49 | <!ENTITY randrproto-md5sum "597491c0d8055e2a66f11350c4985775">
|
---|
| 50 |
|
---|
| 51 | <!ENTITY recordproto-version "1.14.2">
|
---|
| 52 | <!ENTITY recordproto-md5sum "1b4e5dede5ea51906f1530ca1e21d216">
|
---|
| 53 |
|
---|
| 54 | <!ENTITY renderproto-version "0.11.1">
|
---|
| 55 | <!ENTITY renderproto-md5sum "a914ccc1de66ddeb4b611c6b0686e274">
|
---|
| 56 |
|
---|
| 57 | <!ENTITY resourceproto-version "1.2.0">
|
---|
| 58 | <!ENTITY resourceproto-md5sum "cfdb57dae221b71b2703f8e2980eaaf4">
|
---|
| 59 |
|
---|
| 60 | <!ENTITY scrnsaverproto-version "1.2.2">
|
---|
| 61 | <!ENTITY scrnsaverproto-md5sum "edd8a73775e8ece1d69515dd17767bfb">
|
---|
| 62 |
|
---|
| 63 | <!ENTITY videoproto-version "2.3.1">
|
---|
| 64 | <!ENTITY videoproto-md5sum "c3b348c6e2031b72b11ae63fc7f805c2">
|
---|
| 65 |
|
---|
| 66 | <!ENTITY xcmiscproto-version "1.2.2">
|
---|
| 67 | <!ENTITY xcmiscproto-md5sum "5f4847c78e41b801982c8a5e06365b24">
|
---|
| 68 |
|
---|
| 69 | <!ENTITY xextproto-version "7.2.1">
|
---|
| 70 | <!ENTITY xextproto-md5sum "eaac343af094e6b608cf15cfba0f77c5">
|
---|
| 71 |
|
---|
| 72 | <!ENTITY xf86bigfontproto-version "1.2.0">
|
---|
| 73 | <!ENTITY xf86bigfontproto-md5sum "120e226ede5a4687b25dd357cc9b8efe">
|
---|
| 74 |
|
---|
| 75 | <!ENTITY xf86dgaproto-version "2.1">
|
---|
| 76 | <!ENTITY xf86dgaproto-md5sum "a036dc2fcbf052ec10621fd48b68dbb1">
|
---|
| 77 |
|
---|
| 78 | <!ENTITY xf86driproto-version "2.1.1">
|
---|
| 79 | <!ENTITY xf86driproto-md5sum "1d716d0dac3b664e5ee20c69d34bc10e">
|
---|
| 80 |
|
---|
| 81 | <!ENTITY xf86vidmodeproto-version "2.3.1">
|
---|
| 82 | <!ENTITY xf86vidmodeproto-md5sum "e793ecefeaecfeabd1aed6a01095174e">
|
---|
| 83 |
|
---|
| 84 | <!ENTITY xineramaproto-version "1.2.1">
|
---|
| 85 | <!ENTITY xineramaproto-md5sum "9959fe0bfb22a0e7260433b8d199590a">
|
---|
| 86 |
|
---|
| 87 | <!ENTITY xproto-version "7.0.23">
|
---|
| 88 | <!ENTITY xproto-md5sum "d4d241a4849167e4e694fe73371c328c">
|
---|
| 89 |
|
---|
[3f72a148] | 90 | ]>
|
---|
| 91 |
|
---|
| 92 | <sect1 id="xorg7-proto" xreflabel="Xorg Protocol Headers">
|
---|
| 93 | <?dbhtml filename="x7proto.html"?>
|
---|
| 94 |
|
---|
| 95 | <sect1info>
|
---|
[93f3de5] | 96 | <othername>$LastChangedBy$</othername>
|
---|
| 97 | <date>$Date$</date>
|
---|
[3f72a148] | 98 | </sect1info>
|
---|
| 99 |
|
---|
| 100 | <title>Xorg Protocol Headers</title>
|
---|
| 101 |
|
---|
| 102 | <indexterm zone="xorg7-proto">
|
---|
| 103 | <primary sortas="a-xorg7-proto">Xorg Protocol Headers</primary>
|
---|
| 104 | </indexterm>
|
---|
| 105 |
|
---|
[5e8be1c] | 106 | <sect2 role="package">
|
---|
| 107 | <title>Introduction to Xorg Protocol Headers</title>
|
---|
| 108 |
|
---|
| 109 | <para>The <application>Xorg</application> protocol headers provide the
|
---|
| 110 | header files required to build the system, and to allow other
|
---|
| 111 | applications to build against the installed X Window system.</para>
|
---|
| 112 |
|
---|
[90b8fc35] | 113 | &lfs72_checked;
|
---|
[ca0c29cc] | 114 |
|
---|
[5e8be1c] | 115 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 116 | <itemizedlist spacing="compact">
|
---|
| 117 | <listitem>
|
---|
| 118 | <para>Download (HTTP): <ulink url="&x7proto-download-http;"/></para>
|
---|
| 119 | </listitem>
|
---|
| 120 | <listitem>
|
---|
| 121 | <para>Download (FTP): <ulink url="&x7proto-download-ftp;"/></para>
|
---|
| 122 | </listitem>
|
---|
| 123 | <listitem>
|
---|
| 124 | <para>Download size: &x7proto-size;</para>
|
---|
| 125 | </listitem>
|
---|
| 126 | <listitem>
|
---|
| 127 | <para>Estimated disk space required: &x7proto-buildsize;</para>
|
---|
| 128 | </listitem>
|
---|
| 129 | <listitem>
|
---|
| 130 | <para>Estimated build time: &x7proto-time;</para>
|
---|
| 131 | </listitem>
|
---|
| 132 | </itemizedlist>
|
---|
| 133 |
|
---|
[b8a1c6d] | 134 | <bridgehead renderas="sect3">Xorg Protocol Headers Dependencies</bridgehead>
|
---|
| 135 |
|
---|
| 136 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
[3b69a2aa] | 137 | <para role="required"> <xref linkend="util-macros"/></para>
|
---|
[b8a1c6d] | 138 |
|
---|
[5287b7c] | 139 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
| 140 | <para role="required"> <xref linkend="sudo"/> and
|
---|
| 141 | <xref linkend="wget"/></para>
|
---|
| 142 |
|
---|
[b8a1c6d] | 143 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
[9789e716] | 144 | <para role="optional"> <xref linkend="fop"/> and <xref linkend="xmlto"/>
|
---|
[b8a1c6d] | 145 | (to build additional documentation)</para>
|
---|
| 146 |
|
---|
| 147 | <note><para>There is a reciprocal dependency with <xref linkend="fop"/>. If
|
---|
| 148 | you wish to build the documentation, you'll need to re-install the
|
---|
| 149 | Protocol Headers after the installation is complete and
|
---|
| 150 | <xref linkend="fop"/> has been installed.</para></note>
|
---|
| 151 |
|
---|
[5e8be1c] | 152 | <para condition="html" role="usernotes">User Notes:
|
---|
| 153 | <ulink url='&blfs-wiki;/Xorg7ProtocolHeaders'/></para>
|
---|
| 154 |
|
---|
| 155 | </sect2>
|
---|
[10eeae12] | 156 |
|
---|
[3f72a148] | 157 | <sect2>
|
---|
| 158 | <title>Downloading Xorg Protocol Headers</title>
|
---|
| 159 |
|
---|
[5287b7c] | 160 | <para>First, create a list of files to be downloaded. This file will also
|
---|
| 161 | be used to verify the integrity of the downloads when complete:</para>
|
---|
| 162 |
|
---|
| 163 | <screen><userinput>cat > proto-&xorg-version;.md5 << "EOF"
|
---|
| 164 | &bigreqsproto-md5sum; bigreqsproto-&bigreqsproto-version;.tar.bz2
|
---|
| 165 | &compositeproto-md5sum; compositeproto-&compositeproto-version;.tar.bz2
|
---|
| 166 | &damageproto-md5sum; damageproto-&damageproto-version;.tar.bz2
|
---|
| 167 | &dmxproto-md5sum; dmxproto-&dmxproto-version;.tar.bz2
|
---|
| 168 | &dri2proto-md5sum; dri2proto-&dri2proto-version;.tar.bz2
|
---|
| 169 | &fixesproto-md5sum; fixesproto-&fixesproto-version;.tar.bz2
|
---|
| 170 | &fontsproto-md5sum; fontsproto-&fontsproto-version;.tar.bz2
|
---|
| 171 | &glproto-md5sum; glproto-&glproto-version;.tar.bz2
|
---|
| 172 | &inputproto-md5sum; inputproto-&inputproto-version;.tar.bz2
|
---|
| 173 | &kbproto-md5sum; kbproto-&kbproto-version;.tar.bz2
|
---|
| 174 | &randrproto-md5sum; randrproto-&randrproto-version;.tar.bz2
|
---|
| 175 | &recordproto-md5sum; recordproto-&recordproto-version;.tar.bz2
|
---|
| 176 | &renderproto-md5sum; renderproto-&renderproto-version;.tar.bz2
|
---|
| 177 | &resourceproto-md5sum; resourceproto-&resourceproto-version;.tar.bz2
|
---|
| 178 | &scrnsaverproto-md5sum; scrnsaverproto-&scrnsaverproto-version;.tar.bz2
|
---|
| 179 | &videoproto-md5sum; videoproto-&videoproto-version;.tar.bz2
|
---|
| 180 | &xcmiscproto-md5sum; xcmiscproto-&xcmiscproto-version;.tar.bz2
|
---|
| 181 | &xextproto-md5sum; xextproto-&xextproto-version;.tar.bz2
|
---|
| 182 | &xf86bigfontproto-md5sum; xf86bigfontproto-&xf86bigfontproto-version;.tar.bz2
|
---|
| 183 | &xf86dgaproto-md5sum; xf86dgaproto-&xf86dgaproto-version;.tar.bz2
|
---|
| 184 | &xf86driproto-md5sum; xf86driproto-&xf86driproto-version;.tar.bz2
|
---|
| 185 | &xf86vidmodeproto-md5sum; xf86vidmodeproto-&xf86vidmodeproto-version;.tar.bz2
|
---|
| 186 | &xineramaproto-md5sum; xineramaproto-&xineramaproto-version;.tar.bz2
|
---|
| 187 | &xproto-md5sum; xproto-&xproto-version;.tar.bz2
|
---|
| 188 | EOF</userinput></screen>
|
---|
| 189 |
|
---|
[3f72a148] | 190 | <para>To download the needed files using <application>wget</application>,
|
---|
| 191 | use the following commands:</para>
|
---|
| 192 |
|
---|
[4487494] | 193 | <screen><userinput>mkdir proto &&
|
---|
[3f72a148] | 194 | cd proto &&
|
---|
[5287b7c] | 195 | grep -v '^#' ../proto-&xorg-version;.md5 | awk '{print $2}' | wget -i- -c \
|
---|
[d9a6d690] | 196 | -B http://xorg.freedesktop.org/releases/individual/proto/ &&
|
---|
[5287b7c] | 197 | md5sum -c ../proto-&xorg-version;.md5</userinput></screen>
|
---|
[3f72a148] | 198 |
|
---|
| 199 | </sect2>
|
---|
| 200 |
|
---|
| 201 | <sect2 role="installation">
|
---|
| 202 | <title>Installation of Xorg Protocol Headers</title>
|
---|
| 203 |
|
---|
[33cbd93a] | 204 | &as_root;
|
---|
| 205 |
|
---|
[5287b7c] | 206 | <para>First, start a subshell that will exit on error:</para>
|
---|
[3f72a148] | 207 |
|
---|
[5287b7c] | 208 | <screen><userinput>bash -e</userinput></screen>
|
---|
[3f72a148] | 209 |
|
---|
[5287b7c] | 210 | <para>Install all of the applications by running the following
|
---|
| 211 | commands:</para>
|
---|
| 212 |
|
---|
| 213 | <screen><userinput>for package in $(grep -v '^#' ../proto-&xorg-version;.md5 | awk '{print $2}')
|
---|
| 214 | do
|
---|
| 215 | packagedir=${package%.tar.bz2}
|
---|
| 216 | tar -xf $package
|
---|
[33cbd93a] | 217 | pushd $packagedir
|
---|
[5287b7c] | 218 | ./configure $XORG_CONFIG
|
---|
[ba58642] | 219 | as_root make install
|
---|
[33cbd93a] | 220 | popd
|
---|
[5287b7c] | 221 | rm -r $packagedir
|
---|
| 222 | done</userinput></screen>
|
---|
| 223 |
|
---|
| 224 | <para>Finally, exit the shell that was started earlier:</para>
|
---|
| 225 |
|
---|
| 226 | <screen><userinput>exit</userinput></screen>
|
---|
| 227 |
|
---|
| 228 | </sect2>
|
---|
[ad54ac8] | 229 |
|
---|
[5287b7c] | 230 | <sect2 role="commands">
|
---|
| 231 | <title>Command Explanations</title>
|
---|
[3f72a148] | 232 |
|
---|
[33cbd93a] | 233 | <para><command>bash -e</command>: This command starts a subshell that will
|
---|
[5287b7c] | 234 | exit if any command returns a value other than 0, causing the for loop to
|
---|
| 235 | exit immediately if an error occurs. This also eliminates the need for the
|
---|
| 236 | <command>&&</command> construct used elsewhere in the book.</para>
|
---|
[3f72a148] | 237 |
|
---|
| 238 | </sect2>
|
---|
| 239 |
|
---|
[09c2ec8c] | 240 | <sect2 role="content">
|
---|
| 241 | <title>Contents</title>
|
---|
| 242 |
|
---|
| 243 | <segmentedlist>
|
---|
[759586e] | 244 | <segtitle>Installed Programs</segtitle>
|
---|
| 245 | <segtitle>Installed Libraries</segtitle>
|
---|
[6ceb7f5] | 246 | <segtitle>Installed Directories</segtitle>
|
---|
[09c2ec8c] | 247 |
|
---|
| 248 | <seglistitem>
|
---|
[759586e] | 249 | <seg>None</seg>
|
---|
| 250 | <seg>None</seg>
|
---|
[09c2ec8c] | 251 | <seg>The following subdirectories of <envar>$XORG_PREFIX</envar>/:
|
---|
| 252 | include/X11, include/GL, and lib/pkgconfig</seg>
|
---|
| 253 | </seglistitem>
|
---|
| 254 | </segmentedlist>
|
---|
| 255 |
|
---|
| 256 | </sect2>
|
---|
| 257 |
|
---|
[3f72a148] | 258 | </sect1>
|
---|