Diese Dokumentation wurde zur Beschreibung der Serie 1.7.x von Apache™ Subversion® erstellt. Falls Sie eine unterschiedliche Version von Subversion einsetzen, sei Ihnen dringend angeraten, bei http://www.svnbook.com/ vorbeizuschauen und stattdessen die zu Ihrer Version von Subversion passende Version dieser Dokumentation heranzzuiehen.

Protokollierung auf hohem Niveau

Sowohl der Apache httpd- als auch der Subversion svnserve-Server bieten die Protokollierung von Subversion-Operationen auf hohem Niveau. Die Einstellung jeder dieser Server-Optionen zur Bereitstellung dieser Protokollstufe erfolgt natürlich auf unterschiedliche Weise; gleichwohl folgt jedes Ausgabeformat einer einheitlichen Syntax.

Um dieses hohe Protokollierungsniveau in svnserve zu ermöglichen, brauchen Sie nur beim Start des Servers die Kommandozeilenoption --log-file zu verwenden, deren Wert der Name der Datei ist, in die svnserve seine Protokollausgaben schreibt.

$ svnserve -d -r /path/to/repositories --log-file /var/log/svn.log

Um das Gleiche in Apache einzustellen, ist etwas mehr Arbeit notwendig, jedoch handelt es sich um eine Erweiterung von Apaches Standardkonfigurationsmechanismus für die Protokollausgabe (Näheres unter „Protokollierung von Apache“).

Es folgt eine eine Liste mit Protokollnachrichten von Subversion-Aktionen, die von seinem Protokollierungsmechanismus auf hohem Niveau erzeugt werden, gefolgt durch ein oder mehrere Beispiele einer Protokollnachricht wie sie in der Ausgabe erscheint.

Checkout oder Export
checkout-or-export /path r62 depth=infinity
Übergabe
commit harry r100
Diffs
diff /path r15:20 depth=infinity ignore-ancestry
diff /path1@15 /path2@20 depth=infinity ignore-ancestry
Holen eines Verzeichnisses
get-dir /trunk r17 text
Holen einer Datei
get-file /path r20 props
Holen einer Dateirevision
get-file-revs /path r12:15 include-merged-revisions
Holen von Informationen über eine Zusammenführung
get-mergeinfo (/path1 /path2)
Sperre
lock /path steal
Protokoll
log (/path1,/path2,/path3) r20:90 discover-changed-paths revprops=()
Wiederholen von Revisionen (svnsync)
replay /path r19
Änderung einer Revisions-Eigenschaft
change-rev-prop r50 propertyname
Liste von Revisions-Eigenschaften
rev-proplist r34
Status
status /path r62 depth=infinity
Umschalten
switch /pathA /pathB@50 depth=infinity
Entsperren
unlock /path break
Aktualisieren
update /path r17 send-copyfrom-args

Zur Erleichterung der Arbeit von Administratoren, die ihre Subversion Protokollausgaben nachbearbeiten möchten (vielleicht für Berichte oder zur Analyse), ist den Quelltextpaketen für Subversion ein Python-Modul unter tools/server-side/svn_server_log_parse.py beigelegt, das verwendet werden kann, um die Protokollausgaben von Subversion zu parsen.