summaryrefslogtreecommitdiffstats
path: root/bin/pax/pax.1
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>1998-05-15 06:30:58 +0000
committercharnier <charnier@FreeBSD.org>1998-05-15 06:30:58 +0000
commitcf1a881890643db8396c6b430f309529fe461a01 (patch)
tree709d2a8061e8b93da2bdf730a891006cb218f19d /bin/pax/pax.1
parent8a9755ceef4307bb15a25bc49167da719cfbc0fa (diff)
downloadFreeBSD-src-cf1a881890643db8396c6b430f309529fe461a01.zip
FreeBSD-src-cf1a881890643db8396c6b430f309529fe461a01.tar.gz
Correct use of .Nm. Add rcsid.
Diffstat (limited to 'bin/pax/pax.1')
-rw-r--r--bin/pax/pax.164
1 files changed, 32 insertions, 32 deletions
diff --git a/bin/pax/pax.1 b/bin/pax/pax.1
index 557b8ee..e46facb 100644
--- a/bin/pax/pax.1
+++ b/bin/pax/pax.1
@@ -34,7 +34,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94
-.\" $Id: pax.1,v 1.5 1997/02/22 14:04:38 peter Exp $
+.\" $Id: pax.1,v 1.6 1998/03/19 07:26:37 charnier Exp $
.\"
.Dd April 18, 1994
.Dt PAX 1
@@ -194,7 +194,7 @@ The presence of the
and the
.Fl w
options specifies which of the following functional modes
-.Nm pax
+.Nm
will operate under:
.Em list , read , write ,
and
@@ -284,7 +284,7 @@ While processing a damaged archive during a
or
.Em list
operation,
-.Nm pax
+.Nm
will attempt to recover from media defects and will search through the archive
to locate and process the largest number of archive members possible (see the
.Fl E
@@ -298,7 +298,7 @@ If the
.Ar directory
operand does not exist, or it is not writable by the user,
or it is not of type directory,
-.Nm Pax
+.Nm
will exit with a non-zero exit status.
.Pp
The
@@ -317,7 +317,7 @@ be selected.
When a
.Ar pattern
operand does not select at least one archive member,
-.Nm pax
+.Nm
will write these
.Ar pattern
operands in a diagnostic message to
@@ -330,7 +330,7 @@ operand specifies the pathname of a file to be copied or archived.
When a
.Ar file
operand does not select at least one archive member,
-.Nm pax
+.Nm
will write these
.Ar file
operand pathnames in a diagnostic message to
@@ -357,7 +357,7 @@ and
as the mode argument.
When the selected archive format supports the specification of linked
files and these files cannot be linked while the archive is being extracted,
-.Nm pax
+.Nm
will write a diagnostic message to
.Dv standard error
and exit with a non-zero exit status at the completion of operation.
@@ -381,7 +381,7 @@ If an archive format is not specified with a
option, the format currently being used in the archive will be selected.
Any attempt to append to an archive in a format different from the
format already used in the archive will cause
-.Nm pax
+.Nm
to exit immediately
with a non-zero exit status.
The blocking size used in the archive volume where writing starts
@@ -450,7 +450,7 @@ or
.Em write ) .
A single archive may span multiple files and different archive devices.
When required,
-.Nm pax
+.Nm
will prompt for the pathname of the file or device of the next volume in the
archive.
.It Fl i
@@ -460,7 +460,7 @@ For each archive member matching a
operand or each file matching a
.Ar file
operand,
-.Nm pax
+.Nm
will prompt to
.Pa /dev/tty
giving the name of the file, its file mode and its modification time.
@@ -569,7 +569,7 @@ nor the
.Cm o
specification character is specified, or the user ID and group ID are not
preserved for any reason,
-.Nm pax
+.Nm
will not set the
.Dv S_ISUID
.Em ( setuid )
@@ -578,7 +578,7 @@ and
.Em ( setgid )
bits of the file mode.
If the preservation of any of these items fails for any reason,
-.Nm pax
+.Nm
will write a diagnostic message to
.Dv standard error .
Failure to preserve these items will affect the final exit status,
@@ -636,9 +636,9 @@ File or archive member names that substitute to the empty string
are not selected and will be skipped.
.It Fl t
Reset the access times of any file or directory read or accessed by
-.Nm pax
+.Nm
to be the same as they were before being read or accessed by
-.Nm pax .
+.Nm Ns .
.It Fl u
Ignore files that are older (having a less recent file modification time)
than a pre-existing file or archive member with the same name.
@@ -699,7 +699,7 @@ standard.
The default blocksize for this format is 5120 bytes.
Inode and device information about a file (used for detecting file hard links
by this format) which may be truncated by this format is detected by
-.Nm pax
+.Nm
and is repaired.
.It Ar bcpio
The old binary cpio format.
@@ -708,21 +708,21 @@ This format is not very portable and should not be used when other formats
are available.
Inode and device information about a file (used for detecting file hard links
by this format) which may be truncated by this format is detected by
-.Nm pax
+.Nm
and is repaired.
.It Ar sv4cpio
The System V release 4 cpio.
The default blocksize for this format is 5120 bytes.
Inode and device information about a file (used for detecting file hard links
by this format) which may be truncated by this format is detected by
-.Nm pax
+.Nm
and is repaired.
.It Ar sv4crc
The System V release 4 cpio with file crc checksums.
The default blocksize for this format is 5120 bytes.
Inode and device information about a file (used for detecting file hard links
by this format) which may be truncated by this format is detected by
-.Nm pax
+.Nm
and is repaired.
.It Ar tar
The old BSD tar format as found in BSD4.3.
@@ -790,20 +790,20 @@ archives to
.Ar limit .
With a positive
.Ar limit ,
-.Nm pax
+.Nm
will attempt to recover from an archive read error and will
continue processing starting with the next file stored in the archive.
A
.Ar limit
of 0 will cause
-.Nm pax
+.Nm
to stop operation after the first read error is detected on an archive volume.
A
.Ar limit
of
.Li NONE
will cause
-.Nm pax
+.Nm
to attempt to recover from read errors forever.
The default
.Ar limit
@@ -813,7 +813,7 @@ is a small positive number of retries.
Using this option with
.Li NONE
should be used with extreme caution as
-.Nm pax
+.Nm
may get stuck in an infinite loop on a very badly flawed archive.
.It Fl G Ar group
Select a file based on its
@@ -857,7 +857,7 @@ only files with a modification or inode change time of exactly that
time will be selected.
.Pp
When
-.Nm pax
+.Nm
is in the
.Em write
or
@@ -887,7 +887,7 @@ created and had their modification time reset to an older time (as what
happens when a file is extracted from an archive and the modification time
is preserved).
Time comparisons using both file times is useful when
-.Nm pax
+.Nm
is used to create a time based incremental archive (only files that were
changed during a specified time range will be archived).
.Pp
@@ -1093,7 +1093,7 @@ files with the same name found in the source file tree
.Pa home .
.Sh STANDARDS
The
-.Nm pax
+.Nm
utility is a superset of the
.St -p1003.2
standard.
@@ -1125,7 +1125,7 @@ standard.
.An Keith Muller
at the University of California, San Diego
.Sh ERRORS
-.Nm pax
+.Nm Pax
will exit with one of the following values:
.Bl -tag -width 2n
.It 0
@@ -1135,7 +1135,7 @@ An error occurred.
.El
.Pp
Whenever
-.Nm pax
+.Nm
cannot create a file or a link when reading an archive or cannot
find a file when writing an archive, or cannot preserve the user ID,
group ID, or file mode when the
@@ -1144,28 +1144,28 @@ option is specified, a diagnostic message is written to
.Dv standard error
and a non-zero exit status will be returned, but processing will continue.
In the case where pax cannot create a link to a file,
-.Nm pax
+.Nm
will not create a second copy of the file.
.Pp
If the extraction of a file from an archive is prematurely terminated by
a signal or error,
-.Nm pax
+.Nm
may have only partially extracted a file the user wanted.
Additionally, the file modes of extracted files and directories
may have incorrect file bits, and the modification and access times may be
wrong.
.Pp
If the creation of an archive is prematurely terminated by a signal or error,
-.Nm pax
+.Nm
may have only partially created the archive which may violate the specific
archive format specification.
.Pp
If while doing a
.Em copy ,
-.Nm pax
+.Nm
detects a file is about to overwrite itself, the file is not copied,
a diagnostic message is written to
.Dv standard error
and when
-.Nm pax
+.Nm
completes it will exit with a non-zero exit status.
OpenPOWER on IntegriCloud