diff options
Diffstat (limited to 'usr.bin/tar/bsdtar.1')
| -rw-r--r-- | usr.bin/tar/bsdtar.1 | 29 |
1 files changed, 13 insertions, 16 deletions
diff --git a/usr.bin/tar/bsdtar.1 b/usr.bin/tar/bsdtar.1 index 7518a81..01c1ddd 100644 --- a/usr.bin/tar/bsdtar.1 +++ b/usr.bin/tar/bsdtar.1 @@ -28,7 +28,7 @@ .Dt BSDTAR 1 .Os .Sh NAME -.Nm bsdtar +.Nm tar .Nd manipulate tape archives .Sh SYNOPSIS .Nm @@ -123,7 +123,7 @@ In contrast, .Dl Nm Fl c Fl f Pa - Pa newfile Pa original.tar creates a new archive with only two entries. Similarly, -.Dl Nm Fl czf Pa - Fl F Cm pax Cm @ Ns Pa - +.Dl Nm Fl czf Pa - Fl -format Cm pax Cm @ Ns Pa - reads an archive from standard input (whose format will be determined automatically) and converts it into a gzip-compressed pax-format archive on stdout. @@ -148,7 +148,7 @@ Do not process files or directories that match the specified pattern. Note that exclusions take precedence over patterns or filenames specified on the command line. -.It Fl F Ar format +.It Fl -format Ar format ( Fl W Cm format Ns = Ns Ar format ) (c mode only) Use the specified format for the created archive. Supported formats include @@ -480,9 +480,9 @@ are available to improve compatibility with other tar implementations. .Sh SECURITY Certain security issues are common to many archiving programs, including .Nm . -In particular, carefully-crafted archives can request +In particular, carefully-crafted archives can request that .Nm -to extract files to locations outside of the target directory. +extract files to locations outside of the target directory. This can potentially be used to cause unwitting users to overwrite files they did not intend to overwrite. If the archive is being extracted by the superuser, any file @@ -576,17 +576,13 @@ The ustar and pax interchange file formats are defined by .St -p1003.1-2001 for the pax command. .Sh BUGS -The +POSIX and GNU violently disagree about the meaning of the .Fl l -and -.Fl o -options follow POSIX. -GNU tar's +option. +Because of the potential for disaster if someone expects +one behavior and gets the other, the .Fl l -and -.Fl o -options do not. -(This is, of course, a bug in GNU tar and not bsdtar.) +option is deliberately broken in this implementation. .Pp The .Fl C Pa dir @@ -619,7 +615,7 @@ and that generated by .Dl Nm Fl cf Pa - file | Nm gzip .Pp The default should be to read and write archives to the standard I/O paths, -but tradition dictates otherwise. +but tradition (and POSIX) dictates otherwise. .Pp The .Cm r @@ -655,7 +651,8 @@ option is specified. There needs to be better support for file selection on both create and extract. .Pp -There is not yet any support for multi-volume archives or sparse files. +There is not yet any support for multi-volume archives or for archiving +sparse files. .Pp Converting between dissimilar archive formats (such as tar and cpio) using the .Cm @ Ns Pa - |
