Return to pgrep.3p CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / ucs / spms

Annotation of 43BSDReno/share/doc/ucs/spms/pgrep.3p, revision 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.