Open System Services Shell and Utilities Reference Manual (G06.28+, H06.05+)

User Commands (t - u) tar(1)
NAME
tar - Manipulates tape-archive-format
les
SYNOPSIS
tar [ -]required_ag[Abflmovw ]|
[operand ... ]
FLAGS
The function performed by tar is specied by one of the following values for required_ag:
c Creates a new archive le. If the archive le is on tape, writing begins at the beginning
of the tape instead of after the last le. The use of this ag implies the function of the
required_ag value of r.
r Writes the les specied by operand values at the end of the tape or appends them to
the end of an existing archive le. The use of the required_ag value of c implies the
function of this ag.
t Lists the names of the les specied by operand values each time they occur in the
archive le. If no value is given for operand, all the names in the archive le are listed
to the standard output le.
u Adds the les specied by operand values to the archive le, if the les are not already
there or if they were modied since last archived.
x Extracts the les specied by operand values from the archive le. If a specied le
matches a directory whose contents were written into the archive le, this directory is
(recursively) extracted. The owner, modication time, and mode are restored (if possi-
ble).
If no value is given for operand, the entire content of the archive is extracted. If multi-
ple entries specifying the same le are in the archive, the last one overwrites all earlier
ones.
You can use the following ags with required_ag:
A Tells the tar command to suppress warning messages about optional access control list |
(ACL) entries. Because the tar utility does not archive optional ACL entries, a warn- |
ing message is printed for each le that has optional ACL entries. However, if tar is |
executed remotely from a system that does not support OSS ACLs, no warnings are |
printed.
b Tells the tar command to use the next operand as the blocking factor for tape records.
The default value is less than or equal to 20, and the maximum value is greater than or
equal to 20 (larger values can be specied at the risk of creating a tape archive that
some systemstape drives might not be able to restore).
Use this ag only when creating or writing raw magnetic tape archives. The block size
is determined automatically when reading tapes (required_ag values of x or t).
f Tells the tar command to use the rst operand value (or the second, if the b ag has
been specied) as the name of the archive le.
When f is used with the required_ag value of t or x and the pathname specied for
operand is - (dash), the standard input le is an archive le formatted as with pax -x
ustar. When f is used with the required_ag value of r, u,orc and the pathname
specied for operand is - (dash), the standard output le is an archive le formatted as
with pax -x ustar. For example, the following command line is valid:
527188-007 Hewlett-Packard Company 95