1git-grep(1) 2=========== 3 4NAME 5---- 6git-grep - Print lines matching a pattern 7 8 9SYNOPSIS 10-------- 11[verse] 12'git grep' [-a | --text] [-I] [-i | --ignore-case] [-w | --word-regexp] 13 [-v | --invert-match] [-h|-H] [--full-name] 14 [-E | --extended-regexp] [-G | --basic-regexp] 15 [-F | --fixed-strings] [-n] 16 [-l | --files-with-matches] [-L | --files-without-match] 17 [-z | --null] 18 [-c | --count] [--all-match] [-q | --quiet] 19 [--max-depth <depth>] 20 [--color | --no-color] 21 [-A <post-context>] [-B <pre-context>] [-C <context>] 22 [-f <file>] [-e] <pattern> 23 [--and|--or|--not|(|)|-e <pattern>...] 24 [--cached | --no-index | <tree>...] 25 [--] [<pathspec>...] 26 27DESCRIPTION 28----------- 29Look for specified patterns in the tracked files in the work tree, blobs 30registered in the index file, or blobs in given tree objects. 31 32 33OPTIONS 34------- 35--cached:: 36 Instead of searching tracked files in the working tree, search 37 blobs registered in the index file. 38 39--no-index:: 40 Search files in the current directory, not just those tracked by git. 41 42-a:: 43--text:: 44 Process binary files as if they were text. 45 46-i:: 47--ignore-case:: 48 Ignore case differences between the patterns and the 49 files. 50 51-I:: 52 Don't match the pattern in binary files. 53 54--max-depth <depth>:: 55 For each <pathspec> given on command line, descend at most <depth> 56 levels of directories. A negative value means no limit. 57 58-w:: 59--word-regexp:: 60 Match the pattern only at word boundary (either begin at the 61 beginning of a line, or preceded by a non-word character; end at 62 the end of a line or followed by a non-word character). 63 64-v:: 65--invert-match:: 66 Select non-matching lines. 67 68-h:: 69-H:: 70 By default, the command shows the filename for each 71 match. `-h` option is used to suppress this output. 72 `-H` is there for completeness and does not do anything 73 except it overrides `-h` given earlier on the command 74 line. 75 76--full-name:: 77 When run from a subdirectory, the command usually 78 outputs paths relative to the current directory. This 79 option forces paths to be output relative to the project 80 top directory. 81 82-E:: 83--extended-regexp:: 84-G:: 85--basic-regexp:: 86 Use POSIX extended/basic regexp for patterns. Default 87 is to use basic regexp. 88 89-F:: 90--fixed-strings:: 91 Use fixed strings for patterns (don't interpret pattern 92 as a regex). 93 94-n:: 95 Prefix the line number to matching lines. 96 97-l:: 98--files-with-matches:: 99--name-only:: 100-L:: 101--files-without-match:: 102 Instead of showing every matched line, show only the 103 names of files that contain (or do not contain) matches. 104 For better compatibility with 'git diff', `--name-only` is a 105 synonym for `--files-with-matches`. 106 107-z:: 108--null:: 109 Output \0 instead of the character that normally follows a 110 file name. 111 112-c:: 113--count:: 114 Instead of showing every matched line, show the number of 115 lines that match. 116 117--color:: 118 Show colored matches. 119 120--no-color:: 121 Turn off match highlighting, even when the configuration file 122 gives the default to color output. 123 124-[ABC] <context>:: 125 Show `context` trailing (`A` -- after), or leading (`B` 126 -- before), or both (`C` -- context) lines, and place a 127 line containing `--` between contiguous groups of 128 matches. 129 130-<num>:: 131 A shortcut for specifying `-C<num>`. 132 133-p:: 134--show-function:: 135 Show the preceding line that contains the function name of 136 the match, unless the matching line is a function name itself. 137 The name is determined in the same way as 'git diff' works out 138 patch hunk headers (see 'Defining a custom hunk-header' in 139 linkgit:gitattributes[5]). 140 141-f <file>:: 142 Read patterns from <file>, one per line. 143 144-e:: 145 The next parameter is the pattern. This option has to be 146 used for patterns starting with `-` and should be used in 147 scripts passing user input to grep. Multiple patterns are 148 combined by 'or'. 149 150--and:: 151--or:: 152--not:: 153( ... ):: 154 Specify how multiple patterns are combined using Boolean 155 expressions. `--or` is the default operator. `--and` has 156 higher precedence than `--or`. `-e` has to be used for all 157 patterns. 158 159--all-match:: 160 When giving multiple pattern expressions combined with `--or`, 161 this flag is specified to limit the match to files that 162 have lines to match all of them. 163 164-q:: 165--quiet:: 166 Do not output matched lines; instead, exit with status 0 when 167 there is a match and with non-zero status when there isn't. 168 169<tree>...:: 170 Instead of searching tracked files in the working tree, search 171 blobs in the given trees. 172 173\--:: 174 Signals the end of options; the rest of the parameters 175 are <pathspec> limiters. 176 177<pathspec>...:: 178 If given, limit the search to paths matching at least one pattern. 179 Both leading paths match and glob(7) patterns are supported. 180 181Examples 182-------- 183 184git grep 'time_t' -- '*.[ch]':: 185 Looks for `time_t` in all tracked .c and .h files in the working 186 directory and its subdirectories. 187 188git grep -e \'#define\' --and \( -e MAX_PATH -e PATH_MAX \):: 189 Looks for a line that has `#define` and either `MAX_PATH` or 190 `PATH_MAX`. 191 192git grep --all-match -e NODE -e Unexpected:: 193 Looks for a line that has `NODE` or `Unexpected` in 194 files that have lines that match both. 195 196Author 197------ 198Originally written by Linus Torvalds <torvalds@osdl.org>, later 199revamped by Junio C Hamano. 200 201 202Documentation 203-------------- 204Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. 205 206GIT 207--- 208Part of the linkgit:git[1] suite