plan9-grep(1) [debian man page]

GREP(1) 						      General Commands Manual							   GREP(1)

NAME

       grep, g - search a file for a pattern

SYNOPSIS

       grep [ option ...  ] pattern [ file ...	]

       g [ option ...  ] pattern [ file ...  ]

DESCRIPTION

       Grep  searches the input files (standard input default) for lines that match the pattern, a regular expression as defined in regexp(7) with
       the addition of a newline character as an alternative (substitute for |) with lowest precedence.  Normally, each line matching the  pattern
       is `selected', and each selected line is copied to the standard output.	The options are

       -c     Print only a count of matching lines.
       -h     Do not print file name tags (headers) with output lines.
       -e     The  following  argument	is taken as a pattern.	This option makes it easy to specify patterns that might confuse argument parsing,
	      such as -n.
       -i     Ignore alphabetic case distinctions.  The implementation folds into lower case all letters in the pattern and input before interpre-
	      tation.  Matched lines are printed in their original form.
       -l     (ell) Print the names of files with selected lines; don't print the lines.
       -L     Print the names of files with no selected lines; the converse of -l.
       -n     Mark each printed line with its line number counted in its file.
       -s     Produce no output, but return status.
       -v     Reverse: print lines that do not match the pattern.
       -f     The pattern argument is the name of a file containing regular expressions one per line.
       -b     Don't buffer the output: write each output line as soon as it is discovered.

       Output  lines  are  tagged  by  file name when there is more than one input file.  (To force this tagging, include /dev/null as a file name
       argument.)

       Care should be taken when using the shell metacharacters $*[^|()= and newline in pattern; it is safest to enclose the entire expression in
       single quotes '...'.  An expression starting with '*' will treat the rest of the expression as literal characters.

       G invokes grep with -n and forces tagging of output lines by file name.	If no files are listed, it searches all files matching

	      *.C *.b *.c *.h *.m *.cc *.java *.cgi *.pl *.py *.tex *.ms

SOURCE

       /src/cmd/grep
       /bin/g

SEE ALSO

       ed(1), awk(1), sed(1), sam(1), regexp(7)

DIAGNOSTICS

       Exit status is null if any lines are selected, or non-null when no lines are selected or an error occurs.

																	   GREP(1)

PCREGREP(1)						      General Commands Manual						       PCREGREP(1)

NAME

       pcregrep - a grep with Perl-compatible regular expressions.

SYNOPSIS

       pcregrep [-Vcfhilnrsvx] pattern [file] ...

DESCRIPTION

       pcregrep  searches files for character patterns, in the same way as other grep commands do, but it uses the PCRE regular expression library
       to support patterns that are compatible with the regular expressions of Perl 5. See pcre(3) for a full description of syntax and semantics.

       If no files are specified, pcregrep reads the standard input. By default, each line that matches the pattern is copied to the standard out-
       put,  and  if  there is more than one file, the file name is printed before each line of output. However, there are options that can change
       how pcregrep behaves.

       Lines are limited to BUFSIZ characters. BUFSIZ is defined in <stdio.h>.	The newline character is removed from the end of each line  before
       it is matched against the pattern.

OPTIONS

       -V	 Write the version number of the PCRE library being used to the standard error stream.

       -c	 Do  not print individual lines; instead just print a count of the number of lines that would otherwise have been printed. If sev-
		 eral files are given, a count is printed for each of them.

       -ffilename
		 Read patterns from the file, one per line, and match all patterns against each line. There is a maximum of 100 patterns. Trailing
		 white space is removed, and blank lines are ignored. An empty file contains no patterns and therefore matches nothing.

       -h	 Suppress printing of filenames when searching multiple files.

       -i	 Ignore upper/lower case distinctions during comparisons.

       -l	 Instead  of  printing lines from the files, just print the names of the files containing lines that would have been printed. Each
		 file name is printed once, on a separate line.

       -n	 Precede each line by its line number in the file.

       -r	 If any file is a directory, recursively scan the files it contains. Without -r a directory is scanned as a normal file.

       -s	 Work silently, that is, display nothing except error messages.  The exit status indicates whether any matches were found.

       -v	 Invert the sense of the match, so that lines which do not match the pattern are now the ones that are found.

       -x	 Force the pattern to be anchored (it must start matching at the beginning of the line) and in addition, require it to	match  the
		 entire  line.	This  is  equivalent  to  having ^ and $ characters at the start and end of each alternative branch in the regular
		 expression.

SEE ALSO

       pcre(3), Perl 5 documentation

DIAGNOSTICS

       Exit status is 0 if any matches were found, 1 if no matches were found, and 2 for syntax errors or inacessible files (even if matches  were
       found).

AUTHOR

       Philip Hazel <ph10@cam.ac.uk>

       Last updated: 15 August 2001
       Copyright (c) 1997-2001 University of Cambridge.

																       PCREGREP(1)