summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2009-09-08 10:27:57 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2009-09-08 10:27:57 +0300
commitcef4d5e83830763a1acd5d603fb62a356df27299 (patch)
treeb54fc346e5d728c40909fa55e924586ce4d55f1a /doc
parentba954ea1e1576505f2e0ce3efdbed9025739121d (diff)
downloadtar-cef4d5e83830763a1acd5d603fb62a356df27299.tar.gz
Automatic detection of seekable archives.
* src/buffer.c (guess_seekable_archive): New function. (_open_archive): Call guess_seekable_archive for archives open for reading. (new_volume): Likewise. * src/common.h (seek_option): New global. * src/tar.c (options): New option --no-seek. (parse_opt): --seek and --no-seek set seek_option, not seekable_archive. (decode_options): Initialize seek_option to -1. * NEWS: Update. * doc/tar.texi: Update.
Diffstat (limited to 'doc')
-rw-r--r--doc/tar.texi12
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/tar.texi b/doc/tar.texi
index 7154dfd0..e6093685 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -2950,6 +2950,14 @@ When extracting an archive, subtract the user's umask from files from
the permissions specified in the archive. This is the default behavior
for ordinary users.
+@opsummary{no-seek}
+@item --no-seek
+
+The archive media does not support seeks to arbitrary
+locations. Usually @command{tar} determines automatically whether
+the archive can be seeked or not. Use this option to disable this
+mechanism.
+
@opsummary{no-unquote}
@item --no-unquote
Treat all input file or member names literally, do not interpret
@@ -3180,7 +3188,9 @@ effect only for ordinary users. @xref{Attributes}.
Assume that the archive media supports seeks to arbitrary
locations. Usually @command{tar} determines automatically whether
the archive can be seeked or not. This option is intended for use
-in cases when such recognition fails.
+in cases when such recognition fails. It takes effect only if the
+archive is open for reading (e.g. with @option{--list} or
+@option{--extract} options).
@opsummary{show-defaults}
@item --show-defaults