tar: warnings
1
1 3.9 Controlling Warning Messages
1 ================================
1
1 Sometimes, while performing the requested task, GNU 'tar' notices some
1 conditions that are not exactly errors, but which the user should be
1 aware of. When this happens, 'tar' issues a "warning message"
1 describing the condition. Warning messages are output to the standard
1 error and they do not affect the exit code of 'tar' command.
1
1 GNU 'tar' allows the user to suppress some or all of its warning
1 messages:
1
1 '--warning=KEYWORD'
1 Control display of the warning messages identified by KEYWORD. If
1 KEYWORD starts with the prefix 'no-', such messages are suppressed.
1 Otherwise, they are enabled.
1
1 Multiple '--warning' messages accumulate.
1
1 The tables below list allowed values for KEYWORD along with the
1 warning messages they control.
1
1 Keywords controlling 'tar' operation
1 ------------------------------------
1
1 all
1 Enable all warning messages. This is the default.
1 none
1 Disable all warning messages.
1 filename-with-nuls
1 '%s: file name read contains nul character'
1 alone-zero-block
1 'A lone zero block at %s'
1
1 Keywords applicable for 'tar --create'
1 --------------------------------------
1
1 cachedir
1 '%s: contains a cache directory tag %s; %s'
1 file-shrank
1 '%s: File shrank by %s bytes; padding with zeros'
1 xdev
1 '%s: file is on a different filesystem; not dumped'
1 file-ignored
1 '%s: Unknown file type; file ignored'
1 '%s: socket ignored'
1 '%s: door ignored'
1 file-unchanged
1 '%s: file is unchanged; not dumped'
1 ignore-archive
1 '%s: file is the archive; not dumped'
1 file-removed
1 '%s: File removed before we read it'
1 file-changed
1 '%s: file changed as we read it'
1 failed-read
1 Suppresses warnings about unreadable files or directories. This
1 keyword applies only if used together with the
1 '--ignore-failed-read' option. ⇒Ignore Failed Read.
1
1 Keywords applicable for 'tar --extract'
1 ---------------------------------------
1
1 existing-file
1 '%s: skipping existing file'
1 timestamp
1 '%s: implausibly old time stamp %s'
1 '%s: time stamp %s is %s s in the future'
1 contiguous-cast
1 'Extracting contiguous files as regular files'
1 symlink-cast
1 'Attempting extraction of symbolic links as hard links'
1 unknown-cast
1 '%s: Unknown file type '%c', extracted as normal file'
1 ignore-newer
1 'Current %s is newer or same age'
1 unknown-keyword
1 'Ignoring unknown extended header keyword '%s''
1 decompress-program
1 Controls verbose description of failures occurring when trying to
11 run alternative decompressor programs (⇒alternative
decompression programs). This warning is disabled by default
1 (unless '--verbose' is used). A common example of what you can get
1 when using this warning is:
1
1 $ tar --warning=decompress-program -x -f archive.Z
1 tar (child): cannot run compress: No such file or directory
1 tar (child): trying gzip
1
1 This means that 'tar' first tried to decompress 'archive.Z' using
1 'compress', and, when that failed, switched to 'gzip'.
1 record-size
1 'Record size = %lu blocks'
1
1 Keywords controlling incremental extraction:
1 --------------------------------------------
1
1 rename-directory
1 '%s: Directory has been renamed from %s'
1 '%s: Directory has been renamed'
1 new-directory
1 '%s: Directory is new'
1 xdev
1 '%s: directory is on a different device: not purging'
1 bad-dumpdir
1 'Malformed dumpdir: 'X' never used'
1