Add a note that the use of -B option does not guarantee a size of fragment

if -z option also used.

Recommend the use of zip(1) if compressed files of predictable size needed.

PR:			docs/41089
Submitted by:		Sevan Janiyan
Reported by:		areilly@bigpond.net.au

While here, pet igor

Reviewed by:		bcr
Differential Revision:	https://reviews.freebsd.org/D18686
This commit is contained in:
Chris Rees 2018-12-29 23:08:59 +00:00
parent e84f645584
commit 64e8790d7e

View File

@ -33,7 +33,7 @@
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94 .\" @(#)pax.1 8.4 (Berkeley) 4/18/94
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd March 17, 2015 .Dd December 29, 2018
.Dt PAX 1 .Dt PAX 1
.Os .Os
.Sh NAME .Sh NAME
@ -793,6 +793,16 @@ limits can be separated by
.Li x .Li x
to indicate a product. to indicate a product.
.Pp .Pp
Note that the specified size is for the uncompressed pax image itself.
If the
.Fl z
option is also used, the resulting file may contain fewer
.Ar bytes ,
according to the compressibility of the archive contents.
See
.Xr zip 1
if compressed volumes of predictable size are required.
.Pp
.Em Warning : .Em Warning :
Only use this option when writing an archive to a device which supports Only use this option when writing an archive to a device which supports
an end of file read condition based on last (or largest) write offset an end of file read condition based on last (or largest) write offset
@ -804,7 +814,7 @@ This option is the same as the
option, except that the file inode change time is checked instead of the option, except that the file inode change time is checked instead of the
file modification time. file modification time.
The file inode change time can be used to select files whose inode information The file inode change time can be used to select files whose inode information
(e.g.\& uid, gid, etc.) is newer than a copy of the file in the destination (e.g., uid, gid, etc.) is newer than a copy of the file in the destination
.Ar directory . .Ar directory .
.It Fl E Ar limit .It Fl E Ar limit
Limit the number of consecutive read faults while trying to read a flawed Limit the number of consecutive read faults while trying to read a flawed
@ -903,7 +913,7 @@ the file was last written).
The The
.Ar c .Ar c
specifies the comparison of inode change time (the time when the file specifies the comparison of inode change time (the time when the file
inode was last changed; e.g.\& a change of owner, group, mode, etc). inode was last changed; e.g., a change of owner, group, mode, etc).
When When
.Ar c .Ar c
and and