* retrieval of the client's ip with @ref ecore_con_client_ip_get and
* associating data with the client using ecore_con_client_data_set.
* @li ECORE_CON_EVENT_CLIENT_DEL: Whenever a client connection to an
- * @c Ecore_Con_Server, an event of this type is emitted. The contents of
+ * @c Ecore_Con_Server is destroyed, an event of this type is emitted. The contents of
* the data with this event are variable, but if the client object in the data
* is non-null, it must be freed with @ref ecore_con_client_del.
* @li ECORE_CON_EVENT_CLIENT_DATA: Whenever a server object receives
*/
/**
- * Initialises the Ecore_Con library.
+ * @brief Initialise the Ecore_Con library.
* @return Number of times the library has been initialised without being
* shut down.
*
EAPI int ecore_con_init(void);
/**
- * Shuts down the Ecore_Con library.
+ * @brief Shut down the Ecore_Con library.
* @return Number of times the library has been initialised without being
* shut down.
* @note This function already calls ecore_shutdown() internally, so you don't
*/
/**
- * Returns if SSL support is available
+ * @brief Return if SSL support is available
* @return 1 if SSL is available and provided by gnutls,
* 2 if SSL is available and provided by openssl,
* 0 if it is not available.
*/
/**
- * Add a SOCKS v4 proxy to the proxy list
+ * @brief Add a SOCKS v4 proxy to the proxy list
*
* Use this to create (or return, if previously added) a SOCKS proxy
* object which can be used by any ecore_con servers.
EAPI Ecore_Con_Socks *ecore_con_socks4_remote_add(const char *ip, int port, const char *username);
/**
- * Find a SOCKS v4 proxy in the proxy list
+ * @brief Find a SOCKS v4 proxy in the proxy list
*
* Use this to determine if a SOCKS proxy was previously added by checking
* the proxy list against the parameters given.
EAPI Eina_Bool ecore_con_socks4_remote_exists(const char *ip, int port, const char *username);
/**
- * Remove a SOCKS v4 proxy from the proxy list and delete it
+ * @brief Remove a SOCKS v4 proxy from the proxy list and delete it
*
* Use this to remove a SOCKS proxy from the proxy list by checking
* the list against the parameters given. The proxy will then be deleted.
EAPI void ecore_con_socks4_remote_del(const char *ip, int port, const char *username);
/**
- * Add a SOCKS v5 proxy to the proxy list
+ * @brief Add a SOCKS v5 proxy to the proxy list
*
* Use this to create (or return, if previously added) a SOCKS proxy
* object which can be used by any ecore_con servers.
EAPI Ecore_Con_Socks *ecore_con_socks5_remote_add(const char *ip, int port, const char *username, const char *password);
/**
- * Find a SOCKS v5 proxy in the proxy list
+ * @brief Find a SOCKS v5 proxy in the proxy list
*
* Use this to determine if a SOCKS proxy was previously added by checking
* the proxy list against the parameters given.
EAPI Eina_Bool ecore_con_socks5_remote_exists(const char *ip, int port, const char *username, const char *password);
/**
- * Remove a SOCKS v5 proxy from the proxy list and delete it
+ * @brief Remove a SOCKS v5 proxy from the proxy list and delete it
*
* Use this to remove a SOCKS proxy from the proxy list by checking
* the list against the parameters given. The proxy will then be deleted.
EAPI void ecore_con_socks5_remote_del(const char *ip, int port, const char *username, const char *password);
/**
- * Set DNS lookup mode on an existing SOCKS proxy
+ * @brief Set DNS lookup mode on an existing SOCKS proxy
*
* According to RFC, SOCKS v4 does not require that a proxy perform
* its own DNS lookups for addresses. SOCKS v4a specifies the protocol
EAPI void ecore_con_socks_lookup_set(Ecore_Con_Socks *ecs, Eina_Bool enable);
/**
- * Get DNS lookup mode on an existing SOCKS proxy
+ * @brief Get DNS lookup mode on an existing SOCKS proxy
*
* According to RFC, SOCKS v4 does not require that a proxy perform
* its own DNS lookups for addresses. SOCKS v4a specifies the protocol
EAPI Eina_Bool ecore_con_socks_lookup_get(Ecore_Con_Socks *ecs);
/**
- * Enable bind mode on a SOCKS proxy
+ * @brief Enable bind mode on a SOCKS proxy
*
* Use this function to enable binding a remote port for use with a remote server.
* For more information, see http://ufasoft.com/doc/socks4_protocol.htm
EAPI void ecore_con_socks_bind_set(Ecore_Con_Socks *ecs, Eina_Bool is_bind);
/**
- * Return bind mode of a SOCKS proxy
+ * @brief Return bind mode of a SOCKS proxy
*
* Use this function to return bind mode of a proxy (binding a remote port for use with a remote server).
* For more information, see http://ufasoft.com/doc/socks4_protocol.htm
EAPI Eina_Bool ecore_con_socks_bind_get(Ecore_Con_Socks *ecs);
/**
- * Return SOCKS version of a SOCKS proxy
+ * @brief Return SOCKS version of a SOCKS proxy
*
* Use this function to return the SOCKS protocol version of a proxy
* @param ecs The proxy object
EAPI unsigned int ecore_con_socks_version_get(Ecore_Con_Socks *ecs);
/**
- * Remove a SOCKS v4 proxy from the proxy list and delete it
+ * @brief Remove a SOCKS v4 proxy from the proxy list and delete it
*
* Use this to remove a SOCKS proxy from the proxy list by directly deleting the object given.
* @param ecs The proxy object to delete
EAPI void ecore_con_socks_remote_del(Ecore_Con_Socks *ecs);
/**
- * Set a proxy object to be used with the next server created with ecore_con_server_connect()
+ * @brief Set a proxy object to be used with the next server created with ecore_con_server_connect()
*
* This function sets a proxy for the next ecore_con connection. After the next server is created,
* the proxy will NEVER be applied again unless explicitly enabled.
EAPI void ecore_con_socks_apply_once(Ecore_Con_Socks *ecs);
/**
- * Set a proxy object to be used with all servers created with ecore_con_server_connect()
+ * @brief Set a proxy object to be used with all servers created with ecore_con_server_connect()
*
* This function sets a proxy for all ecore_con connections. It will always be used.
* @param ecs The proxy object
*/
/**
- * Creates a server to listen for connections.
+ * @brief Create a server to listen for connections.
*
* @param type The connection type.
* @param name Name to associate with the socket. It is used when
const void *data);
/**
- * Creates a connection to the specified server and returns an associated object.
+ * @brief Create a connection to the specified server and return an associated object.
*
* @param type The connection type.
* @param name Name used when determining what socket to connect to.
const char *name, int port,
const void *data);
/**
- * Closes the connection and frees the given server.
+ * @brief Close the connection and free the given server.
*
* @param svr The given server.
* @return Data associated with the server when it was created.
EAPI void * ecore_con_server_del(Ecore_Con_Server *svr);
/**
- * Retrieves the data associated with the given server.
+ * @brief Retrieve the data associated with the given server.
*
* @param svr The given server.
* @return The associated data.
*/
EAPI void * ecore_con_server_data_get(Ecore_Con_Server *svr);
/**
- * Sets the data associated with the given server.
+ * @brief Set the data associated with the given server.
*
* @param svr The given server.
* @param data The data to associate with @p svr
EAPI void * ecore_con_server_data_set(Ecore_Con_Server *svr,
void *data);
/**
- * Retrieves whether the given server is currently connected.
+ * @brief Retrieve whether the given server is currently connected.
*
* @param svr The given server.
* @return @c EINA_TRUE if the server is connected, @c EINA_FALSE otherwise.
EAPI Eina_Bool ecore_con_server_connected_get(const Ecore_Con_Server *svr);
/**
- * Retrieves the server port in use.
+ * @brief Retrieve the server port in use.
*
* @param svr The given server.
* @return The server port in use.
*/
EAPI double ecore_con_server_uptime_get(const Ecore_Con_Server *svr);
/**
- * Sends the given data to the given server.
+ * @brief Send the given data to the given server.
*
* @param svr The given server.
* @param data The given data.
const void *data,
int size);
/**
- * Sets a limit on the number of clients that can be handled concurrently
+ * @brief Set a limit on the number of clients that can be handled concurrently
* by the given server, and a policy on what to do if excess clients try to
* connect.
*
int client_limit,
char reject_excess_clients);
/**
- * Gets the IP address of a server that has been connected to.
+ * @brief Get the IP address of a server that has been connected to.
*
* @param svr The given server.
* @return A pointer to an internal string that contains the IP address of
*/
EAPI const char * ecore_con_server_ip_get(const Ecore_Con_Server *svr);
/**
- * Flushes all pending data to the given server.
+ * @brief Flush all pending data to the given server.
*
* @param svr The given server.
*
*/
EAPI void ecore_con_server_flush(Ecore_Con_Server *svr);
/**
- * Set the default time after which an inactive client will be disconnected
+ * @brief Set the default time after which an inactive client will be disconnected
*
* @param svr The server object
* @param timeout The timeout, in seconds, to disconnect after
*/
EAPI void ecore_con_server_timeout_set(Ecore_Con_Server *svr, double timeout);
/**
- * Get the default time after which an inactive client will be disconnected
+ * @brief Get the default time after which an inactive client will be disconnected
*
* @param svr The server object
* @return The timeout, in seconds, to disconnect after
EAPI double ecore_con_server_timeout_get(const Ecore_Con_Server *svr);
/**
- * Get the fd that the server is connected to
+ * @brief Get the fd that the server is connected to
*
* @param svr The server object
* @return The fd, or -1 on failure
EAPI int ecore_con_server_fd_get(const Ecore_Con_Server *svr);
/**
- * Get the fd that the client is connected to
+ * @brief Get the fd that the client is connected to
*
* @param cl The client object
* @return The fd, or -1 on failure
*/
/**
- * Sends the given data to the given client.
+ * @brief Send the given data to the given client.
*
* @param cl The given client.
* @param data The given data.
const void *data,
int size);
/**
- * Closes the connection and frees memory allocated to the given client.
+ * @brief Close the connection and free memory allocated to the given client.
*
* @param cl The given client.
* @return Data associated with the client.
*/
EAPI void * ecore_con_client_del(Ecore_Con_Client *cl);
/**
- * Sets the data associated with the given client to @p data.
+ * @brief Set the data associated with the given client to @p data.
*
* @param cl The given client.
* @param data What to set the data to.
EAPI void ecore_con_client_data_set(Ecore_Con_Client *cl,
const void *data);
/**
- * Retrieves the data associated with the given client.
+ * @brief Retrieve the data associated with the given client.
*
* @param cl The given client.
* @return The data associated with @p cl.
EAPI void * ecore_con_client_data_get(Ecore_Con_Client *cl);
/**
- * Gets the IP address of a client that has connected.
+ * @brief Get the IP address of a client that has connected.
*
* @param cl The given client.
* @return A pointer to an internal string that contains the IP address of
*/
EAPI const char * ecore_con_client_ip_get(const Ecore_Con_Client *cl);
/**
- * Flushes all pending data to the given client.
+ * @brief Flush all pending data to the given client.
*
* @param cl The given client.
*
*/
EAPI double ecore_con_client_uptime_get(const Ecore_Con_Client *cl);
/**
- * Get the default time after which the client will be disconnected when
+ * @brief Get the default time after which the client will be disconnected when
* inactive
*
* @param cl The client object
*/
EAPI double ecore_con_client_timeout_get(const Ecore_Con_Client *cl);
/**
- * Set the time after which the client will be disconnected when inactive
+ * @brief Set the time after which the client will be disconnected when inactive
*
* @param cl The client object
* @param timeout The timeout, in seconds, to disconnect after
*/
EAPI void ecore_con_client_timeout_set(Ecore_Con_Client *cl, double timeout);
/**
- * Returns whether the client is still connected
+ * @brief Return whether the client is still connected
*
* @param cl The given client.
* @return @c EINA_TRUE if connected, @c EINA_FALSE otherwise.
} Ecore_Con_Url_Http_Version;
/**
- * Change the HTTP version used for the request
+ * @brief Change the HTTP version used for the request
* @param url_con Connection object through which the request will be sent.
* @param version The version to be used
* @return @c EINA_TRUE on success, @c EINA_FALSE on failure to change version.
EAPI Eina_Bool ecore_con_url_http_version_set(Ecore_Con_Url *url_con, Ecore_Con_Url_Http_Version version);
/**
- * Initialises the Ecore_Con_Url library.
+ * @brief Initialise the Ecore_Con_Url library.
* @return Number of times the library has been initialised without being
* shut down.
*
EAPI int ecore_con_url_init(void);
/**
- * Shuts down the Ecore_Con_Url library.
+ * @brief Shut down the Ecore_Con_Url library.
* @return Number of calls that still uses Ecore_Con_Url
*
* @note This function doesn't call ecore_con_shutdown(). You still need to call
EAPI int ecore_con_url_shutdown(void);
/**
- * Enable or disable HTTP 1.1 pipelining.
+ * @brief Enable or disable HTTP 1.1 pipelining.
* @param enable @c EINA_TRUE will turn it on, @c EINA_FALSE will disable it.
*
* Pipelining allows to send one request after another one, without having to
*/
EAPI void ecore_con_url_pipeline_set(Eina_Bool enable);
/**
- * Is HTTP 1.1 pipelining enable ?
+ * @brief Is HTTP 1.1 pipelining enable ?
* @return @c EINA_TRUE if it is enable.
*
* @see ecore_con_url_pipeline_set()
EAPI Eina_Bool ecore_con_url_pipeline_get(void);
/**
- * Creates and initializes a new Ecore_Con_Url connection object.
+ * @brief Create and initialize a new Ecore_Con_Url connection object.
*
* @param url URL that will receive requests. Can be changed using
* ecore_con_url_url_set.
*
* @return @c NULL on error, a new Ecore_Con_Url on success.
*
- * Creates and initializes a new Ecore_Con_Url connection object that can be
+ * Create and initialize a new Ecore_Con_Url connection object that can be
* used for sending requests.
*
* @see ecore_con_url_custom_new()
*/
EAPI Ecore_Con_Url * ecore_con_url_new(const char *url);
/**
- * Creates a custom connection object.
+ * @brief Create a custom connection object.
*
* @param url URL that will receive requests
* @param custom_request Custom request (e.g. GET, POST, HEAD, PUT, etc)
*
* @return @c NULL on error, a new Ecore_Con_Url on success.
*
- * Creates and initializes a new Ecore_Con_Url for a custom request (e.g. HEAD,
+ * Create and initialize 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 ecore_con_url_new().
*
EAPI Ecore_Con_Url * ecore_con_url_custom_new(const char *url,
const char *custom_request);
/**
- * Destroys a Ecore_Con_Url connection object.
+ * @brief Destroy a Ecore_Con_Url connection object.
*
* @param url_con Connection object to free.
*
EAPI void ecore_con_url_free(Ecore_Con_Url *url_con);
/**
- * Associates data with a connection object.
+ * @brief Associate data with a connection object.
*
* @param url_con Connection object to associate data.
* @param data Data to be set.
*
- * Associates data with a connection object, which can be retrieved later with
+ * Associate data with a connection object, which can be retrieved later with
* ecore_con_url_data_get()).
*
* @see ecore_con_url_data_get()
EAPI void ecore_con_url_data_set(Ecore_Con_Url *url_con,
void *data);
/**
- * Retrieves data associated with a Ecore_Con_Url connection object.
+ * @brief Retrieve data associated with a Ecore_Con_Url connection object.
*
* @param url_con Connection object to retrieve data from.
*
* @return Data associated with the given object.
*
- * Retrieves data associated with a Ecore_Con_Url connection object (previously
+ * Retrieve data associated with a Ecore_Con_Url connection object (previously
* set with ecore_con_url_data_set()).
*
* @see ecore_con_url_data_set()
*/
EAPI void * ecore_con_url_data_get(Ecore_Con_Url *url_con);
/**
- * Adds an additional header to the request connection object.
+ * @brief Add an additional header to the request connection object.
*
* @param url_con Connection object
* @param key Header key
* @param value Header value
*
- * Adds an additional header (User-Agent, Content-Type, etc.) to the request
+ * Add an additional header (User-Agent, Content-Type, etc.) to the request
* connection object. This addition will be valid for only one
* ecore_con_url_get() or ecore_con_url_post() call.
*
const char *key,
const char *value);
/**
- * Cleans additional headers.
+ * @brief Clean additional headers.
*
* @param url_con Connection object to clean additional headers.
*
- * Cleans additional headers associated with a connection object (previously
+ * Clean additional headers associated with a connection object (previously
* added with ecore_con_url_additional_header_add()).
*
* @see ecore_con_url_additional_header_add()
*/
EAPI void ecore_con_url_additional_headers_clear(Ecore_Con_Url *url_con);
/**
- * Retrieves headers from last request sent.
+ * @brief Retrieve headers from last request sent.
*
* @param url_con Connection object to retrieve response headers from.
*
- * Retrieves a list containing the response headers. This function should be
+ * Retrieve 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).
*
*/
EAPI const Eina_List * ecore_con_url_response_headers_get(Ecore_Con_Url *url_con);
/**
- * Setup a file for receiving response data.
+ * @brief Set up a file for receiving response data.
*
* @param url_con Connection object to set file
* @param fd File descriptor associated with the file. A negative value will
* unset any previously set fd.
*
- * Sets up a file to have response data written into. Note that
+ * Set up 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.
*
*/
EAPI void ecore_con_url_fd_set(Ecore_Con_Url *url_con, int fd);
/**
- * Retrieves the number of bytes received.
+ * @brief Retrieve the number of bytes received.
*
- * Retrieves the number of bytes received on the last request of the given
+ * Retrieve the number of bytes received on the last request of the given
* connection object.
*
* @param url_con Connection object which the request was sent on.
*/
EAPI int ecore_con_url_received_bytes_get(Ecore_Con_Url *url_con);
/**
- * Sets url_con to use http auth, with given username and password, "safely" or not.
+ * @brief Set url_con to use http auth, with given username and password, "safely" or not.
*
* @param url_con Connection object to perform a request on, previously created
* with ecore_con_url_new() or ecore_con_url_custom_new().
*
* @return @c EINA_TRUE on success, @c EINA_FALSE on error.
*
- * @attention Requires libcurl >= 7.19.1 to work, otherwise will always return
+ * @attention Require libcurl >= 7.19.1 to work, otherwise will always return
* @c 0.
*/
EAPI Eina_Bool ecore_con_url_httpauth_set(Ecore_Con_Url *url_con,
const char *password,
Eina_Bool safe);
/**
- * Sends a get request.
+ * @brief Send a get request.
*
* @param url_con Connection object to perform a request on, previously created
*
*/
EAPI Eina_Bool ecore_con_url_get(Ecore_Con_Url *url_con);
/**
- * Sends a HEAD request.
+ * @brief Send a HEAD request.
*
* @param url_con Connection object to perform a request on, previously created
*
*/
EAPI Eina_Bool ecore_con_url_head(Ecore_Con_Url *url_con);
/**
- * Sends a post request.
+ * @brief Send a post request.
*
* @param url_con Connection object to perform a request on, previously created
* with ecore_con_url_new() or ecore_con_url_custom_new().
const void *data, long length,
const char *content_type);
/**
- * Sets whether HTTP requests should be conditional, dependent on
+ * @brief Set whether HTTP requests should be conditional, dependent on
* modification time.
*
* @param url_con Ecore_Con_Url to act upon.
double timestamp);
/**
- * @brief Uploads a file to an ftp site.
+ * @brief Upload a file to an ftp site.
*
* @param url_con The Ecore_Con_Url object to send with
* @param filename The path to the file to send
const char *pass,
const char *upload_dir);
/**
- * Toggle libcurl's verbose output.
+ * @brief Toggle libcurl's verbose output.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
* @param verbose Whether or not to enable libcurl's verbose output.
EAPI void ecore_con_url_verbose_set(Ecore_Con_Url *url_con,
Eina_Bool verbose);
/**
- * Enable or disable EPSV extension
+ * @brief Enable or disable EPSV extension
* @param url_con The Ecore_Con_Url instance which will be acted upon.
* @param use_epsv Boolean to enable/disable the EPSV extension.
*/
Eina_Bool use_epsv);
/**
- * Enables the cookie engine for subsequent HTTP requests.
+ * @brief Enable the cookie engine for subsequent HTTP requests.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
*
*/
EAPI void ecore_con_url_cookies_init(Ecore_Con_Url *url_con);
/**
- * Controls whether session cookies from previous sessions shall be loaded.
+ * @brief Control whether session cookies from previous sessions shall be loaded.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
* @param ignore If @c EINA_TRUE, ignore session cookies when loading cookies
EAPI void ecore_con_url_cookies_ignore_old_session_set(Ecore_Con_Url *url_con,
Eina_Bool ignore);
/**
- * Clears currently loaded cookies.
+ * @brief Clear currently loaded cookies.
* @param url_con Ecore_Con_Url instance which will be acted upon.
*
* The cleared cookies are removed and will not be sent in subsequent HTTP
*/
EAPI void ecore_con_url_cookies_clear(Ecore_Con_Url *url_con);
/**
- * Clears currently loaded session cookies.
+ * @brief Clear currently loaded session cookies.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
*
*/
EAPI void ecore_con_url_cookies_session_clear(Ecore_Con_Url *url_con);
/**
- * Adds a file to the list of files from which to load cookies.
+ * @brief Add a file to the list of files from which to load cookies.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
* @param file_name Name of the file that will be added to the list.
EAPI void ecore_con_url_cookies_file_add(Ecore_Con_Url *url_con,
const char * const file_name);
/**
- * Sets the name of the file to which all current cookies will be written when
+ * @brief Set the name of the file to which all current cookies will be written when
* either cookies are flushed or Ecore_Con is shut down.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
EAPI Eina_Bool ecore_con_url_cookies_jar_file_set(Ecore_Con_Url *url_con,
const char * const cookiejar_file);
/**
- * Writes all current cookies to the cookie jar immediately.
+ * @brief Write all current cookies to the cookie jar immediately.
*
* @param url_con Ecore_Con_Url instance which will be acted upon.
*
const char *ca_path);
/**
- * Set HTTP proxy to use.
+ * @brief Set HTTP proxy to use.
*
* The parameter should be a char * to a zero terminated string holding
* the host name or dotted IP address. To specify port number in this string,
EAPI Eina_Bool ecore_con_url_proxy_set(Ecore_Con_Url *url_con, const char *proxy);
/**
- * Set zero terminated username to use for proxy.
+ * @brief Set zero terminated username to use for proxy.
*
- * if socks protocol is used for proxy, protocol should be socks5 and above.
+ * If socks protocol is used for proxy, protocol should be socks5 and above.
*
* @param url_con Connection object that will use the proxy.
* @param username Username string.
EAPI Eina_Bool ecore_con_url_proxy_username_set(Ecore_Con_Url *url_con, const char *username);
/**
- * Set zero terminated password to use for proxy.
+ * @brief Set zero terminated password to use for proxy.
*
- * if socks protocol is used for proxy, protocol should be socks5 and above.
+ * If socks protocol is used for proxy, protocol should be socks5 and above.
*
* @param url_con Connection object that will use the proxy.
* @param password Password string.
EAPI Eina_Bool ecore_con_url_proxy_password_set(Ecore_Con_Url *url_con, const char *password);
/**
- * Set timeout in seconds.
+ * @brief Set timeout in seconds.
*
- * the maximum time in seconds that you allow the ecore con url transfer
+ * The maximum time in seconds that you allow the ecore con url transfer
* operation to take. Normally, name lookups can take a considerable time
* and limiting operations to less than a few minutes risk aborting perfectly
* normal operations.
EAPI void ecore_con_url_timeout_set(Ecore_Con_Url *url_con, double timeout);
/**
- * Get the returned HTTP STATUS code
+ * @brief Get the returned HTTP STATUS code
*
* This is used to, at any time, try to return the status code for a transmission.
* @param url_con Connection object