Name

mod_dav_svn-Konfigurationsanweisungen — Apache Konfigurationsanweisungen, um Subversion-Projektarchive über den Apache-HTTP-Server bereitzustellen.

Beschreibung

Dieser Abschnitt beschreibt kurz jede Apache-Konfigurationsanweisung für Subversion. Für eine tiefergehende Beschreibung zur Konfigurierung von Apache für Subversion, siehe „httpd, der Apache HTTP-Server“.

Anweisungen

Das sind die Anweisungen für httpd.conf, die sich auf mod_dav_svn beziehen:

DAV svn

Muss in jedem Directory- oder Location-Abschnitt für ein Subversion-Projektarchiv enthalten sein. Sie fordert httpd auf, das Subversion-Backend von mod_dav zur Auftragsabwicklung zu verwenden.

SVNAllowBulkUpdates On|Off

Ändert die Unterstützung für vollständige Antworten auf REPORT-Anfragen im Stil von Aktualisierungen. Subversion-Clients verwenden REPORT-Anfragen, um von mod_dav_svn Informationen über Checkouts und Aktualisierungen von Verzeichnisbäumen zu erhalten. Dabei kann vom Server verlangt werden, diese Information auf zwei mögliche Weisen zu senden: entweder mit den Informationen zum gesamten Teilbaum in einer umfangreichen Antwort oder als ein Skelta (eine skelettierte Repräsentation eines Baum-Deltas), das dem Client gerade genug Informationen liefert, so dass er weiß, welche zusätzlichen Daten er vom Server abfragen muss. Wird diese Direktive mit dem Wert Off versehen, werden REPORT-Anfragen von mod_dav_svn ausschließlich mit Skeltas beantwortet, egal welche Art der Antwort vom Client verlangt wurde.

Die Meisten werden diese Direktive überhaupt nicht benötigen. Sie existiert hauptsächlich für Administratoren, die – aus Gründen der Sicherheit oder Nachprüfbarkeit – Subversion-Clients dazu zwingen möchten, alle für Checkouts oder Aktualisierungen benötigten Dateien und Verzeichnisse individuell abzurufen, um somit eine Spur aus GET- und PROPFIND-Anfragen in den Protokolldateien von Apache zu hinterlassen. Der Standardwert dieser Direktive ist On.

SVNAutoversioning On|Off

Wenn der Wert On ist, führen Schreibanfragen von WebDAV-Clients zu automatischen Übergaben ins Projektarchiv. Eine automatisch erzeugte, generische Protokollnachricht wird mit jeder Revision verknüpft. Falls Sie automatische Versionierung ermöglichen, werden Sie sicherlich auch ModMimeUsePathInfo On setzen wollen, so dass mod_mime svn:mime-type automatisch auf den richtigen MIME-Typen setzen kann (natürlich nur so gut, wie es mod_mime kann). Für weitere Informationen, siehe Anhang C, WebDAV und Autoversionierung. Der Standardwert dieser Direktive ist Off.

SVNPath directory-path

Gibt den Ort im Dateisystem an, an dem die Dateien eines Subversion-Projektarchivs liegen. In einem Konfigurationsblock für ein Subversion-Projektarchiv muss entweder diese Direktive oder SVNParentPath vorhanden sein, jedoch nicht beide.

SVNSpecialURI component

Spezifiziert die URI-Komponente (Namensraum) für besondere Subversion-Ressourcen. Der Standardwert ist !svn, und die meisten Administratoren werden diese Direktive nie verwenden. Setzen Sie sie nur, falls die dringende Notwendigkeit besteht, eine Datei namens !svn in Ihrem Projektarchiv zu haben. Falls Sie diese Direktive auf einem Server ändern, der bereits in Gebrauch ist, werden alle offenstehenden Arbeitskopien unbrauchbar gemacht, und Ihre Benutzer werden Sie mit Mistgabeln und Fackeln zur Strecke bringen.

SVNReposName name

Spezifiziert den Namen eines Subversion-Projektarchivs zur Verwendung für HTTP GET-Antworten. Dieser Wert wird dem Titel aller Verzeichnisauflistungen vorangestellt (die übertragen werden, wenn Sie mit einem Browser zu einem Subversion-Projektarchiv navigieren). Diese Direktive ist optional.

SVNIndexXSLT directory-path

Spezifiziert den URI einer XSL-Transformation für Verzeichnisindexe. Diese Direktive ist optional.

SVNParentPath directory-path

Spezifiziert den Ort im Dateisystem, an dem ein Elternverzeichnis liegt, dessen Kindverzeichnisse Subversion-Projektarchive sind. In einem Konfigurationsblock für ein Subversion-Projektarchiv muss entweder diese Direktive oder SVNPath vorhanden sein, jedoch nicht beide.

SVNPathAuthz On|Off|short_circuit

Kontrolliert pfadbasierte Autorisierung, indem Unteranfragen ermöglicht (On) oder abgeschaltet (Off; siehe „Abstellen pfadbasierter Prüfungen“) werden oder bei mod_authz_svn direkt nachgefragt wird (short_circuit). Der Standardwert dieser Direktive ist On.

SVNListParentPath On|Off

Wenn sie auf On gesetzt ist, wird ein GET von SVNParentPath erlaubt, was zu einer Auflistung aller Projektarchive unter diesem Pfad führt. Der Standardwert ist Off.

SVNMasterURI url

Der URI des Master-Subversion-Projektarchivs (verwendet für einen Proxy, über den geschrieben wird).

SVNActivitiesDB directory-path

Spezifiziert den Ort im Dateisystem, an dem die Datenbank für Aktivitäten abgelegt werden soll. Standardmäßig erzeugt und verwendet mod_dav_svn ein Verzeichnis im Projektarchiv namens dav/activities.d. Der durch diese Option angegebene Pfad muss absolut sein.

Falls sie für einen SVNParentPath-Bereich angegeben wird, hängt mod_dav_svn den Basisnamen des Projektarchivs an den hier angegebenen Pfad. Zum Beispiel:

<Location /svn>
  DAV svn

  # any "/svn/foo" URL will map to a repository in 
  # /net/svn.nfs/repositories/foo
  SVNParentPath         "/net/svn.nfs/repositories"

  # any "/svn/foo" URL will map to an activities db in
  #  /var/db/svn/activities/foo
  SVNActivitiesDB       "/var/db/svn/activities"
</Location>

Protokollierung auf hoher Ebene

Dies ist eine Liste mit Protokollnachrichten von Subversion-Aktionen, die von Apaches Protokollmechanismus auf hoher Ebene erzeugt werden, gefolgt durch ein Beispiel einer Protokollnachricht. Siehe „Protokollierung von Apache“ für Details zur Protokollierung.

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