diff options
Diffstat (limited to 'doc/ztest.1')
| -rw-r--r-- | doc/ztest.1 | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/doc/ztest.1 b/doc/ztest.1 index 73f3f8c..7ecb7c5 100644 --- a/doc/ztest.1 +++ b/doc/ztest.1 @@ -1,19 +1,19 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16. -.TH ZTEST "1" "January 2023" "zutils 1.12" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.2. +.TH ZTEST "1" "December 2023" "zutils 1.13-rc1" "User Commands" .SH NAME -ztest \- verify the integrity of compressed files +ztest \- check the integrity of compressed files .SH SYNOPSIS .B ztest [\fI\,options\/\fR] [\fI\,files\/\fR] .SH DESCRIPTION -ztest verifies the integrity of the compressed files specified. It +ztest checks the integrity of the compressed files specified. It also warns if an uncompressed file has a compressed file name extension, or if a compressed file has a wrong compressed extension. Uncompressed files are otherwise ignored. If a file is specified as '\-', the integrity of -compressed data read from standard input is verified. Data read from +compressed data read from standard input is checked. Data read from standard input must be all in the same compressed format. If a file fails to decompress, does not exist, can't be opened, or is a terminal, ztest -continues verifying the rest of the files. A final diagnostic is shown at +continues testing the rest of the files. A final diagnostic is shown at verbosity level 1 or higher if any file fails the test when testing multiple files. .PP @@ -22,15 +22,15 @@ working directory, and nonrecursive searches read standard input. .PP The formats supported are bzip2, gzip, lzip, xz, and zstd. .PP -Note that error detection in the xz format is broken. First, some xz -files lack integrity information. Second, not all xz decompressors can -verify the integrity of all xz files. Third, section 2.1.1.2 'Stream -Flags' of the xz format specification allows xz decompressors to produce -garbage output without issuing any warning. Therefore, xz files can't -always be verified as reliably as files in the other formats can. +Note that error detection in the xz format is broken. First, some xz files +lack integrity information. Second, not all xz decompressors can check the +integrity of all xz files. Third, section 2.1.1.2 'Stream Flags' of the +xz format specification allows xz decompressors to produce garbage output +without issuing any warning. Therefore, xz files can't always be checked as +reliably as files in the other formats can. .PP -Exit status is 0 if all compressed files verify OK, 1 if environmental -problems (file not found, invalid command line options, I/O errors, etc), +Exit status is 0 if all compressed files check OK, 1 if environmental +problems (file not found, invalid command\-line options, I/O errors, etc), 2 if any compressed file is corrupt or invalid, or if any file has an incorrect file name extension. .SH OPTIONS |