140 lines
3.9 KiB
Groff
140 lines
3.9 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
|
|
.TH ZGREP "1" "May 2015" "zgrep (zutils) 1.4" "User Commands"
|
|
.SH NAME
|
|
zgrep \- search compressed files for a regular expression
|
|
.SH SYNOPSIS
|
|
.B zgrep
|
|
[\fI\,options\/\fR] \fI\,<pattern> \/\fR[\fI\,files\/\fR]
|
|
.SH DESCRIPTION
|
|
Zgrep is a front end to the grep program that allows transparent search
|
|
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. If no files are specified, data is 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.
|
|
.PP
|
|
Exit status is 0 if match, 1 if no match, 2 if trouble.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-\-help\fR
|
|
display this help and exit
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
output version information and exit
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-text\fR
|
|
treat all files as text
|
|
.TP
|
|
\fB\-A\fR, \fB\-\-after\-context=\fR<n>
|
|
print <n> lines of trailing context
|
|
.TP
|
|
\fB\-b\fR, \fB\-\-byte\-offset\fR
|
|
print the byte offset of each line
|
|
.TP
|
|
\fB\-B\fR, \fB\-\-before\-context=\fR<n>
|
|
print <n> lines of leading context
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-count\fR
|
|
only print a count of matching lines per file
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-context=\fR<n>
|
|
print <n> lines of output context
|
|
.TP
|
|
\fB\-e\fR, \fB\-\-regexp=\fR<pattern>
|
|
use <pattern> as the pattern to match
|
|
.TP
|
|
\fB\-E\fR, \fB\-\-extended\-regexp\fR
|
|
<pattern> is an extended regular expression
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-file=\fR<file>
|
|
obtain patterns from <file>
|
|
.TP
|
|
\fB\-F\fR, \fB\-\-fixed\-strings\fR
|
|
<pattern> is a set of newline\-separated strings
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-no\-filename\fR
|
|
suppress the prefixing filename on output
|
|
.TP
|
|
\fB\-H\fR, \fB\-\-with\-filename\fR
|
|
print the filename for each match
|
|
.TP
|
|
\fB\-i\fR, \fB\-\-ignore\-case\fR
|
|
ignore case distinctions
|
|
.TP
|
|
\fB\-I\fR
|
|
ignore binary files
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-files\-with\-matches\fR
|
|
only print names of files containing matches
|
|
.TP
|
|
\fB\-L\fR, \fB\-\-files\-without\-match\fR
|
|
only print names of files containing no matches
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-max\-count=\fR<n>
|
|
stop after <n> matches
|
|
.TP
|
|
\fB\-M\fR, \fB\-\-format=\fR<list>
|
|
process only the formats in <list>
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-line\-number\fR
|
|
print the line number of each line
|
|
.TP
|
|
\fB\-N\fR, \fB\-\-no\-rcfile\fR
|
|
don't read runtime configuration file
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-only\-matching\fR
|
|
show only the part of a line matching <pattern>
|
|
.TP
|
|
\fB\-O\fR, \fB\-\-force\-format=\fR<fmt>
|
|
force given format (bz2, gz, lz, xz)
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
suppress all messages
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-recursive\fR
|
|
operate recursively on directories
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-no\-messages\fR
|
|
suppress error messages
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-invert\-match\fR
|
|
select non\-matching lines
|
|
.TP
|
|
\fB\-\-verbose\fR
|
|
verbose mode (show error messages)
|
|
.TP
|
|
\fB\-w\fR, \fB\-\-word\-regexp\fR
|
|
match only whole words
|
|
.TP
|
|
\fB\-x\fR, \fB\-\-line\-regexp\fR
|
|
match only whole lines
|
|
.TP
|
|
\fB\-\-bz2=\fR<command>
|
|
set compressor and options for bzip2 format
|
|
.TP
|
|
\fB\-\-gz=\fR<command>
|
|
set compressor and options for gzip format
|
|
.TP
|
|
\fB\-\-lz=\fR<command>
|
|
set compressor and options for lzip format
|
|
.TP
|
|
\fB\-\-xz=\fR<command>
|
|
set compressor and options for xz format
|
|
.PP
|
|
Numbers may be followed by a multiplier: k = kB = 10^3 = 1000,
|
|
Ki = KiB = 2^10 = 1024, M = 10^6, Mi = 2^20, G = 10^9, Gi = 2^30, etc...
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to zutils\-bug@nongnu.org
|
|
.br
|
|
Zutils home page: http://www.nongnu.org/zutils/zutils.html
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2015 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.
|
|
There is NO WARRANTY, to the extent permitted by law.
|