311 lines
21 KiB
HTML
311 lines
21 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: Copy paths in the working copy and 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>Copy paths in the working copy and 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>Data Structures</h2></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structsvn__client__copy__source__t.html">svn_client_copy_source_t</a></td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">A structure which describes the source of a copy operation--its path, revision, and peg revision. <a href="structsvn__client__copy__source__t.html#_details">More...</a><br></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__Copy.html#gf9c037955c3fa31471725d2d13df4881">svn_client_copy4</a> (<a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> **commit_info_p, apr_array_header_t *sources, const char *dst_path, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> copy_as_child, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> make_parents, const apr_hash_t *revprop_table, <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">Copy each <em>src</em> in <em>sources</em> to <em>dst_path</em>. <a href="#gf9c037955c3fa31471725d2d13df4881"></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__Copy.html#g5d0e80a35a463c860fd9061b01266380">svn_client_copy3</a> (<a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> **commit_info_p, const char *src_path, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *src_revision, const char *dst_path, <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__Copy.html#gf9c037955c3fa31471725d2d13df4881" title="Copy each src in sources to dst_path.">svn_client_copy4()</a>, with only one <em>src_path</em>, <em>copy_as_child</em> set to <code>FALSE</code>, <em>revprop_table</em> passed as NULL, and <em>make_parents</em> set to <code>FALSE</code>. <a href="#g5d0e80a35a463c860fd9061b01266380"></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__Copy.html#ge311e701f73ae4e8aea3ac399290d425">svn_client_copy2</a> (<a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> **commit_info_p, const char *src_path, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *src_revision, const char *dst_path, <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__Copy.html#g5d0e80a35a463c860fd9061b01266380" title="Similar to svn_client_copy4(), with only one src_path, copy_as_child set to FALSE...">svn_client_copy3()</a>, with the difference that if <em>dst_path</em> already exists and is a directory, copy the item into that directory, keeping its name (the last component of <em>src_path</em>). <a href="#ge311e701f73ae4e8aea3ac399290d425"></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__Copy.html#g97c9cd1d8f7323a3bcb43135a484ff8c">svn_client_copy</a> (<a class="el" href="structsvn__client__commit__info__t.html">svn_client_commit_info_t</a> **commit_info_p, const char *src_path, const <a class="el" href="structsvn__opt__revision__t.html">svn_opt_revision_t</a> *src_revision, const char *dst_path, <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__Copy.html#ge311e701f73ae4e8aea3ac399290d425" title="Similar to svn_client_copy3(), with the difference that if dst_path already exists...">svn_client_copy2()</a>, but uses <code><a class="el" href="structsvn__client__commit__info__t.html" title="Information about commits passed back to client from this module.">svn_client_commit_info_t</a></code> for <em>commit_info_p</em>. <a href="#g97c9cd1d8f7323a3bcb43135a484ff8c"></a><br></td></tr>
|
|
</table>
|
|
<hr><h2>Function Documentation</h2>
|
|
<a class="anchor" name="g97c9cd1d8f7323a3bcb43135a484ff8c"></a><!-- doxytag: member="svn_client.h::svn_client_copy" ref="g97c9cd1d8f7323a3bcb43135a484ff8c" args="(svn_client_commit_info_t **commit_info_p, const char *src_path, const svn_opt_revision_t *src_revision, const char *dst_path, 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_copy </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structsvn__client__commit__info__t.html">svn_client_commit_info_t</a> ** </td>
|
|
<td class="paramname"> <em>commit_info_p</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>src_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>src_revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>dst_path</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__Copy.html#ge311e701f73ae4e8aea3ac399290d425" title="Similar to svn_client_copy3(), with the difference that if dst_path already exists...">svn_client_copy2()</a>, but uses <code><a class="el" href="structsvn__client__commit__info__t.html" title="Information about commits passed back to client from this module.">svn_client_commit_info_t</a></code> for <em>commit_info_p</em>.
|
|
<p>
|
|
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000063">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.2 API. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
<a class="anchor" name="ge311e701f73ae4e8aea3ac399290d425"></a><!-- doxytag: member="svn_client.h::svn_client_copy2" ref="ge311e701f73ae4e8aea3ac399290d425" args="(svn_commit_info_t **commit_info_p, const char *src_path, const svn_opt_revision_t *src_revision, const char *dst_path, 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_copy2 </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> ** </td>
|
|
<td class="paramname"> <em>commit_info_p</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>src_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>src_revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>dst_path</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__Copy.html#g5d0e80a35a463c860fd9061b01266380" title="Similar to svn_client_copy4(), with only one src_path, copy_as_child set to FALSE...">svn_client_copy3()</a>, with the difference that if <em>dst_path</em> already exists and is a directory, copy the item into that directory, keeping its name (the last component of <em>src_path</em>).
|
|
<p>
|
|
<dl class="since" compact><dt><b>Since:</b></dt><dd>New in 1.3.</dd></dl>
|
|
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000062">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.3 API. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
<a class="anchor" name="g5d0e80a35a463c860fd9061b01266380"></a><!-- doxytag: member="svn_client.h::svn_client_copy3" ref="g5d0e80a35a463c860fd9061b01266380" args="(svn_commit_info_t **commit_info_p, const char *src_path, const svn_opt_revision_t *src_revision, const char *dst_path, 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_copy3 </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> ** </td>
|
|
<td class="paramname"> <em>commit_info_p</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>src_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>src_revision</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>dst_path</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__Copy.html#gf9c037955c3fa31471725d2d13df4881" title="Copy each src in sources to dst_path.">svn_client_copy4()</a>, with only one <em>src_path</em>, <em>copy_as_child</em> set to <code>FALSE</code>, <em>revprop_table</em> passed as NULL, and <em>make_parents</em> set to <code>FALSE</code>.
|
|
<p>
|
|
Also, use <em>src_revision</em> as both the operational and peg revision.<p>
|
|
<dl class="since" compact><dt><b>Since:</b></dt><dd>New in 1.4.</dd></dl>
|
|
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000061">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.4 API. </dd></dl>
|
|
|
|
</div>
|
|
</div><p>
|
|
<a class="anchor" name="gf9c037955c3fa31471725d2d13df4881"></a><!-- doxytag: member="svn_client.h::svn_client_copy4" ref="gf9c037955c3fa31471725d2d13df4881" args="(svn_commit_info_t **commit_info_p, apr_array_header_t *sources, const char *dst_path, svn_boolean_t copy_as_child, svn_boolean_t make_parents, const apr_hash_t *revprop_table, 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_copy4 </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structsvn__commit__info__t.html">svn_commit_info_t</a> ** </td>
|
|
<td class="paramname"> <em>commit_info_p</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">apr_array_header_t * </td>
|
|
<td class="paramname"> <em>sources</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"> <em>dst_path</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>copy_as_child</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>make_parents</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const apr_hash_t * </td>
|
|
<td class="paramname"> <em>revprop_table</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>
|
|
Copy each <em>src</em> in <em>sources</em> to <em>dst_path</em>.
|
|
<p>
|
|
If multiple <em>sources</em> are given, <em>dst_path</em> must be a directory, and <em>sources</em> will be copied as children of <em>dst_path</em>.<p>
|
|
<em>sources</em> must be an array of elements of type <code><a class="el" href="structsvn__client__copy__source__t.html" title="A structure which describes the source of a copy operation--its path, revision, and...">svn_client_copy_source_t</a> *</code>.<p>
|
|
Each <em>src</em> in <em>sources</em> must be files or directories under version control, or URLs of a versioned item in the repository. If <em>sources</em> has multiple items, the <em>src</em> members must be all repository URLs or all working copy paths.<p>
|
|
The parent of <em>dst_path</em> must already exist.<p>
|
|
If <em>sources</em> has only one item, attempt to copy it to <em>dst_path</em>. If <em>copy_as_child</em> is TRUE and <em>dst_path</em> already exists, attempt to copy the item as a child of <em>dst_path</em>. If <em>copy_as_child</em> is FALSE and <em>dst_path</em> already exists, fail with <code>SVN_ERR_ENTRY_EXISTS</code> if <em>dst_path</em> is a working copy path and <code>SVN_ERR_FS_ALREADY_EXISTS</code> if <em>dst_path</em> is a URL.<p>
|
|
If <em>sources</em> has multiple items, and <em>copy_as_child</em> is TRUE, all <em>sources</em> are copied as children of <em>dst_path</em>. If any child of <em>dst_path</em> already exists with the same name any item in <em>sources</em>, fail with <code>SVN_ERR_ENTRY_EXISTS</code> if <em>dst_path</em> is a working copy path and <code>SVN_ERR_FS_ALREADY_EXISTS</code> if <em>dst_path</em> is a URL.<p>
|
|
If <em>sources</em> has multiple items, and <em>copy_as_child</em> is FALSE, fail with <code>SVN_ERR_CLIENT_MULTIPLE_SOURCES_DISALLOWED</code>.<p>
|
|
If <em>dst_path</em> is a URL, use the authentication baton in <em>ctx</em> and <em>ctx->log_msg_func3/<em>ctx->log_msg_baton3</em> to</em> immediately attempt to commit the copy action in the repository. If the commit succeeds, allocate (in <em>pool</em>) and populate <em>*commit_info_p</em>. If <em>dst_path</em> is not a URL, and the copy succeeds, set <em>*commit_info_p</em> to <code>NULL</code>.<p>
|
|
If <em>dst_path</em> is not a URL, then this is just a variant of <a class="el" href="group__Add.html#gf195ea9edb1abcf4439f9b60a8cece2b" title="Similar to svn_client_add2(), but with force always set to FALSE.">svn_client_add()</a>, where the <em>sources</em> are scheduled for addition as copies. No changes will happen to the repository until a commit occurs. This scheduling can be removed with <a class="el" href="group__Revert.html#gcb44f78571979944837d1ad9967bec5e" title="Restore the pristine version of a working copy paths, effectively undoing any local...">svn_client_revert2()</a>.<p>
|
|
If <em>make_parents</em> is TRUE, create any non-existent parent directories also.<p>
|
|
If non-NULL, <em>revprop_table</em> is a hash table holding additional, custom revision properties (<code>const char *</code> names mapped to <code><a class="el" href="structsvn__string__t.html" title="A simple counted string.">svn_string_t</a> *</code> values) to be set on the new revision in the event that this is a committing operation. This table cannot contain any standard Subversion properties.<p>
|
|
<em>ctx->log_msg_func3/<em>ctx->log_msg_baton3</em> are</em> a callback/baton combo that this function can use to query for a commit log message when one is needed.<p>
|
|
If <em>ctx->notify_func2</em> is non-NULL, invoke it with <em>ctx->notify_baton2</em> for each item added at the new location, passing the new, relative path of the added item.<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>
|