The diff Command in Linux is one of those tools that might seem weird for casual users. After all, there are better alternatives that can do the job more efficiently, and visually better when using file explorers.
But for long-time uses, system administrators, and other professionals, diff
serves as a handy tool for making a quick comparison of two files. Even better, skilled scripters utilize this command to automate simple tasks that require file comparing.
Combining diff
with other commands is another way to maximize its utility. Some commands like ed, ex
and patch
use diff
outputs to produce their outputs. Let’s learn more about this command with the articles and examples below.
What is diff Command?
diff
is a file comparison tool that compares files in a line-by-line manner. This tool was created and published way back in 1974 for Unix machines. Most users utilize this tool to compare text files. However, it is also capable of comparing binaries, directories, and even image files.
For Unix-based operations, diff
functions with ed
to automatically check and modify changes and keep the latest version. In a way, early computer users maximize storage by deleting multiple file versions and keeping the best ones.
But in the current tech landscape, diff
is now used in more ways than before. For instance, users can now save the output in a third file for evaluation. The command can also compare directories and enable other commands to operate automatically.
Default diff Command Syntax
The default syntax for using the diff command in Linux is by running diff
followed by the first file and the second file. In the output, the <
indicates the content of the first file while >
shows the second file.
$ diff <file1> <file2>
$diff <option> <file1> <file2>
In the example below, we compared two files named Mumbo and Grian. All the lines with <
on it shows the content for Mumbo (file 1) and all the content in >
shows text for Grian (file 2).

If both files have the same content, the prompt won’t show any result. In the example below, there is a difference within the first line of the two documents. As you can see, the diff
command shows that Mumbo is a funny guy who has a mustache.

In addition, diff
only shows results if it detects any difference within the two files. If the two files have similar content, diff will return zero. By default, it also includes white space and newlines when detecting for changes.
The random numbers and letters above are instructions on how to change the first file to make it identical to the second file. In the above example, 1c1
means changing the first line of the first file (Mumbo) to the first line of the second file (Grian).
Instructions from diff
commands are not just a randomly generated string. “c” indicates that there are changes between the two lines. Although c
is what you’ll commonly see when using the diff
command, there are also other actions such as “a” and “d.”
c
– the content was replaced
a
– there is content added
d
– the content was deleted
Unfortunately, diff
can only process two files. For comparing multiple files, you might want to check the diffuse
command, which can compare up to 10 files.
Relevant diff Options
Numerous options are available to enhance the functionalities and utility of the diff
command in Linux and UNIX systems. If interested, you can check the exhaustive list of options by running diff --help
. Here are some of the commonly-used options.
-y
: Gives a side-to-side visual comparison of two files in the result.
-s
: Signifies that two files are identical.
-r
: Use the command recursively, including subdirectories.
-i
: Ignore results that only show case-sensitive differences.
-B
: Completely disregards empty line differences.
-w
: Completely disregards white space differences.
-u
: Display the result in an easier to read format.
Example Usages of diff Command
You can use the diff
command in three different ways: compare two text files, other files, and directories. Each method can help in multiple situations, depending on the result that you’re trying to achieve.
Using diff Command to Compare 2 Texts
To compare 2 text files, you can use the default syntax and add more options if needed. As always, <
pertains to the first file while >
points to the second file. Prompts with -B
and -w
will ignore line or space differences, so add those options if you want a neat-looking and less-cluttered result output.
$ diff file1.txt file2.txt

Using diff Command to Compare 2 Files
Comparing two files will not show the line-by-line, pixel-by-pixel, or other binary details. Although it can still compare files, it will only inform the user if the two files are different.
Just like text files, the diff command in Linux will return zero if the two files are identical. You can use this option if you want to compare two files and automate file transfer without duplicating the data.
$ diff file1.file file2.file

Using diff Command to Compare 2 Directories
When comparing two directories, the diff
command will return the difference between each folders’ contents. For instance, only the Grian folder below has the Grian.png file, while only the Mumbo folder has the Mumbo.png file. It is a very useful technique if you want to manage multiple versions of the same directory.
$ diff pathname1 pathname2

Saving Results to a File
Do you want to save a diff
result for viewing or evaluation later on? You can do that by adding >
and the name of the file that you want to save the results into. It’s okay if the results file doesn’t exist yet, it will be created automatically.
$ diff file1 file2 > file3

diff Command with patch
Using diff
with patch
is useful in cases wherein you need to amend a file from third-party instructions. Instead of manually changing the file line per line, you can use the patch
command to automate the amendment.
In the example below, the instruction to change Mumbo.txt to Grian.txt is stored in the Sahara.patch. Once you extract the change instructions, you can use the patch
command to apply the changes automatically.
The format for the patch
command is:
$patch <target file> <patch file>

Final Thoughts
The diff command in Linux is something that you would either use sparingly or would be a go-to tool depending on the task or the project that you’re dealing with. Hopefully, this article is able to help you learn diff
and its various usages. Please share this article and check out other Linux command guides in the How-To section.
If this guide helped you, please share it. ?