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 ...
16 058b0118 2005-01-03 devnull .I option ...
18 058b0118 2005-01-03 devnull .I pattern
20 058b0118 2005-01-03 devnull .I file ...
22 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
23 cfa37a7b 2004-04-10 devnull .I Grep\^
24 cfa37a7b 2004-04-10 devnull searches the input
25 cfa37a7b 2004-04-10 devnull .I files\^
26 cfa37a7b 2004-04-10 devnull (standard input default)
27 cfa37a7b 2004-04-10 devnull for lines that match the
28 cfa37a7b 2004-04-10 devnull .IR pattern ,
29 cfa37a7b 2004-04-10 devnull a regular expression as defined in
30 058b0118 2005-01-03 devnull .IR regexp (7)
31 cfa37a7b 2004-04-10 devnull with the addition of a newline character as an alternative
32 cfa37a7b 2004-04-10 devnull (substitute for
34 cfa37a7b 2004-04-10 devnull with lowest precedence.
35 cfa37a7b 2004-04-10 devnull Normally, each line matching the pattern is `selected',
36 cfa37a7b 2004-04-10 devnull and each selected line is copied to the standard output.
37 cfa37a7b 2004-04-10 devnull The options are
40 cfa37a7b 2004-04-10 devnull Print only a count of matching lines.
44 cfa37a7b 2004-04-10 devnull Do not print file name tags (headers) with output lines.
47 cfa37a7b 2004-04-10 devnull The following argument is taken as a
48 cfa37a7b 2004-04-10 devnull .IR pattern .
49 cfa37a7b 2004-04-10 devnull This option makes it easy to specify patterns that
50 cfa37a7b 2004-04-10 devnull might confuse argument parsing, such as
54 cfa37a7b 2004-04-10 devnull Ignore alphabetic case distinctions. The implementation
55 cfa37a7b 2004-04-10 devnull folds into lower case all letters in the pattern and input before
56 cfa37a7b 2004-04-10 devnull interpretation. Matched lines are printed in their original form.
59 cfa37a7b 2004-04-10 devnull (ell) Print the names of files with selected lines; don't print the lines.
62 cfa37a7b 2004-04-10 devnull Print the names of files with no selected lines;
63 cfa37a7b 2004-04-10 devnull the converse of
67 cfa37a7b 2004-04-10 devnull Mark each printed line with its line number counted in its file.
70 cfa37a7b 2004-04-10 devnull Produce no output, but return status.
73 cfa37a7b 2004-04-10 devnull Reverse: print lines that do not match the pattern.
76 cfa37a7b 2004-04-10 devnull The pattern argument is the name of a file containing regular
77 cfa37a7b 2004-04-10 devnull expressions one per line.
80 cfa37a7b 2004-04-10 devnull Don't buffer the output: write each output line as soon as it is discovered.
83 cfa37a7b 2004-04-10 devnull Output lines are tagged by file name when there is more than one
84 cfa37a7b 2004-04-10 devnull input file.
85 cfa37a7b 2004-04-10 devnull (To force this tagging, include
86 cfa37a7b 2004-04-10 devnull .B /dev/null
87 cfa37a7b 2004-04-10 devnull as a file name argument.)
89 cfa37a7b 2004-04-10 devnull Care should be taken when
90 cfa37a7b 2004-04-10 devnull using the shell metacharacters
91 cfa37a7b 2004-04-10 devnull .B $*[^|()=\e
92 cfa37a7b 2004-04-10 devnull and newline
94 cfa37a7b 2004-04-10 devnull .IR pattern ;
95 cfa37a7b 2004-04-10 devnull it is safest to enclose the
96 cfa37a7b 2004-04-10 devnull entire expression
97 cfa37a7b 2004-04-10 devnull in single quotes
98 cfa37a7b 2004-04-10 devnull .BR \&\|' \|.\|.\|.\| ' .
99 cfa37a7b 2004-04-10 devnull An expression starting with '*'
100 cfa37a7b 2004-04-10 devnull will treat the rest of the expression
101 cfa37a7b 2004-04-10 devnull as literal characters.
104 058b0118 2005-01-03 devnull invokes grep with
106 058b0118 2005-01-03 devnull and forces tagging of output lines by file name.
107 058b0118 2005-01-03 devnull If no files are listed, it searches all files matching
110 715e3ca6 2005-09-13 devnull *.C *.b *.c *.h *.m *.cc *.java *.cgi *.pl *.py *.tex *.ms
112 cfa37a7b 2004-04-10 devnull .SH SOURCE
113 c3674de4 2005-01-11 devnull .B \*9/src/cmd/grep
115 c3674de4 2005-01-11 devnull .B \*9/bin/g
116 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
117 cfa37a7b 2004-04-10 devnull .IR ed (1),
118 cfa37a7b 2004-04-10 devnull .IR awk (1),
119 cfa37a7b 2004-04-10 devnull .IR sed (1),
120 cfa37a7b 2004-04-10 devnull .IR sam (1),
121 058b0118 2005-01-03 devnull .IR regexp (7)
122 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
123 cfa37a7b 2004-04-10 devnull Exit status is null if any lines are selected,
124 cfa37a7b 2004-04-10 devnull or non-null when no lines are selected or an error occurs.