ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahz_5.4.0.1/uncompress.htm

96 lines
2.8 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8">
<title>uncompress - Expand compressed data</title>
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</HEAD>
<body bgcolor="#FFFFFF">
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h2>uncompress - Expand
compressed data</h2>
<p><strong>Synopsis</strong></p>
<p><strong>uncompress [-cv] [-b</strong> <em>bits</em>]
[<em>file</em> ...]</p>
<p><strong>Description</strong></p>
<p>The <strong>uncompress</strong> utility restores the compressed
<em>files</em> to their original form, renaming the files by
deleting the ".Z" extension.</p>
<p>If renaming <em>file</em> would cause files to be overwritten
and the standard input device is a terminal, the user is prompted
(on standard error) for confirmation. If prompting is not possible
or confirmation is not received, the files are not overwritten.</p>
<p><strong>Options</strong></p>
<dl>
<dt><strong>-b</strong> <em>bits</em></dt>
<dd>Specify the bits code limit (see below for details).</dd>
<dt><strong>-c</strong></dt>
<dd>Uncompressed output is written to the standard output. No files
are modified.</dd>
<dt><strong>-v</strong></dt>
<dd>Print the percentage of expansion for each file.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>Each <em>file</em> is a pathname of a file to uncompress. If no
<em>files</em> are specified, the standard input is uncompressed to
the standard output. If either the input and output files are not
regular files, the checks for reduction in size and file
overwriting are not performed, the input file is not removed, and
the attributes of the input file are not retained.</p>
<p><strong>Extended Description</strong></p>
<p>The <strong>uncompress</strong> utility uses a modified
Lempel-Ziv algorithm. Common substrings in the file are first
replaced by 9-bit codes 257 and up. When code 512 is reached, the
algorithm switches to 10-bit codes and continues to use more bits
until the limit specified by the <strong>-b</strong> flag is
reached (the default is 16). Bits must be between 9 and 16.</p>
<p>The amount of compression obtained depends on the size of the
input, the number of bits per code, and the distribution of common
substrings. Typically, text such as source code or English is
reduced by 50-60%.</p>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 on success</li>
<li>&gt;0 if an error occurs.</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="compress.htm">compress - Compress data</a></li>
<li><a href="zcat.htm">zcat - Expand and concatenate data</a></li>
</ul>
<!-- end ibmbody========================================================= -->
</body>
</html>