xz.xml 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-system-xz" role="wrap">
  8. <?dbhtml filename="xz.html"?>
  9. <sect1info condition="script">
  10. <productname>xz</productname>
  11. <productnumber>&xz-version;</productnumber>
  12. <address>&xz-url;</address>
  13. </sect1info>
  14. <title>Xz-&xz-version;</title>
  15. <indexterm zone="ch-system-xz">
  16. <primary sortas="a-xz">Xz</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The Xz package contains programs for compressing and decompressing
  21. files. It provides capabilities for the lzma and the newer xz compression
  22. formats. Compressing text files with <command>xz</command> yields a better
  23. compression percentage than with the traditional <command>gzip</command> or
  24. <command>bzip2</command> commands.</para>
  25. <segmentedlist>
  26. <segtitle>&buildtime;</segtitle>
  27. <segtitle>&diskspace;</segtitle>
  28. <seglistitem>
  29. <seg>&xz-ch6-sbu;</seg>
  30. <seg>&xz-ch6-du;</seg>
  31. </seglistitem>
  32. </segmentedlist>
  33. </sect2>
  34. <sect2 role="installation">
  35. <title>Installation of Xz</title>
  36. <para>Prepare Xz for compilation with:</para>
  37. <screen><userinput remap="configure">./configure --prefix=/usr \
  38. --disable-static \
  39. --docdir=/usr/share/doc/xz-&xz-version;</userinput></screen>
  40. <para>Compile the package:</para>
  41. <screen><userinput remap="make">make</userinput></screen>
  42. <para>To test the results, issue:</para>
  43. <screen><userinput remap="test">make check</userinput></screen>
  44. <para>Install the package and make sure that all essential files are in the
  45. correct directory:</para>
  46. <screen><userinput remap="install">make install
  47. mv -v /usr/bin/{lzma,unlzma,lzcat,xz,unxz,xzcat} /bin
  48. mv -v /usr/lib/liblzma.so.* /lib
  49. ln -svf ../../lib/$(readlink /usr/lib/liblzma.so) /usr/lib/liblzma.so</userinput></screen>
  50. </sect2>
  51. <!-- ~~~~~~~~~~~~~~~~~~~~ ABI 32 ~~~~~~~~~~~~~~~~~~~~ -->
  52. <sect2 arch="ml_32,ml_all" role="installation">
  53. <title>Installation of Xz - 32-bit</title>
  54. <para>Clean previous build:</para>
  55. <screen><userinput remap="pre">make distclean</userinput></screen>
  56. <para>Prepare Xz for compilation:</para>
  57. <screen><userinput remap="configure">CC="gcc -m32" ./configure \
  58. --prefix=/usr \
  59. --disable-static \
  60. --libdir=/usr/lib32 \
  61. --host=i686-pc-linux-gnu</userinput></screen>
  62. <para>Compile the package:</para>
  63. <screen><userinput remap="make">make</userinput></screen>
  64. <para>Install the package:</para>
  65. <screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
  66. cp -Rv DESTDIR/usr/lib32/* /usr/lib32
  67. rm -rf DESTDIR</userinput></screen>
  68. </sect2>
  69. <!-- ~~~~~~~~~~~~~~~~~~~~ ABI x32 ~~~~~~~~~~~~~~~~~~~~ -->
  70. <sect2 arch="ml_x32,ml_all" role="installation">
  71. <title>Installation of Xz - x32-bit</title>
  72. <para>Clean previous build:</para>
  73. <screen><userinput remap="pre">make distclean</userinput></screen>
  74. <para>Prepare Xz for compilation:</para>
  75. <screen><userinput remap="configure">CC="gcc -mx32" ./configure \
  76. --prefix=/usr \
  77. --disable-static \
  78. --libdir=/usr/libx32 \
  79. --host=x86_64-pc-linux-gnux32</userinput></screen>
  80. <para>Compile the package:</para>
  81. <screen><userinput remap="make">make</userinput></screen>
  82. <para>Install the package:</para>
  83. <screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
  84. cp -Rv DESTDIR/usr/libx32/* /usr/libx32
  85. rm -rf DESTDIR</userinput></screen>
  86. </sect2>
  87. <sect2 id="contents-xz" role="content">
  88. <title>Contents of Xz</title>
  89. <segmentedlist>
  90. <segtitle>Installed programs</segtitle>
  91. <segtitle>Installed libraries</segtitle>
  92. <segtitle>Installed directories</segtitle>
  93. <seglistitem>
  94. <seg>
  95. lzcat (link to xz),
  96. lzcmp (link to xzdiff),
  97. lzdiff (link to xzdiff),
  98. lzegrep (link to xzgrep),
  99. lzfgrep (link to xzgrep),
  100. lzgrep (link to xzgrep),
  101. lzless (link to xzless),
  102. lzma (link to xz),
  103. lzmadec,
  104. lzmainfo,
  105. lzmore (link to xzmore),
  106. unlzma (link to xz),
  107. unxz (link to xz),
  108. xz,
  109. xzcat (link to xz),
  110. xzcmp (link to xzdiff),
  111. xzdec,
  112. xzdiff,
  113. xzegrep (link to xzgrep),
  114. xzfgrep (link to xzgrep),
  115. xzgrep,
  116. xzless, and
  117. xzmore</seg>
  118. <seg>
  119. liblzma.so
  120. </seg>
  121. <seg>
  122. /usr/include/lzma and
  123. /usr/share/doc/xz-&xz-version;
  124. </seg>
  125. </seglistitem>
  126. </segmentedlist>
  127. <variablelist>
  128. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  129. <?dbfo list-presentation="list"?>
  130. <?dbhtml list-presentation="table"?>
  131. <varlistentry id="lzcat">
  132. <term><command>lzcat</command></term>
  133. <listitem>
  134. <para>Decompresses to standard output</para>
  135. <indexterm zone="ch-system-xz lzcat">
  136. <primary sortas="b-lzcat">lzcat</primary>
  137. </indexterm>
  138. </listitem>
  139. </varlistentry>
  140. <varlistentry id="lzcmp">
  141. <term><command>lzcmp</command></term>
  142. <listitem>
  143. <para>Runs <command>cmp</command> on LZMA compressed files</para>
  144. <indexterm zone="ch-system-xz lzcmp">
  145. <primary sortas="b-lzcmp">lzcmp</primary>
  146. </indexterm>
  147. </listitem>
  148. </varlistentry>
  149. <varlistentry id="lzdiff">
  150. <term><command>lzdiff</command></term>
  151. <listitem>
  152. <para>Runs <command>diff</command> on LZMA compressed files</para>
  153. <indexterm zone="ch-system-xz lzdiff">
  154. <primary sortas="b-lzdiff">lzdiff</primary>
  155. </indexterm>
  156. </listitem>
  157. </varlistentry>
  158. <varlistentry id="lzegrep">
  159. <term><command>lzegrep</command></term>
  160. <listitem>
  161. <para>Runs <command>egrep</command> on LZMA compressed files</para>
  162. <indexterm zone="ch-system-xz lzegrep">
  163. <primary sortas="b-lzegrep">lzegrep</primary>
  164. </indexterm>
  165. </listitem>
  166. </varlistentry>
  167. <varlistentry id="lzfgrep">
  168. <term><command>lzfgrep</command></term>
  169. <listitem>
  170. <para>Runs <command>fgrep</command> on LZMA compressed files</para>
  171. <indexterm zone="ch-system-xz lzfgrep">
  172. <primary sortas="b-lzfgrep">lzfgrep</primary>
  173. </indexterm>
  174. </listitem>
  175. </varlistentry>
  176. <varlistentry id="lzgrep">
  177. <term><command>lzgrep</command></term>
  178. <listitem>
  179. <para>Runs <command>grep</command> on LZMA compressed files</para>
  180. <indexterm zone="ch-system-xz lzgrep">
  181. <primary sortas="b-lzgrep">lzgrep</primary>
  182. </indexterm>
  183. </listitem>
  184. </varlistentry>
  185. <varlistentry id="lzless">
  186. <term><command>lzless</command></term>
  187. <listitem>
  188. <para>Runs <command>less</command> on LZMA compressed files</para>
  189. <indexterm zone="ch-system-xz lzless">
  190. <primary sortas="b-lzless">lzless</primary>
  191. </indexterm>
  192. </listitem>
  193. </varlistentry>
  194. <varlistentry id="lzma">
  195. <term><command>lzma</command></term>
  196. <listitem>
  197. <para>Compresses or decompresses files using the LZMA format</para>
  198. <indexterm zone="ch-system-xz lzma">
  199. <primary sortas="b-lzma">lzma</primary>
  200. </indexterm>
  201. </listitem>
  202. </varlistentry>
  203. <varlistentry id="lzmadec">
  204. <term><command>lzmadec</command></term>
  205. <listitem>
  206. <para>A small and fast decoder for LZMA compressed files</para>
  207. <indexterm zone="ch-system-xz lzmadec">
  208. <primary sortas="b-lzmadec">lzmadec</primary>
  209. </indexterm>
  210. </listitem>
  211. </varlistentry>
  212. <varlistentry id="lzmainfo">
  213. <term><command>lzmainfo</command></term>
  214. <listitem>
  215. <para>Shows information stored in the LZMA compressed file header</para>
  216. <indexterm zone="ch-system-xz lzmainfo">
  217. <primary sortas="b-lzmainfo">lzmainfo</primary>
  218. </indexterm>
  219. </listitem>
  220. </varlistentry>
  221. <varlistentry id="lzmore">
  222. <term><command>lzmore</command></term>
  223. <listitem>
  224. <para>Runs <command>more</command> on LZMA compressed files</para>
  225. <indexterm zone="ch-system-xz lzmore">
  226. <primary sortas="b-lzmamore">lzmore</primary>
  227. </indexterm>
  228. </listitem>
  229. </varlistentry>
  230. <varlistentry id="unlzma">
  231. <term><command>unlzma</command></term>
  232. <listitem>
  233. <para>Decompresses files using the LZMA format</para>
  234. <indexterm zone="ch-system-xz unlzma">
  235. <primary sortas="b-unlzma">unlzma</primary>
  236. </indexterm>
  237. </listitem>
  238. </varlistentry>
  239. <varlistentry id="unxz">
  240. <term><command>unxz</command></term>
  241. <listitem>
  242. <para>Decompresses files using the XZ format</para>
  243. <indexterm zone="ch-system-xz unxz">
  244. <primary sortas="b-unxz">unxz</primary>
  245. </indexterm>
  246. </listitem>
  247. </varlistentry>
  248. <varlistentry id="xz">
  249. <term><command>xz</command></term>
  250. <listitem>
  251. <para>Compresses or decompresses files using the XZ format</para>
  252. <indexterm zone="ch-system-xz xz">
  253. <primary sortas="b-xz">xz</primary>
  254. </indexterm>
  255. </listitem>
  256. </varlistentry>
  257. <varlistentry id="xzcat">
  258. <term><command>xzcat</command></term>
  259. <listitem>
  260. <para>Decompresses to standard output</para>
  261. <indexterm zone="ch-system-xz xzcat">
  262. <primary sortas="b-xzcat">xzcat</primary>
  263. </indexterm>
  264. </listitem>
  265. </varlistentry>
  266. <varlistentry id="xzcmp">
  267. <term><command>xzcmp</command></term>
  268. <listitem>
  269. <para>Runs <command>cmp</command> on XZ compressed files</para>
  270. <indexterm zone="ch-system-xz xzcmp">
  271. <primary sortas="b-xzcmp">xzcmp</primary>
  272. </indexterm>
  273. </listitem>
  274. </varlistentry>
  275. <varlistentry id="xzdec">
  276. <term><command>xzdec</command></term>
  277. <listitem>
  278. <para>A small and fast decoder for XZ compressed files</para>
  279. <indexterm zone="ch-system-xz xzdec">
  280. <primary sortas="b-xzdec">xzdec</primary>
  281. </indexterm>
  282. </listitem>
  283. </varlistentry>
  284. <varlistentry id="xzdiff">
  285. <term><command>xzdiff</command></term>
  286. <listitem>
  287. <para>Runs <command>diff</command> on XZ compressed files</para>
  288. <indexterm zone="ch-system-xz xzdiff">
  289. <primary sortas="b-xzdiff">xzdiff</primary>
  290. </indexterm>
  291. </listitem>
  292. </varlistentry>
  293. <varlistentry id="xzegrep">
  294. <term><command>xzegrep</command></term>
  295. <listitem>
  296. <para>Runs <command>egrep</command> on XZ compressed files</para>
  297. <indexterm zone="ch-system-xz xzegrep">
  298. <primary sortas="b-xzegrep">xzegrep</primary>
  299. </indexterm>
  300. </listitem>
  301. </varlistentry>
  302. <varlistentry id="xzfgrep">
  303. <term><command>xzfgrep</command></term>
  304. <listitem>
  305. <para>Runs <command>fgrep</command> on XZ compressed files</para>
  306. <indexterm zone="ch-system-xz xzfgrep">
  307. <primary sortas="b-xzfgrep">xzfgrep</primary>
  308. </indexterm>
  309. </listitem>
  310. </varlistentry>
  311. <varlistentry id="xzgrep">
  312. <term><command>xzgrep</command></term>
  313. <listitem>
  314. <para>Runs <command>grep</command> on XZ compressed files</para>
  315. <indexterm zone="ch-system-xz xzgrep">
  316. <primary sortas="b-xzgrep">xzgrep</primary>
  317. </indexterm>
  318. </listitem>
  319. </varlistentry>
  320. <varlistentry id="xzless">
  321. <term><command>xzless</command></term>
  322. <listitem>
  323. <para>Runs <command>less</command> on XZ compressed files</para>
  324. <indexterm zone="ch-system-xz xzless">
  325. <primary sortas="b-xzless">xzless</primary>
  326. </indexterm>
  327. </listitem>
  328. </varlistentry>
  329. <varlistentry id="xzmore">
  330. <term><command>xzmore</command></term>
  331. <listitem>
  332. <para>Runs <command>more</command> on XZ compressed files</para>
  333. <indexterm zone="ch-system-xz xzmore">
  334. <primary sortas="b-xzmore">xzmore</primary>
  335. </indexterm>
  336. </listitem>
  337. </varlistentry>
  338. <varlistentry id="liblzma">
  339. <term><filename class="libraryfile">liblzma</filename></term>
  340. <listitem>
  341. <para>The library implementing lossless, block-sorting data
  342. compression, using the Lempel-Ziv-Markov chain algorithm</para>
  343. <indexterm zone="ch-system-xz liblzma">
  344. <primary sortas="c-liblzma">liblzma</primary>
  345. </indexterm>
  346. </listitem>
  347. </varlistentry>
  348. </variablelist>
  349. </sect2>
  350. </sect1>