# svn_dav.h File Reference

Code related to WebDAV/DeltaV usage in Subversion. More...

Go to the source code of this file.

## Defines
#define | SVN_SVNDIFF_MIME_TYPE "application/vnd.svn-svndiff"
| This is the MIME type that Subversion uses for its "svndiff" format.
#define | SVN_SKEL_MIME_TYPE "application/vnd.svn-skel"
| This is the MIME type that Subversion users for its "skel" format.
#define | SVN_DAV_DELTA_BASE_HEADER "X-SVN-VR-Base"
| This header is *TEMPORARILY* used to transmit the delta base to the server.
#define | SVN_DAV_OPTIONS_HEADER "X-SVN-Options"
| This header is used when an svn client wants to trigger specific svn server behaviors.
#define | SVN_DAV_VERSION_NAME_HEADER "X-SVN-Version-Name"
| This header is used when an svn client wants to tell mod_dav_svn exactly what revision of a resource it thinks it's operating on.
#define | SVN_DAV_CREATIONDATE_HEADER "X-SVN-Creation-Date"
| A header generated by mod_dav_svn whenever it responds successfully to a LOCK request.
#define | SVN_DAV_LOCK_OWNER_HEADER "X-SVN-Lock-Owner"
| A header generated by mod_dav_svn whenever it responds successfully to a PROPFIND for the 'DAV:lockdiscovery' property.
#define | SVN_DAV_YOUNGEST_REV_HEADER "SVN-Youngest-Rev"
| Assuming the OPTIONS was performed against a resource within a Subversion repository, then this header indicates the youngest revision in the repository.
#define | SVN_DAV_REPOS_UUID_HEADER "SVN-Repository-UUID"
| Assuming the OPTIONS was performed against a resource within a Subversion repository, then this header indicates the UUID of the repository.
#define | SVN_DAV_ME_RESOURCE_HEADER "SVN-Me-Resource"
| Presence of this in a DAV header in an OPTIONS response indicates that the server speaks HTTP protocol v2.
#define | SVN_DAV_ROOT_URI_HEADER "SVN-Repository-Root"
| This header provides the repository root URI, suitable for use in calculating the relative paths of other public URIs for this repository into .
#define | SVN_DAV_REV_STUB_HEADER "SVN-Rev-Stub"
| This header provides an opaque URI that the client can append a revision to, to construct a 'revision URL'.
#define | SVN_DAV_REV_ROOT_STUB_HEADER "SVN-Rev-Root-Stub"
| This header provides an opaque URI that the client can append PEGREV/PATH to, in order to construct URIs of pegged objects in the repository, similar to the use of a "revision root" in the libsvn_fs API.
#define | SVN_DAV_TXN_STUB_HEADER "SVN-Txn-Stub"
| This header provides an opaque URI which represents a Subversion transaction (revision-in-progress) object.
#define | SVN_DAV_VTXN_STUB_HEADER "SVN-VTxn-Stub"
| Companion to `SVN_DAV_TXN_STUB_HEADER`, used when a POST request returns `SVN_DAV_VTXN_NAME_HEADER` in response to a client supplied name.
#define | SVN_DAV_TXN_ROOT_STUB_HEADER "SVN-Txn-Root-Stub"
| This header provides an opaque URI which represents the root directory of a Subversion transaction (revision-in-progress), similar to the concept of a "txn root" in the libsvn_fs API.
#define | SVN_DAV_VTXN_ROOT_STUB_HEADER "SVN-VTxn-Root-Stub"
| Companion to `SVN_DAV_TXN_ROOT_STUB_HEADER`, used when a POST request returns `SVN_DAV_VTXN_NAME_HEADER` in response to a client supplied name.
#define | SVN_DAV_TXN_NAME_HEADER "SVN-Txn-Name"
| This header is used in the POST response to tell the client the name of the Subversion transaction created by the request.
#define | SVN_DAV_VTXN_NAME_HEADER "SVN-VTxn-Name"
| This header is used in the POST request, to pass a client supplied alternative transaction name to the server, and in the the POST response, to tell the client that the alternative transaction resource names should be used.
#define | SVN_DAV_ERROR_NAMESPACE "svn:"
| The error object's namespace.
#define | SVN_DAV_ERROR_TAG "error"
| The error object's tag.
#define | SVN_DAV_PROP_NS_SVN "http://subversion.tigris.org/xmlns/svn/"
| A property stored in the fs and wc, begins with 'svn:', and is interpreted either by client or server.
#define | SVN_DAV_PROP_NS_CUSTOM "http://subversion.tigris.org/xmlns/custom/"
| A property stored in the fs and wc, but totally ignored by svn client and server.
#define | SVN_DAV_PROP_NS_DAV "http://subversion.tigris.org/xmlns/dav/"
| A property purely generated and consumed by the network layer, not seen by either fs or wc.
options-header defines
Specific options that can appear in the options-header:
#define | SVN_DAV_OPTION_NO_MERGE_RESPONSE "no-merge-response"
#define | SVN_DAV_OPTION_LOCK_BREAK "lock-break"
#define | SVN_DAV_OPTION_LOCK_STEAL "lock-steal"
#define | SVN_DAV_OPTION_RELEASE_LOCKS "release-locks"
#define | SVN_DAV_OPTION_KEEP_LOCKS "keep-locks"
Fulltext MD5 headers
These headers are for client and server to verify that the base and the result of a change transmission are the same on both sides, regardless of what transformations (svndiff deltification, gzipping, etc) the data may have gone through in between. The result md5 is always used whenever file contents are transferred, because every transmission has a resulting text. The base md5 is used to verify the base text against which svndiff data is being applied. Note that even for svndiff transmissions, base verification is not strictly necessary (and may therefore be unimplemented), as any error will be caught by the verification of the final result. However, if the problem is that the base text is corrupt, the error will be caught earlier if the base md5 is used. Normal WebDAV or DeltaV clients don't use these.
#define | SVN_DAV_BASE_FULLTEXT_MD5_HEADER "X-SVN-Base-Fulltext-MD5"
#define | SVN_DAV_RESULT_FULLTEXT_MD5_HEADER "X-SVN-Result-Fulltext-MD5"
Custom (extension) values for the DAV header.
Note that although these share the SVN_DAV_PROP_NS_DAV namespace prefix, they are not properties; they are header values.
#define | SVN_DAV_NS_DAV_SVN_DEPTH SVN_DAV_PROP_NS_DAV "svn/depth"
| Presence of this in a DAV header in an OPTIONS request or response indicates that the transmitter supports `svn_depth_t`.
#define | SVN_DAV_NS_DAV_SVN_MERGEINFO SVN_DAV_PROP_NS_DAV "svn/mergeinfo"
| Presence of this in a DAV header in an OPTIONS request or response indicates that the server knows how to handle merge-tracking information.
#define | SVN_DAV_NS_DAV_SVN_LOG_REVPROPS SVN_DAV_PROP_NS_DAV "svn/log-revprops"
| Presence of this in a DAV header in an OPTIONS response indicates that the transmitter (in this case, the server) knows how to send custom revprops in log responses.
#define | SVN_DAV_NS_DAV_SVN_ATOMIC_REVPROPS SVN_DAV_PROP_NS_DAV "svn/atomic-revprops"
| Presence of this in a DAV header in an OPTIONS response indicates that the transmitter (in this case, the server) knows how to enforce old-value atomicity in PROPPATCH (for editing revprops).
#define | SVN_DAV_NS_DAV_SVN_PARTIAL_REPLAY SVN_DAV_PROP_NS_DAV "svn/partial-replay"
| Presence of this in a DAV header in an OPTIONS response indicates that the transmitter (in this case, the server) knows how to handle a replay of a directory in the repository (not root).

## Detailed Description

Code related to WebDAV/DeltaV usage in Subversion.

Definition in file svn_dav.h.

## Define Documentation

#define SVN_DAV_CREATIONDATE_HEADER "X-SVN-Creation-Date"

A header generated by mod_dav_svn whenever it responds successfully to a LOCK request.

Only svn clients will notice it, and use it to fill in svn_lock_t->creation_date.

Definition at line 86 of file svn_dav.h.

#define SVN_DAV_DELTA_BASE_HEADER "X-SVN-VR-Base"

This header is *TEMPORARILY* used to transmit the delta base to the server.

It contains a version resource URL for what is on the client.

Definition at line 57 of file svn_dav.h.

#define SVN_DAV_LOCK_OWNER_HEADER "X-SVN-Lock-Owner"

A header generated by mod_dav_svn whenever it responds successfully to a PROPFIND for the 'DAV:lockdiscovery' property.

Only svn clients will notice it, and use it to fill in svn_lock_t->owner. (Remember that the DAV:owner field maps to svn_lock_t->comment, and that there is no analogue in the DAV universe of svn_lock_t->owner.)

Definition at line 94 of file svn_dav.h.

#define SVN_DAV_ME_RESOURCE_HEADER "SVN-Me-Resource"

Presence of this in a DAV header in an OPTIONS response indicates that the server speaks HTTP protocol v2.

This header provides an opaque URI that the client should send all custom REPORT requests against.

Since:
  New in 1.7.

Definition at line 113 of file svn_dav.h.

#define SVN_DAV_OPTIONS_HEADER "X-SVN-Options"

This header is used when an svn client wants to trigger specific svn server behaviors.

Normal WebDAV or DeltaV clients won't use it.

Definition at line 62 of file svn_dav.h.

#define SVN_DAV_REPOS_UUID_HEADER "SVN-Repository-UUID"

Assuming the OPTIONS was performed against a resource within a Subversion repository, then this header indicates the UUID of the repository.

Since:
  New in 1.7.

Definition at line 106 of file svn_dav.h.

#define SVN_DAV_REV_ROOT_STUB_HEADER "SVN-Rev-Root-Stub"

This header provides an opaque URI that the client can append PEGREV/PATH to, in order to construct URIs of pegged objects in the repository, similar to the use of a "revision root" in the libsvn_fs API.

(HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 134 of file svn_dav.h.

#define SVN_DAV_REV_STUB_HEADER "SVN-Rev-Stub"

This header provides an opaque URI that the client can append a revision to, to construct a 'revision URL'.

This allows direct read/write access to revprops via PROPFIND or PROPPATCH, and is similar to libsvn_fs's revision objects (as distinct from "revision roots"). (HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 127 of file svn_dav.h.

#define SVN_DAV_ROOT_URI_HEADER "SVN-Repository-Root"

This header provides the repository root URI, suitable for use in calculating the relative paths of other public URIs for this repository into .

(HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 119 of file svn_dav.h.

#define SVN_DAV_TXN_NAME_HEADER "SVN-Txn-Name"

This header is used in the POST response to tell the client the name of the Subversion transaction created by the request.

It can then be appended to the transaction stub and transaction root stub for access to the properties and paths, respectively, of the named transaction. (HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 171 of file svn_dav.h.

#define SVN_DAV_TXN_ROOT_STUB_HEADER "SVN-Txn-Root-Stub"

This header provides an opaque URI which represents the root directory of a Subversion transaction (revision-in-progress), similar to the concept of a "txn root" in the libsvn_fs API.

The client can append additional path segments to it to access items deeper in the transaction tree as part of a commit process. (HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 157 of file svn_dav.h.

#define SVN_DAV_TXN_STUB_HEADER "SVN-Txn-Stub"

This header provides an opaque URI which represents a Subversion transaction (revision-in-progress) object.

It is suitable for use in fetching and modifying transaction properties as part of a commit process, similar to the svn_fs_txn_t object (as distinct from a "txn root"). (HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 142 of file svn_dav.h.

#define SVN_DAV_VERSION_NAME_HEADER "X-SVN-Version-Name"

This header is used when an svn client wants to tell mod_dav_svn exactly what revision of a resource it thinks it's operating on.

(For example, an svn server can use it to validate a DELETE request.) Normal WebDAV or DeltaV clients won't use it.

Definition at line 81 of file svn_dav.h.

#define SVN_DAV_VTXN_NAME_HEADER "SVN-VTxn-Name"

This header is used in the POST request, to pass a client supplied alternative transaction name to the server, and in the the POST response, to tell the client that the alternative transaction resource names should be used.

(HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 178 of file svn_dav.h.

#define SVN_DAV_VTXN_ROOT_STUB_HEADER "SVN-VTxn-Root-Stub"

Companion to `SVN_DAV_TXN_ROOT_STUB_HEADER`, used when a POST request returns `SVN_DAV_VTXN_NAME_HEADER` in response to a client supplied name.

(HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 163 of file svn_dav.h.

#define SVN_DAV_VTXN_STUB_HEADER "SVN-VTxn-Stub"

Companion to `SVN_DAV_TXN_STUB_HEADER`, used when a POST request returns `SVN_DAV_VTXN_NAME_HEADER` in response to a client supplied name.

(HTTP protocol v2 only)

Since:
  New in 1.7.

Definition at line 148 of file svn_dav.h.

#define SVN_DAV_YOUNGEST_REV_HEADER "SVN-Youngest-Rev"

Assuming the OPTIONS was performed against a resource within a Subversion repository, then this header indicates the youngest revision in the repository.

Since:
  New in 1.7.

Definition at line 100 of file svn_dav.h.

#define SVN_SKEL_MIME_TYPE "application/vnd.svn-skel"

This is the MIME type that Subversion users for its "skel" format.

This is an application type, for the "svn" vendor. The specific subtype is "skel".

Since:
  New in 1.7.

Definition at line 52 of file svn_dav.h.

#define SVN_SVNDIFF_MIME_TYPE "application/vnd.svn-svndiff"

This is the MIME type that Subversion uses for its "svndiff" format.

This is an application type, for the "svn" vendor. The specific subtype is "svndiff".

Definition at line 44 of file svn_dav.h.

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines