aboutsummaryrefslogtreecommitdiff
path: root/bin/pax/pax.1
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2005-01-16 16:41:59 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2005-01-16 16:41:59 +0000
commit6fca4c7c3f16b87ad8b9ffa6564f5654f44ed581 (patch)
tree1775365203268b35ac39f4ba2e40744174a93e39 /bin/pax/pax.1
parent2d7142bf0d3cccc74a0fc8479fa63c795d0d0556 (diff)
downloadsrc-6fca4c7c3f16b87ad8b9ffa6564f5654f44ed581.tar.gz
src-6fca4c7c3f16b87ad8b9ffa6564f5654f44ed581.zip
Add the new standard EXIT STATUS section where appropriate.
Sort standard sections in the (documented) preferred order.
Notes
Notes: svn path=/head/; revision=140353
Diffstat (limited to 'bin/pax/pax.1')
-rw-r--r--bin/pax/pax.198
1 files changed, 49 insertions, 49 deletions
diff --git a/bin/pax/pax.1 b/bin/pax/pax.1
index 5764c6dadd89..05934044674f 100644
--- a/bin/pax/pax.1
+++ b/bin/pax/pax.1
@@ -1049,6 +1049,16 @@ options are specified along with the
.Fl n
option, a file is not considered selected unless it is newer
than the file to which it is compared.
+.Sh EXIT STATUS
+The
+.Nm
+utility will exit with one of the following values:
+.Bl -tag -width 2n
+.It 0
+All files were processed successfully.
+.It 1
+An error occurred.
+.El
.Sh EXAMPLES
The command:
.Dl "pax -w -f /dev/sa0 ."
@@ -1099,6 +1109,45 @@ will update (and list) only those files in the destination directory
which are older (less recent inode change or file modification times) than
files with the same name found in the source file tree
.Pa home .
+.Sh DIAGNOSTICS
+Whenever
+.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
+.Fl p
+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
+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
+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
+may have only partially created the archive which may violate the specific
+archive format specification.
+.Pp
+If while doing a
+.Em copy ,
+.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
+completes it will exit with a non-zero exit status.
+.Sh SEE ALSO
+.Xr cpio 1 ,
+.Xr tar 1
.Sh STANDARDS
The
.Nm
@@ -1130,9 +1179,6 @@ and
operations are extensions to the
.Tn POSIX
standard.
-.Sh SEE ALSO
-.Xr cpio 1 ,
-.Xr tar 1
.Sh HISTORY
The
.Nm
@@ -1141,52 +1187,6 @@ utility appeared in
.Sh AUTHORS
.An Keith Muller
at the University of California, San Diego
-.Sh DIAGNOSTICS
-The
-.Nm
-utility will exit with one of the following values:
-.Bl -tag -width 2n
-.It 0
-All files were processed successfully.
-.It 1
-An error occurred.
-.El
-.Pp
-Whenever
-.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
-.Fl p
-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
-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
-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
-may have only partially created the archive which may violate the specific
-archive format specification.
-.Pp
-If while doing a
-.Em copy ,
-.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
-completes it will exit with a non-zero exit status.
.Sh BUGS
The
.Nm