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

158 lines
4.5 KiB
HTML

<!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>tar - File archiver</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>tar - File archiver</h2>
<strong>Synopsis</strong>
<p><strong>tar -crtux[befmopvwHLPX] [</strong><em>archive</em><strong>]
[</strong><em>blocksize</em><strong>]</strong> <em>file ...</em></p>
<p><strong>Description</strong></p>
<p>The <strong>tar</strong> utility reads, writes, and lists files from an archive file.</p>
<p><strong>Options</strong></p>
<p>The following options select the function <strong>tar</strong> performs. One of these
options must be specified.</p>
<dl>
<dt><strong>-c</strong></dt>
<dd>Create a new archive.</dd>
<dt><strong>-r</strong></dt>
<dd>Add the specified <em>file</em> to end of the achive.</dd>
<dt><strong>-t</strong></dt>
<dd>List the names of the files in the archive to standard output.</dd>
<dt><strong>-u</strong></dt>
<dd>Update the specified <em>file</em> in the archive if it has been modified since last
written to the archive or add <em>file</em> to the archive if it is not in the archive.</dd>
<dt><strong>-x</strong></dt>
<dd>Extract the specified <em>files</em> from the archive. If no <em>files</em> are specified, all files
are extracted from the archive.</dd>
</dl>
<p>The following options affect the operation of <strong>tar</strong>.</p>
<dl>
<dt><strong>-b</strong></dt>
<dd>Use the first operand (or the second, if <strong>f</strong> has already been specified) as the
block size for the archive.</dd>
<dt><strong>-e</strong></dt>
<dd>Exit after the first error is found.</dd>
<dt><strong>-f</strong></dt>
<dd>Use the first operand (or the second, if <strong>b</strong> has already been specified)
as the name of the archive instead of the default name. If the name of the file is -, <strong>tar</strong> writes
to the standard output or reads from the standard input depending on the function.</dd>
<dt><strong>-m</strong></dt>
<dd>Do not restore the modification times. The modification time of the file is the time of extraction.</dd>
<dt><strong>-o</strong></dt>
<dd>Set the owner and group of extracted files to the user running <strong>tar</strong> instead of
to the user and group saved with the archive.</dd>
<dt><strong>-p</strong></dt>
<dd>Preserve the owner, group, file mode, access time, and modification time of files extracted
from the archive.</dd>
<dt><strong>-v</strong></dt>
<dd>Verbose mode. Write to standard error the name of each file being processed. When the <strong>t</strong>
function is specified, the output also includes the mode, number of links, owner, group, size,
and modification date of each file.</dd>
<dt><strong>-w</strong></dt>
<dd>Write the action to be taken, followed by the name of the file, and then wait for the
user's confirmation. If an affirmative response is given, the action is performed. Any
other input suppresses the action.</dd>
<dt><strong>-H</strong></dt>
<dd>Follow only command line symbolic links while performing a physical file system traversal.</dd>
<dt><strong>-L</strong></dt>
<dd>Follow all symbolic links to perform a logical file system traversal.</dd>
<dt><strong>-P</strong></dt>
<dd>Do not follow symbolic links, perform a physical file system traversal. This is the default mode.</dd>
<dt><strong>-X</strong></dt>
<dd>When traversing the file hierarchy specified by a path name, do not descend into directories
that have a different device ID.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>Each <em>file</em> is an object that is either added to the archive or extracted from the
archive depending on the function.</p>
<strong>Environment Variables</strong>
<p><strong>tar</strong> is affected by the following environment
variables:</p>
<dl>
<dt><strong>QIBM_CCSID</strong></dt>
<dd>The value of the environment variable is the CCSID used to create files extracted from the
archive. There must be a valid translation from CCSID 819 to the specified CCSID.</dd>
</dl>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 when successful</li>
<li>&gt;0 when unsuccessful</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="pax.htm">pax - Portable archive interchange</a></li>
</ul>
<!-- end ibmbody========================================================= -->
</body>
</html>