254 lines
17 KiB
HTML
254 lines
17 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
<title>Subversion: Bring a working copy up-to-date with a repository</title>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
</head><body>
|
|
<!-- Generated by Doxygen 1.5.6 -->
|
|
<div class="navigation" id="top">
|
|
<div class="tabs">
|
|
<ul>
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
|
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
<li><a href="annotated.html"><span>Data Structures</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li>
|
|
<form action="search.php" method="get">
|
|
<table cellspacing="0" cellpadding="0" border="0">
|
|
<tr>
|
|
<td><label> <u>S</u>earch for </label></td>
|
|
<td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
|
|
</tr>
|
|
</table>
|
|
</form>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="contents">
|
|
<h1>Bring a working copy up-to-date with a repository<br>
|
|
<small>
|
|
[<a class="el" href="group__clnt__wc.html">Client working copy management</a>]</small>
|
|
</h1><table border="0" cellpadding="0" cellspacing="0">
|
|
<tr><td></td></tr>
|
|
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Update.html#g079508afca6b7892f93cf038bda21495">svn_client_update3</a> (apr_array_header_t **result_revs, const apr_array_header_t *paths, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *revision, <a class="el" href="svn__types_8h.html#21dd8b080111fa6fb5d59156299f3a2c">svn_depth_t</a> depth, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> depth_is_sticky, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> ignore_externals, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> allow_unver_obstructions, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Update working trees <em>paths</em> to <em>revision</em>, authenticating with the authentication baton cached in <em>ctx</em>. <a href="#g079508afca6b7892f93cf038bda21495"></a><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Update.html#g7d1b2ee1735736798e64973a39d393f4">svn_client_update2</a> (apr_array_header_t **result_revs, const apr_array_header_t *paths, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *revision, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> recurse, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> ignore_externals, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Similar to <a class="el" href="group__Update.html#g079508afca6b7892f93cf038bda21495" title="Update working trees paths to revision, authenticating with the authentication baton...">svn_client_update3()</a> but with <em>allow_unver_obstructions</em> always set to FALSE, <em>depth_is_sticky</em> to FALSE, and <em>depth</em> set according to <em>recurse:</em> if <em>recurse</em> is TRUE, set <em>depth</em> to <code>svn_depth_infinity</code>, if <em>recurse</em> is FALSE, set <em>depth</em> to <code>svn_depth_files</code>. <a href="#g7d1b2ee1735736798e64973a39d393f4"></a><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Update.html#g03281f5793596f3934b893bf03a1e385">svn_client_update</a> (<a class="el" href="svn__types_8h.html#f16427ed53d30f27da225c56552d2a89">svn_revnum_t</a> *result_rev, const char *path, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *revision, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> recurse, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Similar to <a class="el" href="group__Update.html#g7d1b2ee1735736798e64973a39d393f4" title="Similar to svn_client_update3() but with allow_unver_obstructions always set to FALSE...">svn_client_update2()</a> except that it accepts only a single target in <em>path</em>, returns a single revision if <em>result_rev</em> is not NULL, and <em>ignore_externals</em> is always set to FALSE. <a href="#g03281f5793596f3934b893bf03a1e385"></a><br></td></tr>
|
|
</table>
|
|
<hr><h2>Function Documentation</h2>
|
|
<a class="anchor" name="g03281f5793596f3934b893bf03a1e385"></a><!-- doxytag: member="svn_client.h::svn_client_update" ref="g03281f5793596f3934b893bf03a1e385" args="(svn_revnum_t *result_rev, const char *path, const svn_opt_revision_t *revision, svn_boolean_t recurse, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_update </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#f16427ed53d30f27da225c56552d2a89">svn_revnum_t</a> * </td>
|
|
<td class="paramname"> <em>result_rev</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>path</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> * </td>
|
|
<td class="paramname"> <em>revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>recurse</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> * </td>
|
|
<td class="paramname"> <em>ctx</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">apr_pool_t * </td>
|
|
<td class="paramname"> <em>pool</em></td><td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>
|
|
Similar to <a class="el" href="group__Update.html#g7d1b2ee1735736798e64973a39d393f4" title="Similar to svn_client_update3() but with allow_unver_obstructions always set to FALSE...">svn_client_update2()</a> except that it accepts only a single target in <em>path</em>, returns a single revision if <em>result_rev</em> is not NULL, and <em>ignore_externals</em> is always set to FALSE.
|
|
<p>
|
|
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000025">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.1 API. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
<a class="anchor" name="g7d1b2ee1735736798e64973a39d393f4"></a><!-- doxytag: member="svn_client.h::svn_client_update2" ref="g7d1b2ee1735736798e64973a39d393f4" args="(apr_array_header_t **result_revs, const apr_array_header_t *paths, const svn_opt_revision_t *revision, svn_boolean_t recurse, svn_boolean_t ignore_externals, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_update2 </td>
|
|
<td>(</td>
|
|
<td class="paramtype">apr_array_header_t ** </td>
|
|
<td class="paramname"> <em>result_revs</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const apr_array_header_t * </td>
|
|
<td class="paramname"> <em>paths</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> * </td>
|
|
<td class="paramname"> <em>revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>recurse</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>ignore_externals</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> * </td>
|
|
<td class="paramname"> <em>ctx</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">apr_pool_t * </td>
|
|
<td class="paramname"> <em>pool</em></td><td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>
|
|
Similar to <a class="el" href="group__Update.html#g079508afca6b7892f93cf038bda21495" title="Update working trees paths to revision, authenticating with the authentication baton...">svn_client_update3()</a> but with <em>allow_unver_obstructions</em> always set to FALSE, <em>depth_is_sticky</em> to FALSE, and <em>depth</em> set according to <em>recurse:</em> if <em>recurse</em> is TRUE, set <em>depth</em> to <code>svn_depth_infinity</code>, if <em>recurse</em> is FALSE, set <em>depth</em> to <code>svn_depth_files</code>.
|
|
<p>
|
|
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000024">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.4 API. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
<a class="anchor" name="g079508afca6b7892f93cf038bda21495"></a><!-- doxytag: member="svn_client.h::svn_client_update3" ref="g079508afca6b7892f93cf038bda21495" args="(apr_array_header_t **result_revs, const apr_array_header_t *paths, const svn_opt_revision_t *revision, svn_depth_t depth, svn_boolean_t depth_is_sticky, svn_boolean_t ignore_externals, svn_boolean_t allow_unver_obstructions, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_update3 </td>
|
|
<td>(</td>
|
|
<td class="paramtype">apr_array_header_t ** </td>
|
|
<td class="paramname"> <em>result_revs</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const apr_array_header_t * </td>
|
|
<td class="paramname"> <em>paths</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> * </td>
|
|
<td class="paramname"> <em>revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#21dd8b080111fa6fb5d59156299f3a2c">svn_depth_t</a> </td>
|
|
<td class="paramname"> <em>depth</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>depth_is_sticky</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>ignore_externals</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> </td>
|
|
<td class="paramname"> <em>allow_unver_obstructions</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> * </td>
|
|
<td class="paramname"> <em>ctx</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">apr_pool_t * </td>
|
|
<td class="paramname"> <em>pool</em></td><td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>
|
|
Update working trees <em>paths</em> to <em>revision</em>, authenticating with the authentication baton cached in <em>ctx</em>.
|
|
<p>
|
|
<em>paths</em> is an array of const char * paths to be updated. Unversioned paths that are direct children of a versioned path will cause an update that attempts to add that path, other unversioned paths are skipped. If <em>result_revs</em> is not <code>NULL</code> an array of svn_revnum_t will be returned with each element set to the revision to which <em>revision</em> was resolved.<p>
|
|
<em>revision</em> must be of kind <code>svn_opt_revision_number</code>, <code>svn_opt_revision_head</code>, or <code>svn_opt_revision_date</code>. If <em>revision</em> does not meet these requirements, return the error <code>SVN_ERR_CLIENT_BAD_REVISION</code>.<p>
|
|
The paths in <em>paths</em> can be from multiple working copies from multiple repositories, but even if they all come from the same repository there is no guarantee that revision represented by <code>svn_opt_revision_head</code> will remain the same as each path is updated.<p>
|
|
If <em>ignore_externals</em> is set, don't process externals definitions as part of this operation.<p>
|
|
If <em>depth</em> is <code>svn_depth_infinity</code>, update fully recursively. Else if it is <code>svn_depth_immediates</code> or <code>svn_depth_files</code>, update each target and its file entries, but not its subdirectories. Else if <code>svn_depth_empty</code>, update exactly each target, nonrecursively (essentially, update the target's properties).<p>
|
|
If <em>depth</em> is <code>svn_depth_unknown</code>, take the working depth from <em>paths</em> and then behave as described above.<p>
|
|
If <em>depth_is_sticky</em> is set and <em>depth</em> is not <code>svn_depth_unknown</code>, then in addition to updating PATHS, also set their sticky ambient depth value to <em>depth</em>.<p>
|
|
If <em>allow_unver_obstructions</em> is TRUE then the update tolerates existing unversioned items that obstruct added paths from <em>URL</em>. Only obstructions of the same type (file or dir) as the added item are tolerated. The text of obstructing files is left as-is, effectively treating it as a user modification after the update. Working properties of obstructing items are set equal to the base properties. If <em>allow_unver_obstructions</em> is FALSE then the update will abort if there are any unversioned obstructing items.<p>
|
|
If <em>ctx->notify_func2</em> is non-NULL, invoke <em>ctx->notify_func2</em> with <em>ctx->notify_baton2</em> for each item handled by the update, and also for files restored from text-base. If <em>ctx->cancel_func</em> is non-NULL, invoke it passing <em>ctx->cancel_baton</em> at various places during the update.<p>
|
|
Use <em>pool</em> for any temporary allocation.<p>
|
|
<dl class="since" compact><dt><b>Since:</b></dt><dd>New in 1.5. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
</div>
|
|
<hr size="1"><address style="text-align: right;"><small>Generated on Fri Oct 24 16:18:29 2008 for Subversion by
|
|
<a href="http://www.doxygen.org/index.html">
|
|
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
|
|
</body>
|
|
</html>
|