<html>
<head>
<title>Ecore: Ecore URL Connection Functions</title>
<meta http-equiv="content-type" content="text/html;charset=UTF-8">
<meta name="author" content="Andres Blanc" >
<link rel="icon" href="img/favicon.png" type="image/x-icon">
<link rel="shortcut icon" href="img/favicon.png" type="image/x-icon">
<link rel="icon" href="img/favicon.png" type="image/ico">
<link rel="shortcut icon" href="img/favicon.png" type="image/ico">
<link rel="stylesheet" type="text/css" href="e.css">
<link rel="stylesheet" type="text/css" href="edoxy.css">
</head>
<body>
<div id="container">
<div id="header">
<div class="layout">
<h1><span>Enlightenment</span></h1>
<h2><span>Beauty at your fingertips</span></h2>
<table cellspacing="0" cellpadding="0" width="100%"><tr>
<td id="header_logo">
<a href="http://www.enlightenment.org"></a>
</td>
<td id="header_menu">
<table cellspacing="0" cellpadding="0" align="right"><tr>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=home">Home</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=news">News</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=about">About</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=download">Download</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=support">Support</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=contribute">Contribute</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=contact">Contact</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://trac.enlightenment.org/e">Tracker</a></td>
<td class="nav_passive"><a class="nav_passive" href="http://www.enlightenment.org/p.php?p=docs">Docs</a></td>
</tr></table>
</td>
<td id="header_last"></td>
</tr></table>
<div class="doxytitle">
Ecore Documentation <small>at 2 Jul 2010</small>
</div>
<div class="menu-container">
<div class="submenu">
<ul class="current">
<li><a href="files.html">Files</a></li>
<li><a href="annotated.html">Data Structures</a></li>
<li><a href="globals.html">Globals</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="pages.html">Related Pages</a></li>
<li class="current"><a href="index.html">Main Page</a></li>
</ul>
</div>
</div>
<div class="clear"></div>
</div>
</div>
<div id="content">
<div class="layout">
<!-- Generated by Doxygen 1.6.2-20100208 -->
<div class="contents">
<h1>Ecore URL Connection Functions</h1>
<p>Utility functions that set up, use and shut down the Ecore URL Connection library.
<a href="#_details">More...</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gac3fbeaf9cde529362e4567fc37e45c9f">ecore_con_url_init</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Initialises the Ecore_Con_Url library. <a href="#gac3fbeaf9cde529362e4567fc37e45c9f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga0da252aa2c919722894dd41cc6549435">ecore_con_url_shutdown</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Shuts down the Ecore_Con_Url library. <a href="#ga0da252aa2c919722894dd41cc6549435"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI Ecore_Con_Url * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061">ecore_con_url_new</a> (const char *url)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates and initializes a new Ecore_Con_Url connection object. <a href="#gab3f271074b3ed5e73fca4bed7e4cb061"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI Ecore_Con_Url * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gafb604272fd5fe81c0dc9b7e087e49401">ecore_con_url_custom_new</a> (const char *url, const char *custom_request)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a custom connection object. <a href="#gafb604272fd5fe81c0dc9b7e087e49401"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga78257e39caa137f5485e38c3bad8851d">ecore_con_url_destroy</a> (Ecore_Con_Url *url_con)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroys a Ecore_Con_Url connection object. <a href="#ga78257e39caa137f5485e38c3bad8851d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga845bc657ab2c845969dd907b0f948848">ecore_con_url_url_set</a> (Ecore_Con_Url *url_con, const char *url)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the URL to send the request to. <a href="#ga845bc657ab2c845969dd907b0f948848"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga194f122b9e4e9f2aa9b5c2f07e9d7f3e">ecore_con_url_data_set</a> (Ecore_Con_Url *url_con, void *data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Associates data with a connection object. <a href="#ga194f122b9e4e9f2aa9b5c2f07e9d7f3e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga1f9939c84aa5128d5197f1939d8cffeb">ecore_con_url_additional_header_add</a> (Ecore_Con_Url *url_con, const char *key, const char *value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an additional header to the request connection object. <a href="#ga1f9939c84aa5128d5197f1939d8cffeb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga453ab737da8b149872b8f3f77f82086c">ecore_con_url_data_get</a> (Ecore_Con_Url *url_con)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves data associated with a Ecore_Con_Url connection object. <a href="#ga453ab737da8b149872b8f3f77f82086c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga3b49c7802c18096eec5d9aa3ec9898e1">ecore_con_url_time</a> (Ecore_Con_Url *url_con, Ecore_Con_Url_Time condition, time_t tm)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">FIXME: To be documented. <a href="#ga3b49c7802c18096eec5d9aa3ec9898e1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga7b58b82b9b49060642ad3fe64348dc8d">ecore_con_url_fd_set</a> (Ecore_Con_Url *url_con, int fd)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Setup a file for receiving request data. <a href="#ga7b58b82b9b49060642ad3fe64348dc8d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga9587eb74811d11b69b281a715b6fd1a1">ecore_con_url_received_bytes_get</a> (Ecore_Con_Url *url_con)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the number of bytes received. <a href="#ga9587eb74811d11b69b281a715b6fd1a1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI const Eina_List * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gad71976dc9c63322ea787757ca2e11314">ecore_con_url_response_headers_get</a> (Ecore_Con_Url *url_con)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves headers from last request sent. <a href="#gad71976dc9c63322ea787757ca2e11314"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gac7d762d196b07a7f693c78884b73b719">ecore_con_url_httpauth_set</a> (Ecore_Con_Url *url_con, const char *username, const char *password, Eina_Bool safe)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets url_con to use http auth, with given username and password, "safely" or not. <a href="#gac7d762d196b07a7f693c78884b73b719"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga51acfcd2a7ff16028fc7953bfbe59f89">ecore_con_url_send</a> (Ecore_Con_Url *url_con, const void *data, size_t length, const char *content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sends a request. <a href="#ga51acfcd2a7ff16028fc7953bfbe59f89"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga35dd83162bee26301e0a43059e117870">ecore_con_url_ftp_upload</a> (Ecore_Con_Url *url_con, const char *filename, const char *user, const char *pass, const char *upload_dir)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Makes a FTP upload. <a href="#ga35dd83162bee26301e0a43059e117870"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gaec221b2370e1a161f7779b38a3b95575">ecore_con_url_http_post_send</a> (Ecore_Con_Url *url_con, void *httppost)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send a Curl httppost. <a href="#gaec221b2370e1a161f7779b38a3b95575"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#ga627467c0fe2b072282c2ab96f3b4545f">ecore_con_url_verbose_set</a> (Ecore_Con_Url *url_con, int verbose)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enable or disable libcurl verbose output, useful for debug. <a href="#ga627467c0fe2b072282c2ab96f3b4545f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Ecore__Con__Url__Group.html#gacd509b1b75c40a25aa17a1d656955bde">ecore_con_url_ftp_use_epsv_set</a> (Ecore_Con_Url *url_con, int use_epsv)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enable or disable EPSV extension. <a href="#gacd509b1b75c40a25aa17a1d656955bde"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Utility functions that set up, use and shut down the Ecore URL Connection library. </p>
<p>FIXME: write detailed description </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga1f9939c84aa5128d5197f1939d8cffeb"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_additional_header_add" ref="ga1f9939c84aa5128d5197f1939d8cffeb" args="(Ecore_Con_Url *url_con, const char *key, const char *value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_additional_header_add </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>value</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds an additional header to the request connection object. </p>
<p>Adds an additional header to the request connection object. This addition will be valid for only one <a class="el" href="group__Ecore__Con__Url__Group.html#ga51acfcd2a7ff16028fc7953bfbe59f89" title="Sends a request.">ecore_con_url_send()</a> call.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>Header key </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>Header value</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#ga51acfcd2a7ff16028fc7953bfbe59f89" title="Sends a request.">ecore_con_url_send()</a> </dd>
<dd>
ecore_con_url_additional_headers_clear() </dd></dl>
</div>
</div>
<a class="anchor" id="gafb604272fd5fe81c0dc9b7e087e49401"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_custom_new" ref="gafb604272fd5fe81c0dc9b7e087e49401" args="(const char *url, const char *custom_request)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI Ecore_Con_Url* ecore_con_url_custom_new </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>custom_request</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a custom connection object. </p>
<p>Creates and initializes a new Ecore_Con_Url for a custom request (e.g. HEAD, SUBSCRIBE and other obscure HTTP requests). This object should be used like one created with <a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061" title="Creates and initializes a new Ecore_Con_Url connection object.">ecore_con_url_new()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>URL that will receive requests </td></tr>
<tr><td valign="top"></td><td valign="top"><em>custom_request</em> </td><td>Custom request (e.g. GET, POST, HEAD, PUT, etc)</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NULL on error, a new Ecore_Con_Url on success.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061" title="Creates and initializes a new Ecore_Con_Url connection object.">ecore_con_url_new()</a> </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#ga845bc657ab2c845969dd907b0f948848" title="Sets the URL to send the request to.">ecore_con_url_url_set()</a> </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00238">ecore_con_url_new()</a>.</p>
</div>
</div>
<a class="anchor" id="ga453ab737da8b149872b8f3f77f82086c"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_data_get" ref="ga453ab737da8b149872b8f3f77f82086c" args="(Ecore_Con_Url *url_con)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void* ecore_con_url_data_get </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves data associated with a Ecore_Con_Url connection object. </p>
<p>Retrieves data associated with a Ecore_Con_Url connection object (previously set with <a class="el" href="group__Ecore__Con__Url__Group.html#ga194f122b9e4e9f2aa9b5c2f07e9d7f3e" title="Associates data with a connection object.">ecore_con_url_data_set()</a>).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Connection</em> </td><td>object to retrieve data from.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Data associated with the given object.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#ga194f122b9e4e9f2aa9b5c2f07e9d7f3e" title="Associates data with a connection object.">ecore_con_url_data_set()</a> </dd></dl>
<p>Referenced by <a class="el" href="ecore__file__download_8c_source.html#l00304">ecore_file_download_abort()</a>.</p>
</div>
</div>
<a class="anchor" id="ga194f122b9e4e9f2aa9b5c2f07e9d7f3e"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_data_set" ref="ga194f122b9e4e9f2aa9b5c2f07e9d7f3e" args="(Ecore_Con_Url *url_con, void *data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_data_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Associates data with a connection object. </p>
<p>Associates data with a connection object, which can be retrieved later with <a class="el" href="group__Ecore__Con__Url__Group.html#ga453ab737da8b149872b8f3f77f82086c" title="Retrieves data associated with a Ecore_Con_Url connection object.">ecore_con_url_data_get()</a>).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object to associate data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>Data to be set.</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#ga453ab737da8b149872b8f3f77f82086c" title="Retrieves data associated with a Ecore_Con_Url connection object.">ecore_con_url_data_get()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga78257e39caa137f5485e38c3bad8851d"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_destroy" ref="ga78257e39caa137f5485e38c3bad8851d" args="(Ecore_Con_Url *url_con)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_destroy </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destroys a Ecore_Con_Url connection object. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061" title="Creates and initializes a new Ecore_Con_Url connection object.">ecore_con_url_new()</a> </dd></dl>
<p>References <a class="el" href="ecore__main_8c_source.html#l00319">ecore_main_fd_handler_del()</a>.</p>
<p>Referenced by <a class="el" href="ecore__con__url_8c_source.html#l00136">ecore_con_url_init()</a>, <a class="el" href="ecore__con__url_8c_source.html#l00190">ecore_con_url_shutdown()</a>, and <a class="el" href="ecore__file__download_8c_source.html#l00304">ecore_file_download_abort()</a>.</p>
</div>
</div>
<a class="anchor" id="ga7b58b82b9b49060642ad3fe64348dc8d"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_fd_set" ref="ga7b58b82b9b49060642ad3fe64348dc8d" args="(Ecore_Con_Url *url_con, int fd)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_fd_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>fd</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Setup a file for receiving request data. </p>
<p>Setups a file to have response data written into. Note that ECORE_CON_EVENT_URL_DATA events will not be emitted if a file has been set to receive the response data.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object to set file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fd</em> </td><td>File descriptor associated with the file </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga35dd83162bee26301e0a43059e117870"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_ftp_upload" ref="ga35dd83162bee26301e0a43059e117870" args="(Ecore_Con_Url *url_con, const char *filename, const char *user, const char *pass, const char *upload_dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_ftp_upload </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>user</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>pass</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>upload_dir</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Makes a FTP upload. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>FIXME: To be more documented. </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00406">ecore_con_url_url_set()</a>.</p>
</div>
</div>
<a class="anchor" id="gacd509b1b75c40a25aa17a1d656955bde"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_ftp_use_epsv_set" ref="gacd509b1b75c40a25aa17a1d656955bde" args="(Ecore_Con_Url *url_con, int use_epsv)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_ftp_use_epsv_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>use_epsv</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enable or disable EPSV extension. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>FIXME: To be more documented. </dd></dl>
</div>
</div>
<a class="anchor" id="gaec221b2370e1a161f7779b38a3b95575"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_http_post_send" ref="gaec221b2370e1a161f7779b38a3b95575" args="(Ecore_Con_Url *url_con, void *httppost)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_http_post_send </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>httppost</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Send a Curl httppost. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>1 on success, 0 on error. </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00730">ecore_con_url_send()</a>.</p>
</div>
</div>
<a class="anchor" id="gac7d762d196b07a7f693c78884b73b719"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_httpauth_set" ref="gac7d762d196b07a7f693c78884b73b719" args="(Ecore_Con_Url *url_con, const char *username, const char *password, Eina_Bool safe)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_httpauth_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>username</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>password</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Eina_Bool </td>
<td class="paramname"> <em>safe</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets url_con to use http auth, with given username and password, "safely" or not. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object to perform a request on, previously created with <a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061" title="Creates and initializes a new Ecore_Con_Url connection object.">ecore_con_url_new()</a> or <a class="el" href="group__Ecore__Con__Url__Group.html#gafb604272fd5fe81c0dc9b7e087e49401" title="Creates a custom connection object.">ecore_con_url_custom_new()</a>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>username</em> </td><td>Username to use in authentication </td></tr>
<tr><td valign="top"></td><td valign="top"><em>password</em> </td><td>Password to use in authentication </td></tr>
<tr><td valign="top"></td><td valign="top"><em>safe</em> </td><td>Whether to use "safer" methods (eg, NOT http basic auth)</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>1 on success, 0 on error. </dd></dl>
</div>
</div>
<a class="anchor" id="gac3fbeaf9cde529362e4567fc37e45c9f"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_init" ref="gac3fbeaf9cde529362e4567fc37e45c9f" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_init </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialises the Ecore_Con_Url library. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of times the library has been initialised without being shut down. </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00341">ecore_con_url_destroy()</a>, <a class="el" href="ecore__events_8c_source.html#l00232">ecore_event_type_new()</a>, and <a class="el" href="ecore__timer_8c_source.html#l00116">ecore_timer_add()</a>.</p>
</div>
</div>
<a class="anchor" id="gab3f271074b3ed5e73fca4bed7e4cb061"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_new" ref="gab3f271074b3ed5e73fca4bed7e4cb061" args="(const char *url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI Ecore_Con_Url* ecore_con_url_new </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>url</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates and initializes a new Ecore_Con_Url connection object. </p>
<p>Creates and initializes a new Ecore_Con_Url connection object that can be uesd for sending requests.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>URL that will receive requests. Can be changed using ecore_con_url_url_set.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NULL on error, a new Ecore_Con_Url on success.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#gafb604272fd5fe81c0dc9b7e087e49401" title="Creates a custom connection object.">ecore_con_url_custom_new()</a> </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#ga845bc657ab2c845969dd907b0f948848" title="Sets the URL to send the request to.">ecore_con_url_url_set()</a> </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00406">ecore_con_url_url_set()</a>.</p>
<p>Referenced by <a class="el" href="ecore__con__url_8c_source.html#l00311">ecore_con_url_custom_new()</a>.</p>
</div>
</div>
<a class="anchor" id="ga9587eb74811d11b69b281a715b6fd1a1"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_received_bytes_get" ref="ga9587eb74811d11b69b281a715b6fd1a1" args="(Ecore_Con_Url *url_con)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_received_bytes_get </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves the number of bytes received. </p>
<p>Retrieves the number of bytes received on the last request of the given connection object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object which the request was sent on.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of bytes received on request.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#ga51acfcd2a7ff16028fc7953bfbe59f89" title="Sends a request.">ecore_con_url_send()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gad71976dc9c63322ea787757ca2e11314"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_response_headers_get" ref="gad71976dc9c63322ea787757ca2e11314" args="(Ecore_Con_Url *url_con)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI const Eina_List* ecore_con_url_response_headers_get </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves headers from last request sent. </p>
<p>Retrieves a list containing the response headers. This function should be used after an ECORE_CON_EVENT_URL_COMPLETE event (headers should normally be ready at that time).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object to retrieve response headers from.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>List of response headers. This list must not be modified by the user. </dd></dl>
</div>
</div>
<a class="anchor" id="ga51acfcd2a7ff16028fc7953bfbe59f89"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_send" ref="ga51acfcd2a7ff16028fc7953bfbe59f89" args="(Ecore_Con_Url *url_con, const void *data, size_t length, const char *content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_send </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"> <em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_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>content_type</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sends a request. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object to perform a request on, previously created with <a class="el" href="group__Ecore__Con__Url__Group.html#gab3f271074b3ed5e73fca4bed7e4cb061" title="Creates and initializes a new Ecore_Con_Url connection object.">ecore_con_url_new()</a> or <a class="el" href="group__Ecore__Con__Url__Group.html#gafb604272fd5fe81c0dc9b7e087e49401" title="Creates a custom connection object.">ecore_con_url_custom_new()</a>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>Payload (data sent on the request) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>Payload length </td></tr>
<tr><td valign="top"></td><td valign="top"><em>content_type</em> </td><td>Content type of the payload (e.g. text/xml)</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>1 on success, 0 on error.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Ecore__Con__Url__Group.html#gafb604272fd5fe81c0dc9b7e087e49401" title="Creates a custom connection object.">ecore_con_url_custom_new()</a> </dd>
<dd>
ecore_con_url_additional_headers_clear() </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#ga1f9939c84aa5128d5197f1939d8cffeb" title="Adds an additional header to the request connection object.">ecore_con_url_additional_header_add()</a> </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#ga194f122b9e4e9f2aa9b5c2f07e9d7f3e" title="Associates data with a connection object.">ecore_con_url_data_set()</a> </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#ga453ab737da8b149872b8f3f77f82086c" title="Retrieves data associated with a Ecore_Con_Url connection object.">ecore_con_url_data_get()</a> </dd>
<dd>
<a class="el" href="group__Ecore__Con__Url__Group.html#gad71976dc9c63322ea787757ca2e11314" title="Retrieves headers from last request sent.">ecore_con_url_response_headers_get()</a> </dd></dl>
<p>Referenced by <a class="el" href="ecore__con__url_8c_source.html#l00876">ecore_con_url_http_post_send()</a>.</p>
</div>
</div>
<a class="anchor" id="ga0da252aa2c919722894dd41cc6549435"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_shutdown" ref="ga0da252aa2c919722894dd41cc6549435" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_shutdown </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Shuts down the Ecore_Con_Url library. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of calls that still uses Ecore_Con_Url </dd></dl>
<p>References <a class="el" href="ecore__con__url_8c_source.html#l00341">ecore_con_url_destroy()</a>, <a class="el" href="ecore__idler_8c_source.html#l00068">ecore_idler_del()</a>, and <a class="el" href="ecore__timer_8c_source.html#l00171">ecore_timer_del()</a>.</p>
</div>
</div>
<a class="anchor" id="ga3b49c7802c18096eec5d9aa3ec9898e1"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_time" ref="ga3b49c7802c18096eec5d9aa3ec9898e1" args="(Ecore_Con_Url *url_con, Ecore_Con_Url_Time condition, time_t tm)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_time </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Ecore_Con_Url_Time </td>
<td class="paramname"> <em>condition</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">time_t </td>
<td class="paramname"> <em>tm</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>FIXME: To be documented. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>FIXME: To be documented. </dd></dl>
</div>
</div>
<a class="anchor" id="ga845bc657ab2c845969dd907b0f948848"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_url_set" ref="ga845bc657ab2c845969dd907b0f948848" args="(Ecore_Con_Url *url_con, const char *url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int ecore_con_url_url_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>url</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the URL to send the request to. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>url_con</em> </td><td>Connection object through which the request will be sent. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>url</em> </td><td>URL that will receive the request</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>1 on success, 0 on error. </dd></dl>
<p>Referenced by <a class="el" href="ecore__con__url_8c_source.html#l00816">ecore_con_url_ftp_upload()</a>, and <a class="el" href="ecore__con__url_8c_source.html#l00238">ecore_con_url_new()</a>.</p>
</div>
</div>
<a class="anchor" id="ga627467c0fe2b072282c2ab96f3b4545f"></a><!-- doxytag: member="ecore_con_url.c::ecore_con_url_verbose_set" ref="ga627467c0fe2b072282c2ab96f3b4545f" args="(Ecore_Con_Url *url_con, int verbose)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void ecore_con_url_verbose_set </td>
<td>(</td>
<td class="paramtype">Ecore_Con_Url * </td>
<td class="paramname"> <em>url_con</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>verbose</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enable or disable libcurl verbose output, useful for debug. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>FIXME: To be more documented. </dd></dl>
</div>
</div>
</div>
<div id="push"></div>
</div> <!-- #content -->
</div> <!-- .layout -->
</div> <!-- #container -->
<div id="footer">
<table><tr>
<td class="copyright">Copyright ©2010 Enlightenment</td>
<td class="generated">Docs generated Fri Jul 2 12:11:49 2010</td>
</tr></table>
</div>
</body>
</html>
