pcregrep(1) [redhat man page]
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)
Check Out this Related Man Page
grep(1) General Commands Manual grep(1) Name grep, egrep, fgrep - search file for regular expression Syntax grep [option...] expression [file...] egrep [option...] [expression] [file...] fgrep [option...] [strings] [file] Description Commands of the family search the input files (standard input default) for lines matching a pattern. Normally, each line found is copied to the standard output. The command patterns are limited regular expressions in the style of which uses a compact nondeterministic algorithm. The command patterns are full regular expressions. The command uses a fast deterministic algorithm that sometimes needs exponential space. The command pat- terns are fixed strings. The command is fast and compact. In all cases the file name is shown if there is more than one input file. Take care when using the characters $ * [ ^ | ( ) and in the expression because they are also meaningful to the Shell. It is safest to enclose the entire expression argument in single quotes ' '. The command searches for lines that contain one of the (new line-separated) strings. The command accepts extended regular expressions. In the following description `character' excludes new line: A followed by a single character other than new line matches that character. The character ^ matches the beginning of a line. The character $ matches the end of a line. A . (dot) matches any character. A single character not otherwise endowed with special meaning matches that character. A string enclosed in brackets [] matches any single character from the string. Ranges of ASCII character codes may be abbreviated as in `a-z0-9'. A ] may occur only as the first character of the string. A literal - must be placed where it can't be mistaken as a range indicator. A regular expression followed by an * (asterisk) matches a sequence of 0 or more matches of the regular expression. A regular expression followed by a + (plus) matches a sequence of 1 or more matches of the regular expression. A regular expression followed by a ? (question mark) matches a sequence of 0 or 1 matches of the regular expression. Two regular expressions concatenated match a match of the first followed by a match of the second. Two regular expressions separated by | or new line match either a match for the first or a match for the second. A regular expression enclosed in parentheses matches a match for the regular expression. The order of precedence of operators at the same parenthesis level is the following: [], then *+?, then concatenation, then | and new line. Options -b Precedes each output line with its block number. This is sometimes useful in locating disk block numbers by context. -c Produces count of matching lines only. -e expression Uses next argument as expression that begins with a minus (-). -f file Takes regular expression (egrep) or string list (fgrep) from file. -i Considers upper and lowercase letter identical in making comparisons and only). -l Lists files with matching lines only once, separated by a new line. -n Precedes each matching line with its line number. -s Silent mode and nothing is printed (except error messages). This is useful for checking the error status (see DIAGNOSTICS). -v Displays all lines that do not match specified expression. -w Searches for an expression as for a word (as if surrounded by `<' and `>'). For further information, see only. -x Prints exact lines matched in their entirety only). Restrictions Lines are limited to 256 characters; longer lines are truncated. Diagnostics Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or inaccessible files. See Also ex(1), sed(1), sh(1) grep(1)