| 1 |
.\" $MirOS: src/bin/pax/pax.1,v 1.6 2006/06/23 23:03:56 tg Exp $ |
.\" $MirOS: src/bin/pax/pax.1,v 1.7 2006/07/21 17:34:59 tg Exp $ |
| 2 |
.\" $OpenBSD: pax.1,v 1.48 2006/05/12 11:55:58 jmc Exp $ |
.\" $OpenBSD: pax.1,v 1.48 2006/05/12 11:55:58 jmc Exp $ |
| 3 |
.\" $NetBSD: pax.1,v 1.3 1995/03/21 09:07:37 cgd Exp $ |
.\" $NetBSD: pax.1,v 1.3 1995/03/21 09:07:37 cgd Exp $ |
| 4 |
.\" |
.\" |
| 5 |
.\" Copyright (c) 2005 Thorsten Glaser <tg@66h.42h.de> |
.\" Copyright (c) 2005, 2006 Thorsten Glaser. |
| 6 |
.\" Copyright (c) 1992 Keith Muller. |
.\" Copyright (c) 1992 Keith Muller. |
| 7 |
.\" Copyright (c) 1992, 1993 |
.\" Copyright (c) 1992, 1993 |
| 8 |
.\" The Regents of the University of California. All rights reserved. |
.\" The Regents of the University of California. All rights reserved. |
| 36 |
.\" |
.\" |
| 37 |
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94 |
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94 |
| 38 |
.\" |
.\" |
| 39 |
.Dd April 18, 1994 |
.Dd July 21, 2006 |
| 40 |
.Dt PAX 1 |
.Dt PAX 1 |
| 41 |
.Os |
.Os MirBSD |
| 42 |
|
.\" for portability |
| 43 |
|
.de Mx |
| 44 |
|
.nr cF \\n(.f |
| 45 |
|
.nr cZ \\n(.s |
| 46 |
|
.ds aa \&\f\\n(cF\s\\n(cZ |
| 47 |
|
.if \\n(aC==0 \{\ |
| 48 |
|
. if \\n(.$==0 \&MirOS\\*(aa |
| 49 |
|
.\} |
| 50 |
|
.if \\n(.$==1 \{\ |
| 51 |
|
. if "\\$1"." \&MirOS\\$1\\*(aa |
| 52 |
|
. if "\\$1"," \&MirOS\\$1\\*(aa |
| 53 |
|
.\} |
| 54 |
|
.. |
| 55 |
.Sh NAME |
.Sh NAME |
| 56 |
.Nm pax |
.Nm pax |
| 57 |
.Nd read and write file archives and copy directory hierarchies |
.Nd read and write file archives and copy directory hierarchies |
| 85 |
.Op Fl b Ar blocksize |
.Op Fl b Ar blocksize |
| 86 |
.Op Fl f Ar archive |
.Op Fl f Ar archive |
| 87 |
.Op Fl G Ar group |
.Op Fl G Ar group |
| 88 |
|
.Op Fl M Ar value |
| 89 |
.Op Fl o Ar options |
.Op Fl o Ar options |
| 90 |
.Op Fl s Ar replstr |
.Op Fl s Ar replstr |
| 91 |
.Op Fl T Ar range |
.Op Fl T Ar range |
| 473 |
.Pq Fl r Fl w , |
.Pq Fl r Fl w , |
| 474 |
hard links are made between the source and destination file hierarchies |
hard links are made between the source and destination file hierarchies |
| 475 |
whenever possible. |
whenever possible. |
| 476 |
|
.It Fl M Ar value |
| 477 |
|
Configure the archive normaliser. |
| 478 |
|
.Ar value |
| 479 |
|
is either a number or a string, optionally prefixed with |
| 480 |
|
.Dq no- |
| 481 |
|
to turn the flag off. |
| 482 |
|
See |
| 483 |
|
.Xr cpio 1 |
| 484 |
|
for a comprehensive list and compatibility notes. |
| 485 |
|
.Pp |
| 486 |
|
.Bl -tag -width xxxxxx -compact |
| 487 |
|
.It Ar inodes |
| 488 |
|
0x0001: Serialise inodes, zero device info. |
| 489 |
|
.It Ar links |
| 490 |
|
0x0002: Store content of hard links only once. |
| 491 |
|
.It Ar mtime |
| 492 |
|
0x0004: Zero out the file modification time. |
| 493 |
|
.It Ar uidgid |
| 494 |
|
0x0008: Set owner to 0:0 (root:wheel). |
| 495 |
|
.El |
| 496 |
|
.Pp |
| 497 |
|
This option is only implemented for the cpio, sv4cpio, |
| 498 |
|
sv4crc, and ustar file format writing routines. |
| 499 |
|
For the ustar format, the |
| 500 |
|
.Ar inodes |
| 501 |
|
and |
| 502 |
|
.Ar links |
| 503 |
|
specifiers are ignored. |
| 504 |
|
TODO: The |
| 505 |
|
.Nm pax |
| 506 |
|
frontend should be using the |
| 507 |
|
.Fl o |
| 508 |
|
option for handling this feature instead. |
| 509 |
.It Fl n |
.It Fl n |
| 510 |
Select the first archive member that matches each |
Select the first archive member that matches each |
| 511 |
.Ar pattern |
.Ar pattern |
| 924 |
by this format), which may be truncated by this format, is detected by |
by this format), which may be truncated by this format, is detected by |
| 925 |
.Nm |
.Nm |
| 926 |
and is repaired. |
and is repaired. |
|
.It Cm dist |
|
|
Anonymised version of the extended cpio interchange format specified in the |
|
|
.St -p1003.2 |
|
|
standard. |
|
|
The default blocksize for this format is 512 bytes. |
|
|
Inode and device information about a file is anonymised, and the UID and GID |
|
|
information is set to zero. |
|
|
The content of hardlinked files is only stored once in the archive. |
|
| 927 |
.It Cm sv4cpio |
.It Cm sv4cpio |
| 928 |
The System V release 4 cpio. |
The System V release 4 cpio. |
| 929 |
The default blocksize for this format is 5120 bytes. |
The default blocksize for this format is 5120 bytes. |
| 965 |
The default blocksize for this format is 10240 bytes. |
The default blocksize for this format is 10240 bytes. |
| 966 |
Filenames stored by this format must be 100 characters or less in length; |
Filenames stored by this format must be 100 characters or less in length; |
| 967 |
the total pathname must be 255 characters or less. |
the total pathname must be 255 characters or less. |
|
.It Cm v4norm |
|
|
Normalised System V release 4 cpio with file CRC checksums. |
|
|
The default blocksize for this format is 512 bytes. |
|
|
The files' ownerships (UID and GID) as well as modification times are |
|
|
set to 0 unconditionally; inode information is serialised and the |
|
|
major:minor of the device the file resided on is anonymised. |
|
|
As an added bonus, this format stores the file content of hard links |
|
|
only once (in contrast to cpio/sv4cpio/sv4crc, which store it with |
|
|
every instance of the multiple-linked file). |
|
|
.It Cm v4root |
|
|
Anonymised System V release 4 cpio with file CRC checksums. |
|
|
The default blocksize for this format is 512 bytes. |
|
|
The files' ownerships (UID and GID) are |
|
|
set to 0 unconditionally; inode information is serialised |
|
|
and device information anonymised. |
|
|
The modification times are however retained. |
|
|
As an added bonus, this format stores the file content of hard links |
|
|
only once (in contrast to cpio/sv4cpio/sv4crc, which store it with |
|
|
every instance of the multiple-linked file). |
|
| 968 |
.El |
.El |
| 969 |
.Pp |
.Pp |
| 970 |
.Nm |
.Nm |
| 1196 |
.Fl G , |
.Fl G , |
| 1197 |
.Fl H , |
.Fl H , |
| 1198 |
.Fl L , |
.Fl L , |
| 1199 |
|
.Fl M , |
| 1200 |
.Fl O , |
.Fl O , |
| 1201 |
.Fl P , |
.Fl P , |
| 1202 |
.Fl T , |
.Fl T , |
| 1217 |
standard. |
standard. |
| 1218 |
.Sh AUTHORS |
.Sh AUTHORS |
| 1219 |
Keith Muller at the University of California, San Diego. |
Keith Muller at the University of California, San Diego. |
| 1220 |
|
.Pp |
| 1221 |
|
.Mx |
| 1222 |
|
extensions by |
| 1223 |
|
.An Thorsten Glaser Aq tg@mirbsd.de . |