Main Page | Class List | Directories | File List | Class Members | File Members

cddb_cmd.h File Reference

Go to the source code of this file.

Defines

#define CDDB_CMD_H   1

Functions

int cddb_read (cddb_conn_t *c, cddb_disc_t *disc)
 Retrieve a disc record from the CDDB server.
int cddb_query (cddb_conn_t *c, cddb_disc_t *disc)
 Query the CDDB database for a list of possible disc matches.
int cddb_query_next (cddb_conn_t *c, cddb_disc_t *disc)
 Returns the next match in a CDDB query result set.
int cddb_write (cddb_conn_t *c, cddb_disc_t *disc)
 Submit a new or updated disc to the CDDB database.


Define Documentation

#define CDDB_CMD_H   1
 


Function Documentation

int cddb_query cddb_conn_t c,
cddb_disc_t disc
 

Query the CDDB database for a list of possible disc matches.

This function requires that the disc ID and disc length of the provided disc structure are valid. The disc should also contain a number of tracks and for each track its frame offset on the CD should be valid.

If there are multiple matches then only the first one will be returned by this function. For other matches you will have to use the cddb_query_next function.

See also:
cddb_query_next
Parameters:
c The CDDB connection structure.
disc A non-null CDDB disc structure.
Returns:
The number of matches found or -1 on error.

int cddb_query_next cddb_conn_t c,
cddb_disc_t disc
 

Returns the next match in a CDDB query result set.

This function should be used in conjunction with cddb_query.

See also:
cddb_query
Parameters:
c The CDDB connection structure.
disc A non-null CDDB disc structure.

int cddb_read cddb_conn_t c,
cddb_disc_t disc
 

Retrieve a disc record from the CDDB server.

This function requires that the category and disc ID of the provided disc structure are valid.

If nothing goes wrong, the function will return 1 and the error code will be reset to:

If there is a problem with reading data from the CDDB server one of the following error codes will be set:

When there are problems with the connection to the CDDB server one of the following error codes will be set:

  • CDDB_ERR_UNKNOWN_HOST_NAME: If there was an error when resolving the host name of the CDDB server.
  • CDDB_ERR_CONNECT: If a connection to the CDDB server could not be established. This can be due to incorrect data about the location of the server (host name, port).
  • CDDB_ERR_NOT_CONNECTED: If something when wrong in the process and you got disconnected. Retrying might succeed (but no guarantees).
  • CDDB_ERR_PERMISSION_DENIED: If the server is up and running but denied the connection. This can occur when the server is too highly loaded or the handshake information (user name, ...) is considered to be invalid.

Parameters:
c The CDDB connection structure.
disc A non-null CDDB disc structure.
Returns:
1 on succes, 0 on failure

int cddb_write cddb_conn_t c,
cddb_disc_t disc
 

Submit a new or updated disc to the CDDB database.

This function requires that the disc ID, length, category, artist and title of the provided disc structure are valid. The disc should also contain a number of tracks and for each track its frame offset on the CD and title should be valid.

Parameters:
c The CDDB connection structure.
disc A non-null CDDB disc structure.


Generated on Thu Apr 21 21:02:15 2005 for libcddb by  doxygen 1.3.9.1