1 cfa37a7b 2004-04-10 devnull .TH GREP 1
3 cfa37a7b 2004-04-10 devnull grep \- 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 ...
13 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
14 cfa37a7b 2004-04-10 devnull .I Grep\^
15 cfa37a7b 2004-04-10 devnull searches the input
16 cfa37a7b 2004-04-10 devnull .I files\^
17 cfa37a7b 2004-04-10 devnull (standard input default)
18 cfa37a7b 2004-04-10 devnull for lines that match the
19 cfa37a7b 2004-04-10 devnull .IR pattern ,
20 cfa37a7b 2004-04-10 devnull a regular expression as defined in
21 cfa37a7b 2004-04-10 devnull .IR regexp (6)
22 cfa37a7b 2004-04-10 devnull with the addition of a newline character as an alternative
23 cfa37a7b 2004-04-10 devnull (substitute for
25 cfa37a7b 2004-04-10 devnull with lowest precedence.
26 cfa37a7b 2004-04-10 devnull Normally, each line matching the pattern is `selected',
27 cfa37a7b 2004-04-10 devnull and each selected line is copied to the standard output.
28 cfa37a7b 2004-04-10 devnull The options are
31 cfa37a7b 2004-04-10 devnull Print only a count of matching lines.
35 cfa37a7b 2004-04-10 devnull Do not print file name tags (headers) with output lines.
38 cfa37a7b 2004-04-10 devnull The following argument is taken as a
39 cfa37a7b 2004-04-10 devnull .IR pattern .
40 cfa37a7b 2004-04-10 devnull This option makes it easy to specify patterns that
41 cfa37a7b 2004-04-10 devnull might confuse argument parsing, such as
45 cfa37a7b 2004-04-10 devnull Ignore alphabetic case distinctions. The implementation
46 cfa37a7b 2004-04-10 devnull folds into lower case all letters in the pattern and input before
47 cfa37a7b 2004-04-10 devnull interpretation. Matched lines are printed in their original form.
50 cfa37a7b 2004-04-10 devnull (ell) Print the names of files with selected lines; don't print the lines.
53 cfa37a7b 2004-04-10 devnull Print the names of files with no selected lines;
54 cfa37a7b 2004-04-10 devnull the converse of
58 cfa37a7b 2004-04-10 devnull Mark each printed line with its line number counted in its file.
61 cfa37a7b 2004-04-10 devnull Produce no output, but return status.
64 cfa37a7b 2004-04-10 devnull Reverse: print lines that do not match the pattern.
67 cfa37a7b 2004-04-10 devnull The pattern argument is the name of a file containing regular
68 cfa37a7b 2004-04-10 devnull expressions one per line.
71 cfa37a7b 2004-04-10 devnull Don't buffer the output: write each output line as soon as it is discovered.
74 cfa37a7b 2004-04-10 devnull Output lines are tagged by file name when there is more than one
75 cfa37a7b 2004-04-10 devnull input file.
76 cfa37a7b 2004-04-10 devnull (To force this tagging, include
77 cfa37a7b 2004-04-10 devnull .B /dev/null
78 cfa37a7b 2004-04-10 devnull as a file name argument.)
80 cfa37a7b 2004-04-10 devnull Care should be taken when
81 cfa37a7b 2004-04-10 devnull using the shell metacharacters
82 cfa37a7b 2004-04-10 devnull .B $*[^|()=\e
83 cfa37a7b 2004-04-10 devnull and newline
85 cfa37a7b 2004-04-10 devnull .IR pattern ;
86 cfa37a7b 2004-04-10 devnull it is safest to enclose the
87 cfa37a7b 2004-04-10 devnull entire expression
88 cfa37a7b 2004-04-10 devnull in single quotes
89 cfa37a7b 2004-04-10 devnull .BR \&\|' \|.\|.\|.\| ' .
90 cfa37a7b 2004-04-10 devnull An expression starting with '*'
91 cfa37a7b 2004-04-10 devnull will treat the rest of the expression
92 cfa37a7b 2004-04-10 devnull as literal characters.
93 cfa37a7b 2004-04-10 devnull .SH SOURCE
94 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/grep
95 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
96 cfa37a7b 2004-04-10 devnull .IR ed (1),
97 cfa37a7b 2004-04-10 devnull .IR awk (1),
98 cfa37a7b 2004-04-10 devnull .IR sed (1),
99 cfa37a7b 2004-04-10 devnull .IR sam (1),
100 cfa37a7b 2004-04-10 devnull .IR regexp (6)
101 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
102 cfa37a7b 2004-04-10 devnull Exit status is null if any lines are selected,
103 cfa37a7b 2004-04-10 devnull or non-null when no lines are selected or an error occurs.
