diff options
Diffstat (limited to 'doc/zutils.info')
| -rw-r--r-- | doc/zutils.info | 125 |
1 files changed, 86 insertions, 39 deletions
diff --git a/doc/zutils.info b/doc/zutils.info index 11ea41a..bf99e2d 100644 --- a/doc/zutils.info +++ b/doc/zutils.info @@ -12,7 +12,7 @@ File: zutils.info, Node: Top, Next: Introduction, Up: (dir) Zutils Manual ************* -This manual is for Zutils (version 1.7, 13 February 2018). +This manual is for Zutils (version 1.8, 1 January 2019). * Menu: @@ -29,7 +29,7 @@ This manual is for Zutils (version 1.7, 13 February 2018). * Concept index:: Index of concepts - Copyright (C) 2009-2018 Antonio Diaz Diaz. + Copyright (C) 2009-2019 Antonio Diaz Diaz. This manual is free documentation: you have unlimited permission to copy, distribute and modify it. @@ -50,8 +50,8 @@ are created. C++ programs. In particular the '--recursive' option is very efficient in those utilities supporting it. -The provided utilities are zcat, zcmp, zdiff, zgrep, ztest and zupdate. -The supported formats are bzip2, gzip, lzip and xz. +The utilities provided are zcat, zcmp, zdiff, zgrep, ztest and zupdate. +The formats supported are bzip2, gzip, lzip and xz. Zutils uses external compressors. The compressor to be used for each format is configurable at runtime. @@ -110,7 +110,8 @@ described here. '-V' '--version' - Print the version number on the standard output and exit. + Print the version number on the standard output and exit. This + version number should be included in all bug reports. '-M FORMAT_LIST' '--format=FORMAT_LIST' @@ -190,12 +191,17 @@ File: zutils.info, Node: Zcat, Next: Zcmp, Prev: The zutilsrc file, Up: Top zcat copies each given file to standard output. If any given file is compressed, its decompressed content is used. If a given file does not exist, and its name does not end with one of the known extensions, zcat -tries the compressed file names corresponding to the supported formats. +tries the compressed file names corresponding to the formats supported. +If a file fails to decompress, zcat continues copying the rest of the +files. - If no files are specified, or if a file is specified as '-', data -are read from standard input, decompressed if needed, and sent to -standard output. Data read from standard input must be of the same type; -all uncompressed or all in the same compression format. + If a file is specified as '-', data are read from standard input, +decompressed if needed, and sent to standard output. Data read from +standard input must be of the same type; all uncompressed or all in the +same compression format. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zcat is: @@ -240,7 +246,14 @@ Exit status is 0 if no errors occurred, non-zero otherwise. '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-s' '--squeeze-blank' @@ -459,12 +472,16 @@ on any combination of compressed and uncompressed files. If any given file is compressed, its decompressed content is used. If a given file does not exist, and its name does not end with one of the known extensions, zgrep tries the compressed file names corresponding to the -supported formats. +formats supported. If a file fails to decompress, zgrep continues +searching the rest of the files. - If no files are specified, or if a file is specified as '-', data -are read from standard input, decompressed if needed, and fed to grep. -Data read from standard input must be of the same type; all uncompressed -or all in the same compression format. + If a file is specified as '-', data are read from standard input, +decompressed if needed, and fed to grep. Data read from standard input +must be of the same type; all uncompressed or all in the same +compression format. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. The format for running zgrep is: @@ -573,7 +590,14 @@ grep program used supports them): '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-s' '--no-messages' @@ -602,10 +626,14 @@ File: zutils.info, Node: Ztest, Next: Zupdate, Prev: Zgrep, Up: Top ******* ztest verifies the integrity of the specified compressed files. -Uncompressed files are ignored. If no files are specified, or if a file -is specified as '-', the integrity of compressed data read from -standard input is verified. Data read from standard input must be all in -the same compression format. +Uncompressed files are ignored. If a file is specified as '-', the +integrity of compressed data read from standard input is verified. Data +read from standard input must be all in the same compression format. If +a file fails to decompress, ztest continues verifying the rest of the +files. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches read standard input. Note that error detection in the xz format is broken. First, some xz files lack integrity information. Second, not all xz decompressors can @@ -640,7 +668,14 @@ environmental problems (file not found, invalid flags, I/O errors, etc), '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-v' '--verbose' @@ -658,9 +693,14 @@ zupdate recompresses files from bzip2, gzip, and xz formats to lzip format. Each original is compared with the new file and then deleted. Only regular files with standard file name extensions are recompressed, other files are ignored. Compressed files are decompressed and then -recompressed on the fly; no temporary files are created. The lzip format -is chosen as destination because it is by far the most appropriate for -long-term data archiving. +recompressed on the fly; no temporary files are created. If an error +happens while recompressing a file, zupdate exits immediately without +recompressing the rest of the files. The lzip format is chosen as +destination because it is the most appropriate for long-term data +archiving. + + If no files are specified, recursive searches examine the current +working directory, and nonrecursive searches do nothing. If the lzip compressed version of a file already exists, the file is skipped unless the '--force' option is given. In this case, if the @@ -679,7 +719,7 @@ files produced have the extensions '.lz' or '.tar.lz'. Recompressing a file is much like copying or moving it; therefore zupdate preserves the access and modification dates, permissions, and, -when possible, ownership of the file just as "cp -p" does. (If the user +when possible, ownership of the file just as 'cp -p' does. (If the user ID or the group ID can't be duplicated, the file permission bits S_ISUID and S_ISGID are cleared). @@ -718,7 +758,14 @@ otherwise. '-r' '--recursive' - Operate recursively on directories. + For each directory operand, read and process all files in that + directory, recursively. Follow symbolic links in the command line, + but skip symlinks that are encountered recursively. + +'-R' +'--dereference-recursive' + For each directory operand, read and process all files in that + directory, recursively, following all symbolic links. '-v' '--verbose' @@ -770,18 +817,18 @@ Concept index Tag Table: Node: Top222 -Node: Introduction1151 -Node: Common options3775 -Ref: compressor-requirements5533 -Node: The zutilsrc file5905 -Node: Zcat6830 -Node: Zcmp8884 -Node: Zdiff11343 -Node: Zgrep14047 -Node: Ztest17541 -Node: Zupdate19375 -Node: Problems22247 -Node: Concept index22781 +Node: Introduction1149 +Node: Common options3773 +Ref: compressor-requirements5596 +Node: The zutilsrc file5968 +Node: Zcat6893 +Node: Zcmp9445 +Node: Zdiff11904 +Node: Zgrep14608 +Node: Ztest18603 +Node: Zupdate20938 +Node: Problems24364 +Node: Concept index24898 End Tag Table |