[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Sometimes, while performing the requested task, GNU tar
notices
some conditions that are not exactly errors, but which the user
should be aware of. When this happens, tar
issues a
warning message describing the condition. Warning messages
are output to the standard error and they do not affect the exit
code of tar
command.
GNU tar
allows the user to suppress some or all of its warning
messages:
Control display of the warning messages identified by keyword. If keyword starts with the prefix ‘no-’, such messages are suppressed. Otherwise, they are enabled.
Multiple ‘--warning’ options accumulate.
By default, GNU tar
enables all messages, except those that are
enabled in verbose mode (see section The ‘--verbose’ Option). See section Default Warning Settings, for details.
The subsections below discuss allowed values for keyword along with the warning messages they control.
3.9.1 Keywords controlling tar operation | Keywords applicable for tar --create .
| |
3.9.2 Keywords applicable for tar --create | ||
3.9.3 Keywords applicable for tar --extract | ||
3.9.4 Keywords controlling incremental extraction | ||
3.9.5 Warning Classes | Convenience keywords control multiple warnings. | |
3.9.6 Default Warning Settings | Default settings for warnings. |
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
tar
operationThese keywords control warnings that may appear in any GNU tar
operation mode:
‘file name read contains nul character’
‘%s: file name read contains nul character’
‘A lone zero block at %s’. Notice, that this warning is suppressed if ‘--ignore-zeros’ is in effect (see section Ignoring Blocks of Zeros).
‘Terminating zero blocks missing at %s’. This warning is suppressed if ‘--ignore-zeros’ is in effect (see section Ignoring Blocks of Zeros).
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
tar --create
The following keywords control messages that can be issued while creating archives.
‘%s: contains a cache directory tag %s; %s’
‘%s: File shrank by %s bytes; padding with zeros’
‘%s: file is on a different filesystem; not dumped’
‘%s: Unknown file type; file ignored’
‘%s: socket ignored’
‘%s: door ignored’
‘%s: file is unchanged; not dumped’
‘%s: archive cannot contain itself; not dumped’
‘%s: File removed before we read it’
‘%s: file changed as we read it’
Suppresses warnings about read failures, which can occur if files or directories are unreadable, or if they change while being read. This keyword applies only if used together with the ‘--ignore-failed-read’ option. See section Ignore Failed Read.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
tar --extract
The following keywords control warnings that can be issued during archive extraction.
‘%s: skipping existing file’
‘%s: implausibly old time stamp %s’
‘%s: time stamp %s is %s s in the future’
‘Extracting contiguous files as regular files’
‘Attempting extraction of symbolic links as hard links’, warning message ‘Attempting extraction of symbolic links as hard links’
‘%s: Unknown file type '%c', extracted as normal file’
‘Current %s is newer or same age’
‘Ignoring unknown extended header keyword '%s'’
Controls verbose description of failures occurring when trying to run alternative decompressor programs (see alternative decompression programs). This warning is disabled by default (unless ‘--verbose’ is used). A common example of what you can get when using this warning is:
$ tar --warning=decompress-program -x -f archive.Z tar (child): cannot run compress: No such file or directory tar (child): trying gzip
This means that tar
first tried to decompress
‘archive.Z’ using compress
, and, when that
failed, switched to gzip
.
‘Record size = %lu blocks’
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
These keywords control warnings that may appear when extracting from incremental archives.
‘%s: Directory has been renamed from %s’
‘%s: Directory has been renamed’
‘%s: Directory is new’
‘%s: directory is on a different device: not purging’
‘Malformed dumpdir: 'X' never used’
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
These convenience keywords define warning classes. When used, they affect several warnings at once.
Enable all warning messages.
Disable all warning messages.
A shorthand for all messages enabled when ‘--verbose’
(see section The ‘--verbose’ Option) is in effect. These are:
decompress-program
, existing-file
, new-directory
,
record-size
, rename-directory
.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
GNU tar
default settings correspond to:
--warning=all --warning=no-verbose --warning=no-missing-zero-blocks
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] |
This document was generated on August 23, 2023 using texi2html 5.0.