GME
13
|
The filesystem 'dump' format contains nothing but the abstract structure of the filesystem -- independent of any internal node-id schema or database back-end. All of the data in the dumpfile is acquired by public function calls into svn_fs.h. Similarly, the parser which reads the dumpfile is able to reconstruct the filesystem using only public svn_fs.h routines.
Thus the dump/load feature's main purpose is for *migrating* data from one svn filesystem to another -- presumably two filesystems which have different internal implementations.
If you simply want to backup your filesystem, you're probably better off using the built-in facilities of the DB backend (using Berkeley DB's hot-backup feature, for example.)
For a description of the dumpfile format, see /trunk/notes/fs_dumprestore.txt.
#define SVN_REPOS_DUMPFILE_CONTENT_LENGTH "Content-length" |
Definition at line 2506 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_FORMAT_VERSION 3 |
Definition at line 2503 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_FORMAT_VERSION_DELTAS 3 |
Definition at line 2504 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_MAGIC_HEADER "SVN-fs-dump-format-version" |
Definition at line 2502 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_NODE_ACTION "Node-action" |
Definition at line 2512 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_NODE_COPYFROM_PATH "Node-copyfrom-path" |
Definition at line 2513 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_NODE_COPYFROM_REV "Node-copyfrom-rev" |
Definition at line 2514 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_NODE_KIND "Node-kind" |
Definition at line 2511 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_NODE_PATH "Node-path" |
Definition at line 2510 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_PROP_CONTENT_LENGTH "Prop-content-length" |
Definition at line 2528 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_PROP_DELTA "Prop-delta" |
Definition at line 2532 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_REVISION_NUMBER "Revision-number" |
Definition at line 2508 of file svn_repos.h.
Definition at line 2525 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_CONTENT_LENGTH "Text-content-length" |
Definition at line 2529 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_CONTENT_MD5 "Text-content-md5" |
Definition at line 2522 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_CONTENT_SHA1 "Text-content-sha1" |
Definition at line 2524 of file svn_repos.h.
Definition at line 2519 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_COPY_SOURCE_MD5 "Text-copy-source-md5" |
Definition at line 2516 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_COPY_SOURCE_SHA1 "Text-copy-source-sha1" |
Definition at line 2518 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_DELTA "Text-delta" |
Definition at line 2534 of file svn_repos.h.
Definition at line 2540 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_DELTA_BASE_MD5 "Text-delta-base-md5" |
Definition at line 2536 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_TEXT_DELTA_BASE_SHA1 "Text-delta-base-sha1" |
Definition at line 2538 of file svn_repos.h.
#define SVN_REPOS_DUMPFILE_UUID "UUID" |
Definition at line 2505 of file svn_repos.h.
typedef struct svn_repos_parse_fns2_t svn_repos_parse_fns2_t |
A vtable that is driven by svn_repos_parse_dumpstream2(). Similar to svn_repos_parse_fns3_t except that it lacks the delete_node_property and apply_textdelta callbacks.
typedef struct svn_repos_parse_fns3_t svn_repos_parse_fns3_t |
A vtable that is driven by svn_repos_parse_dumpstream3().
Definition at line 3035 of file svn_repos.h.
typedef struct svn_repos_parse_fns_t svn_repos_parser_fns_t |
A vtable that is driven by svn_repos_parse_dumpstream(). Similar to svn_repos_parse_fns2_t except that it lacks the delete_node_property and apply_textdelta callbacks.
SVN_DEPRECATED svn_error_t* svn_repos_dump_fs | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_stream_t * | feedback_stream, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_boolean_t | incremental, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_dump_fs2(), but with the use_deltas parameter always set to FALSE
.
SVN_DEPRECATED svn_error_t* svn_repos_dump_fs2 | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_stream_t * | feedback_stream, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_boolean_t | incremental, | ||
svn_boolean_t | use_deltas, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_dump_fs3(), but with a feedback_stream instead of handling feedback via the notify_func handler
svn_error_t* svn_repos_dump_fs3 | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_boolean_t | incremental, | ||
svn_boolean_t | use_deltas, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | scratch_pool | ||
) |
Dump the contents of the filesystem within already-open repos into writable dumpstream. Begin at revision start_rev, and dump every revision up through end_rev. Use pool for all allocation. If non-NULL
, send feedback to feedback_stream. If dumpstream is NULL
, this is effectively a primitive verify. It is not complete, however; svn_repos_verify_fs2() and svn_fs_verify().
If start_rev is SVN_INVALID_REVNUM, then start dumping at revision 0. If end_rev is SVN_INVALID_REVNUM, then dump through the HEAD
revision.
If incremental is TRUE
, the first revision dumped will be a diff against the previous revision (usually it looks like a full dump of the tree).
If use_deltas is TRUE
, output only node properties which have changed relative to the previous contents, and output text contents as svndiff data against the previous contents. Regardless of how this flag is set, the first revision of a non-incremental dump will be done with full plain text. A dump with use_deltas set cannot be loaded by Subversion 1.0.x.
If notify_func is not NULL
, then for every dumped revision call notify_func with rev set to the dumped revision and warning_text NULL
. For warnings call notify_func with warning_text.
If cancel_func is not NULL
, it is called periodically with cancel_baton as argument to see if the client wishes to cancel the dump.
SVN_DEPRECATED svn_error_t* svn_repos_get_fs_build_parser | ( | const svn_repos_parser_fns_t ** | parser, |
void ** | parse_baton, | ||
svn_repos_t * | repos, | ||
svn_boolean_t | use_history, | ||
enum svn_repos_load_uuid | uuid_action, | ||
svn_stream_t * | outstream, | ||
const char * | parent_dir, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_get_fs_build_parser2(), but yields the more limited svn_repos_parser_fns_t vtable type.
SVN_DEPRECATED svn_error_t* svn_repos_get_fs_build_parser2 | ( | const svn_repos_parse_fns2_t ** | parser, |
void ** | parse_baton, | ||
svn_repos_t * | repos, | ||
svn_boolean_t | use_history, | ||
enum svn_repos_load_uuid | uuid_action, | ||
svn_stream_t * | outstream, | ||
const char * | parent_dir, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_get_fs_build_parser3(), but with outstream in place if a svn_repos_notify_func_t and baton and with validate_props always FALSE.
SVN_DEPRECATED svn_error_t* svn_repos_get_fs_build_parser3 | ( | const svn_repos_parse_fns2_t ** | parser, |
void ** | parse_baton, | ||
svn_repos_t * | repos, | ||
svn_boolean_t | use_history, | ||
svn_boolean_t | validate_props, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_get_fs_build_parser4(), but with start_rev and end_rev always passed as SVN_INVALID_REVNUM, and yielding the more limited svn_repos_parse_fns2_t.
svn_error_t* svn_repos_get_fs_build_parser4 | ( | const svn_repos_parse_fns3_t ** | parser, |
void ** | parse_baton, | ||
svn_repos_t * | repos, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_boolean_t | use_history, | ||
svn_boolean_t | validate_props, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
apr_pool_t * | pool | ||
) |
Set *parser and *parse_baton to a vtable parser which commits new revisions to the fs in repos. The constructed parser will treat UUID records in a manner consistent with uuid_action. Use pool to operate on the fs.
start_rev and end_rev act as filters, the lower and upper (inclusive) range values of revisions in dumpstream which will be loaded. Either both of these values are SVN_INVALID_REVNUM (in which case no revision-based filtering occurs at all), or both are valid revisions (where start_rev is older than or equivalent to end_rev).
If use_history is set, then the parser will require relative 'copyfrom' history to exist in the repository when it encounters nodes that are added-with-history.
If validate_props is set, then validate Subversion revision and node properties (those in the svn: namespace) against established rules for those things.
If parent_dir is not NULL, then the parser will reparent all the loaded nodes, from root to parent_dir. The directory parent_dir must be an existing directory in the repository.
SVN_DEPRECATED svn_error_t* svn_repos_load_fs | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_stream_t * | feedback_stream, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_load_fs2(), but with use_pre_commit_hook and use_post_commit_hook always FALSE
.
SVN_DEPRECATED svn_error_t* svn_repos_load_fs2 | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_stream_t * | feedback_stream, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_boolean_t | use_pre_commit_hook, | ||
svn_boolean_t | use_post_commit_hook, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_load_fs3(), but with feedback_stream in place of the svn_repos_notify_func_t and baton and with validate_props always FALSE.
SVN_DEPRECATED svn_error_t* svn_repos_load_fs3 | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_boolean_t | use_pre_commit_hook, | ||
svn_boolean_t | use_post_commit_hook, | ||
svn_boolean_t | validate_props, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_load_fs4(), but with start_rev and end_rev always passed as SVN_INVALID_REVNUM.
svn_error_t* svn_repos_load_fs4 | ( | svn_repos_t * | repos, |
svn_stream_t * | dumpstream, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
enum svn_repos_load_uuid | uuid_action, | ||
const char * | parent_dir, | ||
svn_boolean_t | use_pre_commit_hook, | ||
svn_boolean_t | use_post_commit_hook, | ||
svn_boolean_t | validate_props, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Read and parse dumpfile-formatted dumpstream, reconstructing filesystem revisions in already-open repos, handling uuids in accordance with uuid_action. Use pool for all allocation.
If the dumpstream contains copy history that is unavailable in the repository, an error will be thrown.
The repository's UUID will be updated iff the dumpstream contains a UUID and uuid_action is not equal to svn_repos_load_uuid_ignore and either the repository contains no revisions or uuid_action is equal to svn_repos_load_uuid_force.
If the dumpstream contains no UUID, then uuid_action is ignored and the repository UUID is not touched.
start_rev and end_rev act as filters, the lower and upper (inclusive) range values of revisions in dumpstream which will be loaded. Either both of these values are SVN_INVALID_REVNUM (in which case no revision-based filtering occurs at all), or both are valid revisions (where start_rev is older than or equivalent to end_rev).
If parent_dir is not NULL, then the parser will reparent all the loaded nodes, from root to parent_dir. The directory parent_dir must be an existing directory in the repository.
If use_pre_commit_hook is set, call the repository's pre-commit hook before committing each loaded revision.
If use_post_commit_hook is set, call the repository's post-commit hook after committing each loaded revision.
If validate_props is set, then validate Subversion revision and node properties (those in the svn: namespace) against established rules for those things.
If non-NULL, use notify_func and notify_baton to send notification of events to the caller.
If cancel_func is not NULL
, it is called periodically with cancel_baton as argument to see if the client wishes to cancel the load.
SVN_DEPRECATED svn_error_t* svn_repos_parse_dumpstream | ( | svn_stream_t * | stream, |
const svn_repos_parser_fns_t * | parse_fns, | ||
void * | parse_baton, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_parse_dumpstream2(), but uses the more limited svn_repos_parser_fns_t vtable type.
SVN_DEPRECATED svn_error_t* svn_repos_parse_dumpstream2 | ( | svn_stream_t * | stream, |
const svn_repos_parser_fns2_t * | parse_fns, | ||
void * | parse_baton, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_parse_dumpstream3(), but uses the more limited svn_repos_parser_fns2_t vtable type.
svn_error_t* svn_repos_parse_dumpstream3 | ( | svn_stream_t * | stream, |
const svn_repos_parse_fns3_t * | parse_fns, | ||
void * | parse_baton, | ||
svn_boolean_t | deltas_are_text, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Read and parse dumpfile-formatted stream, calling callbacks in parse_fns/parse_baton, and using pool for allocations.
If deltas_are_text is TRUE
, handle text-deltas with the set_fulltext callback. This is useful when manipulating a dump stream without loading it. Otherwise handle text-deltas with the apply_textdelta callback.
If cancel_func is not NULL
, it is called periodically with cancel_baton as argument to see if the client wishes to cancel the dump.
This parser has built-in knowledge of the dumpfile format, but only in a limited sense:
* it recognizes the "magic" format-version header.
* it recognizes the UUID header.
* it recognizes revision and node records by looking for either a REVISION_NUMBER or NODE_PATH headers.
* it recognizes the CONTENT-LENGTH headers, so it knows if and how to suck up the content body.
* it knows how to parse a content body into two parts: props and text, and pass the pieces to the vtable.
This is enough knowledge to make it easy on vtable implementors, but still allow expansion of the format: most headers do not have to be handled explicitly.
SVN_DEPRECATED svn_error_t* svn_repos_verify_fs | ( | svn_repos_t * | repos, |
svn_stream_t * | feedback_stream, | ||
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_cancel_func_t | cancel_func, | ||
void * | cancel_baton, | ||
apr_pool_t * | pool | ||
) |
Similar to svn_repos_verify_fs2(), but with a feedback_stream instead of handling feedback via the notify_func handler
svn_error_t* svn_repos_verify_fs2 | ( | svn_repos_t * | repos, |
svn_revnum_t | start_rev, | ||
svn_revnum_t | end_rev, | ||
svn_repos_notify_func_t | notify_func, | ||
void * | notify_baton, | ||
svn_cancel_func_t | cancel, | ||
void * | cancel_baton, | ||
apr_pool_t * | scratch_pool | ||
) |
Verify the contents of the file system in repos.
If feedback_stream is not NULL
, write feedback to it (lines of the form "* Verified revision %ld\n").
If start_rev is SVN_INVALID_REVNUM, then start verifying at revision 0. If end_rev is SVN_INVALID_REVNUM, then verify through the HEAD
revision.
For every verified revision call notify_func with rev set to the verified revision and warning_text NULL
. For warnings call notify_func with warning_text set.
If cancel_func is not NULL
, call it periodically with cancel_baton as argument to see if the caller wishes to cancel the verification.