<!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__restart__marker.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Restart Markers</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">union  </td><td class="memItemRight" valign="bottom"><a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Restart marker. <a href="unionglobus__ftp__client__restart__marker__t.html#details">More...</a><br/></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:ga8dd8fe0ed3573611fdb06ed56c3c0061"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061">globus_ftp_client_restart_marker_init</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker)</td></tr>
<tr class="memitem:gaeb89ef456f67c2b9db1572bd9ff9b060"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060">globus_ftp_client_restart_marker_copy</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *new_marker, <a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker)</td></tr>
<tr class="memitem:ga9653b27ec8c1dde82022730848443778"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga9653b27ec8c1dde82022730848443778">globus_ftp_client_restart_marker_destroy</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker)</td></tr>
<tr class="memitem:ga72a27b2f70d6c9346b8f98fcfabe3c94"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga72a27b2f70d6c9346b8f98fcfabe3c94">globus_ftp_client_restart_marker_insert_range</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, globus_off_t offset, globus_off_t end_offset)</td></tr>
<tr class="memitem:ga640155556c6ab6d4a438c5771e824153"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga640155556c6ab6d4a438c5771e824153">globus_ftp_client_restart_marker_set_ascii_offset</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, globus_off_t offset, globus_off_t ascii_offset)</td></tr>
<tr class="memitem:ga7e918848837403b0025f8b4fdfa6284b"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga7e918848837403b0025f8b4fdfa6284b">globus_ftp_client_restart_marker_set_offset</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, globus_off_t offset)</td></tr>
<tr class="memitem:gaffcfb3c4cddefde22124117faae51043"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#gaffcfb3c4cddefde22124117faae51043">globus_ftp_client_restart_marker_get_total</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, globus_off_t *total_bytes)</td></tr>
<tr class="memitem:ga74376b80855292e81bca5d4b85cb2664"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga74376b80855292e81bca5d4b85cb2664">globus_ftp_client_restart_marker_to_string</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, char **marker_string)</td></tr>
<tr class="memitem:ga1815b87c414845789ff2c54efa71a77c"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__ftp__client__restart__marker.html#ga1815b87c414845789ff2c54efa71a77c">globus_ftp_client_restart_marker_from_string</a> (<a class="el" href="unionglobus__ftp__client__restart__marker__t.html">globus_ftp_client_restart_marker_t</a> *marker, const char *marker_string)</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>FTP Restart Markers. </p>
<p>The Globus FTP Client library provides the ability to start a file transfer from a known location into the file. This is accomplished by passing a restart marker to 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>, <a class="el" href="group__globus__ftp__client__operations.html#gab5ea9958c3f649258c25cae5d4e847f1" title="Store a file on an FTP server.">globus_ftp_client_put()</a>, or <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> functions. </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga8dd8fe0ed3573611fdb06ed56c3c0061"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_init </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>marker</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize a restart marker. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>New restart marker. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="unionglobus__ftp__client__restart__marker__t.html" title="Restart marker.">globus_ftp_client_restart_marker_t</a>, <a class="el" href="group__globus__ftp__client__restart__marker.html#ga9653b27ec8c1dde82022730848443778" title="Destroy a restart marker.">globus_ftp_client_restart_marker_destroy()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gaeb89ef456f67c2b9db1572bd9ff9b060"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_copy </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>new_marker</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>marker</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create a copy of a restart marker. </p>
<p>This function copies the contents of marker to new_marker.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">new_marker</td><td>A pointer to a new restart marker. </td></tr>
<tr><td class="paramname">marker</td><td>The marker to copy.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a>, <a class="el" href="group__globus__ftp__client__restart__marker.html#ga9653b27ec8c1dde82022730848443778" title="Destroy a restart marker.">globus_ftp_client_restart_marker_destroy()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga9653b27ec8c1dde82022730848443778"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_destroy </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>marker</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destroy a restart marker. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>Restart marker. This marker must be initialized by either calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a> or <a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060" title="Create a copy of a restart marker.">globus_ftp_client_restart_marker_copy()</a></td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="unionglobus__ftp__client__restart__marker__t.html" title="Restart marker.">globus_ftp_client_restart_marker_t</a>, <a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a>, <a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060" title="Create a copy of a restart marker.">globus_ftp_client_restart_marker_copy()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga72a27b2f70d6c9346b8f98fcfabe3c94"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_insert_range </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>marker</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t </td>
<td class="paramname"><em>end_offset</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Insert a range into a restart markerThis function updates a restart marker with a new byte range, suitable for using to restart an extended block mode transfer. </p>
<p>Adjacent ranges within the marker will be combined into a single entry in the marker.</p>
<p>The marker must first be initialized by calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a> or <a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060" title="Create a copy of a restart marker.">globus_ftp_client_restart_marker_copy()</a>.</p>
<p>A marker can only hold a range list or a stream offset. Calling this function after calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga7e918848837403b0025f8b4fdfa6284b" title="Set the offset for a restart marker.">globus_ftp_client_restart_marker_set_offset()</a> will result in a marker suitable only for use restarting an extended block mode transfer.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>A restart marker </td></tr>
<tr><td class="paramname">offset</td><td>The starting offset of the range. </td></tr>
<tr><td class="paramname">end_offset</td><td>The ending offset of the range.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html#ga7e918848837403b0025f8b4fdfa6284b" title="Set the offset for a restart marker.">globus_ftp_client_restart_marker_set_offset()</a> <a class="el" href="group__globus__ftp__client__operationattr.html#ga0c910be730c118fb94c59fa5413ac473" title="Set/Get the file transfer mode attribute for an ftp client attribute set.">globus_ftp_client_operationattr_set_mode()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga640155556c6ab6d4a438c5771e824153"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_set_ascii_offset </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>marker</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>ascii_offset</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the offset for a restart marker. </p>
<p>This function modifies a restart marker to contain a stream offset, suitable for using to restart a steam mode transfer.</p>
<p>The marker must first be initialized by calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a> or <a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060" title="Create a copy of a restart marker.">globus_ftp_client_restart_marker_copy()</a>.</p>
<p>A marker can only hold a range list or a stream offset. Calling this function after calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga72a27b2f70d6c9346b8f98fcfabe3c94" title="Insert a range into a restart markerThis function updates a restart marker with a new byte range...">globus_ftp_client_restart_marker_insert_range()</a> will delete the ranges associated with the marker, and replace it with a marker suitable only for use restarting a stream mode transfer.</p>
<p>When restarting an ASCII type transfer, use <a class="el" href="group__globus__ftp__client__restart__marker.html#ga640155556c6ab6d4a438c5771e824153" title="Set the offset for a restart marker.">globus_ftp_client_restart_marker_set_ascii_offset()</a> to set both the offset used in the local representation of an ACSII file, and the network representation of the ASCII file. For UNIX systems, the former includes counts newlines as one character towards the file offset, and the latter counts them as 2 characters (CRLF).</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>A restart marker </td></tr>
<tr><td class="paramname">offset</td><td>The local stream offset. </td></tr>
<tr><td class="paramname">ascii_offset</td><td>The network ascii representation of the offset.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html#ga72a27b2f70d6c9346b8f98fcfabe3c94" title="Insert a range into a restart markerThis function updates a restart marker with a new byte range...">globus_ftp_client_restart_marker_insert_range()</a>, <a class="el" href="group__globus__ftp__client__restart__marker.html#ga7e918848837403b0025f8b4fdfa6284b" title="Set the offset for a restart marker.">globus_ftp_client_restart_marker_set_offset()</a>, <a class="el" href="group__globus__ftp__client__operationattr.html#ga0c910be730c118fb94c59fa5413ac473" title="Set/Get the file transfer mode attribute for an ftp client attribute set.">globus_ftp_client_operationattr_set_mode()</a>, <a class="el" href="group__globus__ftp__client__operationattr.html#ga56cc6a5739bf34f4e8009bf593c29ec8" title="Set/Get the file representation type attribute for an ftp client attribute set.">globus_ftp_client_operationattr_set_type()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga7e918848837403b0025f8b4fdfa6284b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_set_offset </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>marker</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the offset for a restart marker. </p>
<p>This function modifies a restart marker to contain a stream offset, suitable for using to restart a steam mode transfer.</p>
<p>The marker must first be initialized by calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga8dd8fe0ed3573611fdb06ed56c3c0061" title="Initialize a restart marker.">globus_ftp_client_restart_marker_init()</a> or <a class="el" href="group__globus__ftp__client__restart__marker.html#gaeb89ef456f67c2b9db1572bd9ff9b060" title="Create a copy of a restart marker.">globus_ftp_client_restart_marker_copy()</a>.</p>
<p>A marker can only hold a range list or a stream offset. Calling this function after calling <a class="el" href="group__globus__ftp__client__restart__marker.html#ga72a27b2f70d6c9346b8f98fcfabe3c94" title="Insert a range into a restart markerThis function updates a restart marker with a new byte range...">globus_ftp_client_restart_marker_insert_range()</a> will delete the ranges associated with the marker, and replace it with a marker suitable only for use restarting a stream mode transfer.</p>
<p>When restarting an ASCII type transfer, the offset must take into account the additional carriage return characters added to the data stream.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>A restart marker </td></tr>
<tr><td class="paramname">offset</td><td>The stream offset</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html#ga72a27b2f70d6c9346b8f98fcfabe3c94" title="Insert a range into a restart markerThis function updates a restart marker with a new byte range...">globus_ftp_client_restart_marker_insert_range()</a>, <a class="el" href="group__globus__ftp__client__operationattr.html#ga0c910be730c118fb94c59fa5413ac473" title="Set/Get the file transfer mode attribute for an ftp client attribute set.">globus_ftp_client_operationattr_set_mode()</a>, <a class="el" href="group__globus__ftp__client__operationattr.html#ga56cc6a5739bf34f4e8009bf593c29ec8" title="Set/Get the file representation type attribute for an ftp client attribute set.">globus_ftp_client_operationattr_set_type()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gaffcfb3c4cddefde22124117faae51043"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_get_total </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>marker</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_off_t * </td>
<td class="paramname"><em>total_bytes</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get total bytes accounted for in restart markerThis funtion will return the sum of all bytes accounted for in a restart marker. </p>
<p>If this restart marker contains a stream offset then this value is the same as the offset (not the ascii offset) that it was set with. If it is a range list, it a sum of all the bytes in the ranges.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>A previously initialized or copied restart marker</td></tr>
<tr><td class="paramname">total_bytes</td><td>pointer to storage for total bytes in marker</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd><ul>
<li>Error on NULL marker or total bytes</li>
<li><possible return>=""> </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga74376b80855292e81bca5d4b85cb2664"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_to_string </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>marker</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>marker_string</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create a string representation of a restart marker. </p>
<p>This function sets the <em>marker_string</em> parameter to point to a freshly allocated string suitable for sending as an argument to the FTP REST command, or for a later call to <a class="el" href="group__globus__ftp__client__restart__marker.html#ga1815b87c414845789ff2c54efa71a77c" title="Initialize a restart marker from a string.">globus_ftp_client_restart_marker_from_string()</a>.</p>
<p>The string pointed to by marker_string must be freed by the caller.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>An initialized FTP client restart marker. </td></tr>
<tr><td class="paramname">marker_string</td><td>A pointer to a char * to be set to a freshly allocated marker string.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html" title="FTP Restart Markers.">Restart Markers</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga1815b87c414845789ff2c54efa71a77c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_ftp_client_restart_marker_from_string </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>marker</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>marker_string</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize a restart marker from a string. </p>
<p>This function initializes a new restart, <em>marker</em>, based on the <em>marker_string</em> parameter. The string may be either a single offset for a stream-mode restart marker, or a comma-separated list of start-end ranges.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">marker</td><td>The restart marker to be unitialized. </td></tr>
<tr><td class="paramname">marker_string</td><td>The string containing a textual representation of a restart marker. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__globus__ftp__client__restart__marker.html" title="FTP Restart Markers.">Restart Markers</a> </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>
