grep -r for recursive search in Linux CLI - Step-by-Step Execution

Concept Flow - grep -r for recursive search

Start grep command with -r

↓

Read directory

↓

For each item in directory

↓

Is directory?

↓

Print matching lines

↓

Next item

↓

End when all items searched

The grep -r command starts at a directory, reads each item, recurses into subdirectories, and searches files for the pattern, printing matches.

Execution Sample

Linux CLI

grep -r 'hello' ./myfolder

Searches recursively in 'myfolder' for the word 'hello' and prints matching lines with filenames.

Execution Table

Step	Directory/File	Is Directory?	Action	Output
1	./myfolder	Yes	Read contents: file1.txt, subdir
2	file1.txt	No	Search for 'hello'	file1.txt: hello world
3	subdir	Yes	Recurse into subdir
4	subdir/file2.txt	No	Search for 'hello'	subdir/file2.txt: say hello again
5	subdir/file3.txt	No	Search for 'hello'
6	All items processed		Exit	No more files to search

💡 All files and subdirectories have been searched recursively.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5	Final
Current Item	grep -r command start	./myfolder	file1.txt	subdir	subdir/file2.txt	subdir/file3.txt	None
Output Lines	empty	empty	file1.txt: hello world	file1.txt: hello world	file1.txt: hello world subdir/file2.txt: say hello again	file1.txt: hello world subdir/file2.txt: say hello again	final output printed

Key Moments - 3 Insights

Why does grep -r search inside subdirectories automatically?

Because the -r option tells grep to treat directories by going inside them and searching all files recursively, as shown in steps 3 and 4 of the execution_table.

What happens if a file does not contain the search pattern?

No output is printed for that file, as seen in step 5 where subdir/file3.txt has no matching lines, so output is empty.

Does grep -r print the filename with the matching line?

Yes, grep -r prints the filename before the matching line to show where the match was found, as shown in steps 2 and 4.

Visual Quiz - 3 Questions

Look at the execution table, what is the output after step 2?

A file1.txt: hello world

B subdir/file2.txt: say hello again

C No output yet

D subdir/file3.txt: no match

💡 Hint

Check the Output column at step 2 in the execution_table.

At which step does grep enter the subdirectory to continue searching?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Look at the Action column where recursion into subdir happens.

If the file subdir/file3.txt contained 'hello', how would the output change at step 5?

A No change, output stays empty

B Output would include 'subdir/file3.txt: hello'

C Output would remove previous matches

D grep would stop searching

💡 Hint

Refer to how output accumulates in variable_tracker and execution_table outputs.

Concept Snapshot

grep -r PATTERN DIRECTORY

- Searches recursively inside DIRECTORY and all subdirectories
- Prints matching lines with filenames
- Automatically descends into directories
- Stops when all files are searched
- Useful to find text in many files quickly

Full Transcript

The grep -r command starts by reading the given directory. It checks each item inside. If the item is a file, it searches for the pattern and prints matching lines with the filename. If the item is a directory, grep -r goes inside and repeats the process. This continues until all files and subdirectories are searched. If a file has no matches, nothing is printed for it. The output shows all matches found with their file paths. This recursive search helps find text across many files easily.