<!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 Source File</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</h1><a href="cddb__conn_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> $Id: cddb_conn.h,v 1.30 2005/08/03 18:25:01 airborne Exp $</span>
<a name="l00003"></a>00003 <span class="comment"></span>
<a name="l00004"></a>00004 <span class="comment"> Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be></span>
<a name="l00005"></a>00005 <span class="comment"></span>
<a name="l00006"></a>00006 <span class="comment"> This library is free software; you can redistribute it and/or</span>
<a name="l00007"></a>00007 <span class="comment"> modify it under the terms of the GNU Library General Public</span>
<a name="l00008"></a>00008 <span class="comment"> License as published by the Free Software Foundation; either</span>
<a name="l00009"></a>00009 <span class="comment"> version 2 of the License, or (at your option) any later version.</span>
<a name="l00010"></a>00010 <span class="comment"></span>
<a name="l00011"></a>00011 <span class="comment"> This library is distributed in the hope that it will be useful,</span>
<a name="l00012"></a>00012 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00013"></a>00013 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00014"></a>00014 <span class="comment"> Library General Public License for more details.</span>
<a name="l00015"></a>00015 <span class="comment"></span>
<a name="l00016"></a>00016 <span class="comment"> You should have received a copy of the GNU Library General Public</span>
<a name="l00017"></a>00017 <span class="comment"> License along with this library; if not, write to the</span>
<a name="l00018"></a>00018 <span class="comment"> Free Software Foundation, Inc., 59 Temple Place - Suite 330,</span>
<a name="l00019"></a>00019 <span class="comment"> Boston, MA 02111-1307, USA.</span>
<a name="l00020"></a>00020 <span class="comment">*/</span>
<a name="l00021"></a>00021
<a name="l00022"></a>00022 <span class="preprocessor">#ifndef CDDB_CONN_H</span>
<a name="l00023"></a><a class="code" href="cddb__conn_8h.html#be705ae4bff57876bddfb0bb65eb6dd0">00023</a> <span class="preprocessor"></span><span class="preprocessor">#define CDDB_CONN_H 1</span>
<a name="l00024"></a>00024 <span class="preprocessor"></span>
<a name="l00025"></a>00025 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00026"></a>00026 <span class="preprocessor"></span> <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
<a name="l00027"></a>00027 <span class="preprocessor">#endif</span>
<a name="l00028"></a>00028 <span class="preprocessor"></span>
<a name="l00029"></a>00029
<a name="l00030"></a>00030 <span class="preprocessor">#include <stdio.h></span>
<a name="l00031"></a>00031 <span class="preprocessor">#include <netinet/in.h></span>
<a name="l00032"></a>00032
<a name="l00033"></a>00033 <span class="preprocessor">#include "<a class="code" href="cddb__site_8h.html">cddb/cddb_site.h</a>"</span>
<a name="l00034"></a>00034
<a name="l00035"></a>00035
<a name="l00036"></a><a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">00036</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {
<a name="l00037"></a>00037 <a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b89ceda9ff7fcc69ea74bfb81c1527512">CACHE_OFF</a> = 0,
<a name="l00039"></a>00039 <a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b916a7dbc1d2807513a9a0ad10c9b13bc">CACHE_ON</a>,
<a name="l00040"></a><a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567">00040</a> <a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b7ca046cd60ca10f3a4ceca753c217567">CACHE_ONLY</a>
<a name="l00042"></a>00042 } <a class="code" href="cddb__conn_8h.html#264ac059c9a7ba457e4054efc7aaa69b">cddb_cache_mode_t</a>;
<a name="l00043"></a>00043
<a name="l00048"></a><a class="code" href="cddb__conn_8h.html#f94df4c76a9be88725db4e8319167864">00048</a> <span class="keyword">typedef</span> <span class="keyword">struct </span>cddb_iconv_s *<a class="code" href="cddb__conn_8h.html#f94df4c76a9be88725db4e8319167864">cddb_iconv_t</a>;
<a name="l00049"></a>00049
<a name="l00054"></a><a class="code" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">00054</a> <span class="keyword">typedef</span> <span class="keyword">struct </span>cddb_conn_s cddb_conn_t;
<a name="l00055"></a>00055
<a name="l00060"></a><a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">00060</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {
<a name="l00061"></a>00061 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2075a32fc941d9f7c9dbf7041a93331f50b">SEARCH_NONE</a> = 0,
<a name="l00062"></a>00062 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207f22a7dcf1e5539628c03c3bd305b8e95">SEARCH_ARTIST</a> = 1,
<a name="l00063"></a>00063 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b2077e19ca550798cc8c07d1be4c65953475">SEARCH_TITLE</a> = 2,
<a name="l00064"></a>00064 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207098d21d3074984ecab7951bf3db7abc4">SEARCH_TRACK</a> = 4,
<a name="l00065"></a>00065 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207f198570d5b701789f391811aa461da35">SEARCH_OTHER</a> = 8,
<a name="l00066"></a>00066 <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207596ecb69d2e3480c4b5bad071d758de5">SEARCH_ALL</a> = ~0,
<a name="l00067"></a>00067 } <a class="code" href="cddb__conn_8h.html#c3528eb88b27e833f1b239dab018b207">cddb_search_t</a>;
<a name="l00068"></a>00068
<a name="l00073"></a><a class="code" href="cddb__conn_8h.html#e1655d536ba835be95af11110a519cb4">00073</a> <span class="preprocessor">#define SEARCHCAT(c) (1 << (c))</span>
<a name="l00074"></a>00074 <span class="preprocessor"></span>
<a name="l00075"></a>00075
<a name="l00076"></a>00076 <span class="comment">/* --- construction / destruction --- */</span>
<a name="l00077"></a>00077
<a name="l00078"></a>00078
<a name="l00087"></a>00087 cddb_conn_t *<a class="code" href="cddb__conn_8h.html#207796cf79ed9a83a772cde49f7579e4">cddb_new</a>(<span class="keywordtype">void</span>);
<a name="l00088"></a>00088
<a name="l00093"></a>00093 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#6e82c862d1338be57dccd92309149854">cddb_destroy</a>(cddb_conn_t *c);
<a name="l00094"></a>00094
<a name="l00095"></a>00095
<a name="l00096"></a>00096 <span class="comment">/* --- getters & setters --- */</span>
<a name="l00097"></a>00097
<a name="l00098"></a>00098
<a name="l00110"></a>00110 <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#955e264a4407f15f94717565bf704d27">cddb_set_charset</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *cs);
<a name="l00111"></a>00111
<a name="l00118"></a>00118 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#e06260fc9b5ff8394060ceefe1146d5a">cddb_set_buf_size</a>(cddb_conn_t *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size);
<a name="l00119"></a>00119
<a name="l00133"></a>00133 <a class="code" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> <a class="code" href="cddb__conn_8h.html#e26fe63627f6811edd44a9cb6ab0723f">cddb_set_site</a>(cddb_conn_t *c, <span class="keyword">const</span> <a class="code" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> *site);
<a name="l00134"></a>00134
<a name="l00143"></a>00143 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#051dbe7b93104f10635b960b8b0a8ec5">cddb_get_server_name</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00144"></a>00144
<a name="l00154"></a>00154 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#54641c0dac5234713f1916d8d70d8e8b">cddb_set_server_name</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *server);
<a name="l00155"></a>00155
<a name="l00164"></a>00164 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#830de23455bcb74f71fd19c078dc9ae2">cddb_get_server_port</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00165"></a>00165
<a name="l00174"></a>00174 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#f401470406a0139b0ea78c24960361b1">cddb_set_server_port</a>(cddb_conn_t *c, <span class="keywordtype">int</span> port);
<a name="l00175"></a>00175
<a name="l00184"></a>00184 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#3008d788bf1c5aa30b17304ca23ae1f5">cddb_get_timeout</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00185"></a>00185
<a name="l00195"></a>00195 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#4c4b3c013eb29951c34d161501eb8ca4">cddb_set_timeout</a>(cddb_conn_t *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> t);
<a name="l00196"></a>00196
<a name="l00205"></a>00205 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#1b01364eaf39628cf85956f11aec79ef">cddb_get_http_path_query</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00206"></a>00206
<a name="l00216"></a>00216 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#149b142eaa370b6032ce997fd0ab387e">cddb_set_http_path_query</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *path);
<a name="l00217"></a>00217
<a name="l00226"></a>00226 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#d9f1419dcecc44d28a51890ea6c82fe1">cddb_get_http_path_submit</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00227"></a>00227
<a name="l00237"></a>00237 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#689e000fc2739c94dcee2c396564d2dd">cddb_set_http_path_submit</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *path);
<a name="l00238"></a>00238
<a name="l00249"></a>00249 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#d891527db2f4a22f6953a555e226a72e">cddb_is_http_enabled</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00250"></a>00250
<a name="l00260"></a>00260 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#7a864e89e1d1eb17b958bdd7ed21d260">cddb_http_enable</a>(cddb_conn_t *c);
<a name="l00261"></a>00261
<a name="l00271"></a>00271 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#454f75dbcba03c9a5d6f5086f13feb74">cddb_http_disable</a>(cddb_conn_t *c);
<a name="l00272"></a>00272
<a name="l00285"></a>00285 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#bb05f98da82a91f4cb1ee81955775f8a">cddb_is_http_proxy_enabled</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00286"></a>00286
<a name="l00298"></a>00298 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#8e33685500b1f00f6a6b3216a5d501a0">cddb_http_proxy_enable</a>(cddb_conn_t *c);
<a name="l00299"></a>00299
<a name="l00309"></a>00309 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#6592483c8a70b7fa11a50ef60762c079">cddb_http_proxy_disable</a>(cddb_conn_t *c);
<a name="l00310"></a>00310
<a name="l00319"></a>00319 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#5a1a4c69d3b36f026addcbcb5d6b75df">cddb_get_http_proxy_server_name</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00320"></a>00320
<a name="l00330"></a>00330 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#8484ac5eb6a1efee1cb440f1bd9de0f7">cddb_set_http_proxy_server_name</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *server);
<a name="l00331"></a>00331
<a name="l00340"></a>00340 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#bec34ae32a54dce958c06f26852a9775">cddb_get_http_proxy_server_port</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00341"></a>00341
<a name="l00350"></a>00350 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#f6cbc387b2c20eae3d122577e80196c3">cddb_set_http_proxy_server_port</a>(cddb_conn_t *c, <span class="keywordtype">int</span> port);
<a name="l00351"></a>00351
<a name="l00359"></a>00359 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#0eb1aed5a60b987b68e35aab6f8a789e">cddb_set_http_proxy_username</a>(cddb_conn_t* c, <span class="keyword">const</span> <span class="keywordtype">char</span>* username);
<a name="l00360"></a>00360
<a name="l00367"></a>00367 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#0601de0b5f52ded89928841dde0df2f2">cddb_get_http_proxy_username</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00368"></a>00368
<a name="l00376"></a>00376 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#596f6f53c24aa16ba7618cc068c814db">cddb_set_http_proxy_password</a>(cddb_conn_t* c, <span class="keyword">const</span> <span class="keywordtype">char</span>* passwd);
<a name="l00377"></a>00377
<a name="l00384"></a>00384 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#89eb5251fad6494b62c007376e455bfc">cddb_get_http_proxy_password</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00385"></a>00385
<a name="l00397"></a>00397 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#aa4a07780a2d4602a9d42b4bd42e284d">cddb_set_http_proxy_credentials</a>(cddb_conn_t* c,
<a name="l00398"></a>00398 <span class="keyword">const</span> <span class="keywordtype">char</span> *username, <span class="keyword">const</span> <span class="keywordtype">char</span>* passwd);
<a name="l00399"></a>00399
<a name="l00406"></a>00406 <a class="code" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb">cddb_error_t</a> <a class="code" href="cddb__conn_8h.html#41d1b47b9ad3e64f6fa3e94d7547e6e5">cddb_errno</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00407"></a>00407
<a name="l00420"></a>00420 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#1c1d0afabce7dfd17759e46795c3f637">cddb_set_client</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *cname, <span class="keyword">const</span> <span class="keywordtype">char</span> *cversion);
<a name="l00421"></a>00421
<a name="l00430"></a>00430 <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#cfcd1cffe82707f325d8e47355a243f9">cddb_set_email_address</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *email);
<a name="l00431"></a>00431
<a name="l00445"></a>00445 cddb_cache_mode_t <a class="code" href="cddb__conn_8h.html#f51571f2931ec69c8ef6211eaeeff9d7">cddb_cache_mode</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00446"></a>00446
<a name="l00458"></a>00458 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#cd50c16de3aa51dcdc751d2d280c449a">cddb_cache_enable</a>(cddb_conn_t *c);
<a name="l00459"></a>00459
<a name="l00471"></a>00471 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#ea8e701c4ebeddc6833186cd46b0d357">cddb_cache_only</a>(cddb_conn_t *c);
<a name="l00472"></a>00472
<a name="l00484"></a>00484 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#b39d8c98dcab69671ecb0c00e880e3a7">cddb_cache_disable</a>(cddb_conn_t *c);
<a name="l00485"></a>00485
<a name="l00494"></a>00494 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="cddb__conn_8h.html#0b279d3ee74ce0e7948f25b2176c86fd">cddb_cache_get_dir</a>(<span class="keyword">const</span> cddb_conn_t *c);
<a name="l00495"></a>00495
<a name="l00508"></a>00508 <span class="keywordtype">int</span> <a class="code" href="cddb__conn_8h.html#4279db07e78685fb1a502bbd6096dbb4">cddb_cache_set_dir</a>(cddb_conn_t *c, <span class="keyword">const</span> <span class="keywordtype">char</span> *dir);
<a name="l00509"></a>00509
<a name="l00516"></a>00516 <span class="keyword">const</span> <a class="code" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> *<a class="code" href="cddb__conn_8h.html#a567bd00e3102515bc48a7f8e2e1aadc">cddb_first_site</a>(cddb_conn_t *c);
<a name="l00517"></a>00517
<a name="l00524"></a>00524 <span class="keyword">const</span> <a class="code" href="cddb__site_8h.html#a47454e35766b6edce0cc0ba513b1685">cddb_site_t</a> *<a class="code" href="cddb__conn_8h.html#10422062fb1bf7b1b34a17e6790dd38e">cddb_next_site</a>(cddb_conn_t *c);
<a name="l00525"></a>00525
<a name="l00534"></a>00534 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#98bcdf45d34339bd3b9bee82e5dc4bc3">cddb_search_set_fields</a>(cddb_conn_t *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fields);
<a name="l00535"></a>00535
<a name="l00553"></a>00553 <span class="keywordtype">void</span> <a class="code" href="cddb__conn_8h.html#42926ccaf6269a28e4a8bde07ef7b985">cddb_search_set_categories</a>(cddb_conn_t *c, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cats);
<a name="l00554"></a>00554
<a name="l00555"></a>00555
<a name="l00556"></a>00556 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00557"></a>00557 <span class="preprocessor"></span> }
<a name="l00558"></a>00558 <span class="preprocessor">#endif</span>
<a name="l00559"></a>00559 <span class="preprocessor"></span>
<a name="l00560"></a>00560 <span class="preprocessor">#endif </span><span class="comment">/* CDDB_CONN_H */</span>
</pre></div><hr size="1"><address style="align: right;"><small>Generated on Sun Oct 15 14:49:14 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>
