Return to pgrep.3p CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / spms / man / man3

Annotation of 43BSD/contrib/spms/man/man3/pgrep.3p, revision 1.1.1.1

1.1       root        1: .TH PGREP 3P "10 April 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: pgrep \- search files for a pattern
                      5: .SH SYNOPSIS
                      6: .B pgrep
                      7: [\fB\-eilmnw\fR] [\fB\-f \fRmakefile] [\fB\-C \fRcommand] [\fB\-F \fRpatfile]
                      8: [pattern [file ...]]
                      9: .SH DESCRIPTION
                     10: .I Pgrep
                     11: searchs through specified files for lines matching
                     12: .I pattern.
                     13: Normally, each line found is printed to standard output. Alternatively,
                     14: .I command
                     15: can be executed, with arguments that are the names of files containing
                     16: .I pattern.
                     17: .PP
                     18: The names of files can be specified as arguments, or obtained from the `HDRS'
                     19: and `SRCS' macro definitions in a makefile (\fB\-m \fRoption),
                     20: or a combination of both. When
                     21: .I pgrep
                     22: is told to use a makefile and the
                     23: .B \-f
                     24: option is not present, the files `makefile' and `Makefile' are tried in
                     25: order.
                     26: .PP
                     27: .I Pgrep
                     28: uses the
                     29: .I grep
                     30: or
                     31: .I egrep
                     32: commands to search for the pattern.
                     33: .I Grep
                     34: patterns are limited to regular expressions in the style of \fIex\fR(1).
                     35: .I Egrep
                     36: patterns are full regular expressions.
                     37: Care should be taken when using the characters $ * [ | ( ) and \\ in
                     38: .I pattern
                     39: as they are also meaningful to the command shell. It is safest to enclose
                     40: the entire
                     41: .I pattern
                     42: in single quotes.
                     43: .SH OPTIONS
                     44: .IP \fB\-e\fR
                     45: Use
                     46: .I egrep
                     47: instead of
                     48: .I grep.
                     49: .IP "\fB\-f \fImakefile\fR"
                     50: Specify an alternative
                     51: .I makefile
                     52: file name. This option also implies the
                     53: .B \-m
                     54: option.
                     55: .IP \fB\-i\fR
                     56: Ignore case of letters when making comparisons (i.e. upper and lower case
                     57: are considered identical).
                     58: .I Grep
                     59: only.
                     60: .IP \fB\-l\fR
                     61: List the names of files with matching lines. The file names are printed
                     62: one per line.
                     63: .IP \fB\-m\fR
                     64: Obtain the names of files to search from a makefile. If no
                     65: .B \-f
                     66: option is present, the makefiles `makefile' and `Makefile' are tried in order.
                     67: .IP \fB\-n\fR
                     68: Precede each matching line by its relative line number in the file.
                     69: .IP \fB\-w\fR
                     70: Treat
                     71: .I pattern
                     72: as a word (i.e. as if surrounded by `\\<' and `\\>'; see \fIex\fR(1)\|).
                     73: .I Grep
                     74: only.
                     75: .IP "\fB\-C \fIcommand\fR"
                     76: Execute
                     77: .I command
                     78: with arguments that are
                     79: the names of files containing
                     80: .I pattern.
                     81: .IP "\fB\-F \fIpatfile\fR"
                     82: The regular expression is taken from
                     83: .I patfile.
                     84: .I Egrep
                     85: only.
                     86: .SH FILES
                     87: .ta \w'/usr/new/lib/pgrep'u+.5i
                     88: /usr/new/lib/pgrep     Pgrep program.
                     89: .br
                     90: makefile       Default makefile.
                     91: .br
                     92: Makefile       Alternative default makefile.
                     93: .DT
                     94: .SH "SEE ALSO"
                     95: egrep(1), ex(1), grep(1), make(1), mkmf(1P), pgrep(1P), vi(1)
                     96: .SH DIAGNOSTICS
                     97: Exit status is 0 if any matches are found, 1 if none,
                     98: 2 for syntax errors or inaccessible files.
                     99: .SH AUTHOR
                    100: Peter J. Nicklin

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