Mercurial > repos > rliterman > csp2

comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/man/man1/lzgrep.1 @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 68:5028fdace37b
1 .\" SPDX-License-Identifier: 0BSD
2 .\"
3 .\" Authors: Lasse Collin
4 .\" Jia Tan
5 .\"
6 .\" (Note that this file is not based on gzip's zgrep.1.)
7 .\"
8 .TH XZGREP 1 "2024-02-13" "Tukaani" "XZ Utils"
9 .SH NAME
10 xzgrep \- search possibly-compressed files for patterns
11 .
12 .SH SYNOPSIS
13 .B xzgrep
14 .RI [ option... ]
15 .RI [ pattern_list ]
16 .RI [ file... ]
17 .br
18 .B xzegrep
19 \&...
20 .br
21 .B xzfgrep
22 \&...
23 .br
24 .B lzgrep
25 \&...
26 .br
27 .B lzegrep
28 \&...
29 .br
30 .B lzfgrep
31 \&...
32 .
33 .SH DESCRIPTION
34 .B xzgrep
35 invokes
36 .BR grep (1)
37 on uncompressed contents of files.
38 The formats of the
39 .I files
40 are determined from the filename suffixes.
41 Any
42 .I file
43 with a suffix supported by
44 .BR xz (1),
45 .BR gzip (1),
46 .BR bzip2 (1),
47 .BR lzop (1),
48 .BR zstd (1),
49 or
50 .BR lz4 (1)
51 will be decompressed;
52 all other files are assumed to be uncompressed.
53 .PP
54 If no
55 .I files
56 are specified or
57 .I file
58 is
59 .B \-
60 then standard input is read.
61 When reading from standard input, only files supported by
62 .BR xz (1)
63 are decompressed.
64 Other files are assumed to be in uncompressed form already.
65 .PP
66 Most
67 .I options
68 of
69 .BR grep (1)
70 are supported.
71 However, the following options are not supported:
72 .IP "" 4
73 .BR \-r ,
74 .B \-\-recursive
75 .IP "" 4
76 .BR \-R ,
77 .B \-\-dereference\-recursive
78 .IP "" 4
79 .BR \-d ,
80 .BI \-\-directories= action
81 .IP "" 4
82 .BR \-Z ,
83 .B \-\-null
84 .IP "" 4
85 .BR \-z ,
86 .B \-\-null\-data
87 .IP "" 4
88 .BI \-\-include= glob
89 .IP "" 4
90 .BI \-\-exclude= glob
91 .IP "" 4
92 .BI \-\-exclude\-from= file
93 .IP "" 4
94 .BI \-\-exclude\-dir= glob
95 .PP
96 .B xzegrep
97 is an alias for
98 .BR "xzgrep \-E" .
99 .B xzfgrep
100 is an alias for
101 .BR "xzgrep \-F" .
102 .PP
103 The commands
104 .BR lzgrep ,
105 .BR lzegrep ,
106 and
107 .B lzfgrep
108 are provided for backward compatibility with LZMA Utils.
109 .
110 .SH EXIT STATUS
111 .TP
112 0
113 At least one match was found from at least one of the input files.
114 No errors occurred.
115 .TP
116 1
117 No matches were found from any of the input files.
118 No errors occurred.
119 .TP
120 >1
121 One or more errors occurred.
122 It is unknown if matches were found.
123 .
124 .SH ENVIRONMENT
125 .TP
126 .B GREP
127 If
128 .B GREP
129 is set to a non-empty value,
130 it is used instead of
131 .BR "grep" ,
132 .BR "grep \-E" ,
133 or
134 .BR "grep \-F" .
135 .
136 .SH "SEE ALSO"
137 .BR grep (1),
138 .BR xz (1),
139 .BR gzip (1),
140 .BR bzip2 (1),
141 .BR lzop (1),
142 .BR zstd (1),
143 .BR lz4 (1),
144 .BR zgrep (1)