Diff

diff on komentoriviohjelma, jolla voidaan vertailla kahta eri tiedostoa. Tavallisimpia käyttökohteita on esimerkiksi ohjelmistokehityksessä eri versioiden vertailu. Lisäksi diffiä hyödynnetään mm. korjauspaketeissa, versionhallintaohjelmissa sekä asetustiedostojen ja ylipäätänsä tekstimuotoisten tiedostojen vertailussa.

diff perustuu rivien vertailuun, joten se ei sovellu dataan, jossa rivit ovat hyvin pitkiä tai missä rivien järjestys, rivinvaihdot tai rivien sisältö vaihtuu vertailun kannalta mielivaltaisesti.

Peruskäyttö

Tehdään aluksi kaksi C-kielistä tiedostoa, esimerkiksi hello.c

#include <stdio.h>
void main() {
 printf("Hello word");
}

Ja hello2.c

#include <stdio.h>
int main() {
 printf("Hello world");
 return 0;
}

Esimerkissä uuteen hello2.c-versioon korjattiin kirjoitusvirhe rivillä 3 ja lisättiin funktio palauttamaan 0. Näitä voitaisiin nyt vertailla komennolla

diff hello.c hello2.c

Diffin tuloste olisi seuraavanlainen

2,3c2,4
< void main() {
<  printf("Hello word");
---
> int main() {
>  printf("Hello world");
>  return 0;

< tarkoittaa, että rivi poistui ja > tarkoittaa uutta riviä. Tulosteesta nähdään että alkuperäisen tiedoston rivit 2-3 korvaantuivat viivan alla olevilla uusilla riveillä 2-4.

Vivulla -u diffin tulosteen saa monipuolisemmaksi ja selkeämmäksi. Esimerkkitapauksessamme diff -u hello.c hello2.c antaisi tulosteen

--- hello.c      2006-04-07 10:05:08.000000000 +0000
+++ hello2.c      2006-04-07 10:12:47.000000000 +0000
@@ -1,5 +1,6 @@
#include <stdio.h>
-void main() {
- printf("Hello word");
+int main() {
+ printf("Hello world");
+ return 0;
}

Aluksi nähdään tiedostojen nimet ja niiden viimeiset muokkausajat. Varsinainen tuloste on selkeä, + rivin edessä tarkoittaa lisättyä riviä ja - poistettua. Nyt diff näyttää myös muutaman rivin muutoskohdan ympäriltä mikä selkeyttää tulostetta.

Joskus C-tiedostojen muutokset halutaan yhdistää siten että valinta versioiden välillä tapahtuu käännösvaiheessa. diff -D VER_2_00 hello.c hello2.c >hello_molemmat.c yhdistää versiot siten että kumpikin versio saadaan halutessa aikaan lisäämällä tarvittaessa -D VER_2_00 valitsin.

#include <stdio.h>
#ifndef VER_2_00
void main() {
 printf("Hello word");
#else /* VER_2_00 */
int main() {
 printf("Hello world");
 return 0;
#endif /* VER_2_00 */
}

Hakemistojen vertailu

Diff osaa yksittäisten tiedostojen lisäksi vertailla myös kokonaisia hakemistoja. Tällöin käytetään vipua -r (recursive). Hakemistoja vertaillessa diff käy läpi kaikki hakemistojen tiedostot myös alihakemistoista.

Katso myös

• Patch
• TkDiff on graafinen tiedostojen ja kansioiden vertailuun käytettävä apuohjelma.
• Meld on graafinen tiedostojen ja kansioiden vertailuun käytettävä apuohjelma.
• Beyond Compare

Aiheesta muualla

• FLUG:in Diff-ohje Linux-ohjelmointioppaassa.