grep Command Purpose Searches a file for a pattern. Syntax grep [ -E | -F ] [ -i ] [ -h ] [ -q ] [ -s ] [ -v ] [ -w ] [ -x ] [ -y ] [ [ [ -b ] [ -n ] ] | [ -c | -l ] ] [ -p [ Separator ] ] { [ -e PatternList ... ] [ -f PatternFile ... ] | PatternList ... } [ File ... ] Description The grep command searches for the pattern specified by the Pattern parameter and writes each matching line to standard out- put. The patterns are limited regular expressions in the style of the ed or egrep command. The grep command uses a compact non- deterministic algorithm. The grep command displays the name of the file containing the matched line if you specify more than one name in the File param- eter. Characters with special meaning to the shell ($, *, [, |, \^, (, ), \ ) must be in quotation marks when they appear in the Pattern parameter. When the Pattern parameter is not a simple string, you usually must enclose the entire pattern in single quotation marks. In an expression such as [a-z], the - (minus sign) specifies a range, according to the current collating se- quence. A collating sequence may define equivalence classes for use in character ranges. Notes: 1. Lines are limited to 2048 characters; longer lines are broken into multiple lines of 2048 or fewer characters. 2. Paragraphs (under the -p flag) are currently limited to a length of 5000 characters. 3. Do not run the grep command on a special file because it pro- duces unpredictable results. 4. Input lines should not contain the NULL character. 5. Input files should end with the new-line character. 6. Although some flags can be specified simultaneously, some flags override others. For example, if you specify -l and -n to- gether, only file names are written to standard output. And if you specify both the -E and -F flags, the last one specified takes priority. Flags -b Precedes each line by the block number on which it was found. Use this flag to help find disk block numbers by context. -c Displays only a count of matching lines. -E Treats each pattern specified as an extended regular expres- sion (ERE). A NULL value for the ERE matches every line. Note: The grep command with the -E flag is the same as the egrep command, except that error and usage messages are different and the -s flag functions differently. -e PatternList Specifies one or more search patterns. This works like a simple pattern but is useful when the pattern begins with a - (minus). Patterns should be separated by a new-line charac- ter. A NULL pattern can be specified by two adjacent new-line characters or a quotation mark followed by a new-line character ("\n). Each pattern is treated like a basic regular expression (BRE) unless the -E or -F flag is also specified. -F Treats each specified pattern as a string instead of a regular expression. A NULL string matches every line. Note: The grep command with the -F flag is the same as the fgrep command, except that error and usage messages are different and the -s flag functions differently. -f PatternFile Specifies a file containing search patterns. Each pattern should be separated by a new-line character, and an empty line is considered a NULL pattern. Each pattern is treated like a basic regular expression (BRE), unless the -E or -F flag is also specified. -h Suppresses file names when multiple files are specified. -i Ignores the case (uppercase or lowercase) of letters when mak- ing comparisons. -l Lists just the names of files (once) which contain matching lines. Each file name is separated by a new-line character. If standard input is searched, a path name of "(StandardInput)" is returned. -n Precedes each line with the relative line number in the file. Each file starts at line 1, and the line counter is reset for each file processed. -p[Separator] Displays the entire paragraph containing matched lines. Paragraphs are delimited by paragraph separators, as specified by the Separator parameter, which are patterns in the same form as the search pattern. Lines containing the paragraph separators are used only as separators; they are never included in the output. The default paragraph separator is a blank line. -q Suppresses all writing to standard output, regardless of matching lines. Exits with a zero status if an input line is selected. -s Suppresses error messages ordinarily written for nonexistent or unreadable files. Other error messages are not suppressed. -v Displays all lines not matching the specified pattern. -w Does a word search. -x Displays lines that match the specified pattern exactly with no additional characters. -y Ignores the case of letters when making comparisons. PatternList Specifies one or more patterns to be used during the search. The patterns are treated as if they were specified using the -e flag. File Specifies a name of a file to be searched for patterns. If no File variable is given, the standard input is used. Exit Status This command returns the following exit values: 0 A match was found. 1 No match was found. >1 A syntax error was found or a file was inaccessible (even if matches were found). Examples 1. To use a pattern that contains some of the pattern-matching characters *, \^, ?, [, ], \(, \), \{, and \}, enter: grep "\^[a-zA-Z]" pgm.s This displays every line in pgm.s whose first character is a letter. 2. To display all lines that do not match a pattern, enter: grep -v "\^#" pgm.s This displays every line in pgm.s whose first character is not a # (pound sign). 3. To display all lines in the file1 file that match either the abc or xyz string, enter: grep -E "abc|xyz" file1 4. To search for a $ (dollar sign) in the file named test2, enter: grep \\$ test2 The \\ (double backslash) characters are necessary in order to force the shell to pass a \$ (single backslash, dollar sign) to the grep command. The \ (single backslash) character tells the grep command to treat the following character (in this example the $) as a literal character rather than an expression charac- ter. Use the fgrep command to avoid the necessity of using es- cape characters such as the backslash. Implementation Specifics This command is part of Base Operating System (BOS) Runtime. Files /usr/bin/grep Contains the grep command. Related Information File Overview in AIX Version 3.2 System User's Guide: Base and Devices. Input and Output Redirection Overview in AIX Version 3.2 System User's Guide: Base and Devices. National Language Support Overview for Programming in AIX Ver- sion 3.2 General Programming Concepts. Shells Overview in AIX Version 3.2 System User's Guide: Base and Devices. The ed command, egrep command, fgrep command, sed command.