/[pcre]/code/tags/pcre-2.08/pgrep.1.txt
ViewVC logotype

Contents of /code/tags/pcre-2.08/pgrep.1.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 40 - (show annotations) (download)
Sat Feb 24 21:39:15 2007 UTC (7 years, 5 months ago) by nigel
File MIME type: text/plain
File size: 2867 byte(s)
Tag code/trunk as code/tags/pcre-2.08.

1 NAME
2 pgrep - a grep with Perl-compatible regular expressions.
3
4
5
6 SYNOPSIS
7 pgrep [-Vchilnsvx] pattern [file] ...
8
9
10
11 DESCRIPTION
12 pgrep searches files for character patterns, in the same way
13 as other grep commands do, but it uses the PCRE regular
14 expression library to support patterns that are compatible
15 with the regular expressions of Perl 5. See pcre(3) for a
16 full description of syntax and semantics.
17
18 If no files are specified, pgrep reads the standard input.
19 By default, each line that matches the pattern is copied to
20 the standard output, and if there is more than one file, the
21 file name is printed before each line of output. However,
22 there are options that can change how pgrep behaves.
23
24 Lines are limited to BUFSIZ characters. BUFSIZ is defined in
25 <stdio.h>. The newline character is removed from the end of
26 each line before it is matched against the pattern.
27
28
29
30 OPTIONS
31 -V Write the version number of the PCRE library being
32 used to the standard error stream.
33
34 -c Do not print individual lines; instead just print
35 a count of the number of lines that would other-
36 wise have been printed. If several files are
37 given, a count is printed for each of them.
38
39 -h Suppress printing of filenames when searching mul-
40 tiple files.
41
42 -i Ignore upper/lower case distinctions during com-
43 parisons.
44
45 -l Instead of printing lines from the files, just
46 print the names of the files containing lines that
47 would have been printed. Each file name is printed
48 once, on a separate line.
49
50 -n Precede each line by its line number in the file.
51
52 -s Work silently, that is, display nothing except
53 error messages. The exit status indicates whether
54 any matches were found.
55
56 -v Invert the sense of the match, so that lines which
57 do not match the pattern are now the ones that are
58 found.
59
60 -x Force the pattern to be anchored (it must start
61 matching at the beginning of the line) and in
62 addition, require it to match the entire line.
63 This is equivalent to having ^ and $ characters at
64 the start and end of each alternative branch in
65 the regular expression.
66
67
68
69 SEE ALSO
70 pcre(3), Perl 5 documentation
71
72
73
74
75
76 DIAGNOSTICS
77 Exit status is 0 if any matches were found, 1 if no matches
78 were found, and 2 for syntax errors or inacessible files
79 (even if matches were found).
80
81
82
83 AUTHOR
84 Philip Hazel <ph10@cam.ac.uk>
85 Copyright (c) 1997-1999 University of Cambridge.
86

webmaster@exim.org
ViewVC Help
Powered by ViewVC 1.1.12