sbase/grep.1

62 lines
1.4 KiB
Groff

.TH GREP 1 sbase\-VERSION
.SH NAME
grep \- search files for a pattern
.SH SYNOPSIS
.B grep
.RB [ \-EHchilnqv ]
.RB [ \-e
.I pattern ]
.I pattern
.RI [ file ...]
.SH DESCRIPTION
.B grep
searches the input files for lines that match the
.IR pattern ,
a regular expression as defined in
.IR regex (7).
By default each matching line is printed to stdout. If no file is given, grep
reads from stdin.
.P
The status code is 0 if any lines match, and 1 if not. If an error occurred the
status code is 2.
.SH OPTIONS
.TP
.B \-E
matches using extended regex.
.TP
.B \-H
prefixes each matching line with its filename in the output. This is the
default when there is more than one file specified.
.TP
.B \-c
prints only a count of matching lines.
.TP
.B \-e pattern
Specify a pattern used during the search of the input: an input
line is selected if it matches any of the specified patterns.
This option is most useful when multiple -e options are used to
specify multiple patterns, or when a pattern begins with a dash
(`-').
.TP
.B \-h
do not prefix each line with 'filename:' prefix.
.TP
.B \-i
matches lines case insensitively.
.TP
.B \-l
prints only the names of files with matching lines.
.TP
.B \-n
prefixes each matching line with its line number in the input.
.TP
.B \-q
prints nothing, only returns status.
.TP
.B \-v
selects lines which do
.B not
match the pattern.
.SH SEE ALSO
.IR regex (7)