English Language flag
// Log In ​
// CVSweb ​
Project: FreeWRT
// Summary ​ // Activity ​ // Search ​ // Tracker ​ // Lists ​ // News ​ // SCM ​ // Wiki ​
// Access Source Code ​ // Browse Source Code ​

SCM Repository

project home | /[freewrt]/branches/freewrt_1_0/tools/paxmirabilis/src/pax.1
ViewVC logotype

Diff of /branches/freewrt_1_0/tools/paxmirabilis/src/pax.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 3815 by tg, Tue Jun 5 14:52:44 2007 UTC revision 3816 by tg, Wed Oct 29 17:58:40 2008 UTC
# Line 1  Line 1 
1  .\"     $MirOS: src/bin/pax/pax.1,v 1.7 2006/07/21 17:34:59 tg Exp $  .\"     $MirOS: src/bin/pax/pax.1,v 1.9 2008/03/14 17:05:06 tg Exp $
2  .\"     $OpenBSD: pax.1,v 1.48 2006/05/12 11:55:58 jmc Exp $  .\"     $OpenBSD: pax.1,v 1.52 2007/05/31 19:19:15 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, 2006 Thorsten Glaser.  .\" Copyright (c) 2005, 2006 Thorsten Glaser.
# Line 36  Line 36 
36  .\"  .\"
37  .\"     @(#)pax.1       8.4 (Berkeley) 4/18/94  .\"     @(#)pax.1       8.4 (Berkeley) 4/18/94
38  .\"  .\"
39  .Dd July 21, 2006  .\"-
40  .Dt PAX 1  .\" Try to make GNU groff and AT&T nroff more compatible
41  .Os MirBSD  .\" * ` generates ‘ in groff, so use \`
42  .\" for portability  .\" * ' generates ’ in groff, \' generates ´, so use \*(aq
43    .\" * - generates ‐ in groff, \- generates −, fixed in tmac/mdoc/doc-groff
44    .\"   thus use - for hyphens and \- for minus signs and option dashes
45    .\" * ~ is size-reduced and placed atop in groff, so use \*(TI
46    .\" * ^ is size-reduced and placed atop in groff, so use \*(ha
47    .\" * \(en does not work in nroff, so use \*(en
48    .ie \n(.g \{\
49    .       ds aq \(aq
50    .       ds TI \(ti
51    .       ds ha \(ha
52    .       ds en \(en
53    .\}
54    .el \{\
55    .       ds aq '
56    .       ds TI ~
57    .       ds ha ^
58    .       ds en \(em
59    .\}
60    .\"
61    .\" Implement .Dd with the Mdocdate RCS keyword
62    .rn Dd xD
63    .de Dd
64    .ie \\$1$Mdocdate: \{\
65    .       xD \\$2 \\$3, \\$4
66    .\}
67    .el .xD \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
68    ..
69    .\"
70    .\" .Dd must come before definition of .Mx, because when called
71    .\" with -mandoc, it might implement .Mx itself, but we want to
72    .\" use our own definition. And .Dd must come *first*, always.
73    .Dd $Mdocdate: March 14 2008 $
74    .\"
75    .\" Implement .Mx (MirBSD)
76  .de Mx  .de Mx
77  .nr cF \\n(.f  .nr cF \\n(.f
78  .nr cZ \\n(.s  .nr cZ \\n(.s
79  .ds aa \&\f\\n(cF\s\\n(cZ  .ds aa \&\f\\n(cF\s\\n(cZ
80  .if \\n(aC==0 \{\  .if \\n(aC==0 \{\
81  .       if \\n(.$==0 \&MirOS\\*(aa  .       ie \\n(.$==0 \&MirOS\\*(aa
82    .       el .aV \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
83  .\}  .\}
84  .if \\n(.$==1 \{\  .if \\n(aC>\\n(aP \{\
85  .       if "\\$1"."  \&MirOS\\$1\\*(aa  .       nr aP \\n(aP+1
86  .       if "\\$1","  \&MirOS\\$1\\*(aa  .       ie \\n(C\\n(aP==2 \{\
87    .               as b1 \&MirOS\ #\&\\*(A\\n(aP\\*(aa
88    .               ie \\n(aC>\\n(aP \{\
89    .                       nr aP \\n(aP+1
90    .                       nR
91    .               \}
92    .               el .aZ
93    .       \}
94    .       el \{\
95    .               as b1 \&MirOS\\*(aa
96    .               nR
97    .       \}
98  .\}  .\}
99  ..  ..
100    .Dt PAX 1
101    .Os MirBSD
102  .Sh NAME  .Sh NAME
103  .Nm pax  .Nm pax
104  .Nd read and write file archives and copy directory hierarchies  .Nd read and write file archives and copy directory hierarchies
105  .Sh SYNOPSIS  .Sh SYNOPSIS
106  .Bk -words  .Bk -words
107  .Nm pax  .Nm pax
108  .Op Fl 0cdOnvz  .Op Fl 0cdnOvz
109  .Op Fl E Ar limit  .Op Fl E Ar limit
110  .Op Fl f Ar archive  .Op Fl f Ar archive
111  .Op Fl G Ar group  .Op Fl G Ar group
# Line 68  Line 115 
115  .Op Ar pattern ...  .Op Ar pattern ...
116  .Nm pax  .Nm pax
117  .Fl r  .Fl r
118  .Op Fl 0cDdikOnuvYZz  .Op Fl 0cDdiknOuvYZz
119  .Op Fl E Ar limit  .Op Fl E Ar limit
120  .Op Fl f Ar archive  .Op Fl f Ar archive
121  .Op Fl G Ar group  .Op Fl G Ar group
# Line 85  Line 132 
132  .Op Fl b Ar blocksize  .Op Fl b Ar blocksize
133  .Op Fl f Ar archive  .Op Fl f Ar archive
134  .Op Fl G Ar group  .Op Fl G Ar group
135  .Op Fl M Ar value  .Op Fl M Ar flag
136  .Op Fl o Ar options  .Op Fl o Ar options
137  .Op Fl s Ar replstr  .Op Fl s Ar replstr
138  .Op Fl T Ar range  .Op Fl T Ar range
# Line 93  Line 140 
140  .Op Fl x Ar format  .Op Fl x Ar format
141  .Op Ar file ...  .Op Ar file ...
142  .Nm pax  .Nm pax
143  .Fl r  .Fl rw
 .Fl w  
144  .Op Fl 0DdHikLlnOPtuvXYZ  .Op Fl 0DdHikLlnOPtuvXYZ
145  .Op Fl G Ar group  .Op Fl G Ar group
146  .Op Fl p Ar string  .Op Fl p Ar string
# Line 166  When a Line 212  When a
212  .Ar file  .Ar file
213  operand is also a directory, the entire file hierarchy rooted  operand is also a directory, the entire file hierarchy rooted
214  at that directory will be included.  at that directory will be included.
215  .It Fl r Fl w  .It Fl rw
216  .Em Copy .  .Em Copy .
217  .Nm  .Nm
218  copies the  copies the
# Line 473  mode Line 519  mode
519  .Pq Fl r Fl w ,  .Pq Fl r Fl w ,
520  hard links are made between the source and destination file hierarchies  hard links are made between the source and destination file hierarchies
521  whenever possible.  whenever possible.
522  .It Fl M Ar value  .It Fl M Ar flag
523  Configure the archive normaliser.  Configure the archive normaliser.
524  .Ar value  .Ar flag
525  is either a number or a string, optionally prefixed with  is either a number or a string, optionally prefixed with
526  .Dq no-  .Dq no-
527  to turn the flag off.  to turn it off.
528  See  See
529  .Xr cpio 1  .Xr cpio 1
530  for a comprehensive list and compatibility notes.  for a comprehensive list and compatibility notes.
# Line 704  The optional trailing Line 750  The optional trailing
750  will cause the final result of a successful substitution to be written to  will cause the final result of a successful substitution to be written to
751  standard error in the following format:  standard error in the following format:
752  .Pp  .Pp
753  .D1 Em original-pathname No >> Em new-pathname  .D1 Em original-pathname No \*(Gt\*(Gt Em new-pathname
754  .Pp  .Pp
755  File or archive member names that substitute to the empty string  File or archive member names that substitute to the empty string
756  are not selected and will be skipped.  are not selected and will be skipped.
# Line 906  Specify the output archive format, with Line 952  Specify the output archive format, with
952  .Nm  .Nm
953  currently supports the following formats:  currently supports the following formats:
954  .Bl -tag -width "sv4cpio"  .Bl -tag -width "sv4cpio"
955  .It Cm cpio  .It Cm bcpio
956  The extended cpio interchange format specified in the  The old binary cpio format.
 .St -p1003.2  
 standard.  
957  The default blocksize for this format is 5120 bytes.  The default blocksize for this format is 5120 bytes.
958    This format is not very portable and should not be used when other formats
959    are available.
960  Inode and device information about a file (used for detecting file hard links  Inode and device information about a file (used for detecting file hard links
961  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
962  .Nm  .Nm
963  and is repaired.  and is repaired.
964  .It Cm bcpio  .It Cm cpio
965  The old binary cpio format.  The extended cpio interchange format specified in the
966    .St -p1003.2
967    standard.
968  The default blocksize for this format is 5120 bytes.  The default blocksize for this format is 5120 bytes.
 This format is not very portable and should not be used when other formats  
 are available.  
969  Inode and device information about a file (used for detecting file hard links  Inode and device information about a file (used for detecting file hard links
970  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
971  .Nm  .Nm
# Line 1103  $ cd olddir Line 1149  $ cd olddir
1149  $ pax -rw . ../newdir  $ pax -rw . ../newdir
1150  .Ed  .Ed
1151  .Pp  .Pp
1152  Read the archive  Extract files from the archive
1153  .Pa a.pax ,  .Pa a.pax .
1154  with all files rooted in  Files rooted in
1155  .Pa /usr  .Pa /usr
1156  into the archive extracted relative to the current directory:  are extracted relative to the current working directory;
1157    all other files are extracted to their unmodified path.
1158  .Pp  .Pp
1159  .Dl $ pax -r -s ',^//*usr//*,,' -f a.pax  .Dl $ pax -r -s ',^/usr/,,' -f a.pax
1160  .Pp  .Pp
1161  This can be used to interactively select the files to copy from the  This can be used to interactively select the files to copy from the
1162  current directory to  current directory to
# Line 1185  completes it will exit with a non-zero e Line 1232  completes it will exit with a non-zero e
1232  .Sh STANDARDS  .Sh STANDARDS
1233  The  The
1234  .Nm  .Nm
1235  utility is a superset of the  utility is compliant with the
1236  .St -p1003.2  .St -p1003.1-2004
1237  standard.  specification.
1238  The options  .Pp
1239  .Fl 0 ,  The flags
1240  .Fl B ,  .Op Fl 0BDEGHLMOPTUYZz ,
 .Fl D ,  
 .Fl E ,  
 .Fl G ,  
 .Fl H ,  
 .Fl L ,  
 .Fl M ,  
 .Fl O ,  
 .Fl P ,  
 .Fl T ,  
 .Fl U ,  
 .Fl Y ,  
 .Fl Z ,  
1241  the archive formats  the archive formats
1242  .Em bcpio ,  .Em bcpio ,
1243  .Em sv4cpio ,  .Em sv4cpio ,
# Line 1212  and the flawed archive handling during Line 1247  and the flawed archive handling during
1247  .Em list  .Em list
1248  and  and
1249  .Em read  .Em read
1250  operations are extensions to the  operations
1251  .Tn POSIX  are extensions to that specification.
 standard.  
1252  .Sh AUTHORS  .Sh AUTHORS
1253  Keith Muller at the University of California, San Diego.  Keith Muller at the University of California, San Diego.
1254  .Pp  .Pp
Legend:
Removed from v.3815  
changed lines
  Added in v.3816
root@freewrt.org:443
 ViewVC Help
Powered by ViewVC 1.1.20