158 lines
4.5 KiB
HTML
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>>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>
|