1 cfa37a7b 2004-04-10 devnull .TH GREP 1
3 058b0118 2005-01-03 devnull grep, g \- search a file for a pattern
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
7 cfa37a7b 2004-04-10 devnull .I option ...
9 cfa37a7b 2004-04-10 devnull .I pattern
11 cfa37a7b 2004-04-10 devnull .I file ...
15 058b0118 2005-01-03 devnull .I option ...
17 058b0118 2005-01-03 devnull .I pattern
19 058b0118 2005-01-03 devnull .I file ...
21 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
22 cfa37a7b 2004-04-10 devnull .I Grep\^
23 cfa37a7b 2004-04-10 devnull searches the input
24 cfa37a7b 2004-04-10 devnull .I files\^
25 cfa37a7b 2004-04-10 devnull (standard input default)
26 cfa37a7b 2004-04-10 devnull for lines that match the
27 cfa37a7b 2004-04-10 devnull .IR pattern ,
28 cfa37a7b 2004-04-10 devnull a regular expression as defined in
29 058b0118 2005-01-03 devnull .IR regexp (7)
30 cfa37a7b 2004-04-10 devnull with the addition of a newline character as an alternative
31 cfa37a7b 2004-04-10 devnull (substitute for
33 cfa37a7b 2004-04-10 devnull with lowest precedence.
34 cfa37a7b 2004-04-10 devnull Normally, each line matching the pattern is `selected',
35 cfa37a7b 2004-04-10 devnull and each selected line is copied to the standard output.
36 cfa37a7b 2004-04-10 devnull The options are
39 cfa37a7b 2004-04-10 devnull Print only a count of matching lines.
43 cfa37a7b 2004-04-10 devnull Do not print file name tags (headers) with output lines.
46 cfa37a7b 2004-04-10 devnull The following argument is taken as a
47 cfa37a7b 2004-04-10 devnull .IR pattern .
48 cfa37a7b 2004-04-10 devnull This option makes it easy to specify patterns that
49 cfa37a7b 2004-04-10 devnull might confuse argument parsing, such as
53 cfa37a7b 2004-04-10 devnull Ignore alphabetic case distinctions. The implementation
54 cfa37a7b 2004-04-10 devnull folds into lower case all letters in the pattern and input before
55 cfa37a7b 2004-04-10 devnull interpretation. Matched lines are printed in their original form.
58 cfa37a7b 2004-04-10 devnull (ell) Print the names of files with selected lines; don't print the lines.
61 cfa37a7b 2004-04-10 devnull Print the names of files with no selected lines;
62 cfa37a7b 2004-04-10 devnull the converse of
66 cfa37a7b 2004-04-10 devnull Mark each printed line with its line number counted in its file.
69 cfa37a7b 2004-04-10 devnull Produce no output, but return status.
72 cfa37a7b 2004-04-10 devnull Reverse: print lines that do not match the pattern.
75 cfa37a7b 2004-04-10 devnull The pattern argument is the name of a file containing regular
76 cfa37a7b 2004-04-10 devnull expressions one per line.
79 cfa37a7b 2004-04-10 devnull Don't buffer the output: write each output line as soon as it is discovered.
82 cfa37a7b 2004-04-10 devnull Output lines are tagged by file name when there is more than one
83 cfa37a7b 2004-04-10 devnull input file.
84 cfa37a7b 2004-04-10 devnull (To force this tagging, include
85 cfa37a7b 2004-04-10 devnull .B /dev/null
86 cfa37a7b 2004-04-10 devnull as a file name argument.)
88 cfa37a7b 2004-04-10 devnull Care should be taken when
89 cfa37a7b 2004-04-10 devnull using the shell metacharacters
90 cfa37a7b 2004-04-10 devnull .B $*[^|()=\e
91 cfa37a7b 2004-04-10 devnull and newline
93 cfa37a7b 2004-04-10 devnull .IR pattern ;
94 cfa37a7b 2004-04-10 devnull it is safest to enclose the
95 cfa37a7b 2004-04-10 devnull entire expression
96 cfa37a7b 2004-04-10 devnull in single quotes
97 cfa37a7b 2004-04-10 devnull .BR \&\|' \|.\|.\|.\| ' .
98 cfa37a7b 2004-04-10 devnull An expression starting with '*'
99 cfa37a7b 2004-04-10 devnull will treat the rest of the expression
100 cfa37a7b 2004-04-10 devnull as literal characters.
103 058b0118 2005-01-03 devnull invokes grep with
105 058b0118 2005-01-03 devnull and forces tagging of output lines by file name.
106 058b0118 2005-01-03 devnull If no files are listed, it searches all files matching
109 058b0118 2005-01-03 devnull *.C *.b *.c *.h *.m *.cc *.java *.py *.tex *.ms
111 cfa37a7b 2004-04-10 devnull .SH SOURCE
112 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/grep
114 058b0118 2005-01-03 devnull .B /usr/local/plan9/bin/g
115 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
116 cfa37a7b 2004-04-10 devnull .IR ed (1),
117 cfa37a7b 2004-04-10 devnull .IR awk (1),
118 cfa37a7b 2004-04-10 devnull .IR sed (1),
119 cfa37a7b 2004-04-10 devnull .IR sam (1),
120 058b0118 2005-01-03 devnull .IR regexp (7)
121 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
122 cfa37a7b 2004-04-10 devnull Exit status is null if any lines are selected,
123 cfa37a7b 2004-04-10 devnull or non-null when no lines are selected or an error occurs.