<!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.8.1.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<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>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('group__globus__ftp__client__operations.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#typedef-members">Typedefs</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">FTP Operations</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:ga395e0e9dbb22bf3d4c81223b58f2b749"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> )(void *user_arg, <a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, globus_object_t *error)</td></tr>
<tr class="memitem:ga7c3c6c7e81300251f055ee783d105bdc"><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
globus_i_ftp_client_features_s * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:gae52d1000b926bae6436d61aeeaf68803"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gae52d1000b926bae6436d61aeeaf68803">globus_ftp_client_tristate_t</a> </td></tr>
<tr class="memitem:ga51ebf6e3cc1c40e87193b8416cbf19dc"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga51ebf6e3cc1c40e87193b8416cbf19dc">globus_ftp_client_probed_feature_t</a> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga851bdcb0bca0928ba69af638d9e8802d"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga851bdcb0bca0928ba69af638d9e8802d">globus_ftp_client_machine_list</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga2511fb841af9d5ab3bdb34343f3c3bb1"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga2511fb841af9d5ab3bdb34343f3c3bb1">globus_ftp_client_recursive_list</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
File or Directory Existence</h2></td></tr>
<tr class="memitem:ga59d8fb30909efd7060504679b176e0f0"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga59d8fb30909efd7060504679b176e0f0">globus_ftp_client_exists</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Features</h2></td></tr>
<tr class="memitem:gadbefc4babee95c4e0d2ed3b8f359dba6"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gadbefc4babee95c4e0d2ed3b8f359dba6">globus_ftp_client_features_init</a> (<a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> *u_features)</td></tr>
<tr class="memitem:gafa40b5e9a22464719214725009dbffd3"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gafa40b5e9a22464719214725009dbffd3">globus_ftp_client_features_destroy</a> (<a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> *u_features)</td></tr>
<tr class="memitem:ga764549c6bd3034fe3e163a8a16683bf8"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga764549c6bd3034fe3e163a8a16683bf8">globus_ftp_client_feat</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> *u_features, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga7ea2785b4aec136fd44896e987b3091c"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga7ea2785b4aec136fd44896e987b3091c">globus_ftp_client_is_feature_supported</a> (const <a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> *u_features, <a class="el" href="group__globus__ftp__client__operations.html#gae52d1000b926bae6436d61aeeaf68803">globus_ftp_client_tristate_t</a> *answer, <a class="el" href="group__globus__ftp__client__operations.html#ga51ebf6e3cc1c40e87193b8416cbf19dc">globus_ftp_client_probed_feature_t</a> feature)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Make Directory</h2></td></tr>
<tr class="memitem:ga4b57d5aca86af0ac836b7855268d06f0"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga4b57d5aca86af0ac836b7855268d06f0">globus_ftp_client_mkdir</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Remove Directory</h2></td></tr>
<tr class="memitem:ga7c9e7a6bdfc765ba45c454466606519a"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga7c9e7a6bdfc765ba45c454466606519a">globus_ftp_client_rmdir</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Change Working Directory</h2></td></tr>
<tr class="memitem:ga8a8f51e9e7c8e49c48a8e0a598388609"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga8a8f51e9e7c8e49c48a8e0a598388609">globus_ftp_client_cwd</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, globus_byte_t **cwd_buffer, globus_size_t *cwd_buffer_length, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Delete</h2></td></tr>
<tr class="memitem:gada6998846e4248e2a18e321e07e00dc1"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gada6998846e4248e2a18e321e07e00dc1">globus_ftp_client_delete</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
List</h2></td></tr>
<tr class="memitem:ga5fa70baff2a6fc9e90f30e19f8104027"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga5fa70baff2a6fc9e90f30e19f8104027">globus_ftp_client_list</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga65cec516fcfc8b3e267f73dd31616db9"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga65cec516fcfc8b3e267f73dd31616db9">globus_ftp_client_verbose_list</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
STAT</h2></td></tr>
<tr class="memitem:gaddbb4ccbda05f791bed0014183585245"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gaddbb4ccbda05f791bed0014183585245">globus_ftp_client_stat</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, globus_byte_t **stat_buffer, globus_size_t *stat_buffer_length, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
MLST</h2></td></tr>
<tr class="memitem:gab2a3d5c6d964108b21705c9943088e20"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gab2a3d5c6d964108b21705c9943088e20">globus_ftp_client_mlst</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, globus_byte_t **mlst_buffer, globus_size_t *mlst_buffer_length, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Move</h2></td></tr>
<tr class="memitem:ga60503e21cbd98a5e5f938fee355904c1"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga60503e21cbd98a5e5f938fee355904c1">globus_ftp_client_move</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *source_url, const char *dest_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
chmod</h2></td></tr>
<tr class="memitem:gab1408701532e2397c9206f6b92885811"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gab1408701532e2397c9206f6b92885811">globus_ftp_client_chmod</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, int mode, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
chgrp</h2></td></tr>
<tr class="memitem:ga5c1cc65213d207d4714e07bf5fdabfb1"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga5c1cc65213d207d4714e07bf5fdabfb1">globus_ftp_client_chgrp</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, const char *group, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
utime</h2></td></tr>
<tr class="memitem:ga2c8aac51dd40c6cfec996a05d752271f"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga2c8aac51dd40c6cfec996a05d752271f">globus_ftp_client_utime</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, const struct tm *utime_time, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
symlink</h2></td></tr>
<tr class="memitem:gadf97d9ea0257eef2e76eed5195168b07"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gadf97d9ea0257eef2e76eed5195168b07">globus_ftp_client_symlink</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *source_url, const char *link_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Get</h2></td></tr>
<tr class="memitem:ga6fe365dd2dfac6da159ff389e1f76a9b"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga6fe365dd2dfac6da159ff389e1f76a9b">globus_ftp_client_get</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:gab2632967419fb566d6cf5b26cf0bbeb2"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gab2632967419fb566d6cf5b26cf0bbeb2">globus_ftp_client_partial_get</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, globus_off_t partial_offset, globus_off_t partial_end_offset, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:gaf0cbdd77ea0cbecf2b8f51ef1e6aec04"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gaf0cbdd77ea0cbecf2b8f51ef1e6aec04">globus_ftp_client_extended_get</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, const char *eret_alg_str, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Put</h2></td></tr>
<tr class="memitem:gab5ea9958c3f649258c25cae5d4e847f1"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gab5ea9958c3f649258c25cae5d4e847f1">globus_ftp_client_put</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga35ba972b1faac5d9b5c62f3413f1282e"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga35ba972b1faac5d9b5c62f3413f1282e">globus_ftp_client_partial_put</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, globus_off_t partial_offset, globus_off_t partial_end_offset, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga269a4635be32807146d05817987429a3"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga269a4635be32807146d05817987429a3">globus_ftp_client_extended_put</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, const char *esto_alg_str, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
3rd Party Transfer</h2></td></tr>
<tr class="memitem:ga6a54cd75d80d657de8787aaae5eeed19"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga6a54cd75d80d657de8787aaae5eeed19">globus_ftp_client_third_party_transfer</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *source_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *source_attr, const char *dest_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *dest_attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:ga930ea54b04772e6fac93d4001daf4b5e"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga930ea54b04772e6fac93d4001daf4b5e">globus_ftp_client_partial_third_party_transfer</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *source_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *source_attr, const char *dest_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *dest_attr, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, globus_off_t partial_offset, globus_off_t partial_end_offset, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
<tr class="memitem:gabfe92d86d671664178b524ebba55bd1b"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gabfe92d86d671664178b524ebba55bd1b">globus_ftp_client_extended_third_party_transfer</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, const char *source_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *source_attr, const char *eret_alg_str, const char *dest_url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *dest_attr, const char *esto_alg_str, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *restart, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Modification Time</h2></td></tr>
<tr class="memitem:ga6d805fe57c2274594515fa27d9f4a047"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga6d805fe57c2274594515fa27d9f4a047">globus_ftp_client_modification_time</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, globus_abstime_t *modification_time, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Size</h2></td></tr>
<tr class="memitem:ga1735fe602111ab0e3ce24ed8fb51d932"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga1735fe602111ab0e3ce24ed8fb51d932">globus_ftp_client_size</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, globus_off_t *size, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Cksm</h2></td></tr>
<tr class="memitem:ga044c9c3145212f2d2328a013a53c03d7"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#ga044c9c3145212f2d2328a013a53c03d7">globus_ftp_client_cksm</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle, const char *url, <a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> *attr, char *cksm, globus_off_t offset, globus_off_t length, const char *algorithm, <a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> complete_callback, void *callback_arg)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Abort</h2></td></tr>
<tr class="memitem:gaf4ec9fabaa624d60eb1ad821e0cc1b3a"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__operations.html#gaf4ec9fabaa624d60eb1ad821e0cc1b3a">globus_ftp_client_abort</a> (<a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *u_handle)</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>Initiate an FTP operation. </p>
<p>This module contains the API functions for a user to request a get, put, third-party transfer, or other FTP file operation. </p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga395e0e9dbb22bf3d4c81223b58f2b749"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* globus_ftp_client_complete_callback_t)(void *user_arg, <a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> *handle, globus_object_t *error)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Operation complete callback. </p>
<p>Every FTP Client operation (get, put, transfer, mkdir, etc) is asynchronous. A callback of this type is passed to each of the operation function calls to let the user know when the operation is complete. The completion callback is called only once per operation, after all other callbacks for the operation have returned.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">user_arg</td><td>The user_arg parameter passed to the operation. </td></tr>
<tr><td class="paramname">handle</td><td>The handle on which the operation was done. </td></tr>
<tr><td class="paramname">error</td><td>A Globus error object indicating any problem which occurred, or GLOBUS_SUCCESS, if the operation completed successfully. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7c3c6c7e81300251f055ee783d105bdc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct globus_i_ftp_client_features_s* <a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Feature HandleHandle used to associate state with feature operations. </p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__operations.html#ga764549c6bd3034fe3e163a8a16683bf8" title="Check the features supported by the server (FTP FEAT command).">globus_ftp_client_feat</a>, <a class="el" href="group__globus__ftp__client__operations.html#gadbefc4babee95c4e0d2ed3b8f359dba6" title="Initialize the feature set, to be later used by globus_ftp_client_feat().">globus_ftp_client_features_init</a>, <a class="el" href="group__globus__ftp__client__operations.html#gafa40b5e9a22464719214725009dbffd3" title="Destroy the feature set.">globus_ftp_client_features_destroy</a> </dd></dl>
</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="gae52d1000b926bae6436d61aeeaf68803"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__globus__ftp__client__operations.html#gae52d1000b926bae6436d61aeeaf68803">globus_ftp_client_tristate_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Types for feature existenceFALSE and TRUE are known to be fact that a feature does or does not exist MAYBE means that the feature may exist. </p>
</div>
</div>
<a class="anchor" id="ga51ebf6e3cc1c40e87193b8416cbf19dc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__globus__ftp__client__operations.html#ga51ebf6e3cc1c40e87193b8416cbf19dc">globus_ftp_client_probed_feature_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Types of features. </p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga59d8fb30909efd7060504679b176e0f0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_exists </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check for the existence of a file or directory on an FTP server. </p>
<p>This function attempts to determine whether the specified URL points to a valid file or directory. The <em>complete_callback</em> will be invoked with the result of the existence check passed as a globus error object, or GLOBUS_SUCCESS.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the existence check operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of the directory or file to check. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes to use for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the existence operation is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gadbefc4babee95c4e0d2ed3b8f359dba6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_features_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> * </td>
<td class="paramname"><em>u_features</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize the feature set, to be later used by <a class="el" href="group__globus__ftp__client__operations.html#ga764549c6bd3034fe3e163a8a16683bf8" title="Check the features supported by the server (FTP FEAT command).">globus_ftp_client_feat()</a>. </p>
<p>Each feature gets initial value GLOBUS_FTP_CLIENT_MAYBE. </p>
<dl class="section note"><dt>Note:</dt><dd>Structure initialized by this function must be destroyed using <a class="el" href="group__globus__ftp__client__operations.html#gafa40b5e9a22464719214725009dbffd3" title="Destroy the feature set.">globus_ftp_client_features_destroy()</a> </dd></dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS on success, otherwise error. </dd></dl>
</div>
</div>
<a class="anchor" id="gafa40b5e9a22464719214725009dbffd3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_features_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> * </td>
<td class="paramname"><em>u_features</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destroy the feature set. </p>
<dl class="section note"><dt>Note:</dt><dd>Structure passed to this function must have been previously initialized by <a class="el" href="group__globus__ftp__client__operations.html#gadbefc4babee95c4e0d2ed3b8f359dba6" title="Initialize the feature set, to be later used by globus_ftp_client_feat().">globus_ftp_client_features_init()</a>. </dd></dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS on success, otherwise error. </dd></dl>
</div>
</div>
<a class="anchor" id="ga764549c6bd3034fe3e163a8a16683bf8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_feat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></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"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> * </td>
<td class="paramname"><em>u_features</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check the features supported by the server (FTP FEAT command). </p>
<p>After this procedure completes, the features set (parameter u_features) represents the features supported by the server. Prior to calling this procedure, the structure should have been initialized by <a class="el" href="group__globus__ftp__client__operations.html#gadbefc4babee95c4e0d2ed3b8f359dba6" title="Initialize the feature set, to be later used by globus_ftp_client_feat().">globus_ftp_client_features_init()</a>; afterwards, it should be destroyed by <a class="el" href="group__globus__ftp__client__operations.html#gafa40b5e9a22464719214725009dbffd3" title="Destroy the feature set.">globus_ftp_client_features_destroy()</a>. After <a class="el" href="group__globus__ftp__client__operations.html#ga764549c6bd3034fe3e163a8a16683bf8" title="Check the features supported by the server (FTP FEAT command).">globus_ftp_client_feat()</a> returns, each feature in the list has one of the values: GLOBUS_FTP_CLIENT_TRUE, GLOBUS_FTP_CLIENT_FALSE, or GLOBUS_FTP_CLIENT_MAYBE. The first two denote the server supporting, or not supporting, the given feature. The last one means that the test has not been performed. This is not necessarily caused by error; there might have been no reason to check for this particular feature.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">u_features</td><td>A pointer to a globus_ftp_client_features_t to be filled with the feature set supported by the server. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the size check is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>source_url is GLOBUS_NULL</li>
<li>source_url cannot be parsed</li>
<li>source_url is not a ftp or gsiftp url</li>
<li>u_features is GLOBUS_NULL or badly initialized</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga7ea2785b4aec136fd44896e987b3091c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_is_feature_supported </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__globus__ftp__client__operations.html#ga7c3c6c7e81300251f055ee783d105bdc">globus_ftp_client_features_t</a> * </td>
<td class="paramname"><em>u_features</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#gae52d1000b926bae6436d61aeeaf68803">globus_ftp_client_tristate_t</a> * </td>
<td class="paramname"><em>answer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga51ebf6e3cc1c40e87193b8416cbf19dc">globus_ftp_client_probed_feature_t</a> </td>
<td class="paramname"><em>feature</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check if the feature is supported by the server. </p>
<p>After the function completes, parameter answer contains the state of the server support of the given function. It can have one of the values: GLOBUS_FTP_CLIENT_TRUE, GLOBUS_FTP_CLIENT_FALSE, or GLOBUS_FTP_CLIENT_MAYBE.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_features</td><td>list of features, as returned by <a class="el" href="group__globus__ftp__client__operations.html#ga764549c6bd3034fe3e163a8a16683bf8" title="Check the features supported by the server (FTP FEAT command).">globus_ftp_client_feat()</a> </td></tr>
<tr><td class="paramname">answer</td><td>this variable will contain the answer </td></tr>
<tr><td class="paramname">feature</td><td>feature number, 0 <= feature < GLOBUS_FTP_CLIENT_FEATURE_MAX </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>error when any of the parameters is null or badly initialized </dd></dl>
</div>
</div>
<a class="anchor" id="ga4b57d5aca86af0ac836b7855268d06f0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_mkdir </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make a directory on an FTP server. </p>
<p>This function starts a mkdir operation on a FTP server.</p>
<p>When the response to the mkdir request has been received the complete_callback will be invoked with the result of the mkdir operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the mkdir operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL for the directory to create. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the mkdir is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga7c9e7a6bdfc765ba45c454466606519a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_rmdir </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make a directory on an FTP server. </p>
<p>This function starts a rmdir operation on a FTP server.</p>
<p>When the response to the rmdir request has been received the complete_callback will be invoked with the result of the rmdir operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the rmdir operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL for the directory to create. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the rmdir is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga8a8f51e9e7c8e49c48a8e0a598388609"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_cwd </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_byte_t ** </td>
<td class="paramname"><em>cwd_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_size_t * </td>
<td class="paramname"><em>cwd_buffer_length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make a directory on an FTP server. </p>
<p>This function starts a cwd operation on a FTP server.</p>
<p>When the response to the cwd request has been received the complete_callback will be invoked with the result of the cwd operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the cwd operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL for the directory to cd into. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">cwd_buffer</td><td>A pointer to a globus_byte_t * to be allocated and filled with the directory name returned by the CWD, if it succeeds. Otherwise, the value pointed to by it is undefined. It is up the user to free this memory. </td></tr>
<tr><td class="paramname">cwd_buffer_length</td><td>A pointer to a globus_size_t to be filled with the length of the data in cwd_buffer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the cwd is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>cwd_buffer is GLOBUS_NULL</li>
<li>cwd_buffer_length is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gada6998846e4248e2a18e321e07e00dc1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_delete </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Delete a file on an FTP server. </p>
<p>This function starts a delete operation on a FTP server. Note that this functions will only delete files, not directories.</p>
<p>When the response to the delete request has been received the complete_callback will be invoked with the result of the delete operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the delete operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL for the file to delete. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the delete is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>u_handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga5fa70baff2a6fc9e90f30e19f8104027"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_list </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file listing from an FTP server. </p>
<p>This function starts a "NLST" transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this listing.</p>
<p>When all of the data associated with the listing is retrieved, and all of the data callbacks have been called, or if the list request is aborted, the complete_callback will be invoked with the final status of the list.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "list" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga65cec516fcfc8b3e267f73dd31616db9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_verbose_list </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file listing from an FTP server. </p>
<p>This function starts a "LIST" transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this listing.</p>
<p>When all of the data associated with the listing is retrieved, and all of the data callbacks have been called, or if the list request is aborted, the complete_callback will be invoked with the final status of the list.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "list" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gaddbb4ccbda05f791bed0014183585245"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_stat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_byte_t ** </td>
<td class="paramname"><em>stat_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_size_t * </td>
<td class="paramname"><em>stat_buffer_length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get information about a file or directory from a FTP server. </p>
<p>This function requests the STAT listing of a file or directory from an FTP server.</p>
<p>When the STAT request is completed or aborted, the complete_callback will be invoked with the final status of the operation. If the callback is returns without an error, the STAT fact string will be stored in the globus_byte_t * pointed to by the stat_buffer parameter to this function.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of a file or directory to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">stat_buffer</td><td>A pointer to a globus_byte_t * to be allocated and filled with the STAT listing of the file, if it exists. Otherwise, the value pointed to by it is undefined. It is up to the user to free this memory. </td></tr>
<tr><td class="paramname">stat_buffer_length</td><td>A pointer to a globus_size_t to be filled with the length of the data in stat_buffer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the STAT command is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>stat_buffer is GLOBUS_NULL</li>
<li>stat_buffer_length is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga851bdcb0bca0928ba69af638d9e8802d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_machine_list </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a machine parseable file listing from an FTP server. </p>
<p>This function starts a "MLSD" transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this listing.</p>
<p>When all of the data associated with the listing is retrieved, and all of the data callbacks have been called, or if the list request is aborted, the complete_callback will be invoked with the final status of the list.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "list" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga2511fb841af9d5ab3bdb34343f3c3bb1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_recursive_list </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a machine parseable recursive file listing from an FTP server. </p>
<p>This function starts a "MLSR" transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this listing.</p>
<p>When all of the data associated with the listing is retrieved, and all of the data callbacks have been called, or if the list request is aborted, the complete_callback will be invoked with the final status of the list.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "list" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gab2a3d5c6d964108b21705c9943088e20"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_mlst </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_byte_t ** </td>
<td class="paramname"><em>mlst_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_size_t * </td>
<td class="paramname"><em>mlst_buffer_length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get information about a file or directory from a FTP server. </p>
<p>This function requests the MLST fact string of a file or directory from an FTP server.</p>
<p>When the MLST request is completed or aborted, the complete_callback will be invoked with the final status of the operation. If the callback is returns without an error, the MLST fact string will be stored in the globus_byte_t * pointed to by the mlst_buffer parameter to this function.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of a file or directory to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">mlst_buffer</td><td>A pointer to a globus_byte_t * to be allocated and filled with the MLST fact string of the file, if it exists. Otherwise, the value pointed to by it is undefined. It is up to the user to free this memory. </td></tr>
<tr><td class="paramname">mlst_buffer_length</td><td>A pointer to a globus_size_t to be filled with the length of the data in mlst_buffer. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the MLST command is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>mlst_buffer is GLOBUS_NULL</li>
<li>mlst_buffer_length is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga60503e21cbd98a5e5f938fee355904c1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_move </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Move a file on an FTP server. </p>
<p>This function starts a move (rename) operation on an FTP server. Note that this function does not move files between FTP servers and that the host:port part of the destination url is ignored.</p>
<p>When the response to the move request has been received the complete_callback will be invoked with the result of the move operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the move operation. </td></tr>
<tr><td class="paramname">source_url</td><td>The URL for the file to move. </td></tr>
<tr><td class="paramname">dest_url</td><td>The URL for the target of the move. The host:port part of this URL is ignored. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the move is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>source_url is GLOBUS_NULL</li>
<li>source_url cannot be parsed</li>
<li>source_url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gab1408701532e2397c9206f6b92885811"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_chmod </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>mode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Change permissions on a file. </p>
<p>This function changes file permissions</p>
<p>When the response to the move request has been received the complete_callback will be invoked with the result of the operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the move operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of the file to modify permissions. </td></tr>
<tr><td class="paramname">mode</td><td>The integer file mode to change to. Be sure that the integer is in the proper base, i.e. 0777 (octal) vs 777 (decimal). </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the move is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga5c1cc65213d207d4714e07bf5fdabfb1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_chgrp </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>group</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Change group membership on a file. </p>
<p>This function changes file group membership</p>
<p>When the response to the group change request has been received the complete_callback will be invoked with the result of the operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the change operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of the file to modify group membership. </td></tr>
<tr><td class="paramname">group</td><td>The group name or numeric identifier for the group that the file should become a member of. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the change is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga2c8aac51dd40c6cfec996a05d752271f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_utime </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const struct tm * </td>
<td class="paramname"><em>utime_time</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the modification time on a file. </p>
<p>This function changes file modification time</p>
<p>When the response to the modification time request has been received the complete_callback will be invoked with the result of the operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the change operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL of the file to modify group membership. </td></tr>
<tr><td class="paramname">utime_time</td><td>The absolute time to which the file's modification time should be set. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the change is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gadf97d9ea0257eef2e76eed5195168b07"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_symlink </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>link_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create a symbolic link on the FTP server. </p>
<p>This function creates a symbolic link on the FTP server pointing to a given path. Note that this function does not link files between FTP servers and that the host:port part of the link url is ignored.</p>
<p>When the response to the symlink request has been received the complete_callback will be invoked with the result of the move operation.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the move operation. </td></tr>
<tr><td class="paramname">source_url</td><td>The URL for the symbolic link to create. </td></tr>
<tr><td class="paramname">link_url</td><td>The URL for the target of the link. The host:port part of this URL is ignored. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this operation. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the symlink is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>source_url is GLOBUS_NULL</li>
<li>source_url cannot be parsed</li>
<li>source_url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga6fe365dd2dfac6da159ff389e1f76a9b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_get </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file from an FTP server. </p>
<p>This function starts a "get" file transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this URL.</p>
<p>When all of the data associated with this URL is retrieved, and all of the data callbacks have been called, or if the get request is aborted, the complete_callback will be invoked with the final status of the get.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to download. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "get" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gab2632967419fb566d6cf5b26cf0bbeb2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_partial_get </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_end_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file from an FTP server. </p>
<p>This function starts a "get" file transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this URL.</p>
<p>When all of the data associated with this URL is retrieved, and all of the data callbacks have been called, or if the get request is aborted, the complete_callback will be invoked with the final status of the get.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to download. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">partial_offset</td><td>Starting offset for a partial file get. </td></tr>
<tr><td class="paramname">partial_end_offset</td><td>Ending offset for a partial file get. Use -1 for EOF. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "get" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gaf0cbdd77ea0cbecf2b8f51ef1e6aec04"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_extended_get </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>eret_alg_str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file from an FTP server with server-side processing. </p>
<p>This function starts a "get" file transfer from an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> to retrieve the data associated with this URL.</p>
<p>When all of the data associated with this URL is retrieved, and all of the data callbacks have been called, or if the get request is aborted, the complete_callback will be invoked with the final status of the get.</p>
<p>This function differs from the <a class="el" href="group__globus__ftp__client__operations.html#ga6fe365dd2dfac6da159ff389e1f76a9b" title="Get a file from an FTP server.">globus_ftp_client_get()</a> function by allowing the user to invoke server-side data processing algorithms. GridFTP servers may support support algorithms for data reduction or other customized data storage requirements. There is no client-side verification done on the algorithm string provided by the user. If the server does not understand the requested algorithm, the transfer will fail.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to download. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">eret_alg_str</td><td>The ERET algorithm string. This string contains information needed to invoke a server-specific data reduction algorithm on the file being retrieved. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "get" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress</li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#ga806808e7efb4cffad9e6d932751975c3" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_read()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gab5ea9958c3f649258c25cae5d4e847f1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_put </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Store a file on an FTP server. </p>
<p>This function starts a "put" file transfer to an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> to send the data associated with this URL.</p>
<p>When all of the data associated with this URL is sent, and all of the data callbacks have been called, or if the put request is aborted, the complete_callback will be invoked with the final status of the put.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the put operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to store the data to. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga35ba972b1faac5d9b5c62f3413f1282e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_partial_put </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_end_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Store a file on an FTP server. </p>
<p>This function starts a "put" file transfer to an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> to send the data associated with this URL.</p>
<p>When all of the data associated with this URL is sent, and all of the data callbacks have been called, or if the put request is aborted, the complete_callback will be invoked with the final status of the put.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the put operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to store the data to. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">partial_offset</td><td>Starting offset for a partial file put. </td></tr>
<tr><td class="paramname">partial_end_offset</td><td>Ending offset for a partial file put. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga269a4635be32807146d05817987429a3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_extended_put </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>esto_alg_str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Store a file on an FTP server with server-side processing. </p>
<p>This function starts a "put" file transfer to an FTP server. If this function returns GLOBUS_SUCCESS, then the user may immediately begin calling <a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> to send the data associated with this URL.</p>
<p>When all of the data associated with this URL is sent, and all of the data callbacks have been called, or if the put request is aborted, the complete_callback will be invoked with the final status of the put.</p>
<p>This function differs from the <a class="el" href="group__globus__ftp__client__operations.html#gab5ea9958c3f649258c25cae5d4e847f1" title="Store a file on an FTP server.">globus_ftp_client_put()</a> function by allowing the user to invoke server-side data processing algorithms. GridFTP servers may support algorithms for data reduction or other customized data storage requirements. There is no client-side verification done on the alogirhtm string provided by the user. if the server does not understand the requested algorithm, the transfer will fail.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the put operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to store the data to. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">esto_alg_str</td><td></td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__data.html#gac3ff58b56d3cbd945381c5b9f9f0f3a5" title="Register a data buffer to handle a part of the FTP data transfer.">globus_ftp_client_register_write()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga6a54cd75d80d657de8787aaae5eeed19"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_third_party_transfer </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>dest_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Transfer a file between two FTP servers. </p>
<p>This function starts up a third-party file transfer between FTP server. This function returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the complete_callback will be invoked with the final status of the transfer.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">source_url</td><td>The URL to transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">source_attr</td><td>Attributes for the souce URL. </td></tr>
<tr><td class="paramname">dest_url</td><td>The destination URL for the transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">dest_attr</td><td>Attributes for the destination URL. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note:</dt><dd>The source_attr and dest_attr MUST be compatible. For example, the MODE and TYPE should match for both the source and destination. </dd></dl>
</div>
</div>
<a class="anchor" id="ga930ea54b04772e6fac93d4001daf4b5e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_partial_third_party_transfer </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>dest_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>partial_end_offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Transfer a file between two FTP servers. </p>
<p>This function starts up a third-party file transfer between FTP server. This function returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the complete_callback will be invoked with the final status of the transfer.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">source_url</td><td>The URL to transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">source_attr</td><td>Attributes for the souce URL. </td></tr>
<tr><td class="paramname">dest_url</td><td>The destination URL for the transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">dest_attr</td><td>Attributes for the destination URL. </td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">partial_offset</td><td>Starting offset for a partial file get. </td></tr>
<tr><td class="paramname">partial_end_offset</td><td>Ending offset for a partial file get. Use -1 for EOF. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note:</dt><dd>The source_attr and dest_attr MUST be compatible. For example, the MODE and TYPE should match for both the source and destination. </dd></dl>
</div>
</div>
<a class="anchor" id="gabfe92d86d671664178b524ebba55bd1b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_extended_third_party_transfer </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>source_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>source_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>eret_alg_str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>dest_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>dest_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>esto_alg_str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> * </td>
<td class="paramname"><em>restart</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Transfer a file between two FTP servers with server-side processing. </p>
<p>This function starts up a third-party file transfer between FTP server. This function returns immediately.</p>
<p>When the transfer is completed or if the transfer is aborted, the complete_callback will be invoked with the final status of the transfer.</p>
<p>This function differes from the <a class="el" href="group__globus__ftp__client__operations.html#ga6a54cd75d80d657de8787aaae5eeed19" title="Transfer a file between two FTP servers.">globus_ftp_client_third_party_transfer()</a> funciton by allowing the user to invoke server-side data processing algorithms. GridFTP servers may support algorithms for data reduction or other customized data storage requirements. There is no client-side verification done on the alogirhtm string provided by the user. if the server does not understand * the requested algorithm, the transfer will fail.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>An FTP Client handle to use for the get operation. </td></tr>
<tr><td class="paramname">source_url</td><td>The URL to transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">source_attr</td><td>Attributes for the souce URL. </td></tr>
<tr><td class="paramname">eret_alg_str</td><td></td></tr>
<tr><td class="paramname">dest_url</td><td>The destination URL for the transfer. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">dest_attr</td><td>Attributes for the destination URL. </td></tr>
<tr><td class="paramname">esto_alg_str</td><td></td></tr>
<tr><td class="paramname">restart</td><td>Pointer to a restart marker. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the "put" is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note:</dt><dd>The source_attr and dest_attr MUST be compatible. For example, the MODE and TYPE should match for both the source and destination. </dd></dl>
</div>
</div>
<a class="anchor" id="ga6d805fe57c2274594515fa27d9f4a047"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_modification_time </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_abstime_t * </td>
<td class="paramname"><em>modification_time</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file's modification time from an FTP server. </p>
<p>This function requests the modification time of a file from an FTP server.</p>
<p>When the modification time request is completed or aborted, the complete_callback will be invoked with the final status of the operation. If the callback is returns without an error, the modification time will be stored in the globus_abstime_t value pointed to by the modification_time parameter to this function.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">modification_time</td><td>A pointer to a globus_abstime_t to be filled with the modification time of the file, if it exists. Otherwise, the value pointed to by it is undefined. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the modification time check is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>modification time is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga1735fe602111ab0e3ce24ed8fb51d932"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_size </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t * </td>
<td class="paramname"><em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file's size from an FTP server. </p>
<p>This function requests the size of a file from an FTP server.</p>
<p>When the size request is completed or aborted, the complete_callback will be invoked with the final status of the operation. If the callback is returns without an error, the size will be stored in the globus_off_t value pointed to by the size parameter to this function.</p>
<dl class="section note"><dt>Note:</dt><dd>In ASCII mode, the size will be the size of the file after conversion to ASCII mode. The actual amount of data which is returned in the data callbacks may be less than this amount.</dd></dl>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">size</td><td>A pointer to a globus_off_t to be filled with the total size of the file, if it exists. Otherwise, the value pointed to by it is undefined. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the size check is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>size is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga044c9c3145212f2d2328a013a53c03d7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_cksm </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operationattr.html#ga71207b29c31268b27e52b4cbd6d71224">globus_ftp_client_operationattr_t</a> * </td>
<td class="paramname"><em>attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>cksm</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>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>algorithm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__operations.html#ga395e0e9dbb22bf3d4c81223b58f2b749">globus_ftp_client_complete_callback_t</a> </td>
<td class="paramname"><em>complete_callback</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>callback_arg</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a file's checksum from an FTP server. </p>
<p>This function requests the checksum of a file from an FTP server.</p>
<p>When the request is completed or aborted, the complete_callback will be invoked with the final status of the operation. If the callback is returns without an error, the checksum will be stored in the char * buffer provided in the 'checksum' parameter to this function. The buffer must be large enough to hold the expected checksum result.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>An FTP Client handle to use for the list operation. </td></tr>
<tr><td class="paramname">url</td><td>The URL to list. The URL may be an ftp or gsiftp URL. </td></tr>
<tr><td class="paramname">attr</td><td>Attributes for this file transfer. </td></tr>
<tr><td class="paramname">cksm</td><td>A pointer to a buffer to be filled with the checksum of the file. On error the buffer contents are undefined. </td></tr>
<tr><td class="paramname">offset</td><td>File offset to start calculating checksum. </td></tr>
<tr><td class="paramname">length</td><td>Length of data to read from the starting offset. Use -1 to read the entire file. </td></tr>
<tr><td class="paramname">algorithm</td><td>A pointer to a string to specifying the desired algorithm Currently, GridFTP servers only support the MD5 algorithm. </td></tr>
<tr><td class="paramname">complete_callback</td><td>Callback to be invoked once the checksum is completed. </td></tr>
<tr><td class="paramname">callback_arg</td><td>Argument to be passed to the complete_callback.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>This function returns an error when any of these conditions are true:<ul>
<li>handle is GLOBUS_NULL</li>
<li>url is GLOBUS_NULL</li>
<li>url cannot be parsed</li>
<li>url is not a ftp or gsiftp url</li>
<li>size is GLOBUS_NULL</li>
<li>complete_callback is GLOBUS_NULL</li>
<li>handle already has an operation in progress </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="gaf4ec9fabaa624d60eb1ad821e0cc1b3a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_abort </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__ftp__client__handle.html#ga9d8a98c88d529ab539c2fedee545f172">globus_ftp_client_handle_t</a> * </td>
<td class="paramname"><em>u_handle</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Abort the operation currently in progress. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">u_handle</td><td>Handle which to abort. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<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>
