pax.1 (139969) | pax.1 (140353) |
---|---|
1.\"- 2.\" Copyright (c) 1992 Keith Muller. 3.\" Copyright (c) 1992, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" Keith Muller of the University of California, San Diego. 8.\" --- 17 unchanged lines hidden (view full) --- 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.\" @(#)pax.1 8.4 (Berkeley) 4/18/94 | 1.\"- 2.\" Copyright (c) 1992 Keith Muller. 3.\" Copyright (c) 1992, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" Keith Muller of the University of California, San Diego. 8.\" --- 17 unchanged lines hidden (view full) --- 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.\" @(#)pax.1 8.4 (Berkeley) 4/18/94 |
34.\" $FreeBSD: head/bin/pax/pax.1 139969 2005-01-10 08:39:26Z imp $ | 34.\" $FreeBSD: head/bin/pax/pax.1 140353 2005-01-16 16:41:59Z ru $ |
35.\" 36.Dd July 3, 2004 37.Dt PAX 1 38.Os 39.Sh NAME 40.Nm pax 41.Nd read and write file archives and copy directory hierarchies 42.Sh SYNOPSIS --- 1001 unchanged lines hidden (view full) --- 1044When one or both of the 1045.Fl u 1046or 1047.Fl D 1048options are specified along with the 1049.Fl n 1050option, a file is not considered selected unless it is newer 1051than the file to which it is compared. | 35.\" 36.Dd July 3, 2004 37.Dt PAX 1 38.Os 39.Sh NAME 40.Nm pax 41.Nd read and write file archives and copy directory hierarchies 42.Sh SYNOPSIS --- 1001 unchanged lines hidden (view full) --- 1044When one or both of the 1045.Fl u 1046or 1047.Fl D 1048options are specified along with the 1049.Fl n 1050option, a file is not considered selected unless it is newer 1051than the file to which it is compared. |
1052.Sh EXIT STATUS 1053The 1054.Nm 1055utility will exit with one of the following values: 1056.Bl -tag -width 2n 1057.It 0 1058All files were processed successfully. 1059.It 1 1060An error occurred. 1061.El |
|
1052.Sh EXAMPLES 1053The command: 1054.Dl "pax -w -f /dev/sa0 ." 1055copies the contents of the current directory to the device 1056.Pa /dev/sa0 . 1057.Pp 1058The command: 1059.Dl pax -v -f filename --- 34 unchanged lines hidden (view full) --- 1094.Pp 1095The command: 1096.Dl pax -r -w -v -Y -Z home /backup 1097will update (and list) only those files in the destination directory 1098.Pa /backup 1099which are older (less recent inode change or file modification times) than 1100files with the same name found in the source file tree 1101.Pa home . | 1062.Sh EXAMPLES 1063The command: 1064.Dl "pax -w -f /dev/sa0 ." 1065copies the contents of the current directory to the device 1066.Pa /dev/sa0 . 1067.Pp 1068The command: 1069.Dl pax -v -f filename --- 34 unchanged lines hidden (view full) --- 1104.Pp 1105The command: 1106.Dl pax -r -w -v -Y -Z home /backup 1107will update (and list) only those files in the destination directory 1108.Pa /backup 1109which are older (less recent inode change or file modification times) than 1110files with the same name found in the source file tree 1111.Pa home . |
1112.Sh DIAGNOSTICS 1113Whenever 1114.Nm 1115cannot create a file or a link when reading an archive or cannot 1116find a file when writing an archive, or cannot preserve the user ID, 1117group ID, or file mode when the 1118.Fl p 1119option is specified, a diagnostic message is written to 1120.Dv standard error 1121and a non-zero exit status will be returned, but processing will continue. 1122In the case where pax cannot create a link to a file, 1123.Nm 1124will not create a second copy of the file. 1125.Pp 1126If the extraction of a file from an archive is prematurely terminated by 1127a signal or error, 1128.Nm 1129may have only partially extracted a file the user wanted. 1130Additionally, the file modes of extracted files and directories 1131may have incorrect file bits, and the modification and access times may be 1132wrong. 1133.Pp 1134If the creation of an archive is prematurely terminated by a signal or error, 1135.Nm 1136may have only partially created the archive which may violate the specific 1137archive format specification. 1138.Pp 1139If while doing a 1140.Em copy , 1141.Nm 1142detects a file is about to overwrite itself, the file is not copied, 1143a diagnostic message is written to 1144.Dv standard error 1145and when 1146.Nm 1147completes it will exit with a non-zero exit status. 1148.Sh SEE ALSO 1149.Xr cpio 1 , 1150.Xr tar 1 |
|
1102.Sh STANDARDS 1103The 1104.Nm 1105utility is a superset of the 1106.St -p1003.2 1107standard. 1108The options 1109.Fl z , --- 15 unchanged lines hidden (view full) --- 1125.Ar tar , 1126and the flawed archive handling during 1127.Ar list 1128and 1129.Ar read 1130operations are extensions to the 1131.Tn POSIX 1132standard. | 1151.Sh STANDARDS 1152The 1153.Nm 1154utility is a superset of the 1155.St -p1003.2 1156standard. 1157The options 1158.Fl z , --- 15 unchanged lines hidden (view full) --- 1174.Ar tar , 1175and the flawed archive handling during 1176.Ar list 1177and 1178.Ar read 1179operations are extensions to the 1180.Tn POSIX 1181standard. |
1133.Sh SEE ALSO 1134.Xr cpio 1 , 1135.Xr tar 1 | |
1136.Sh HISTORY 1137The 1138.Nm 1139utility appeared in 1140.Bx 4.4 . 1141.Sh AUTHORS 1142.An Keith Muller 1143at the University of California, San Diego | 1182.Sh HISTORY 1183The 1184.Nm 1185utility appeared in 1186.Bx 4.4 . 1187.Sh AUTHORS 1188.An Keith Muller 1189at the University of California, San Diego |
1144.Sh DIAGNOSTICS 1145The 1146.Nm 1147utility will exit with one of the following values: 1148.Bl -tag -width 2n 1149.It 0 1150All files were processed successfully. 1151.It 1 1152An error occurred. 1153.El 1154.Pp 1155Whenever 1156.Nm 1157cannot create a file or a link when reading an archive or cannot 1158find a file when writing an archive, or cannot preserve the user ID, 1159group ID, or file mode when the 1160.Fl p 1161option is specified, a diagnostic message is written to 1162.Dv standard error 1163and a non-zero exit status will be returned, but processing will continue. 1164In the case where pax cannot create a link to a file, 1165.Nm 1166will not create a second copy of the file. 1167.Pp 1168If the extraction of a file from an archive is prematurely terminated by 1169a signal or error, 1170.Nm 1171may have only partially extracted a file the user wanted. 1172Additionally, the file modes of extracted files and directories 1173may have incorrect file bits, and the modification and access times may be 1174wrong. 1175.Pp 1176If the creation of an archive is prematurely terminated by a signal or error, 1177.Nm 1178may have only partially created the archive which may violate the specific 1179archive format specification. 1180.Pp 1181If while doing a 1182.Em copy , 1183.Nm 1184detects a file is about to overwrite itself, the file is not copied, 1185a diagnostic message is written to 1186.Dv standard error 1187and when 1188.Nm 1189completes it will exit with a non-zero exit status. | |
1190.Sh BUGS 1191The 1192.Nm 1193utility does not recognize multibyte characters. | 1190.Sh BUGS 1191The 1192.Nm 1193utility does not recognize multibyte characters. |