Main Page   Modules   Data Structures   File List   Data Fields  

svn_ra_reporter_t Struct Reference

The update Reporter. More...

#include <svn_ra.h>


Data Fields

svn_error_t *(* set_path )(void *report_baton, const char *path, svn_revnum_t revision, svn_boolean_t start_empty, apr_pool_t *pool)
 Describe a working copy path as being at a particular revision. More...

svn_error_t *(* delete_path )(void *report_baton, const char *path, apr_pool_t *pool)
 Describing a working copy path as missing. More...

svn_error_t *(* link_path )(void *report_baton, const char *path, const char *url, svn_revnum_t revision, svn_boolean_t start_empty, apr_pool_t *pool)
 Like set_path, but differs in that path in the working copy (relative to the root of the report driver) isn't a reflection of path in the repository (relative to the URL specified when opening the RA layer), but is instead a reflection of a different repository url at revision. More...

svn_error_t *(* finish_report )(void *report_baton, apr_pool_t *pool)
 WC calls this when the state report is finished; any directories or files not explicitly `set' above are assumed to be at the baseline revision originally passed into do_update().

svn_error_t *(* abort_report )(void *report_baton, apr_pool_t *pool)
 If an error occurs during a report, this routine should cause the filesystem transaction to be aborted & cleaned up.


Detailed Description

The update Reporter.

A vtable structure which allows a working copy to describe a subset (or possibly all) of its working-copy to an RA layer, for the purposes of an update, switch, status, or diff operation.

Paths for report calls are relative to the target (not the anchor) of the operation. Report calls must be made in depth-first order: parents before children, all children of a parent before any siblings of the parent. The first report call must be a set_path with a path argument of "" and a valid revision. (If the target of the operation is locally deleted or missing, use the anchor's revision.) If the target of the operation is deleted or switched relative to the anchor, follow up the initial set_path call with a link_path or delete_path call with a path argument of "" to indicate that. In no other case may there be two report descriptions for the same path. If the target of the operation is a locally added file or directory (which previously did not exist), it may be reported as having revision 0 or as having the parent directory's revision.

Definition at line 134 of file svn_ra.h.


Field Documentation

svn_error_t*(* svn_ra_reporter_t::delete_path)(void *report_baton, const char *path, apr_pool_t *pool)
 

Describing a working copy path as missing.

All temporary allocations are done in pool.

svn_error_t*(* svn_ra_reporter_t::link_path)(void *report_baton, const char *path, const char *url, svn_revnum_t revision, svn_boolean_t start_empty, apr_pool_t *pool)
 

Like set_path, but differs in that path in the working copy (relative to the root of the report driver) isn't a reflection of path in the repository (relative to the URL specified when opening the RA layer), but is instead a reflection of a different repository url at revision.

If START_EMPTY is set and path is a directory, the implementor should assume the directory has no entries or props.

All temporary allocations are done in pool.

svn_error_t*(* svn_ra_reporter_t::set_path)(void *report_baton, const char *path, svn_revnum_t revision, svn_boolean_t start_empty, apr_pool_t *pool)
 

Describe a working copy path as being at a particular revision.

If START_EMPTY is set and path is a directory, the implementor should assume the directory has no entries or props.

This will *override* any previous set_path calls made on parent paths. path is relative to the URL specified in open().

All temporary allocations are done in pool.


The documentation for this struct was generated from the following file:
Generated on Tue Oct 19 09:49:47 2004 for Subversion by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002