{"id":192,"date":"2016-01-12T15:34:42","date_gmt":"2016-01-12T15:34:42","guid":{"rendered":"http:\/\/wp-p3d2tsa2xh.pairsite.com\/?p=192"},"modified":"2025-05-21T14:12:55","modified_gmt":"2025-05-21T18:12:55","slug":"paircloud-diff-and-patch","status":"publish","type":"ht_kb","link":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/","title":{"rendered":"How to use diff and patch"},"content":{"rendered":"

Shared<\/p><\/a>

VPS<\/p><\/a>

Dedicated<\/p><\/a> 

WP Professional<\/p><\/a>

WP Professional Plus<\/p><\/a><\/span><\/p>\n

The \"diff\" tool calculates the differences between two text files. That difference is called a patch.  You can apply a patch to another file using the \"patch\" tool.<\/span><\/p>\n \t\t

\r\n \t\t\t \t\t\t \t\t\t\t

\r\n \t\t\t\t\tdiff and patch are intended to be used on text files. Files that are binary or manipulated by purpose-built applications, like .doc, .pdf, .xlsx, or .wav files, don\u2019t work well with diff and patch. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n

Why use diff and patch?<\/h3>\n

Reason 1<\/b>: diff can be useful by itself to see what has changed between files, even if you never use patch. <\/span><\/p>\n

Reason 2<\/b>: Sometimes you can get patches from third parties and apply them to your files. This can be beneficial in cases when the files being patched are large, but the number of changes is relatively small: transferring a patch file is more efficient than transferring the entire file.<\/span><\/p>\n

Reason 3: <\/b>You can apply patches to files that don't perfectly match the original file used in diff. <\/span>
\n<\/span>
\n<\/span>For example, if you use a CMS with a configuration file, and make local modifications to that configuration file, you want to preserve those local changes when you upgrade your CMS. Copying the vendor's new configuration over your version will lose your changes. However, in many cases, you can still safely use patch to apply the vendor's changes from the most recent version without losing your own changes.<\/span><\/p>\n

What is diff?<\/h3>\n

diff is a way to compare files for differences (hence the name \"diff\") from the command line. For example, if you have an original file, then make some changes and save it under another name, you could compare the two using diff. <\/span><\/p>\n

\"using<\/a><\/p>\n

diff Syntax<\/h4>\n

diff is used in the command line. The basic diff syntax looks like this: <\/span><\/p>\n

diff [options] [original filename] [changed filename]<\/span><\/pre>\n
This command sets up the basic structure for comparing one file to another. There are also <\/span>options <\/span><\/a>to add more functionality to a command.<\/span><\/p>\n
Basic Syntax (without Options)<\/h5>\n
Replace <\/span>[original filename]<\/span> and <\/span>[changed filename]<\/span> with the actual names of the files. Be sure to include the file extensions with the file names. A basic diff command without options may look something like this: <\/span><\/p>\n
diff file1.html file2.html<\/span><\/pre>\n
In this example, the command would compare <\/span>file1.html <\/span>and<\/span> file2.html <\/span>and output the differences into the command line.<\/span><\/p>\n
diff Syntax (with Options)<\/h5>\n
diff options add more functionality to commands. However, options will change the command syntax a little. <\/span><\/p>\n
diff options go between <\/span>diff <\/span>and the first filename:<\/span><\/p>\n
diff -y<\/span> file1.html file2.html<\/span><\/pre>\n
You can also combine multiple options in one command. Do this by adding all the pertinent options\u2019 letters after the dash (-). It will end up looking something like this:<\/span><\/p>\n
diff -uy file1.html file2.html<\/span><\/pre>\n
You may also see a variation that gives each option its own dash (-). Both methods of adding multiple options are valid<\/span><\/p>\n
diff -u -y file1.html file2.html<\/span><\/pre>\n
<\/a>See below for a list of commonly used options:
\n<\/span><\/p>\n\n\n\n\n\n\n\n
Option<\/b><\/td>\nDescription<\/b><\/td>\n<\/tr>\n
-N<\/span><\/td>\nIgnores absent files<\/span><\/td>\n<\/tr>\n
-r<\/span><\/td>\nRecursively executes diff through a directory. Used to compare multiple files at once. <\/span>Note: this is not the same as <\/span><\/i>-R<\/span><\/i><\/a>, which is a patch option<\/span><\/i><\/td>\n<\/tr>\n
-u<\/span><\/td>\nDisplays output in an easier to read format. This may remove some information, such as context lines. <\/span><\/td>\n<\/tr>\n
-y<\/span><\/td>\nForces output to display differences side by side. <\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
For more options, see <\/span>this list of diff options by GNU. <\/span><\/a><\/p>\n
diff Output<\/h4>\n
When a diff command is run, the basic output will look similar to this: <\/span><\/p>\n    \t\t
\r\n    \t\t\t    \t\t\t    \t\t\t\t
\r\n    \t\t\t\t\tUsing the <\/span><\/i>-y<\/span><\/i> option will change how the output is displayed<\/span><\/i>    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div>\r\n    \t\t\n
11c11<\/span>\n< this is text from the original file<\/span>\n---<\/span>\n> this is the same line from the second, changed file<\/span><\/pre>\n
Only changes will be displayed in the output, so you don\u2019t have to weed through the two files. Instead, diff compares and pulls the changes out for you to view.  <\/span><\/p>\n    \t\t
\r\n    \t\t\tTip<\/span>    \t\t\t    \t\t\t\t
\r\n    \t\t\t\t\tThe \u201c>\u201d and \u201c<\u201d characters in diff output point in the direction of the file in which the content is found. So, for the command \u201cdiff file1 file2\u201d<\/span>, a \u201c<\u201d refers to lines from file1 and \u201c>\u201d refers to lines from file2.    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div>\r\n    \t\t\n
\"content<\/a><\/p>\n
How to Read diff Output<\/h5>\n
Here\u2019s a brief guide about reading diff\u2019s output. <\/span><\/p>\n
The First Line of Output<\/h6>\n
The first line in the output indicates the line numbers that contain differences and the type of changes that have been made. <\/span><\/p>\n
\"diff<\/a><\/p>\n
If two numbers are separated by a comma, this means that there are changes from the first line number through to the second. In the example image above, 11,12 would indicate that there are changes on lines 11 - 12. <\/span><\/p>\n
The \u201cc\u201d that separates the line numbers in the example above indicates the type of change that occurred. There are different letters that indicate different types of changes:<\/span><\/p>\n\n\n\n\n\n\n
Letter<\/b><\/td>\nMeaning<\/b><\/td>\n<\/tr>\n
c<\/span><\/td>\nContent was replaced<\/span><\/td>\n<\/tr>\n
a<\/span><\/td>\nContent was added or appended<\/span><\/td>\n<\/tr>\n
d<\/span><\/td>\nContent was deleted <\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
When using patch, which will be explained in the <\/span>What is patch? <\/span><\/a>section, these letters will be important.<\/span><\/p>\n
The Rest of Output<\/h6>\n
The rest of the output concerns the actual differences between files. <\/span><\/p>\n
The changed lines will be listed next to < or > angle brackets. Three dashes (---) indicate that the end of the first file\u2019s line changes and the beginning of the next file\u2019s. It will look like this: <\/span><\/p>\n
< text from file one<\/span>\n---<\/span>\n> text from file two<\/span><\/pre>\n
Now that you have a basic understanding of diff, it\u2019s time to move on to patch.<\/span>
\n<\/a><\/p>\n
What is patch?<\/h3>\n
patch is a command that takes the output from the diff and puts it into a file. Then, it can take the filed output and overwrite another file with with the changes. For example, a common use is to use the patch to transfer changes from the changed file to the original file, thus making them identical. While this can also be accomplished by copy\/pasting the updated file into the original file, patch is much faster and efficient. <\/span><\/p>\n
How to use diff and patch Together<\/h3>\n
diff works by cataloging the changes between the two files or folders. Patch can take those changes, put them in a file, and update older versions with it. <\/span><\/p>\n
patch Options<\/h4>\n
The patch command also has its own set of options to add functionality. Find a list of commonly used options below: <\/span><\/p>\n\n\n\n\n\n\n\n
-b<\/span><\/td>\nCreates a backup of the original file<\/span><\/td>\n<\/tr>\n
-i<\/span><\/td>\nForces the command to read the patch from the .patch file instead of from standard input<\/span><\/td>\n<\/tr>\n
-p[#]<\/span><\/td>\nInstructs the command to strip # number of slashes from the filepath to the filename. You\u2019ll see in most of our examples, we use <\/span>-p0<\/span> so that no slashes are stripped away<\/span><\/td>\n<\/tr>\n
<\/a>-R<\/span><\/td>\nReverses the previous patch<\/span><\/td>\n<\/tr>\n
-s<\/span><\/td>\nRuns the command silently. It will only show process if there are errors<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
For more options, see <\/span>this list of patch options by GNU<\/span><\/a>.<\/span>
\n<\/a><\/p>\n
Creating a patch<\/h4>\n
Creating a patch file is the first step for using patch and diff together. The patch file can be used to add changes to other files, and so it is necessary for commands like <\/span>Overwrite the original file with changes<\/a>.<\/span><\/p>\n
To create a patch file, enter the command below into the command line:<\/span><\/p>\n
diff -u file1.html file2.html > patchfile.patch<\/span><\/pre>\n
In the example above, the diff output will be saved into a file named <\/span>patchfile.patch<\/span>. When executing the command, be sure to change <\/span>file1.html <\/span>and <\/span>file2.html<\/span> to actual file names.<\/span>
\n<\/a><\/p>\n
Overwrite files with changes<\/h4>\n
Once the <\/span>patch file is created<\/span><\/a>, you can use it to copy the changes to another file. For example, you may want to overwrite file1 with the changes from the updated file2. To do this, you could use syntax like this:<\/span><\/p>\n
patch file1.html patchfile.patch<\/span><\/pre>\n
Replace <\/span>file1.html <\/span>with your original file. This would overwrite the old contents of <\/span>file1.html<\/span> with the changed contents of <\/span>file2.html<\/span>.<\/span><\/p>\n
How to Reverse a patch<\/h4>\n
If you want to revert the file to its previous version before patching, you can do so by running this command: <\/span><\/p>\n
patch -p0 -R -i patchfile.patch<\/span><\/pre>\n
The command line will then prompt you to input the name of the file you want to revert. Once the filename has been entered, the reversing process will begin. If successful, the file will be reverted to its previous state.<\/span><\/p>\n
patch Directories<\/h4>\n
Using diff and patch on whole directories is a similar process to using it on single files. <\/span><\/p>\n
The first step is to create a patch file by using the command:<\/span><\/p>\n
diff -ruN folder1\/ folder2\/ > patchfile.patch<\/span><\/pre>\n
Then, you would issue the command to patch the original folder, which in this case is <\/span>folder1<\/span>:<\/span><\/p>\n
patch -s -p0 < patchfile.patch<\/span><\/pre>\n
If successful, your original directory should now be updated to match the second, updated folder.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
  The “diff” tool calculates the differences between two text files. That difference is called a patch.  You can apply a patch to another file using the “patch” tool. Why use diff and patch? Reason 1: diff can be useful by itself to see what has changed between files, even…<\/p>\n","protected":false},"author":12,"comment_status":"closed","ping_status":"open","template":"","format":"standard","meta":[],"ht-kb-category":[13],"ht-kb-tag":[],"yoast_head":"\nHow to Use diff and patch | Apply diff patch | diff patch Example<\/title>\n<meta name=\"description\" content=\"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Use diff and patch | Apply diff patch | diff patch Example\" \/>\n<meta property=\"og:description\" content=\"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/\" \/>\n<meta property=\"og:site_name\" content=\"Knowledge Base - Pair Networks\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/pairnetworks\/\" \/>\n<meta property=\"article:modified_time\" content=\"2025-05-21T18:12:55+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2016\/01\/Using-diff.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@pairNetworks\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/\",\"url\":\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/\",\"name\":\"How to Use diff and patch | Apply diff patch | diff patch Example\",\"isPartOf\":{\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#website\"},\"datePublished\":\"2016-01-12T15:34:42+00:00\",\"dateModified\":\"2025-05-21T18:12:55+00:00\",\"description\":\"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.pair.com\/support\/kb\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to use diff and patch\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#website\",\"url\":\"https:\/\/www.pair.com\/support\/kb\/\",\"name\":\"Knowledge Base - Pair Networks\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.pair.com\/support\/kb\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#organization\",\"name\":\"Pair Networks\",\"url\":\"https:\/\/www.pair.com\/support\/kb\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2022\/02\/Gb_TUkUE_400x400.jpeg\",\"contentUrl\":\"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2022\/02\/Gb_TUkUE_400x400.jpeg\",\"width\":360,\"height\":360,\"caption\":\"Pair Networks\"},\"image\":{\"@id\":\"https:\/\/www.pair.com\/support\/kb\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/pairnetworks\/\",\"https:\/\/twitter.com\/pairNetworks\",\"https:\/\/www.instagram.com\/pairnetworks\/\",\"https:\/\/www.linkedin.com\/company\/2269676\/\",\"https:\/\/www.pinterest.com\/pairnetworksinc\/pins\/\",\"https:\/\/www.youtube.com\/user\/pairnetworks\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Use diff and patch | Apply diff patch | diff patch Example","description":"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/","og_locale":"en_US","og_type":"article","og_title":"How to Use diff and patch | Apply diff patch | diff patch Example","og_description":"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.","og_url":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/","og_site_name":"Knowledge Base - Pair Networks","article_publisher":"https:\/\/www.facebook.com\/pairnetworks\/","article_modified_time":"2025-05-21T18:12:55+00:00","og_image":[{"url":"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2016\/01\/Using-diff.png"}],"twitter_card":"summary_large_image","twitter_site":"@pairNetworks","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/","url":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/","name":"How to Use diff and patch | Apply diff patch | diff patch Example","isPartOf":{"@id":"https:\/\/www.pair.com\/support\/kb\/#website"},"datePublished":"2016-01-12T15:34:42+00:00","dateModified":"2025-05-21T18:12:55+00:00","description":"Use diff and patch tools to compare and change files. diff compares the files and patch applies the output to other files. Learn how to apply diff patch.","breadcrumb":{"@id":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.pair.com\/support\/kb\/paircloud-diff-and-patch\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.pair.com\/support\/kb\/"},{"@type":"ListItem","position":2,"name":"How to use diff and patch"}]},{"@type":"WebSite","@id":"https:\/\/www.pair.com\/support\/kb\/#website","url":"https:\/\/www.pair.com\/support\/kb\/","name":"Knowledge Base - Pair Networks","description":"","publisher":{"@id":"https:\/\/www.pair.com\/support\/kb\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.pair.com\/support\/kb\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.pair.com\/support\/kb\/#organization","name":"Pair Networks","url":"https:\/\/www.pair.com\/support\/kb\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.pair.com\/support\/kb\/#\/schema\/logo\/image\/","url":"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2022\/02\/Gb_TUkUE_400x400.jpeg","contentUrl":"https:\/\/www.pair.com\/support\/kb\/wp-content\/uploads\/2022\/02\/Gb_TUkUE_400x400.jpeg","width":360,"height":360,"caption":"Pair Networks"},"image":{"@id":"https:\/\/www.pair.com\/support\/kb\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/pairnetworks\/","https:\/\/twitter.com\/pairNetworks","https:\/\/www.instagram.com\/pairnetworks\/","https:\/\/www.linkedin.com\/company\/2269676\/","https:\/\/www.pinterest.com\/pairnetworksinc\/pins\/","https:\/\/www.youtube.com\/user\/pairnetworks"]}]}},"_links":{"self":[{"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb\/192"}],"collection":[{"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/comments?post=192"}],"version-history":[{"count":6,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb\/192\/revisions"}],"predecessor-version":[{"id":9796,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb\/192\/revisions\/9796"}],"wp:attachment":[{"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/media?parent=192"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=192"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.pair.com\/support\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=192"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}