cddb_conn.h

Go to the documentation of this file.

/*
    $Id: cddb_conn.h,v 1.30 2005/08/03 18:25:01 airborne Exp $

    Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA  02111-1307, USA.
*/

#ifndef CDDB_CONN_H
#define CDDB_CONN_H 1

#ifdef __cplusplus
    extern "C" {
#endif


#include <stdio.h>
#include <netinet/in.h>

#include "cddb/cddb_site.h"


typedef enum {
    CACHE_OFF = 0,              
    CACHE_ON,                   
    CACHE_ONLY                  
} cddb_cache_mode_t;

typedef struct cddb_iconv_s *cddb_iconv_t;

typedef struct cddb_conn_s cddb_conn_t;

typedef enum {
    SEARCH_NONE = 0,            
    SEARCH_ARTIST = 1,          
    SEARCH_TITLE = 2,           
    SEARCH_TRACK = 4,           
    SEARCH_OTHER = 8,           
    SEARCH_ALL = ~0,            
} cddb_search_t;

#define SEARCHCAT(c) (1 << (c))


/* --- construction / destruction --- */


cddb_conn_t *cddb_new(void);

void cddb_destroy(cddb_conn_t *c);


/* --- getters & setters --- */


int cddb_set_charset(cddb_conn_t *c, const char *cs);

void cddb_set_buf_size(cddb_conn_t *c, unsigned int size);

cddb_error_t cddb_set_site(cddb_conn_t *c, const cddb_site_t *site);

const char *cddb_get_server_name(const cddb_conn_t *c);

void cddb_set_server_name(cddb_conn_t *c, const char *server);

unsigned int cddb_get_server_port(const cddb_conn_t *c);

void cddb_set_server_port(cddb_conn_t *c, int port);

unsigned int cddb_get_timeout(const cddb_conn_t *c);

void cddb_set_timeout(cddb_conn_t *c, unsigned int t);

const char *cddb_get_http_path_query(const cddb_conn_t *c);

void cddb_set_http_path_query(cddb_conn_t *c, const char *path);

const char *cddb_get_http_path_submit(const cddb_conn_t *c);

void cddb_set_http_path_submit(cddb_conn_t *c, const char *path);

unsigned int cddb_is_http_enabled(const cddb_conn_t *c);

void cddb_http_enable(cddb_conn_t *c);

void cddb_http_disable(cddb_conn_t *c);

unsigned int cddb_is_http_proxy_enabled(const cddb_conn_t *c);

void cddb_http_proxy_enable(cddb_conn_t *c);

void cddb_http_proxy_disable(cddb_conn_t *c);

const char *cddb_get_http_proxy_server_name(const cddb_conn_t *c);

void cddb_set_http_proxy_server_name(cddb_conn_t *c, const char *server);

unsigned int cddb_get_http_proxy_server_port(const cddb_conn_t *c);

void cddb_set_http_proxy_server_port(cddb_conn_t *c, int port);

void cddb_set_http_proxy_username(cddb_conn_t* c, const char* username);

const char *cddb_get_http_proxy_username(const cddb_conn_t *c);

void cddb_set_http_proxy_password(cddb_conn_t* c, const char* passwd);

const char *cddb_get_http_proxy_password(const cddb_conn_t *c);

void cddb_set_http_proxy_credentials(cddb_conn_t* c,
                                     const char *username, const char* passwd);

cddb_error_t cddb_errno(const cddb_conn_t *c);

void cddb_set_client(cddb_conn_t *c, const char *cname, const char *cversion);

int cddb_set_email_address(cddb_conn_t *c, const char *email);

cddb_cache_mode_t cddb_cache_mode(const cddb_conn_t *c);

void cddb_cache_enable(cddb_conn_t *c);

void cddb_cache_only(cddb_conn_t *c);

void cddb_cache_disable(cddb_conn_t *c);

const char *cddb_cache_get_dir(const cddb_conn_t *c);

int cddb_cache_set_dir(cddb_conn_t *c, const char *dir);

const cddb_site_t *cddb_first_site(cddb_conn_t *c);

const cddb_site_t *cddb_next_site(cddb_conn_t *c);

void cddb_search_set_fields(cddb_conn_t *c, unsigned int fields);

void cddb_search_set_categories(cddb_conn_t *c, unsigned int cats);


#ifdef __cplusplus
    }
#endif

#endif /* CDDB_CONN_H */

---