blob: 1204e5bb6fbd1ca477bc0204c706e9d0c4a9d46a [file] [log] [blame]
Elliott Hughes44aba642023-09-12 20:18:59 +00001.TH "ZSTDGREP" "1" "March 2023" "zstd 1.5.5" "User Commands"
Yann Collet3addf2f2021-09-22 14:30:59 -07002.SH "NAME"
3\fBzstdgrep\fR \- print lines matching a pattern in zstandard\-compressed files
4.SH "SYNOPSIS"
Elliott Hughes44aba642023-09-12 20:18:59 +00005\fBzstdgrep\fR [\fIgrep\-flags\fR] [\-\-] \fIpattern\fR [\fIfiles\fR \|\.\|\.\|\.]
Yann Collet3addf2f2021-09-22 14:30:59 -07006.SH "DESCRIPTION"
Elliott Hughes44aba642023-09-12 20:18:59 +00007\fBzstdgrep\fR runs \fBgrep\fR(1) on files, or \fBstdin\fR if no files argument is given, after decompressing them with \fBzstdcat\fR(1)\.
Yann Collet3addf2f2021-09-22 14:30:59 -07008.P
Elliott Hughes44aba642023-09-12 20:18:59 +00009The \fIgrep\-flags\fR and \fIpattern\fR arguments are passed on to \fBgrep\fR(1)\. If an \fB\-e\fR flag is found in the \fIgrep\-flags\fR, \fBzstdgrep\fR will not look for a \fIpattern\fR argument\.
Yann Collet3addf2f2021-09-22 14:30:59 -070010.P
Elliott Hughes44aba642023-09-12 20:18:59 +000011Note that modern \fBgrep\fR alternatives such as \fBripgrep\fR (\fBrg\fR(1)) support \fBzstd\fR\-compressed files out of the box, and can prove better alternatives than \fBzstdgrep\fR notably for unsupported complex pattern searches\. Note though that such alternatives may also feature some minor command line differences\.
Yann Collet3addf2f2021-09-22 14:30:59 -070012.SH "EXIT STATUS"
13In case of missing arguments or missing pattern, 1 will be returned, otherwise 0\.
14.SH "SEE ALSO"
Elliott Hughes44aba642023-09-12 20:18:59 +000015\fBzstd\fR(1)
Yann Collet3addf2f2021-09-22 14:30:59 -070016.SH "AUTHORS"
17Thomas Klausner \fIwiz@NetBSD\.org\fR