<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>libcddb: cddb_conn.h File Reference</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.4.6 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li id="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul></div>
<div class="nav">
<a class="el" href="dir_d95480e064f2cd25d4e283edd80a73aa.html">include</a> » <a class="el" href="dir_847afe0584ab2be2f35afc524ae78865.html">cddb</a></div>
<h1>cddb_conn.h File Reference</h1><code>#include <stdio.h></code><br>
<code>#include <netinet/in.h></code><br>
<code>#include "<a class="el" href="cddb__site_8h-source.html">cddb/cddb_site.h</a>"</code><br>
<p>
<a href="cddb__conn_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#be705ae4bff57876bddfb0bb65eb6dd0">CDDB_CONN_H</a> 1</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">SEARCHCAT</a>(c) (1 << (c))</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to be used for building the category search bit-string from the values of <a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a>. <a href="#e1655d536ba835be95af11110a519cb4"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef cddb_iconv_s * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#f94df4c76a9be88725db4e8319167864">cddb_iconv_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Forward declaration of opaque structure used for character set conversions. <a href="#f94df4c76a9be88725db4e8319167864"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef cddb_conn_s </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An opaque structure for keeping state about the connection to a CDDB server. <a href="#56aabb81a12e2653f737f1fde87285d9"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">cddb_cache_mode_t</a> { <a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b89ceda9ff7fcc69ea74bfb81c1527512">CACHE_OFF</a> = 0,
<a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b916a7dbc1d2807513a9a0ad10c9b13bc">CACHE_ON</a>,
<a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567">CACHE_ONLY</a>
}</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">cddb_search_t</a> { <br>
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b">SEARCH_NONE</a> = 0,
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207f22a7dcf1e5539628c03c3bd305b8e95">SEARCH_ARTIST</a> = 1,
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2077e19ca550798cc8c07d1be4c65953475">SEARCH_TITLE</a> = 2,
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207098d21d3074984ecab7951bf3db7abc4">SEARCH_TRACK</a> = 4,
<br>
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207f198570d5b701789f391811aa461da35">SEARCH_OTHER</a> = 8,
<a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5">SEARCH_ALL</a> = ~0
<br>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Which fields to use for the full text search is defined by one or more of the constants below. <a href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#207796cf79ed9a83a772cde49f7579e4">cddb_new</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new CDDB connection structure. <a href="#207796cf79ed9a83a772cde49f7579e4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#6e82c862d1338be57dccd92309149854">cddb_destroy</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Free all resources associated with the given CDDB connection structure. <a href="#6e82c862d1338be57dccd92309149854"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#955e264a4407f15f94717565bf704d27">cddb_set_charset</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *cs)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the character set. <a href="#955e264a4407f15f94717565bf704d27"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#e06260fc9b5ff8394060ceefe1146d5a">cddb_set_buf_size</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, unsigned int size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Change the size of the internal buffer. <a href="#e06260fc9b5ff8394060ceefe1146d5a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#e26fe63627f6811edd44a9cb6ab0723f">cddb_set_site</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> *site)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set all server details in one go through the use of a site structure. <a href="#e26fe63627f6811edd44a9cb6ab0723f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#051dbe7b93104f10635b960b8b0a8ec5">cddb_get_server_name</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the host name of the CDDB server that is currently being used. <a href="#051dbe7b93104f10635b960b8b0a8ec5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#54641c0dac5234713f1916d8d70d8e8b">cddb_set_server_name</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *server)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the host name of the CDDB server. <a href="#54641c0dac5234713f1916d8d70d8e8b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#830de23455bcb74f71fd19c078dc9ae2">cddb_get_server_port</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the port of the CDDB server that is currently being used. <a href="#830de23455bcb74f71fd19c078dc9ae2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#f401470406a0139b0ea78c24960361b1">cddb_set_server_port</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, int port)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the port of the CDDB server. <a href="#f401470406a0139b0ea78c24960361b1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#3008d788bf1c5aa30b17304ca23ae1f5">cddb_get_timeout</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the network time out value (in seconds). <a href="#3008d788bf1c5aa30b17304ca23ae1f5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#4c4b3c013eb29951c34d161501eb8ca4">cddb_set_timeout</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, unsigned int t)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the network time out value (in seconds). <a href="#4c4b3c013eb29951c34d161501eb8ca4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#1b01364eaf39628cf85956f11aec79ef">cddb_get_http_path_query</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the URL path for querying a CDDB server through HTTP. <a href="#1b01364eaf39628cf85956f11aec79ef"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#149b142eaa370b6032ce997fd0ab387e">cddb_set_http_path_query</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *path)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the URL path for querying a CDDB server through HTTP. <a href="#149b142eaa370b6032ce997fd0ab387e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#d9f1419dcecc44d28a51890ea6c82fe1">cddb_get_http_path_submit</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the URL path for submitting to a CDDB server through HTTP. <a href="#d9f1419dcecc44d28a51890ea6c82fe1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#689e000fc2739c94dcee2c396564d2dd">cddb_set_http_path_submit</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *path)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the URL path for submitting to a CDDB server through HTTP. <a href="#689e000fc2739c94dcee2c396564d2dd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#d891527db2f4a22f6953a555e226a72e">cddb_is_http_enabled</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the HTTP protocol is currently enabled and false if CDDBP is enabled. <a href="#d891527db2f4a22f6953a555e226a72e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#7a864e89e1d1eb17b958bdd7ed21d260">cddb_http_enable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enable HTTP tunneling to connect to the CDDB server. <a href="#7a864e89e1d1eb17b958bdd7ed21d260"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#454f75dbcba03c9a5d6f5086f13feb74">cddb_http_disable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Disable HTTP tunneling to connect to the CDDB server. <a href="#454f75dbcba03c9a5d6f5086f13feb74"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#bb05f98da82a91f4cb1ee81955775f8a">cddb_is_http_proxy_enabled</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the proxy support is currently enabled and false if it is not. <a href="#bb05f98da82a91f4cb1ee81955775f8a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#8e33685500b1f00f6a6b3216a5d501a0">cddb_http_proxy_enable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enable HTTP tunneling through an HTTP proxy server to connect to the CDDB server. <a href="#8e33685500b1f00f6a6b3216a5d501a0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#6592483c8a70b7fa11a50ef60762c079">cddb_http_proxy_disable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Disable HTTP tunneling through an HTTP proxy server to connect to the CDDB server. <a href="#6592483c8a70b7fa11a50ef60762c079"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#5a1a4c69d3b36f026addcbcb5d6b75df">cddb_get_http_proxy_server_name</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the host name of the HTTP proxy server. <a href="#5a1a4c69d3b36f026addcbcb5d6b75df"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#8484ac5eb6a1efee1cb440f1bd9de0f7">cddb_set_http_proxy_server_name</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *server)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the host name of the HTTP proxy server. <a href="#8484ac5eb6a1efee1cb440f1bd9de0f7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#bec34ae32a54dce958c06f26852a9775">cddb_get_http_proxy_server_port</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the port of the HTTP proxy server. <a href="#bec34ae32a54dce958c06f26852a9775"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#f6cbc387b2c20eae3d122577e80196c3">cddb_set_http_proxy_server_port</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, int port)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the port of the HTTP proxy server. <a href="#f6cbc387b2c20eae3d122577e80196c3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#0eb1aed5a60b987b68e35aab6f8a789e">cddb_set_http_proxy_username</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *username)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the HTTP proxy user name which is used when Basic Authentication is required. <a href="#0eb1aed5a60b987b68e35aab6f8a789e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#0601de0b5f52ded89928841dde0df2f2">cddb_get_http_proxy_username</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the HTTP proxy user name. <a href="#0601de0b5f52ded89928841dde0df2f2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#596f6f53c24aa16ba7618cc068c814db">cddb_set_http_proxy_password</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *passwd)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the HTTP proxy password which is used when Basic Authentication is required. <a href="#596f6f53c24aa16ba7618cc068c814db"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#89eb5251fad6494b62c007376e455bfc">cddb_get_http_proxy_password</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the HTTP proxy password. <a href="#89eb5251fad6494b62c007376e455bfc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#aa4a07780a2d4602a9d42b4bd42e284d">cddb_set_http_proxy_credentials</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *username, const char *passwd)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the HTTP proxy user name and password in one go. <a href="#aa4a07780a2d4602a9d42b4bd42e284d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#41d1b47b9ad3e64f6fa3e94d7547e6e5">cddb_errno</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the error number returned by the last libcddb command. <a href="#41d1b47b9ad3e64f6fa3e94d7547e6e5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#1c1d0afabce7dfd17759e46795c3f637">cddb_set_client</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *cname, const char *cversion)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the name and version of the client program overwriting the previous values. <a href="#1c1d0afabce7dfd17759e46795c3f637"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#cfcd1cffe82707f325d8e47355a243f9">cddb_set_email_address</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *email)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the user name and host name of the local machine. <a href="#cfcd1cffe82707f325d8e47355a243f9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">cddb_cache_mode_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#f51571f2931ec69c8ef6211eaeeff9d7">cddb_cache_mode</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current cache mode. <a href="#f51571f2931ec69c8ef6211eaeeff9d7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#cd50c16de3aa51dcdc751d2d280c449a">cddb_cache_enable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enable caching of CDDB entries locally. <a href="#cd50c16de3aa51dcdc751d2d280c449a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#ea8e701c4ebeddc6833186cd46b0d357">cddb_cache_only</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Only use the local CDDB cache. <a href="#ea8e701c4ebeddc6833186cd46b0d357"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#b39d8c98dcab69671ecb0c00e880e3a7">cddb_cache_disable</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Disable caching of CDDB entries locally. <a href="#b39d8c98dcab69671ecb0c00e880e3a7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#0b279d3ee74ce0e7948f25b2176c86fd">cddb_cache_get_dir</a> (const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the directory currently being used for caching. <a href="#0b279d3ee74ce0e7948f25b2176c86fd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#4279db07e78685fb1a502bbd6096dbb4">cddb_cache_set_dir</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, const char *dir)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Change the directory used for caching CDDB entries locally. <a href="#4279db07e78685fb1a502bbd6096dbb4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#a567bd00e3102515bc48a7f8e2e1aadc">cddb_first_site</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the first CDDB mirror site. <a href="#a567bd00e3102515bc48a7f8e2e1aadc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#10422062fb1bf7b1b34a17e6790dd38e">cddb_next_site</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the next CDDB mirror site. <a href="#10422062fb1bf7b1b34a17e6790dd38e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#98bcdf45d34339bd3b9bee82e5dc4bc3">cddb_search_set_fields</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, unsigned int fields)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the bit-string specifying which fields to examine when performing a text search. <a href="#98bcdf45d34339bd3b9bee82e5dc4bc3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__conn_8h.html#42926ccaf6269a28e4a8bde07ef7b985">cddb_search_set_categories</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, unsigned int cats)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the bit-string specifying which categories to examine when performing a text search. <a href="#42926ccaf6269a28e4a8bde07ef7b985"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="be705ae4bff57876bddfb0bb65eb6dd0"></a><!-- doxytag: member="cddb_conn.h::CDDB_CONN_H" ref="be705ae4bff57876bddfb0bb65eb6dd0" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define CDDB_CONN_H 1 </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="e1655d536ba835be95af11110a519cb4"></a><!-- doxytag: member="cddb_conn.h::SEARCHCAT" ref="e1655d536ba835be95af11110a519cb4" args="(c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define SEARCHCAT </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">c </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> (1 << (c))</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Macro to be used for building the category search bit-string from the values of <a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a>.
<p>
</td>
</tr>
</table>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="56aabb81a12e2653f737f1fde87285d9"></a><!-- doxytag: member="cddb_conn.h::cddb_conn_t" ref="56aabb81a12e2653f737f1fde87285d9" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef struct cddb_conn_s <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
An opaque structure for keeping state about the connection to a CDDB server.
<p>
</td>
</tr>
</table>
<a class="anchor" name="f94df4c76a9be88725db4e8319167864"></a><!-- doxytag: member="cddb_conn.h::cddb_iconv_t" ref="f94df4c76a9be88725db4e8319167864" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef struct cddb_iconv_s* <a class="el" href="cddb__conn_8h.html#f94df4c76a9be88725db4e8319167864">cddb_iconv_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Forward declaration of opaque structure used for character set conversions.
<p>
</td>
</tr>
</table>
<hr><h2>Enumeration Type Documentation</h2>
<a class="anchor" name="264ac059c9a7ba457e4054efc7aaa69b"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_mode_t" ref="264ac059c9a7ba457e4054efc7aaa69b" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">enum <a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">cddb_cache_mode_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="264ac059c9a7ba457e4054efc7aaa69b89ceda9ff7fcc69ea74bfb81c1527512"></a><!-- doxytag: member="CACHE_OFF" ref="264ac059c9a7ba457e4054efc7aaa69b89ceda9ff7fcc69ea74bfb81c1527512" args="" -->CACHE_OFF</em> </td><td>
do not use local CDDB cache, network only </td></tr>
<tr><td valign="top"><em><a class="anchor" name="264ac059c9a7ba457e4054efc7aaa69b916a7dbc1d2807513a9a0ad10c9b13bc"></a><!-- doxytag: member="CACHE_ON" ref="264ac059c9a7ba457e4054efc7aaa69b916a7dbc1d2807513a9a0ad10c9b13bc" args="" -->CACHE_ON</em> </td><td>
use local CDDB cache, if possible </td></tr>
<tr><td valign="top"><em><a class="anchor" name="264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567"></a><!-- doxytag: member="CACHE_ONLY" ref="264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567" args="" -->CACHE_ONLY</em> </td><td>
only use local CDDB cache, no network access </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="c3528eb88b27e833f1b239dab018b207"></a><!-- doxytag: member="cddb_conn.h::cddb_search_t" ref="c3528eb88b27e833f1b239dab018b207" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">enum <a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">cddb_search_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Which fields to use for the full text search is defined by one or more of the constants below.
<p>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b"></a><!-- doxytag: member="SEARCH_NONE" ref="c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b" args="" -->SEARCH_NONE</em> </td><td>
no fields </td></tr>
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b207f22a7dcf1e5539628c03c3bd305b8e95"></a><!-- doxytag: member="SEARCH_ARTIST" ref="c3528eb88b27e833f1b239dab018b207f22a7dcf1e5539628c03c3bd305b8e95" args="" -->SEARCH_ARTIST</em> </td><td>
artist name field </td></tr>
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b2077e19ca550798cc8c07d1be4c65953475"></a><!-- doxytag: member="SEARCH_TITLE" ref="c3528eb88b27e833f1b239dab018b2077e19ca550798cc8c07d1be4c65953475" args="" -->SEARCH_TITLE</em> </td><td>
disc title field </td></tr>
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b207098d21d3074984ecab7951bf3db7abc4"></a><!-- doxytag: member="SEARCH_TRACK" ref="c3528eb88b27e833f1b239dab018b207098d21d3074984ecab7951bf3db7abc4" args="" -->SEARCH_TRACK</em> </td><td>
track title field </td></tr>
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b207f198570d5b701789f391811aa461da35"></a><!-- doxytag: member="SEARCH_OTHER" ref="c3528eb88b27e833f1b239dab018b207f198570d5b701789f391811aa461da35" args="" -->SEARCH_OTHER</em> </td><td>
other fields </td></tr>
<tr><td valign="top"><em><a class="anchor" name="c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5"></a><!-- doxytag: member="SEARCH_ALL" ref="c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5" args="" -->SEARCH_ALL</em> </td><td>
all fields </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="b39d8c98dcab69671ecb0c00e880e3a7"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_disable" ref="b39d8c98dcab69671ecb0c00e880e3a7" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_cache_disable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Disable caching of CDDB entries locally.
<p>
All data will be fetched from a CDDB server everytime and the retrieved data will not be cached locally.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#f51571f2931ec69c8ef6211eaeeff9d7">cddb_cache_mode</a> <p>
<a class="el" href="cddb__conn_8h.html#cd50c16de3aa51dcdc751d2d280c449a">cddb_cache_enable</a> <p>
<a class="el" href="cddb__conn_8h.html#ea8e701c4ebeddc6833186cd46b0d357">cddb_cache_only</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="cd50c16de3aa51dcdc751d2d280c449a"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_enable" ref="cd50c16de3aa51dcdc751d2d280c449a" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_cache_enable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Enable caching of CDDB entries locally.
<p>
Caching is enabled by default. The cache directory can be changed with the cddb_cache_set_dir function.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#f51571f2931ec69c8ef6211eaeeff9d7">cddb_cache_mode</a> <p>
<a class="el" href="cddb__conn_8h.html#b39d8c98dcab69671ecb0c00e880e3a7">cddb_cache_disable</a> <p>
<a class="el" href="cddb__conn_8h.html#ea8e701c4ebeddc6833186cd46b0d357">cddb_cache_only</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="0b279d3ee74ce0e7948f25b2176c86fd"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_get_dir" ref="0b279d3ee74ce0e7948f25b2176c86fd" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_cache_get_dir </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Return the directory currently being used for caching.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#4279db07e78685fb1a502bbd6096dbb4">cddb_cache_set_dir</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The directory being used for caching. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="f51571f2931ec69c8ef6211eaeeff9d7"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_mode" ref="f51571f2931ec69c8ef6211eaeeff9d7" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">cddb_cache_mode_t</a> cddb_cache_mode </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns the current cache mode.
<p>
This can be either on, off or cache only.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b916a7dbc1d2807513a9a0ad10c9b13bc">CACHE_ON</a> <p>
<a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567">CACHE_ONLY</a> <p>
<a class="el" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b89ceda9ff7fcc69ea74bfb81c1527512">CACHE_OFF</a> <p>
<a class="el" href="cddb__conn_8h.html#cd50c16de3aa51dcdc751d2d280c449a">cddb_cache_enable</a> <p>
<a class="el" href="cddb__conn_8h.html#ea8e701c4ebeddc6833186cd46b0d357">cddb_cache_only</a> <p>
<a class="el" href="cddb__conn_8h.html#b39d8c98dcab69671ecb0c00e880e3a7">cddb_cache_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="ea8e701c4ebeddc6833186cd46b0d357"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_only" ref="ea8e701c4ebeddc6833186cd46b0d357" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_cache_only </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Only use the local CDDB cache.
<p>
Never contact a server to retrieve any data. The cache directory can be changed with the cddb_cache_set_dir function.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#f51571f2931ec69c8ef6211eaeeff9d7">cddb_cache_mode</a> <p>
<a class="el" href="cddb__conn_8h.html#cd50c16de3aa51dcdc751d2d280c449a">cddb_cache_enable</a> <p>
<a class="el" href="cddb__conn_8h.html#b39d8c98dcab69671ecb0c00e880e3a7">cddb_cache_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="4279db07e78685fb1a502bbd6096dbb4"></a><!-- doxytag: member="cddb_conn.h::cddb_cache_set_dir" ref="4279db07e78685fb1a502bbd6096dbb4" args="(cddb_conn_t *c, const char *dir)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int cddb_cache_set_dir </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>dir</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Change the directory used for caching CDDB entries locally.
<p>
The default location of the cached entries is a subdirectory (.cddbslave) of the user's home directory. If the first character of the directory is '~', then it will be expanded to the contents of $HOME.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#0b279d3ee74ce0e7948f25b2176c86fd">cddb_cache_get_dir</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dir</em> </td><td>The directory to use for caching. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="6e82c862d1338be57dccd92309149854"></a><!-- doxytag: member="cddb_conn.h::cddb_destroy" ref="6e82c862d1338be57dccd92309149854" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_destroy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Free all resources associated with the given CDDB connection structure.
<p>
</td>
</tr>
</table>
<a class="anchor" name="41d1b47b9ad3e64f6fa3e94d7547e6e5"></a><!-- doxytag: member="cddb_conn.h::cddb_errno" ref="41d1b47b9ad3e64f6fa3e94d7547e6e5" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> cddb_errno </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the error number returned by the last libcddb command.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The error number. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a567bd00e3102515bc48a7f8e2e1aadc"></a><!-- doxytag: member="cddb_conn.h::cddb_first_site" ref="a567bd00e3102515bc48a7f8e2e1aadc" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a>* cddb_first_site </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Retrieve the first CDDB mirror site.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The first mirror site or NULL if not found. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="1b01364eaf39628cf85956f11aec79ef"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_path_query" ref="1b01364eaf39628cf85956f11aec79ef" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_http_path_query </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the URL path for querying a CDDB server through HTTP.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#149b142eaa370b6032ce997fd0ab387e">cddb_set_http_path_query</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The URL path. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="d9f1419dcecc44d28a51890ea6c82fe1"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_path_submit" ref="d9f1419dcecc44d28a51890ea6c82fe1" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_http_path_submit </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the URL path for submitting to a CDDB server through HTTP.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#689e000fc2739c94dcee2c396564d2dd">cddb_set_http_path_submit</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The URL path. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="89eb5251fad6494b62c007376e455bfc"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_proxy_password" ref="89eb5251fad6494b62c007376e455bfc" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_http_proxy_password </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the HTTP proxy password.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The password. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="5a1a4c69d3b36f026addcbcb5d6b75df"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_proxy_server_name" ref="5a1a4c69d3b36f026addcbcb5d6b75df" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_http_proxy_server_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the host name of the HTTP proxy server.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#8484ac5eb6a1efee1cb440f1bd9de0f7">cddb_set_http_proxy_server_name</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The proxy server host name. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="bec34ae32a54dce958c06f26852a9775"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_proxy_server_port" ref="bec34ae32a54dce958c06f26852a9775" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_get_http_proxy_server_port </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the port of the HTTP proxy server.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#f6cbc387b2c20eae3d122577e80196c3">cddb_set_http_proxy_server_port</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The proxy server port. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="0601de0b5f52ded89928841dde0df2f2"></a><!-- doxytag: member="cddb_conn.h::cddb_get_http_proxy_username" ref="0601de0b5f52ded89928841dde0df2f2" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_http_proxy_username </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the HTTP proxy user name.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The user name. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="051dbe7b93104f10635b960b8b0a8ec5"></a><!-- doxytag: member="cddb_conn.h::cddb_get_server_name" ref="051dbe7b93104f10635b960b8b0a8ec5" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_get_server_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the host name of the CDDB server that is currently being used.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#54641c0dac5234713f1916d8d70d8e8b">cddb_set_server_name</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The server host name. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="830de23455bcb74f71fd19c078dc9ae2"></a><!-- doxytag: member="cddb_conn.h::cddb_get_server_port" ref="830de23455bcb74f71fd19c078dc9ae2" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_get_server_port </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the port of the CDDB server that is currently being used.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#f401470406a0139b0ea78c24960361b1">cddb_set_server_port</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The server port. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="3008d788bf1c5aa30b17304ca23ae1f5"></a><!-- doxytag: member="cddb_conn.h::cddb_get_timeout" ref="3008d788bf1c5aa30b17304ca23ae1f5" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_get_timeout </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the network time out value (in seconds).
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#4c4b3c013eb29951c34d161501eb8ca4">cddb_set_timeout</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The current time out in seconds. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="454f75dbcba03c9a5d6f5086f13feb74"></a><!-- doxytag: member="cddb_conn.h::cddb_http_disable" ref="454f75dbcba03c9a5d6f5086f13feb74" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_http_disable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Disable HTTP tunneling to connect to the CDDB server.
<p>
By default this option is disabled.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#d891527db2f4a22f6953a555e226a72e">cddb_is_http_enabled</a> <p>
<a class="el" href="cddb__conn_8h.html#7a864e89e1d1eb17b958bdd7ed21d260">cddb_http_enable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="7a864e89e1d1eb17b958bdd7ed21d260"></a><!-- doxytag: member="cddb_conn.h::cddb_http_enable" ref="7a864e89e1d1eb17b958bdd7ed21d260" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_http_enable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Enable HTTP tunneling to connect to the CDDB server.
<p>
By default this option is disabled.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#d891527db2f4a22f6953a555e226a72e">cddb_is_http_enabled</a> <p>
<a class="el" href="cddb__conn_8h.html#454f75dbcba03c9a5d6f5086f13feb74">cddb_http_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="6592483c8a70b7fa11a50ef60762c079"></a><!-- doxytag: member="cddb_conn.h::cddb_http_proxy_disable" ref="6592483c8a70b7fa11a50ef60762c079" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_http_proxy_disable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Disable HTTP tunneling through an HTTP proxy server to connect to the CDDB server.
<p>
By default this option is disabled.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#bb05f98da82a91f4cb1ee81955775f8a">cddb_is_http_proxy_enabled</a> <p>
<a class="el" href="cddb__conn_8h.html#8e33685500b1f00f6a6b3216a5d501a0">cddb_http_proxy_enable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="8e33685500b1f00f6a6b3216a5d501a0"></a><!-- doxytag: member="cddb_conn.h::cddb_http_proxy_enable" ref="8e33685500b1f00f6a6b3216a5d501a0" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_http_proxy_enable </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Enable HTTP tunneling through an HTTP proxy server to connect to the CDDB server.
<p>
The usage of an HTTP proxy implies normal HTTP tunneling instead of connecting directly to the CDDB server. By default this option is disabled.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#bb05f98da82a91f4cb1ee81955775f8a">cddb_is_http_proxy_enabled</a> <p>
<a class="el" href="cddb__conn_8h.html#6592483c8a70b7fa11a50ef60762c079">cddb_http_proxy_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="d891527db2f4a22f6953a555e226a72e"></a><!-- doxytag: member="cddb_conn.h::cddb_is_http_enabled" ref="d891527db2f4a22f6953a555e226a72e" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_is_http_enabled </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns true if the HTTP protocol is currently enabled and false if CDDBP is enabled.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#7a864e89e1d1eb17b958bdd7ed21d260">cddb_http_enable</a> <p>
<a class="el" href="cddb__conn_8h.html#454f75dbcba03c9a5d6f5086f13feb74">cddb_http_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>True or false. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="bb05f98da82a91f4cb1ee81955775f8a"></a><!-- doxytag: member="cddb_conn.h::cddb_is_http_proxy_enabled" ref="bb05f98da82a91f4cb1ee81955775f8a" args="(const cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_is_http_proxy_enabled </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns true if the proxy support is currently enabled and false if it is not.
<p>
This fucntion does not check whether HTTP is enabled. So it is possible that true will be returned while in reality the CDDBP protocol is being used (no proxy support).<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#8e33685500b1f00f6a6b3216a5d501a0">cddb_http_proxy_enable</a> <p>
<a class="el" href="cddb__conn_8h.html#6592483c8a70b7fa11a50ef60762c079">cddb_http_proxy_disable</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The CDDB connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>True or false. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="207796cf79ed9a83a772cde49f7579e4"></a><!-- doxytag: member="cddb_conn.h::cddb_new" ref="207796cf79ed9a83a772cde49f7579e4" args="(void)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a>* cddb_new </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Creates a new CDDB connection structure.
<p>
This structure will have to be passed to all libcddb functions. Default values will be used for the connection parameters allowing it to contact the CDDB server at freedb.org.<p>
<dl compact><dt><b>Returns:</b></dt><dd>The CDDB connection structure or NULL if something went wrong. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="10422062fb1bf7b1b34a17e6790dd38e"></a><!-- doxytag: member="cddb_conn.h::cddb_next_site" ref="10422062fb1bf7b1b34a17e6790dd38e" args="(cddb_conn_t *c)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a>* cddb_next_site </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>c</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Retrieve the next CDDB mirror site.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The next mirror site or NULL if not found. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="42926ccaf6269a28e4a8bde07ef7b985"></a><!-- doxytag: member="cddb_conn.h::cddb_search_set_categories" ref="42926ccaf6269a28e4a8bde07ef7b985" args="(cddb_conn_t *c, unsigned int cats)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_search_set_categories </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>cats</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the bit-string specifying which categories to examine when performing a text search.
<p>
The <a class="el" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">SEARCHCAT</a> macro needs to be used to build the actual bit-string from individual categories. The <a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">cddb_search_t</a> values <a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b">SEARCH_NONE</a> and <a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5">SEARCH_ALL</a> are also valid. The example below shows some possible combinations. By default all categories are searched.<p>
<div class="fragment"><pre class="fragment"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cats = <a class="code" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">SEARCHCAT</a>(<a class="code" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d57a322c8a25ae9a30b77f0fcea838872">CDDB_CAT_ROCK</a>) | <a class="code" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">SEARCHCAT</a>(<a class="code" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d0f8ff1f94ad8c134bd34c791772d60e7">CDDB_CAT_MISC</a>);
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cats = <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5">SEARCH_ALL</a>;
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cats = <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b">SEARCH_NONE</a>;
</pre></div><p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cats</em> </td><td>A bitwise ORed set of values from <a class="el" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">SEARCHCAT</a>(<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a>). </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="98bcdf45d34339bd3b9bee82e5dc4bc3"></a><!-- doxytag: member="cddb_conn.h::cddb_search_set_fields" ref="98bcdf45d34339bd3b9bee82e5dc4bc3" args="(cddb_conn_t *c, unsigned int fields)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_search_set_fields </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>fields</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the bit-string specifying which fields to examine when performing a text search.
<p>
By default only the artist and disc title fields are searched.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fields</em> </td><td>A bitwise ORed set of values from <a class="el" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">cddb_search_t</a>. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="e06260fc9b5ff8394060ceefe1146d5a"></a><!-- doxytag: member="cddb_conn.h::cddb_set_buf_size" ref="e06260fc9b5ff8394060ceefe1146d5a" args="(cddb_conn_t *c, unsigned int size)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_buf_size </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Change the size of the internal buffer.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The new buffer size. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="955e264a4407f15f94717565bf704d27"></a><!-- doxytag: member="cddb_conn.h::cddb_set_charset" ref="955e264a4407f15f94717565bf704d27" args="(cddb_conn_t *c, const char *cs)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int cddb_set_charset </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>cs</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the character set.
<p>
By default the FreeDB server uses UTF-8 when providing CD data. When a character set is defined with this function any strings retrieved from or sent to the server will automatically be converted.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cs</em> </td><td>The character set that will be used. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>False if the specified character set is unknown, or no conversion from/to UTF-8 is available. True otherwise. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="1c1d0afabce7dfd17759e46795c3f637"></a><!-- doxytag: member="cddb_conn.h::cddb_set_client" ref="1c1d0afabce7dfd17759e46795c3f637" args="(cddb_conn_t *c, const char *cname, const char *cversion)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_client </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>cname</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>cversion</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the name and version of the client program overwriting the previous values.
<p>
This function will make a copy of the provided strings. The defaults are 'libcddb' and the version number of the libcddb library in use. Both parameters must be valid strings. If any of teh strings is NULL, this fucntion will return without changing anything.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cname</em> </td><td>The name of the client program. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cversion</em> </td><td>The version number of the client program. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="cfcd1cffe82707f325d8e47355a243f9"></a><!-- doxytag: member="cddb_conn.h::cddb_set_email_address" ref="cfcd1cffe82707f325d8e47355a243f9" args="(cddb_conn_t *c, const char *email)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int cddb_set_email_address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>email</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Sets the user name and host name of the local machine.
<p>
This function will parse out the user name and host name from the e-mail address.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>email</em> </td><td>The e-mail address of the user. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="149b142eaa370b6032ce997fd0ab387e"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_path_query" ref="149b142eaa370b6032ce997fd0ab387e" args="(cddb_conn_t *c, const char *path)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_path_query </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>path</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the URL path for querying a CDDB server through HTTP.
<p>
The default value is '/~cddb/cddb.cgi'.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#1b01364eaf39628cf85956f11aec79ef">cddb_get_http_path_query</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>path</em> </td><td>The URL path. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="689e000fc2739c94dcee2c396564d2dd"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_path_submit" ref="689e000fc2739c94dcee2c396564d2dd" args="(cddb_conn_t *c, const char *path)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_path_submit </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>path</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the URL path for submitting to a CDDB server through HTTP.
<p>
The default value is '/~cddb/submit.cgi'.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#d9f1419dcecc44d28a51890ea6c82fe1">cddb_get_http_path_submit</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>path</em> </td><td>The URL path. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="aa4a07780a2d4602a9d42b4bd42e284d"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_proxy_credentials" ref="aa4a07780a2d4602a9d42b4bd42e284d" args="(cddb_conn_t *c, const char *username, const char *passwd)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_proxy_credentials </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>username</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>passwd</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the HTTP proxy user name and password in one go.
<p>
These credentials are used when Basic Authentication is required. The advantage of using this function over setting the user name and password seperately is that the cleartext user name and password are not kept in memory longer than needed.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>username</em> </td><td>The user name. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>passwd</em> </td><td>The password. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="596f6f53c24aa16ba7618cc068c814db"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_proxy_password" ref="596f6f53c24aa16ba7618cc068c814db" args="(cddb_conn_t *c, const char *passwd)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_proxy_password </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>passwd</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the HTTP proxy password which is used when Basic Authentication is required.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>passwd</em> </td><td>The password. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="8484ac5eb6a1efee1cb440f1bd9de0f7"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_proxy_server_name" ref="8484ac5eb6a1efee1cb440f1bd9de0f7" args="(cddb_conn_t *c, const char *server)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_proxy_server_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>server</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the host name of the HTTP proxy server.
<p>
There is no default value.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#5a1a4c69d3b36f026addcbcb5d6b75df">cddb_get_http_proxy_server_name</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>server</em> </td><td>The server host name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="f6cbc387b2c20eae3d122577e80196c3"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_proxy_server_port" ref="f6cbc387b2c20eae3d122577e80196c3" args="(cddb_conn_t *c, int port)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_proxy_server_port </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>port</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the port of the HTTP proxy server.
<p>
The default value is 8080.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#bec34ae32a54dce958c06f26852a9775">cddb_get_http_proxy_server_port</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>port</em> </td><td>The server port. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="0eb1aed5a60b987b68e35aab6f8a789e"></a><!-- doxytag: member="cddb_conn.h::cddb_set_http_proxy_username" ref="0eb1aed5a60b987b68e35aab6f8a789e" args="(cddb_conn_t *c, const char *username)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_http_proxy_username </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>username</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the HTTP proxy user name which is used when Basic Authentication is required.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>username</em> </td><td>The user name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="54641c0dac5234713f1916d8d70d8e8b"></a><!-- doxytag: member="cddb_conn.h::cddb_set_server_name" ref="54641c0dac5234713f1916d8d70d8e8b" args="(cddb_conn_t *c, const char *server)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_server_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>server</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the host name of the CDDB server.
<p>
The default value for the server is 'freedb.org'.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#051dbe7b93104f10635b960b8b0a8ec5">cddb_get_server_name</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>server</em> </td><td>The server host name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="f401470406a0139b0ea78c24960361b1"></a><!-- doxytag: member="cddb_conn.h::cddb_set_server_port" ref="f401470406a0139b0ea78c24960361b1" args="(cddb_conn_t *c, int port)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_server_port </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>port</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the port of the CDDB server.
<p>
The default value is 888.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#830de23455bcb74f71fd19c078dc9ae2">cddb_get_server_port</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>port</em> </td><td>The server port. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="e26fe63627f6811edd44a9cb6ab0723f"></a><!-- doxytag: member="cddb_conn.h::cddb_set_site" ref="e26fe63627f6811edd44a9cb6ab0723f" args="(cddb_conn_t *c, const cddb_site_t *site)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> cddb_set_site </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> * </td>
<td class="mdname" nowrap> <em>site</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set all server details in one go through the use of a site structure.
<p>
This function initializzes the server address, port, protocol and query path in case of HTTP.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__cmd_8h.html#709293423e9a376d49518900db445e67">cddb_sites</a> <p>
<a class="el" href="cddb__conn_8h.html#a567bd00e3102515bc48a7f8e2e1aadc">cddb_first_site</a> <p>
<a class="el" href="cddb__conn_8h.html#10422062fb1bf7b1b34a17e6790dd38e">cddb_next_site</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>site</em> </td><td>The site to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Error code: CDDB_ERR_OK or CDDB_ERR_INVALID. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="4c4b3c013eb29951c34d161501eb8ca4"></a><!-- doxytag: member="cddb_conn.h::cddb_set_timeout" ref="4c4b3c013eb29951c34d161501eb8ca4" args="(cddb_conn_t *c, unsigned int t)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_set_timeout </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> * </td>
<td class="mdname" nowrap> <em>c</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>t</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the network time out value (in seconds).
<p>
The default is 10 seconds.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__conn_8h.html#3008d788bf1c5aa30b17304ca23ae1f5">cddb_get_timeout</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The connection structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>t</em> </td><td>The new time out in seconds. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Sun Oct 15 14:49:15 2006 for libcddb by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
</body>
</html>
