<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta name="robots" content="noindex">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<!-- THIS FILE IS AUTOMATICALLY GENERATED FROM THE GLOBUS SOURCE CODE
DO NOT MODIFY.
-->
<title>Globus Reference Manual</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.6.2-20100208 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="main.html"><span>Main Page</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>globus_gass_copy.c File Reference</h1>
<p>Globus GASS Copy library.
<a href="#_details">More...</a></p>
<h2>Functions</h2>
<ul>
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a61d8c79a0d7001292bfe256a6558bf45">globus_gass_copy_handle_init</a> (globus_gass_copy_handle_t *handle, globus_gass_copy_handleattr_t *attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a99f73bc446fa70cf498b2b7d71060ebf">globus_gass_copy_handle_destroy</a> (globus_gass_copy_handle_t *handle)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a9e56d84d6b970ae20e26fb497defce6e">globus_gass_copy_set_buffer_length</a> (globus_gass_copy_handle_t *handle, int length)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#ae1d163945b26e7e0bc8c88471eeb3487">globus_gass_copy_get_buffer_length</a> (globus_gass_copy_handle_t *handle, int *length)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a94b35859fce8470b6e514b2ce9701706">globus_gass_copy_set_no_third_party_transfers</a> (globus_gass_copy_handle_t *handle, globus_bool_t no_third_party_transfers)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#acd4d1bbf92b6942339daa8934868ceee">globus_gass_copy_get_no_third_party_transfers</a> (globus_gass_copy_handle_t *handle, globus_bool_t *no_third_party_transfers)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#ac2c1cfeafd510f9b010005e69e0494cf">globus_gass_copy_set_allocate</a> (globus_gass_copy_handle_t *handle, globus_bool_t send_allo)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a8f70d7378a1b66fc53bf7d27b834eba9">globus_gass_copy_set_partial_offsets</a> (globus_gass_copy_handle_t *handle, globus_off_t offset, globus_off_t end_offset)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#aa9375ae3b7860655dced7d6e91f8f1ec">globus_gass_copy_get_partial_offsets</a> (globus_gass_copy_handle_t *handle, globus_off_t *offset, globus_off_t *end_offset)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a4e83747383c97fdbc43ae03e280a8880">globus_gass_copy_attr_init</a> (globus_gass_copy_attr_t *attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0">globus_gass_copy_attr_set_ftp</a> (globus_gass_copy_attr_t *attr, globus_ftp_client_operationattr_t *ftp_attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f">globus_gass_copy_attr_set_io</a> (globus_gass_copy_attr_t *attr, globus_io_attr_t *io_attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#abec04bc6ec5e1ac0c2334ffcd8011497">globus_gass_copy_attr_set_gass</a> (globus_gass_copy_attr_t *attr, globus_gass_transfer_requestattr_t *gass_attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a4c58b047bb662db147d46b4b1007b78e">globus_gass_copy_get_url_mode</a> (char *url, globus_gass_copy_url_mode_t *mode)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#af59abfbbbef6d9298d33c550b6648811">globus_gass_copy_register_performance_cb</a> (globus_gass_copy_handle_t *handle, <a class="el" href="globus__gass__copy_8h.html#a0d2b5b6d5f7b8cb9246fd77d16ee00be">globus_gass_copy_performance_cb_t</a> callback, void *user_arg)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a2f01cfa265d71b96b679a20a26063244">globus_gass_copy_get_status</a> (globus_gass_copy_handle_t *handle, globus_gass_copy_status_t *status)
<li>const char * <a class="el" href="globus__gass__copy_8c.html#a6a67acc06857281bac4ca7823d90ca00">globus_gass_copy_get_status_string</a> (globus_gass_copy_handle_t *handle)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#ae819427fb2386ae134c687547bd14d4f">globus_gass_copy_url_to_url</a> (globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, char *dest_url, globus_gass_copy_attr_t *dest_attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a568b3b9898a1faa527d1e9e54717a6ac">globus_gass_copy_url_to_handle</a> (globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, globus_io_handle_t *dest_handle)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a527e243537e57b02b71f7225fa0334f9">globus_gass_copy_handle_to_url</a> (globus_gass_copy_handle_t *handle, globus_io_handle_t *source_handle, char *dest_url, globus_gass_copy_attr_t *dest_attr)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#ab8af05a91b7cc79ef6c5dbc6230a3b90">globus_gass_copy_register_url_to_url</a> (globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, char *dest_url, globus_gass_copy_attr_t *dest_attr, globus_gass_copy_callback_t callback_func, void *callback_arg)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#aacb0215efc5618137e9e4e0152db86e2">globus_gass_copy_register_url_to_handle</a> (globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, globus_io_handle_t *dest_handle, globus_gass_copy_callback_t callback_func, void *callback_arg)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a9e8df805ffa4f251fc726b2d1d495dac">globus_gass_copy_register_handle_to_url</a> (globus_gass_copy_handle_t *handle, globus_io_handle_t *source_handle, char *dest_url, globus_gass_copy_attr_t *dest_attr, globus_gass_copy_callback_t callback_func, void *callback_arg)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a11291452cc59b61c413ebaa167ba2969">globus_gass_copy_cache_url_state</a> (globus_gass_copy_handle_t *handle, char *url)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a6423bc3e8a66eeb20e5dee4e7a213b2c">globus_gass_copy_flush_url_state</a> (globus_gass_copy_handle_t *handle, char *url)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a048130bb19d65fec64cbef54d4176b09">globus_gass_copy_set_user_pointer</a> (globus_gass_copy_handle_t *handle, void *user_pointer)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a73e3f61383c3c95f7c806ead96df8e4c">globus_gass_copy_get_user_pointer</a> (globus_gass_copy_handle_t *handle, void **user_data)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a1b39ba5a6e6f01855b64d4bab5b1815c">globus_gass_copy_cancel</a> (globus_gass_copy_handle_t *handle, globus_gass_copy_callback_t cancel_callback, void *cancel_callback_arg)
<li>globus_result_t <a class="el" href="globus__gass__copy_8c.html#a955f28307f02693b48e48ff64ad409d4">globus_l_gass_copy_target_cancel</a> (<a class="el" href="structglobus__i__gass__copy__cancel__s.html">globus_i_gass_copy_cancel_t</a> *cancel_info)
</ul>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Globus GASS Copy library. </p>
<dl class="see"><dt><b>See also:</b></dt><dd>See the detailed description in <a class="el" href="globus__gass__copy_8h.html" title="Header file for the gass copy library.">globus_gass_copy.h</a> </dd></dl>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a61d8c79a0d7001292bfe256a6558bf45"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_handle_init" ref="a61d8c79a0d7001292bfe256a6558bf45" args="(globus_gass_copy_handle_t *handle, globus_gass_copy_handleattr_t *attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_handle_init </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_handleattr_t * </td>
<td class="paramname"> <em>attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialize a GASS Copy handle. </p>
<p>A globus_gass_copy_handle must be initialized before any transfers may be associated with it. This function initializes a globus_gass_copy_handle to be used for doing transfers, this includes initializing a globus_ftp_client_handle which will be used for doing any ftp/gsiftp transfers. The same handle may be used to perform multiple, consecutive transfers. However, there can only be one transfer associated with a particular handle at any given time. After all transfers to be associated with this handle have completed, the handle should be destroyed by calling <a class="el" href="globus__gass__copy_8c.html#a99f73bc446fa70cf498b2b7d71060ebf" title="Destroy a GASS Copy handle.">globus_gass_copy_handle_destroy()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to be initialized </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attr</em> </td><td>The handle attributes used to use with this handle </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a99f73bc446fa70cf498b2b7d71060ebf" title="Destroy a GASS Copy handle.">globus_gass_copy_handle_destroy()</a> , globus_gass_copy_handleattr_init(), globus_ftp_client_hande_init() </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a99f73bc446fa70cf498b2b7d71060ebf"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_handle_destroy" ref="a99f73bc446fa70cf498b2b7d71060ebf" args="(globus_gass_copy_handle_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_handle_destroy </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destroy a GASS Copy handle. </p>
<p>Destroy a gass_copy_handle, which was initialized using <a class="el" href="globus__gass__copy_8c.html#a61d8c79a0d7001292bfe256a6558bf45" title="Initialize a GASS Copy handle.">globus_gass_copy_handle_init()</a>, that will no longer be used for doing transfers. Once the handle is detroyed, no further transfers should be associated with it.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to be destroyed</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a61d8c79a0d7001292bfe256a6558bf45" title="Initialize a GASS Copy handle.">globus_gass_copy_handle_init()</a>, globus_ftp_client_handle_destroy() </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a9e56d84d6b970ae20e26fb497defce6e"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_set_buffer_length" ref="a9e56d84d6b970ae20e26fb497defce6e" args="(globus_gass_copy_handle_t *handle, int length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_set_buffer_length </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the size of the buffer to be used for doing transfers. </p>
<p>This function allows the user to set the size of the buffer that will be used for doing transfers, if this function is not called the buffer size will default to 1M.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Set the buffer length for transfers associated with this handle. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>The length, in bytes, to make the buffer.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="ae1d163945b26e7e0bc8c88471eeb3487"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_buffer_length" ref="ae1d163945b26e7e0bc8c88471eeb3487" args="(globus_gass_copy_handle_t *handle, int *length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_buffer_length </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the size of the buffer being used for doing transfers. </p>
<p>This function allows the user to get the size of the buffer that is being used for doing transfers.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Get the buffer length for transfers associated with this handle. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>The length, in bytes, of the buffer.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a94b35859fce8470b6e514b2ce9701706"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_set_no_third_party_transfers" ref="a94b35859fce8470b6e514b2ce9701706" args="(globus_gass_copy_handle_t *handle, globus_bool_t no_third_party_transfers)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_set_no_third_party_transfers </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_bool_t </td>
<td class="paramname"> <em>no_third_party_transfers</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Turn third-party transfers on or off. </p>
<p>(They are on by default.)</p>
<p>This function allows the user to turn third-party transfers on or off for ftp to ftp transfers associated with a particular handle. This is often desired if one of the servers involved in the transfer does not allow third-party transfers.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Turn third-party transfers on or off for transfers associated with this handle. They are on by default. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>no_third_party_transfers</em> </td><td>GLOBUS_FALSE if third-party transfers should be used. GLOBUS_TRUE if third-party transfers should not be used.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8c_source.html#l01539">globus_gass_copy_get_status()</a>, and <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="acd4d1bbf92b6942339daa8934868ceee"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_no_third_party_transfers" ref="acd4d1bbf92b6942339daa8934868ceee" args="(globus_gass_copy_handle_t *handle, globus_bool_t *no_third_party_transfers)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_no_third_party_transfers </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_bool_t * </td>
<td class="paramname"> <em>no_third_party_transfers</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>See if third-party transfers are turned on or off. </p>
<p>(They are on by default.)</p>
<p>This function allows the user to see if third-party transfers are turned on or off for ftp to ftp transfers associated with a particular handle. This is often desired if one of the servers involved in the transfer does not allow third-party transfers.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>See if third-party transfers are turned on or off for transfers associated with this handle. They are on by default. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>no_third_party_transfers</em> </td><td>GLOBUS_FALSE if third-party transfers should be used. GLOBUS_TRUE if third-party transfers should not be used.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="ac2c1cfeafd510f9b010005e69e0494cf"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_set_allocate" ref="ac2c1cfeafd510f9b010005e69e0494cf" args="(globus_gass_copy_handle_t *handle, globus_bool_t send_allo)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_set_allocate </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_bool_t </td>
<td class="paramname"> <em>send_allo</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set allo on or off. </p>
</div>
</div>
<a class="anchor" id="a8f70d7378a1b66fc53bf7d27b834eba9"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_set_partial_offsets" ref="a8f70d7378a1b66fc53bf7d27b834eba9" args="(globus_gass_copy_handle_t *handle, globus_off_t offset, globus_off_t end_offset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_set_partial_offsets </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"> <em>end_offset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the offsets to be used for doing partial transfers. </p>
<p>This function allows the user to set the offsets that will be used for doing partial transfers. An offset of -1 will disable partial transfers. An end_offset of -1 means EOF.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Set the offsets for partial transfers associated with this handle. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The starting offset for the partial transfer. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>end_offset</em> </td><td>The ending offset for the partial transfer.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="aa9375ae3b7860655dced7d6e91f8f1ec"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_partial_offsets" ref="aa9375ae3b7860655dced7d6e91f8f1ec" args="(globus_gass_copy_handle_t *handle, globus_off_t *offset, globus_off_t *end_offset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_partial_offsets </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t * </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t * </td>
<td class="paramname"> <em>end_offset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the offsets being used for doing partial transfers. </p>
<p>This function allows the user to get the offsets that are being used for doing partial transfers. An offset of -1 means partial transfers are disabled.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Get the offsets for partial transfers associated with this handle. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The starting offset for the partial transfer. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>end_offset</em> </td><td>The ending offset for the partial transfer.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a4e83747383c97fdbc43ae03e280a8880"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_attr_init" ref="a4e83747383c97fdbc43ae03e280a8880" args="(globus_gass_copy_attr_t *attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_attr_init </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>attr</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialize an attribute structure. </p>
<p>The globus_gass_copy_attr_t can be used to pass the globus_gass_copy library information about how a transfer should be performed. It must first be initialized by calling this function. Then any or all of the following functions may be called to set attributes associated with a particular protocol: <a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0" title="Set the attributes for ftp/gsiftp transfers.">globus_gass_copy_attr_set_ftp()</a>, <a class="el" href="globus__gass__copy_8c.html#abec04bc6ec5e1ac0c2334ffcd8011497" title="Set the attributes for http/https transfers.">globus_gass_copy_attr_set_gass()</a>, <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f" title="Set the attributes for file transfers.">globus_gass_copy_attr_set_io()</a>. Any function which takes a globus_gass_copy_attr_t as an argument will also accept GLOBUS_NULL, in which case the appropriate set of default attributes will be used.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>attr</em> </td><td>The attribute structure to be initialized</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0" title="Set the attributes for ftp/gsiftp transfers.">globus_gass_copy_attr_set_ftp()</a>, <a class="el" href="globus__gass__copy_8c.html#abec04bc6ec5e1ac0c2334ffcd8011497" title="Set the attributes for http/https transfers.">globus_gass_copy_attr_set_gass()</a>, <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f" title="Set the attributes for file transfers.">globus_gass_copy_attr_set_io()</a>, <a class="el" href="globus__gass__copy_8c.html#a4c58b047bb662db147d46b4b1007b78e" title="Classify the URL schema into the transfer method that will be used to do the actual...">globus_gass_copy_get_url_mode()</a>. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a011a6b17268ce2a0527d2d182deff2c0"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_attr_set_ftp" ref="a011a6b17268ce2a0527d2d182deff2c0" args="(globus_gass_copy_attr_t *attr, globus_ftp_client_operationattr_t *ftp_attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_attr_set_ftp </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_ftp_client_operationattr_t * </td>
<td class="paramname"> <em>ftp_attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the attributes for ftp/gsiftp transfers. </p>
<p>In order to specify attributes for ftp/gsiftp transfers, a globus_ftp_client_operationattr_t should be initialized and its values set using the appropriate globus_ftp_client_operationattr_* functions. The globus_ftp_client_operationattr_t * can then be passed to the globus_gass_copy_attr_t via this function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>attr</em> </td><td>A globus_gass_copy attribute structure </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ftp_attr</em> </td><td>The ftp/gsiftp attributes to be used</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a4e83747383c97fdbc43ae03e280a8880" title="Initialize an attribute structure.">globus_gass_copy_attr_init()</a>, <a class="el" href="globus__gass__copy_8c.html#abec04bc6ec5e1ac0c2334ffcd8011497" title="Set the attributes for http/https transfers.">globus_gass_copy_attr_set_gass()</a>, <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f" title="Set the attributes for file transfers.">globus_gass_copy_attr_set_io()</a>, <a class="el" href="globus__gass__copy_8c.html#a4c58b047bb662db147d46b4b1007b78e" title="Classify the URL schema into the transfer method that will be used to do the actual...">globus_gass_copy_get_url_mode()</a>, globus_ftp_client_operationattr_* </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="ab99d7a13d564345cd49834c79aaace6f"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_attr_set_io" ref="ab99d7a13d564345cd49834c79aaace6f" args="(globus_gass_copy_attr_t *attr, globus_io_attr_t *io_attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_attr_set_io </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_io_attr_t * </td>
<td class="paramname"> <em>io_attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the attributes for file transfers. </p>
<p>In order to specify attributes for file transfers, a globus_io_attr_t should be initialized and its values set using the appropriate globus_io_attr_* functions. The globus_io_attr_t can then be passed to the globus_gass_copy_attr_t via this function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>attr</em> </td><td>A globus_gass_copy attribute structure </td></tr>
<tr><td valign="top"></td><td valign="top"><em>io_attr</em> </td><td>The file attributes to be used</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a4e83747383c97fdbc43ae03e280a8880" title="Initialize an attribute structure.">globus_gass_copy_attr_init()</a>, <a class="el" href="globus__gass__copy_8c.html#abec04bc6ec5e1ac0c2334ffcd8011497" title="Set the attributes for http/https transfers.">globus_gass_copy_attr_set_gass()</a>, <a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0" title="Set the attributes for ftp/gsiftp transfers.">globus_gass_copy_attr_set_ftp()</a>, <a class="el" href="globus__gass__copy_8c.html#a4c58b047bb662db147d46b4b1007b78e" title="Classify the URL schema into the transfer method that will be used to do the actual...">globus_gass_copy_get_url_mode()</a>, globus_io_attr_* </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="abec04bc6ec5e1ac0c2334ffcd8011497"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_attr_set_gass" ref="abec04bc6ec5e1ac0c2334ffcd8011497" args="(globus_gass_copy_attr_t *attr, globus_gass_transfer_requestattr_t *gass_attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_attr_set_gass </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_transfer_requestattr_t * </td>
<td class="paramname"> <em>gass_attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the attributes for http/https transfers. </p>
<p>In order to specify attributes for http/https transfers, a globus_gass_transfer_requestattr_t should be initialized and its values set using the appropriate globus_gass_transfer_requestattr_* functions. The globus_gass_transfer_requestattr_t can then be passed to the globus_gass_copy_attr_t via this function.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>attr</em> </td><td>A globus_gass_copy attribute structure </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gass_attr</em> </td><td>The http/https attributes to be used</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a4e83747383c97fdbc43ae03e280a8880" title="Initialize an attribute structure.">globus_gass_copy_attr_init()</a>, <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f" title="Set the attributes for file transfers.">globus_gass_copy_attr_set_io()</a>, <a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0" title="Set the attributes for ftp/gsiftp transfers.">globus_gass_copy_attr_set_ftp()</a>, <a class="el" href="globus__gass__copy_8c.html#a4c58b047bb662db147d46b4b1007b78e" title="Classify the URL schema into the transfer method that will be used to do the actual...">globus_gass_copy_get_url_mode()</a>, globus_gass_transfer_requestattr_* </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a4c58b047bb662db147d46b4b1007b78e"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_url_mode" ref="a4c58b047bb662db147d46b4b1007b78e" args="(char *url, globus_gass_copy_url_mode_t *mode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_url_mode </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_url_mode_t * </td>
<td class="paramname"> <em>mode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Classify the URL schema into the transfer method that will be used to do the actual tranfer. </p>
<p>This function enables the user to determine what protocol will be used to transfer data to/from a particular url. This information can then be used to specify the appropriate attributes when initiating a transfer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>The URL for schema checking </td></tr>
<tr><td valign="top"></td><td valign="top"><em>mode</em> </td><td>the filled in schema type of the URL param</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a4e83747383c97fdbc43ae03e280a8880" title="Initialize an attribute structure.">globus_gass_copy_attr_init()</a>, <a class="el" href="globus__gass__copy_8c.html#ab99d7a13d564345cd49834c79aaace6f" title="Set the attributes for file transfers.">globus_gass_copy_attr_set_io()</a>, <a class="el" href="globus__gass__copy_8c.html#a011a6b17268ce2a0527d2d182deff2c0" title="Set the attributes for ftp/gsiftp transfers.">globus_gass_copy_attr_set_ftp()</a>, globus_gass_copy_set_gass() </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="af59abfbbbef6d9298d33c550b6648811"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_register_performance_cb" ref="af59abfbbbef6d9298d33c550b6648811" args="(globus_gass_copy_handle_t *handle, globus_gass_copy_performance_cb_t callback, void *user_arg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_register_performance_cb </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="globus__gass__copy_8h.html#a0d2b5b6d5f7b8cb9246fd77d16ee00be">globus_gass_copy_performance_cb_t</a> </td>
<td class="paramname"> <em>callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>user_arg</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Register a performance information callback. </p>
<p>Use this to register a performance information callback. You change or set to GLOBUS_NULL the callback any time a transfer is not occurring.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>an initialized gass copy handle for which you would like to see performance info</td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback</em> </td><td>the performance callback</td></tr>
<tr><td valign="top"></td><td valign="top"><em>user_arg</em> </td><td>a user pointer that will be passed to all callbacks for a given handle</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><ul>
<li>GLOBUS_SUCCESS</li>
<li>error on a NULL or busy handle</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8h.html#a0d2b5b6d5f7b8cb9246fd77d16ee00be" title="Gass copy transfer performance callback.">globus_gass_copy_performance_cb_t</a> </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a2f01cfa265d71b96b679a20a26063244"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_status" ref="a2f01cfa265d71b96b679a20a26063244" args="(globus_gass_copy_handle_t *handle, globus_gass_copy_status_t *status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_status </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_status_t * </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the status code of the current transfer. </p>
<p>Get the status of the last transfer to be initiated using the given handle. Only one transfer can be active on a handle at a given time, therefore new transfers may only be initiated when the current status is one of the following: GLOBUS_GASS_COPY_STATUS_NONE, GLOBUS_GASS_COPY_STATUS_DONE_SUCCESS, GLOBUS_GASS_COPY_STATUS_DONE_FAILURE, GLOBUS_GASS_COPY_STATUS_DONE_CANCELLED</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>A globus_gass_copy_handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Will be one of the following: GLOBUS_GASS_COPY_STATUS_NONE (No transfers have been initiated using this handle.) GLOBUS_GASS_COPY_STATUS_PENDING (A transfer is currently being set up.) GLOBUS_GASS_COPY_STATUS_TRANSFER_IN_PROGRESS (There is currently a transfer in progress.) GLOBUS_GASS_COPY_STATUS_CANCEL (The last transfer initiated using this handle has been cancelled by the user before completing, and is in the process of being cleaned up.) GLOBUS_GASS_COPY_STATUS_FAILURE (The last transfer initiated using this handle failed, and is in the process of being cleaned up.) GLOBUS_GASS_COPY_STATUS_DONE_SUCCESS (The last transfer initiated using this handle has completed successfully.) GLOBUS_GASS_COPY_STATUS_DONE_FAILURE (The last transfer initiated using this handle failed and has finished cleaning up.) GLOBUS_GASS_COPY_STATUS_DONE_CANCELLED (The last transfer initiated using this handle was cancelled and has finished cleaning up.) </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a6a67acc06857281bac4ca7823d90ca00"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_status_string" ref="a6a67acc06857281bac4ca7823d90ca00" args="(globus_gass_copy_handle_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* globus_gass_copy_get_status_string </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the status string of the current transfer. </p>
<p>Get the status of the last transfer to be initiated using the given handle. Only one transfer can be active on a handle at a given time, therefore new transfers may only be initiated when the current status is one of the following: GLOBUS_GASS_COPY_STATUS_NONE, GLOBUS_GASS_COPY_STATUS_DONE_SUCCESS, GLOBUS_GASS_COPY_STATUS_DONE_FAILURE, GLOBUS_GASS_COPY_STATUS_DONE_CANCELLED</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>A globus_gass_copy_handle</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Returns a pointer to a character string describing the current status </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8c_source.html#l01539">globus_gass_copy_get_status()</a>.</p>
</div>
</div>
<a class="anchor" id="ae819427fb2386ae134c687547bd14d4f"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_url_to_url" ref="ae819427fb2386ae134c687547bd14d4f" args="(globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, char *dest_url, globus_gass_copy_attr_t *dest_attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_url_to_url </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>dest_attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from source URL to destination URL (blocking). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_url</em> </td><td>transfer data from this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_attr</em> </td><td>Attributes describing how the transfer form the source should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_url</em> </td><td>transfer data to this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_attr</em> </td><td>Attributes describing how the transfer to the destination should be done</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was completed successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#a568b3b9898a1faa527d1e9e54717a6ac" title="Transfer data from source URL to an IO handle (blocking).">globus_gass_copy_url_to_handle()</a> <a class="el" href="globus__gass__copy_8c.html#a527e243537e57b02b71f7225fa0334f9" title="Transfer data from an IO handle to destination URL (blocking).">globus_gass_copy_handle_to_url()</a> </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__gass__copy_8c_source.html#l05007">globus_gass_copy_register_url_to_url()</a>.</p>
</div>
</div>
<a class="anchor" id="a568b3b9898a1faa527d1e9e54717a6ac"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_url_to_handle" ref="a568b3b9898a1faa527d1e9e54717a6ac" args="(globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, globus_io_handle_t *dest_handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_url_to_handle </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_io_handle_t * </td>
<td class="paramname"> <em>dest_handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from source URL to an IO handle (blocking). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_url</em> </td><td>transfer data from this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_attr</em> </td><td>Attributes describing how the transfer form the source should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_handle</em> </td><td>transfer data to this IO handle</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was completed successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#ae819427fb2386ae134c687547bd14d4f" title="Transfer data from source URL to destination URL (blocking).">globus_gass_copy_url_to_url()</a> <a class="el" href="globus__gass__copy_8c.html#a527e243537e57b02b71f7225fa0334f9" title="Transfer data from an IO handle to destination URL (blocking).">globus_gass_copy_handle_to_url()</a> </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__gass__copy_8c_source.html#l05406">globus_gass_copy_register_url_to_handle()</a>.</p>
</div>
</div>
<a class="anchor" id="a527e243537e57b02b71f7225fa0334f9"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_handle_to_url" ref="a527e243537e57b02b71f7225fa0334f9" args="(globus_gass_copy_handle_t *handle, globus_io_handle_t *source_handle, char *dest_url, globus_gass_copy_attr_t *dest_attr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_handle_to_url </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_io_handle_t * </td>
<td class="paramname"> <em>source_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>dest_attr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from an IO handle to destination URL (blocking). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_handle</em> </td><td>transfer data from this IO handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_url</em> </td><td>transfer data to this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_attr</em> </td><td>Attributes describing how the transfer to the destination should be done</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was completed successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#ae819427fb2386ae134c687547bd14d4f" title="Transfer data from source URL to destination URL (blocking).">globus_gass_copy_url_to_url()</a> <a class="el" href="globus__gass__copy_8c.html#a568b3b9898a1faa527d1e9e54717a6ac" title="Transfer data from source URL to an IO handle (blocking).">globus_gass_copy_url_to_handle()</a> </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__gass__copy_8c_source.html#l05565">globus_gass_copy_register_handle_to_url()</a>.</p>
</div>
</div>
<a class="anchor" id="ab8af05a91b7cc79ef6c5dbc6230a3b90"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_register_url_to_url" ref="ab8af05a91b7cc79ef6c5dbc6230a3b90" args="(globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, char *dest_url, globus_gass_copy_attr_t *dest_attr, globus_gass_copy_callback_t callback_func, void *callback_arg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_register_url_to_url </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>dest_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_callback_t </td>
<td class="paramname"> <em>callback_func</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>callback_arg</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from source URL to destination URL (non-blocking). </p>
<p>This functions initiates a transfer from source URL to destination URL, then returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the callback_func will be invoked with the final status of the transfer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_url</em> </td><td>transfer data from this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_attr</em> </td><td>Attributes describing how the transfer form the source should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_url</em> </td><td>transfer data to this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_attr</em> </td><td>Attributes describing how the transfer to the destination should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_func</em> </td><td>Callback to be invoked once the transfer is completed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_arg</em> </td><td>Argument to be passed to the callback_func.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was initiated successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#aacb0215efc5618137e9e4e0152db86e2" title="Transfer data from source URL to an IO handle (non-blocking).">globus_gass_copy_register_url_to_handle()</a>, <a class="el" href="globus__gass__copy_8c.html#a9e8df805ffa4f251fc726b2d1d495dac" title="Transfer data from an IO handle to destination URL (non-blocking).">globus_gass_copy_register_handle_to_url()</a> </dd></dl>
<p>References <a class="el" href="globus__i__gass__copy_8h_source.html#l00116">globus_i_gass_copy_state_target_s::attr</a>, <a class="el" href="globus__i__gass__copy_8h_source.html#l00253">globus_gass_copy_state_s::cancel</a>, <a class="el" href="globus__i__gass__copy_8h_source.html#l00228">globus_gass_copy_state_s::dest</a>, <a class="el" href="globus__gass__copy_8c_source.html#l01007">globus_gass_copy_get_url_mode()</a>, <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__i__gass__copy_8h_source.html#l00223">globus_gass_copy_state_s::source</a>.</p>
</div>
</div>
<a class="anchor" id="aacb0215efc5618137e9e4e0152db86e2"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_register_url_to_handle" ref="aacb0215efc5618137e9e4e0152db86e2" args="(globus_gass_copy_handle_t *handle, char *source_url, globus_gass_copy_attr_t *source_attr, globus_io_handle_t *dest_handle, globus_gass_copy_callback_t callback_func, void *callback_arg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_register_url_to_handle </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_io_handle_t * </td>
<td class="paramname"> <em>dest_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_callback_t </td>
<td class="paramname"> <em>callback_func</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>callback_arg</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from source URL to an IO handle (non-blocking). </p>
<p>This functions initiates a transfer from source URL to an IO handle, then returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the callback_func will be invoked with the final status of the transfer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_url</em> </td><td>transfer data from this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_attr</em> </td><td>Attributes describing how the transfer form the source should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_handle</em> </td><td>transfer data to this IO handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_func</em> </td><td>Callback to be invoked once the transfer is completed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_arg</em> </td><td>Argument to be passed to the callback_func.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was initiated successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#ab8af05a91b7cc79ef6c5dbc6230a3b90" title="Transfer data from source URL to destination URL (non-blocking).">globus_gass_copy_register_url_to_url()</a>, <a class="el" href="globus__gass__copy_8c.html#a9e8df805ffa4f251fc726b2d1d495dac" title="Transfer data from an IO handle to destination URL (non-blocking).">globus_gass_copy_register_handle_to_url()</a> </dd></dl>
<p>References <a class="el" href="globus__i__gass__copy_8h_source.html#l00253">globus_gass_copy_state_s::cancel</a>, <a class="el" href="globus__i__gass__copy_8h_source.html#l00228">globus_gass_copy_state_s::dest</a>, <a class="el" href="globus__gass__copy_8c_source.html#l01007">globus_gass_copy_get_url_mode()</a>, <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__i__gass__copy_8h_source.html#l00223">globus_gass_copy_state_s::source</a>.</p>
</div>
</div>
<a class="anchor" id="a9e8df805ffa4f251fc726b2d1d495dac"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_register_handle_to_url" ref="a9e8df805ffa4f251fc726b2d1d495dac" args="(globus_gass_copy_handle_t *handle, globus_io_handle_t *source_handle, char *dest_url, globus_gass_copy_attr_t *dest_attr, globus_gass_copy_callback_t callback_func, void *callback_arg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_register_handle_to_url </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_io_handle_t * </td>
<td class="paramname"> <em>source_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_attr_t * </td>
<td class="paramname"> <em>dest_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_callback_t </td>
<td class="paramname"> <em>callback_func</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>callback_arg</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Transfer data from an IO handle to destination URL (non-blocking). </p>
<p>This functions initiates a transfer from an IO handle to destination URL, then returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the callback_func will be invoked with the final status of the transfer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>The handle to perform the copy operation </td></tr>
<tr><td valign="top"></td><td valign="top"><em>source_handle</em> </td><td>transfer data from this IO handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_url</em> </td><td>transfer data to this URL </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest_attr</em> </td><td>Attributes describing how the transfer to the destination should be done </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_func</em> </td><td>Callback to be invoked once the transfer is completed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback_arg</em> </td><td>Argument to be passed to the callback_func.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if the transfer was initiated successfully, or a result pointing to an object of one of the the following error types: </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_NULL_PARAMETER</em> </td><td>The handle was equal to GLOBUS_NULL, so the transfer could not processed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GASS_COPY_ERROR_TYPE_next_error</em> </td><td>next error description</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="globus__gass__copy_8c.html#ab8af05a91b7cc79ef6c5dbc6230a3b90" title="Transfer data from source URL to destination URL (non-blocking).">globus_gass_copy_register_url_to_url()</a>, <a class="el" href="globus__gass__copy_8c.html#aacb0215efc5618137e9e4e0152db86e2" title="Transfer data from source URL to an IO handle (non-blocking).">globus_gass_copy_register_url_to_handle()</a> </dd></dl>
<p>References <a class="el" href="globus__i__gass__copy_8h_source.html#l00253">globus_gass_copy_state_s::cancel</a>, <a class="el" href="globus__i__gass__copy_8h_source.html#l00228">globus_gass_copy_state_s::dest</a>, <a class="el" href="globus__gass__copy_8c_source.html#l01007">globus_gass_copy_get_url_mode()</a>, <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__i__gass__copy_8h_source.html#l00223">globus_gass_copy_state_s::source</a>.</p>
</div>
</div>
<a class="anchor" id="a11291452cc59b61c413ebaa167ba2969"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_cache_url_state" ref="a11291452cc59b61c413ebaa167ba2969" args="(globus_gass_copy_handle_t *handle, char *url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_cache_url_state </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>url</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Cache connections to an FTP or GSIFTP server. </p>
<p>Explicitly cache connections to URL server. When an URL is cached, the connection to the URL server will not be closed after a file transfer completes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Handle which will contain a cached connection to the URL server. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>The URL of the FTP or GSIFTP server to cache.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a6423bc3e8a66eeb20e5dee4e7a213b2c"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_flush_url_state" ref="a6423bc3e8a66eeb20e5dee4e7a213b2c" args="(globus_gass_copy_handle_t *handle, char *url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_flush_url_state </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>url</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Remove a cached connection to an FTP or GSIFTP server. </p>
<p>Explicitly remove a cached connection to an FTP or GSIFTP server. If an idle connection to an FTP server exists, it will be closed.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>Handle which contains a cached connection to the URL server. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>The URL of the FTP or GSIFTP server to remove.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>This function returns GLOBUS_SUCCESS if successful, or a globus_result_t indicating the error that occurred. </dd></dl>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a048130bb19d65fec64cbef54d4176b09"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_set_user_pointer" ref="a048130bb19d65fec64cbef54d4176b09" args="(globus_gass_copy_handle_t *handle, void *user_pointer)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_set_user_pointer </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>user_pointer</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set a pointer in the handle to point at user-allocated memory. </p>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a73e3f61383c3c95f7c806ead96df8e4c"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_get_user_pointer" ref="a73e3f61383c3c95f7c806ead96df8e4c" args="(globus_gass_copy_handle_t *handle, void **user_data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_get_user_pointer </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void ** </td>
<td class="paramname"> <em>user_data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the pointer in the handle that points to user-allocated memory. </p>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>.</p>
</div>
</div>
<a class="anchor" id="a1b39ba5a6e6f01855b64d4bab5b1815c"></a><!-- doxytag: member="globus_gass_copy.c::globus_gass_copy_cancel" ref="a1b39ba5a6e6f01855b64d4bab5b1815c" args="(globus_gass_copy_handle_t *handle, globus_gass_copy_callback_t cancel_callback, void *cancel_callback_arg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gass_copy_cancel </td>
<td>(</td>
<td class="paramtype">globus_gass_copy_handle_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gass_copy_callback_t </td>
<td class="paramname"> <em>cancel_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>cancel_callback_arg</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Cancel the current transfer associated with this handle,. </p>
<p><p>store the cancel_callback and cancel_callback_arg in the handle. Needed because the ftp callback will be the one given from the original globus_ftp_client_third_party_transfer() call.</p>
</p>
<p>References <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, and <a class="el" href="globus__gass__copy_8c_source.html#l06033">globus_l_gass_copy_target_cancel()</a>.</p>
</div>
</div>
<a class="anchor" id="a955f28307f02693b48e48ff64ad409d4"></a><!-- doxytag: member="globus_gass_copy.c::globus_l_gass_copy_target_cancel" ref="a955f28307f02693b48e48ff64ad409d4" args="(globus_i_gass_copy_cancel_t *cancel_info)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_l_gass_copy_target_cancel </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structglobus__i__gass__copy__cancel__s.html">globus_i_gass_copy_cancel_t</a> * </td>
<td class="paramname"> <em>cancel_info</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Cancel the source or destination transfer in progress. </p>
<p>References <a class="el" href="structglobus__i__gass__copy__state__target__s.html#adeab759deadfe9d6fb6ceb809bb4cfcf">globus_i_gass_copy_state_target_s::data</a>, <a class="el" href="structglobus__i__gass__copy__state__target__s.html#a4ccd4291b0694c1079b13d0e9761beb9">globus_i_gass_copy_state_target_s::ftp</a>, <a class="el" href="structglobus__i__gass__copy__state__target__s.html#ac9d2612aff9b365e5c6e6cddbd0af696">globus_i_gass_copy_state_target_s::gass</a>, <a class="el" href="globus__gass__copy_8h_source.html#l00096">GLOBUS_GASS_COPY_MODULE</a>, <a class="el" href="structglobus__i__gass__copy__state__target__s.html#add7bc58345aa67d7dd87f23b14a1dfc2">globus_i_gass_copy_state_target_s::io</a>, <a class="el" href="globus__i__gass__copy_8h_source.html#l00156">globus_i_gass_copy_state_target_s::mode</a>, and <a class="el" href="globus__i__gass__copy_8h_source.html#l00111">globus_i_gass_copy_state_target_s::url</a>.</p>
</div>
</div>
</div>
<hr>
<p align="center">
<a href="http://www.globus.org/toolkit/about.html" target="_top">about globus</a> |
<a href="http://www.globus.org/toolkit/" target="_top">globus toolkit</a> |
<a href="https://dev.globus.org/wiki/Welcome/" target="_top">dev.globus</a>
<br>
<br>
Comments? <a href="mailto:webmaster@globus.org">webmaster@globus.org</a>
</body>
</html>
