Adding upstream version 1.8.
Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
parent
350226fc6e
commit
6e7259427c
34 changed files with 858 additions and 455 deletions
22
doc/zcat.1
22
doc/zcat.1
|
@ -1,5 +1,5 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZCAT "1" "February 2018" "zcat (zutils) 1.7" "User Commands"
|
||||
.TH ZCAT "1" "January 2019" "zcat (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
zcat \- decompress and concatenate files to standard output
|
||||
.SH SYNOPSIS
|
||||
|
@ -9,14 +9,17 @@ zcat \- decompress and concatenate files to standard output
|
|||
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.
|
||||
.PP
|
||||
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.
|
||||
.PP
|
||||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
If no files are specified, recursive searches examine the current
|
||||
working directory, and nonrecursive searches read standard input.
|
||||
.PP
|
||||
The formats supported are bzip2, gzip, lzip and xz.
|
||||
.PP
|
||||
Exit status is 0 if no errors occurred, non\-zero otherwise.
|
||||
.SH OPTIONS
|
||||
|
@ -57,6 +60,9 @@ suppress all messages
|
|||
\fB\-r\fR, \fB\-\-recursive\fR
|
||||
operate recursively on directories
|
||||
.TP
|
||||
\fB\-R\fR, \fB\-\-dereference\-recursive\fR
|
||||
recursively follow symbolic links
|
||||
.TP
|
||||
\fB\-s\fR, \fB\-\-squeeze\-blank\fR
|
||||
never more than one single blank line
|
||||
.TP
|
||||
|
@ -88,7 +94,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZCMP "1" "February 2018" "zcmp (zutils) 1.7" "User Commands"
|
||||
.TH ZCMP "1" "January 2019" "zcmp (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
zcmp \- decompress and compare two files byte by byte
|
||||
.SH SYNOPSIS
|
||||
|
@ -12,7 +12,7 @@ are numbered starting with 1. If any given file is compressed, its
|
|||
decompressed content is used. Compressed files are decompressed on the
|
||||
fly; no temporary files are created.
|
||||
.PP
|
||||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
The formats supported are bzip2, gzip, lzip and xz.
|
||||
.PP
|
||||
Zcmp compares file1 to file2. If file2 is omitted zcmp tries the
|
||||
following:
|
||||
|
@ -85,7 +85,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZDIFF "1" "February 2018" "zdiff (zutils) 1.7" "User Commands"
|
||||
.TH ZDIFF "1" "January 2019" "zdiff (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
zdiff \- decompress and compare two files line by line
|
||||
.SH SYNOPSIS
|
||||
|
@ -12,7 +12,7 @@ compressed, its decompressed content is used. Zdiff is a front end to
|
|||
the diff program and has the limitation that messages from diff refer to
|
||||
temporary filenames instead of those specified.
|
||||
.PP
|
||||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
The formats supported are bzip2, gzip, lzip and xz.
|
||||
.PP
|
||||
Zdiff compares file1 to file2. If file2 is omitted zdiff tries the
|
||||
following:
|
||||
|
@ -109,7 +109,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
22
doc/zgrep.1
22
doc/zgrep.1
|
@ -1,5 +1,5 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZGREP "1" "February 2018" "zgrep (zutils) 1.7" "User Commands"
|
||||
.TH ZGREP "1" "January 2019" "zgrep (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
zgrep \- search compressed files for a regular expression
|
||||
.SH SYNOPSIS
|
||||
|
@ -11,14 +11,17 @@ 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.
|
||||
.PP
|
||||
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.
|
||||
.PP
|
||||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
If no files are specified, recursive searches examine the current
|
||||
working directory, and nonrecursive searches read standard input.
|
||||
.PP
|
||||
The formats supported are bzip2, gzip, lzip and xz.
|
||||
.PP
|
||||
Exit status is 0 if match, 1 if no match, 2 if trouble.
|
||||
.SH OPTIONS
|
||||
|
@ -104,6 +107,9 @@ suppress all messages
|
|||
\fB\-r\fR, \fB\-\-recursive\fR
|
||||
operate recursively on directories
|
||||
.TP
|
||||
\fB\-R\fR, \fB\-\-dereference\-recursive\fR
|
||||
recursively follow symbolic links
|
||||
.TP
|
||||
\fB\-s\fR, \fB\-\-no\-messages\fR
|
||||
suppress error messages
|
||||
.TP
|
||||
|
@ -138,7 +144,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
19
doc/ztest.1
19
doc/ztest.1
|
@ -1,5 +1,5 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZTEST "1" "February 2018" "ztest (zutils) 1.7" "User Commands"
|
||||
.TH ZTEST "1" "January 2019" "ztest (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
ztest \- verify the integrity of compressed files
|
||||
.SH SYNOPSIS
|
||||
|
@ -7,12 +7,14 @@ ztest \- verify the integrity of compressed files
|
|||
[\fI\,options\/\fR] [\fI\,files\/\fR]
|
||||
.SH DESCRIPTION
|
||||
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.
|
||||
.PP
|
||||
The supported formats are bzip2, gzip, lzip and xz.
|
||||
If no files are specified, recursive searches examine the current
|
||||
working directory, and nonrecursive searches read standard input.
|
||||
.PP
|
||||
The formats supported are bzip2, gzip, lzip and xz.
|
||||
.PP
|
||||
Note that error detection in the xz format is broken. First, some xz
|
||||
files lack integrity information. Second, not all xz decompressors can
|
||||
|
@ -47,6 +49,9 @@ suppress all messages
|
|||
\fB\-r\fR, \fB\-\-recursive\fR
|
||||
operate recursively on directories
|
||||
.TP
|
||||
\fB\-R\fR, \fB\-\-dereference\-recursive\fR
|
||||
recursively follow symbolic links
|
||||
.TP
|
||||
\fB\-v\fR, \fB\-\-verbose\fR
|
||||
be verbose (a 2nd \fB\-v\fR gives more)
|
||||
.TP
|
||||
|
@ -66,7 +71,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
|
@ -1,19 +1,21 @@
|
|||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
||||
.TH ZUPDATE "1" "February 2018" "zupdate (zutils) 1.7" "User Commands"
|
||||
.TH ZUPDATE "1" "January 2019" "zupdate (zutils) 1.8" "User Commands"
|
||||
.SH NAME
|
||||
zupdate \- recompress bzip2, gzip, xz files to lzip format
|
||||
.SH SYNOPSIS
|
||||
.B zupdate
|
||||
[\fI\,options\/\fR] [\fI\,files\/\fR]
|
||||
.SH DESCRIPTION
|
||||
Zupdate recompresses files from bzip2, gzip, and xz formats to lzip format.
|
||||
The originals are compared with the new files and then deleted.
|
||||
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.
|
||||
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 the most appropriate for
|
||||
long\-term data archiving.
|
||||
.PP
|
||||
If no files are specified, recursive searches examine the current
|
||||
working directory, and nonrecursive searches do nothing.
|
||||
.PP
|
||||
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
|
||||
|
@ -54,6 +56,9 @@ suppress all messages
|
|||
\fB\-r\fR, \fB\-\-recursive\fR
|
||||
operate recursively on directories
|
||||
.TP
|
||||
\fB\-R\fR, \fB\-\-dereference\-recursive\fR
|
||||
recursively follow symbolic links
|
||||
.TP
|
||||
\fB\-v\fR, \fB\-\-verbose\fR
|
||||
be verbose (a 2nd \fB\-v\fR gives more)
|
||||
.TP
|
||||
|
@ -76,7 +81,7 @@ Report bugs to zutils\-bug@nongnu.org
|
|||
.br
|
||||
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2018 Antonio Diaz Diaz.
|
||||
Copyright \(co 2019 Antonio Diaz Diaz.
|
||||
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
|
125
doc/zutils.info
125
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
|
||||
|
||||
|
|
101
doc/zutils.texi
101
doc/zutils.texi
|
@ -6,8 +6,8 @@
|
|||
@finalout
|
||||
@c %**end of header
|
||||
|
||||
@set UPDATED 13 February 2018
|
||||
@set VERSION 1.7
|
||||
@set UPDATED 1 January 2019
|
||||
@set VERSION 1.8
|
||||
|
||||
@dircategory Data Compression
|
||||
@direntry
|
||||
|
@ -49,7 +49,7 @@ This manual is for Zutils (version @value{VERSION}, @value{UPDATED}).
|
|||
@end menu
|
||||
|
||||
@sp 1
|
||||
Copyright @copyright{} 2009-2018 Antonio Diaz Diaz.
|
||||
Copyright @copyright{} 2009-2019 Antonio Diaz Diaz.
|
||||
|
||||
This manual is free documentation: you have unlimited permission
|
||||
to copy, distribute and modify it.
|
||||
|
@ -70,8 +70,8 @@ programs. In particular the @samp{--recursive} option is very efficient
|
|||
in those utilities supporting it.
|
||||
|
||||
@noindent
|
||||
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.
|
||||
|
||||
|
@ -133,6 +133,7 @@ only supports the @samp{--help} form of this option.
|
|||
@item -V
|
||||
@itemx --version
|
||||
Print the version number on the standard output and exit.
|
||||
This version number should be included in all bug reports.
|
||||
|
||||
@item -M @var{format_list}
|
||||
@itemx --format=@var{format_list}
|
||||
|
@ -221,12 +222,17 @@ where <format> is one of @samp{bz2}, @samp{gz}, @samp{lz} or @samp{xz}.
|
|||
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 @samp{-}, 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 @samp{-}, 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:
|
||||
|
||||
|
@ -274,7 +280,14 @@ Quiet operation. Suppress all messages.
|
|||
|
||||
@item -r
|
||||
@itemx --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.
|
||||
|
||||
@item -R
|
||||
@itemx --dereference-recursive
|
||||
For each directory operand, read and process all files in that
|
||||
directory, recursively, following all symbolic links.
|
||||
|
||||
@item -s
|
||||
@itemx --squeeze-blank
|
||||
|
@ -509,12 +522,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 @samp{-}, 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 @samp{-}, 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:
|
||||
|
||||
|
@ -629,7 +646,14 @@ found, even if an error was detected.
|
|||
|
||||
@item -r
|
||||
@itemx --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.
|
||||
|
||||
@item -R
|
||||
@itemx --dereference-recursive
|
||||
For each directory operand, read and process all files in that
|
||||
directory, recursively, following all symbolic links.
|
||||
|
||||
@item -s
|
||||
@itemx --no-messages
|
||||
|
@ -658,10 +682,14 @@ Match only whole lines.
|
|||
@cindex ztest
|
||||
|
||||
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 @samp{-}, 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 @samp{-}, 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
|
||||
|
@ -703,7 +731,14 @@ Quiet operation. Suppress all messages.
|
|||
|
||||
@item -r
|
||||
@itemx --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.
|
||||
|
||||
@item -R
|
||||
@itemx --dereference-recursive
|
||||
For each directory operand, read and process all files in that
|
||||
directory, recursively, following all symbolic links.
|
||||
|
||||
@item -v
|
||||
@itemx --verbose
|
||||
|
@ -721,9 +756,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 @samp{--force} option is given. In this case, if the
|
||||
|
@ -743,7 +783,7 @@ extensions @samp{.lz} or @samp{.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 @samp{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).
|
||||
|
||||
|
@ -785,7 +825,14 @@ Quiet operation. Suppress all messages.
|
|||
|
||||
@item -r
|
||||
@itemx --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.
|
||||
|
||||
@item -R
|
||||
@itemx --dereference-recursive
|
||||
For each directory operand, read and process all files in that
|
||||
directory, recursively, following all symbolic links.
|
||||
|
||||
@item -v
|
||||
@itemx --verbose
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue