Changeset View
Changeset View
Standalone View
Standalone View
head/bin/pax/pax.1
Show All 27 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)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 | ||||
.Nm pax | .Nm pax | ||||
.Nd read and write file archives and copy directory hierarchies | .Nd read and write file archives and copy directory hierarchies | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl cdnvzO | .Op Fl cdnvzO | ||||
▲ Show 20 Lines • Show All 743 Lines • ▼ Show 20 Lines | |||||
.Li b | .Li b | ||||
to specify multiplication by 1048576 (1M), 1024 (1K) or 512, respectively. | to specify multiplication by 1048576 (1M), 1024 (1K) or 512, respectively. | ||||
A pair of | A pair of | ||||
.Ar bytes | .Ar bytes | ||||
limits can be separated by | 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 | ||||
(such as a regular file or a tape drive). | (such as a regular file or a tape drive). | ||||
The use of this option with a floppy or hard disk is not recommended. | The use of this option with a floppy or hard disk is not recommended. | ||||
.It Fl D | .It Fl D | ||||
This option is the same as the | This option is the same as the | ||||
.Fl u | .Fl u | ||||
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 | ||||
archives to | archives to | ||||
.Ar limit . | .Ar limit . | ||||
With a positive | With a positive | ||||
.Ar limit , | .Ar limit , | ||||
.Nm | .Nm | ||||
▲ Show 20 Lines • Show All 82 Lines • ▼ Show 20 Lines | |||||
If neither is specified, the default is to use file modification time only. | If neither is specified, the default is to use file modification time only. | ||||
The | The | ||||
.Ar m | .Ar m | ||||
specifies the comparison of file modification time (the time when | specifies the comparison of file modification time (the time when | ||||
the file was last written). | 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 | ||||
.Ar m | .Ar m | ||||
are both specified, then the modification and inode change times are | are both specified, then the modification and inode change times are | ||||
both compared. | both compared. | ||||
The inode change time comparison is useful in selecting files whose | The inode change time comparison is useful in selecting files whose | ||||
attributes were recently changed or selecting files which were recently | attributes were recently changed or selecting files which were recently | ||||
▲ Show 20 Lines • Show All 309 Lines • Show Last 20 Lines |