Diff: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
K Textersetzung - „Exit-Status“ durch „Rückgabewert“ |
||
| Zeile 442: | Zeile 442: | ||
DATEIEN sind »DATEI1 DATEI2« oder »VERZEICHNIS1 VERZEICHNIS2« oder »VERZEICHNIS DATEI« oder »DATEI VERZEICHNIS«. Falls --from-file oder --to-file an‐ | DATEIEN sind »DATEI1 DATEI2« oder »VERZEICHNIS1 VERZEICHNIS2« oder »VERZEICHNIS DATEI« oder »DATEI VERZEICHNIS«. Falls --from-file oder --to-file an‐ | ||
gegeben ist, gibt es keine Einschränkungen für DATEI(en). Falls eine DATEI »-« ist, wird die Standardeingabe gelesen. Der | gegeben ist, gibt es keine Einschränkungen für DATEI(en). Falls eine DATEI »-« ist, wird die Standardeingabe gelesen. Der Rückgabewert ist 0, wenn die | ||
Eingaben gleich sind, 1, wenn verschieden und 2 bei Problemen. | Eingaben gleich sind, 1, wenn verschieden und 2 bei Problemen. | ||
Aktuelle Version vom 8. September 2024, 10:16 Uhr
diff
Mit dem Programm diff kann man auf der Kommandozeile Dateien vergleichen. Die Befehlssyntax ist einfach:
diff Datei1 Datei2
Will man nur wissen ob eine Datei sich inhaltlich von einer anderen Datei unterscheidet, kann der Parameter q verwendet werden:
diff -q Datei1 Datei2
Unterscheiden sich die Dateien, gibt diff eine entsprechende Meldung aus, ansonsten erfolgt keine Ausgabe.
Dateien datei1 und datei2 sind verschieden.
Ohne den Parameter q zeigt diff die Unterschiede an, das sieht zum Beispiel so aus:
diff beispiel2 beispiel1 1,2c1,2 < Das ist ein Beispieltext für einen Blogartikel. < Diese Datei heisst beispiel2. --- > Das hier ist ein Beispieltext. > Diese Datei heisst beispiel1. 6C6 < Nicht eingerückter Text. --- > Eingerückter Text. 8A9,10 > > Mit noch mehr Text.
| Diff zeigt immer an, was man in der zweiten Datei ändern müsste, damit sie der ersten Datei entspricht.
Die erste Zeile (1,2c1,2) bedeutet: Zeile 1 und Zeile 2 der zweiten Datei müssen verändert (c steht für change, das englische Wort für Ändern) werden, damit sie Zeile 1 und 2 der ersten Datei entsprechen. Außerdem wird der Inhalt der Zeilen angezeigt, so sieht man gleich was man ändern müsste. |
Datei:Grafik18.png |
Außer c für change gibt es noch a, das steht für Anhängen (append), und d für Löschen (delete). 8a9,10 bedeutet also, das hinter Zeile 8 noch Text eingefügt werden muss, nämlich die Zeilen 9 und 10 der zweiten Datei.
Ansicht ändern
Es gibt auch noch zwei andere Ausgabeformate. Das eine ist das Kontext-Format, dabei werden zu jeder Zeile, die verändert werden muss, auch noch die vorangehenden und folgenden 3 Zeilen angezeigt.
Die ersten beiden Zeilen geben an, welche Dateien verglichen werden, und das Inhalte aus der ersten Datei mittels Sternchen (***) und Inhalte aus der zweiten Zeile mittels Bindestrichen (---) gekennzeichnet werden.
$ diff -c beispiel2 beispiel1 *** beispiel2 2009-05-12 22:01:52.000000000 +0200 --- beispiel1 2009-05-12 20:26:48.000000000 +0200 *************** *** 1,8 **** ! Das ist ein Beispieltext für einen Blogartikel. ! Diese Datei heisst beispiel2. Lorem ipsum. ! Nicht eingerückter Text. Hier geht es noch weiter. --- 1,10 ---- ! Das hier ist ein Beispieltext. ! Diese Datei heisst beispiel1. Lorem ipsum. ! Eingerückter Text. Hier geht es noch weiter. + + Mit noch mehr Text.
Änderungen werden durch ein Ausrufezeichen, hinzuzufügende Zeilen mit einem Plus, zu entfernende Zeilen mit einem Minus gekennzeichnet.
Außerdem ist es möglich die Inhalte der beiden Dateien nebeneinander anzuzeigen.
$ diff -y beispiel2 beispiel1
Das ist ein Beispieltext für einen Blogartikel. | Das hier ist ein Beispieltext.
Diese Datei heisst beispiel2. | Diese Datei heisst beispiel1.
Lorem ipsum. Lorem ipsum.
Nicht eingerückter Text. | Eingerückter Text.
Hier geht es noch weiter. Hier geht es noch weiter.
>
> Mit noch mehr Text.
Was kann diff noch?
Möchte man drei Dateien miteinander vergleichen kann man anstatt diff den Befehl diff3 verwenden.
$ diff3 beispiel1 beispiel2 beispiel3 ====1 1:1,2c Das hier ist ein Beispieltext. Diese Datei heisst beispiel1. 2:1,2c 3:1,2c Das ist ein Beispieltext für einen Blogartikel. Diese Datei heisst beispiel2.
Es ist auch möglich mit diff den Inhalt von Verzeichnissen zu vergleichen, diff zeigt dann an, welche Dateien nur in einem der beiden Verzeichnisse existieren. Der Parameter r weist diff an, auch Unterverzeichnisse zu überprüfen.
$ diff -r verz1 verz2 Nur in verz1: datei3.
Wenn man längere Texte miteinander vergleicht und die Ausgabe nicht mehr auf den Bildschirm passt kann man sie auch an ein Programm wie less übergeben:
diff datei1 datei2 | less
Anschließend kann man bequem durch die Ausgabe von diff scrollen.
Optionen
| -q | für quick, gibt nur Unterschiede aus |
| -s | für same, meldet wenn Dateien gleich sind |
| --help | Hilfe |
| -r | für rekursiv, vergleicht Unterverzeichnisse wenn vorhanden |
| -y | tabellarische Ausgabe, auch gleiche Zeilen, ungleiche Zeilen werden markiert |
| --suppress-common-lines | unterdrückt gleiche Zeilen |
| -a | behandelt alle Dateien (z. B. binäre) wie Text |
| -d | versucht mit erhöhtem Aufwand kleinere Veränderungen zu finden |
| --speed-large-files | geht von großen Dateien und vielen, kleinen, verstreuten Veränderungen aus |
Beispiele
$ diff -q DATEI1 DATEI2 Dateien DATEI1 und DATEI2 unterscheiden sich diff DATEI1 DATEI2 4,6c4,5 < Unterschied 1 < Unterschied 2 < Unterschied 5 --- > Unterschied 3 > Unterschied 4
Zuerst gibt diff an, in welcher Zeile sich die Unterschiede befinden. Zeilen mit < sind in der ersten Datei vorhanden und Zeilen mit > in der zweiten.
Vergleichen von Ordnern:
$ diff -s ORDNER1 ORDNER2 Dateien ORDNER1/DATEI1 und ORDNER2/DATEI1 sind identisch Dateien ORDNER1/DATEI2 und ORDNER2/DATEI2 sind identisch Nur in ORDNER2: DATEI3
Patchdatei erstellen
Wer sich mit Programmierung, Bugs oder dem Verbessern von Programmen beschäftigt, benutzt diff um Änderungen per Versionsverwaltung mitzuteilen. Um nicht alle Codedateien mit Änderungen auszutauschen, werden nur die geänderten Stellen im Diff-Format gespeichert. Der so erstellte Diff kann dann als Patch (beispielsweise mit patch) angewandt werden.
Folgende Optionen von diff sind außerdem noch für das Erstellen einer Patchdatei interessant:
| -q | ignoriert in diesem Fall fehlende Dateien |
| -u | für unified, gibt NUM (Standard 3) der unveränderten Zeilen aus |
| -N | für New, erstellt fehlende Dateien |
Beispiele
$ diff -uNr ORIGINALDATEI VERBESSERTE_DATEI > DIFFDATEI.diff
Die Datei DIFFDATEI.diff würde dann in etwa so aussehen:
--- a/ORIGINALDATEI
+++ b/VERBESSERTE_DATEI
@@ -1,8 +1,9 @@
Gleich 1
Gleich 2
Gleich 3
+ Unterschied 1
+ Unterschied 2
- Unterschied 3
- Unterschied 4
+ Unterschied 5
Gleich 4
Gleich 5
Gleich 6
Nach Angabe der Dateien, in welcher Zeile man sich befindet und wie viele Zeilen es vorher und danach sind, kommen die drei gleichgebliebenen Zeilen. Die Angabe der Verzeichnisse (a/ und b/) dient nur als Platzhalter, falls Dateien bereits vorhanden sind. Zeilen mit + sind dazugekommen, Zeilen mit - weggenommen und Zeilen mit einem Leerzeichen " " gleichgeblieben.
diff -uNr ORDNER1 ORDNER2 > DIFFORDNER.diff
Der Inhalt der Datei DIFFORDNER.diff:
diff -uNr ORDNER1/DATEI3 ORDNER2/DATEI3 --- ORDNER1/DATEI3 +++ ORDNER2/DATEI3 @@ -0,0 +1,5 @@ + Unterschied 1 + Unterschied 2 + Unterschied 3 + Unterschied 4 + Unterschied 5
Hier wurden die Ordner verglichen und in den - und +-Zeilen mit angegeben. Da DATEI3 noch nicht in ORDNER1 vorhanden (0,0) ist, werden die Zeilen 1-5 einfach eingefügt.
Somit wird die Datei bei einem Anwenden von patch erstellt.
tmp
DIFF(1) Dienstprogramme für Benutzer DIFF(1)
BEZEICHNUNG GNU diff - Dateien zeilenweise vergleichen
ÜBERSICHT diff [OPTION]… DATEIEN
BESCHREIBUNG DATEIEN zeilenweise vergleichen
Die obligatorischen Argumente für Optionen sind für deren Kurz- und Langform gleich.
--normal
Ein normales Diff ausgeben (Voreinstellung)
-q, --brief
Nur melden, wenn sich Dateien unterscheiden
-s, --report-identical-files
Melden, wenn zwei Dateien gleich sind
-c, -C ANZAHL, --context[=ANZAHL]
ANZAHL Zeilen (Vorgabe 3) des kopierten Umfelds ausgeben
-u, -U ANZAHL, --unified[=ANZAHL]
ANZAHL Zeilen (Vorgabe 3) des vereinheitlichten Kontexts ausgeben
-e, --ed
Ein ed(1)-Skript ausgeben
-n, --rcs
Ein Diff im RCS-Format ausgeben
-y, --side-by-side
Zwei Spalten ausgeben
-W, --width=ANZAHL
Höchstens ANZAHL Spalten (Vorgabe 130) ausgeben
--left-column
Nur die linke Spalte von gemeinsamen Zeilen ausgeben
--suppress-common-lines
Gemeinsame Zeilen nicht ausgeben
-p, --show-c-function
Für jede Änderung die entsprechende C-Funktion zeigen
-F, --show-function-line=REGULÄRER_AUSDRUCK
Die letzte Zeile zeigen, auf die REGULÄRER_AUSDRUCK passt
--label BESCHRIFTUNG
BESCHRIFTUNG an Stelle des Dateinamens und Zeitstempels benutzen (kann wiederholt werden)
-t, --expand-tabs
Tabulatoren in der Ausgabe durch Leerzeichen ersetzen
-T, --initial-tab
Tabulatoren durch Voranstellen von Tabulatoren ausgleichen
--tabsize=ANZAHL
Tabulator-Stopps befinden sich nach je ANZAHL (Vorgabe 8) Ausgabespalten
--suppress-blank-empty
Leerzeichen oder Tabulatoren vor leeren Ausgabezeilen unterdrücken
-l, --paginate
Die Ausgabe durch pr(1) leiten, um die Seiten zu nummerieren
-r, --recursive
Alle gefundenen Unterverzeichnisse rekursiv vergleichen
--no-dereference
Symbolischen Links nicht folgen
-N, --new-file
Fehlende Dateien als leer behandeln
--unidirectional-new-file
Fehlende erste Dateien als leer behandeln
--ignore-file-name-case
Ignoriert beim Vergleich von Dateinamen Groß- und Kleinschreibung
--no-ignore-file-name-case
Beachtet beim Vergleich von Dateinamen Groß- und Kleinschreibung
-x, --exclude=MUSTER
Dateien ausschließen, die auf MUSTER passen
-X, --exclude-from=DATEI
Dateien ausschließen, die auf irgendein Muster in DATEI passen
-S, --starting-file=DATEI
Beim Vergleich von Verzeichnissen mit DATEI beginnen
--from-file=DATEI1
DATEI1 mit allen Operanden vergleichen. DATEI1 kann ein Verzeichnis sein.
--to-file=DATEI2
Alle Operanden mit DATEI2 vergleichen. DATEI2 kann ein Verzeichnis sein.
-i, --ignore-case
Ignoriert unterschiedliche Groß- und Kleinschreibung im Dateiinhalt
-E, --ignore-tab-expansion
Änderungen auf Grund von Tabulator-Expansion ignorieren
-Z, --ignore-trailing-space
Alle Leerräume am Zeilenende ignorieren
-b, --ignore-space-change
Änderungen der Anzahl von Leerräumen ignorieren
-w, --ignore-all-space
Alle Leerräume ignorieren
-B, --ignore-blank-lines
Änderungen ignorieren, die nur leere Zeilen betreffen
-I, --ignore-matching-lines=REGULÄRER_AUSDRUCK
Änderungen ignorieren, deren Zeilen alle auf REGULÄRER_AUSDRUCK passen
-a, --text
Alle Dateien als Text behandeln
--strip-trailing-cr
Wagenrücklauf (Carriage Return) am Ende der Eingabe entfernen
-D, --ifdef=NAME
Zusammengefügte Datei mit »#ifdef NAME«-Diffs ausgeben
--GTYPE-group-format=GFMT
GTYPE-Eingabegruppen mit GFMT formatieren
--line-format=LFMT
Alle Eingabezeilen mit LFMT formatieren
--LTYPE-line-format=LFMT
Alle LTYPE-Eingabezeilen mit LFMT formatieren
Mit den folgenden Optionen, einer Verallgemeinerung von
-D/--ifdef, können Sie die Formatierung der Ausgabe von diff detailliert festlegen.
LTYPE kann »old«, »new« oder »unchanged« sein.
GTYPE ist LTYPE oder »changed«.
GFMT darf (nur) Folgendes enthalten:
%< Zeilen aus DATEI1
%> Zeilen aus DATEI2
%= Gemeinsame Zeilen von DATEI1 und DATEI2
%[-][BREITE][.[PRÄZ]]{doxX}BUCHSTABE
Angabe im printf(1)-Stil für BUCHSTABE
BUCHSTABEn sind für neue Gruppe, Kleinschreibung und alte Gruppe wie folgt:
F Erste Zeilennummer
L Letzte Zeilennummer
N Anzahl der Zeilen = L-F+1
E F-1
M L+1
%(A=B?T:E)
Wenn A gleich B ist, dann T, sonst E
LFMT darf (nur) Folgendes enthalten:
%L Inhalt der Zeile
%l Inhalt der Zeile, außer irgendwelchen führenden Zeilenumbrüchen
%[-][BREITE][.[PRÄZ]]{doxX}n
Angabe im printf(1)-Stil für Eingabe-Zeilennummer
Sowohl GFMT als auch LFMT dürfen Folgendes enthalten:
%% %
%c»C« Das einzelne Zeichen C
%c»\OOO«
Das Zeichen mit dem oktalen Code 000
C Das Zeichen C (andere Zeichen stellen sich selbst dar)
-d, --minimal
Intensive Suche nach einer kleineren Menge von Änderungen
--horizon-lines=ANZAHL
ANZAHL Zeilen des üblichen Präfix und der Endung behalten
--speed-large-files
Große Dateien und viele vereinzelte kleine Änderungen annehmen
--color[=WANN]
Farben bei der Ausgabe verwenden; WANN kann die Werte »never«, »always« oder »auto« (Voreinstellung) annehmen
--palette=PALETTE
Die Farben, die verwandt werden sollen, wenn --color aktiv ist. PALETTE ist eine durch Doppelpunkte getrennte Liste von »terminfo capabili‐
ties«
--help zeigt Hilfeinformationen an und beendet das Programm.
-v, --version
gibt Versionsinformationen aus und beendet das Programm.
DATEIEN sind »DATEI1 DATEI2« oder »VERZEICHNIS1 VERZEICHNIS2« oder »VERZEICHNIS DATEI« oder »DATEI VERZEICHNIS«. Falls --from-file oder --to-file an‐ gegeben ist, gibt es keine Einschränkungen für DATEI(en). Falls eine DATEI »-« ist, wird die Standardeingabe gelesen. Der Rückgabewert ist 0, wenn die Eingaben gleich sind, 1, wenn verschieden und 2 bei Problemen.
AUTOR Geschrieben von Paul Eggert, Mike Haertel, David Hayes, Richard Stallman und Len Tower.
FEHLER MELDEN Melden Sie Fehler (auf Englisch) an ⟨bug-diffutils@gnu.org⟩. Homepage der GNU diffutils: ⟨https://www.gnu.org/software/diffutils/⟩ Allgemeine Hilfe zur Benutzung von GNU-Software: ⟨https://www.gnu.org/gethelp/⟩
COPYRIGHT Copyright © 2018 Free Software Foundation, Inc. Lizenz GPLv3+: GNU GPL Version 3 ⟨https://gnu.org/licenses/gpl.html⟩ oder neuer. Dies ist freie Software: Sie können sie verändern und weitergeben. Es gibt KEINE GARANTIE, soweit gesetzlich zulässig.
SIEHE AUCH wdiff(1), cmp(1), diff3(1), sdiff(1), patch(1)
Die vollständige Dokumentation für diff wird als Texinfo-Handbuch gepflegt. Wenn die Programme info(1) und diff auf Ihrem Rechner ordnungsgemäß in‐ stalliert sind, können Sie mit dem Befehl
info diff
auf das vollständige Handbuch zugreifen.
ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Michael Piefel <piefel@debian.org>, Chris Leick <c.leick@vollbio.de>, Dr. Tobias Quathamer <toddy@debian.org> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer ⟨debian-l10n- german@lists.debian.org⟩.
diffutils 3.7 Dezember 2018 DIFF(1)