Return to grep CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/grep, revision 1.1.1.1

1.1       root        1: .TH GREP 1
                      2: .SH NAME
                      3: grep \- search a file for a pattern
                      4: .SH SYNOPSIS
                      5: .B grep
                      6: [
                      7: .I option ...
                      8: ]
                      9: .I pattern
                     10: [
                     11: .I file ...
                     12: ]
                     13: .SH DESCRIPTION
                     14: .I Grep\^
                     15: searches the input
                     16: .I files\^
                     17: (standard input default)
                     18: for lines (with newlines excluded) that match the
                     19: .IR pattern ,
                     20: a regular expression as defined in
                     21: .IR regexp (6).
                     22: Normally, each line matching the pattern is `selected',
                     23: and each selected line is copied to the standard output.
                     24: The options are
                     25: .TP
                     26: .B -c
                     27: Print only a count of matching lines.
                     28: .PD 0
                     29: .TP
                     30: .B -h
                     31: Do not print file name tags (headers) with output lines.
                     32: .TP
                     33: .B -i
                     34: Ignore alphabetic case distinctions.  The implementation
                     35: folds into lower case all letters in the pattern and input before
                     36: interpretation.  Matched lines are printed in their original form.
                     37: .TP
                     38: .B -l
                     39: (ell) Print the names of files with selected lines; don't print the lines.
                     40: .TP
                     41: .B -L
                     42: Print the names of files with no selected lines;
                     43: the converse of
                     44: .BR -l .
                     45: .TP
                     46: .B -n
                     47: Mark each printed line with its line number counted in its file.
                     48: .TP
                     49: .B -s
                     50: Produce no output, but return status.
                     51: .TP
                     52: .B -v
                     53: Reverse: print lines that do not match the pattern.
                     54: .PD
                     55: .PP
                     56: Output lines are tagged by file name when there is more than one
                     57: input file.
                     58: (To force this tagging, include
                     59: .B /dev/null
                     60: as a file name argument.)
                     61: .PP
                     62: Care should be taken when
                     63: using the shell metacharacters
                     64: .B $*[^|()=\e
                     65: and newline
                     66: in
                     67: .IR pattern ;
                     68: it is safest to enclose the
                     69: entire expression
                     70: in single quotes
                     71: .BR \&\|' \|.\|.\|.\| ' .
                     72: .SH SOURCE
                     73: .B /sys/src/cmd/grep.c
                     74: .SH SEE ALSO
                     75: .IR ed (1),
                     76: .IR awk (1),
                     77: .IR sed (1),
                     78: .IR sam (1),
                     79: .IR regexp (6)
                     80: .SH DIAGNOSTICS
                     81: Exit status is null if any lines are selected,
                     82: or non-null when no lines are selected or an error occurs.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.