Sophie

Sophie

distrib > * > cooker > x86_64 > by-pkgid > 8092ed20821fac5ed4b1a593fb4ef021 > files > 27

lib64cddb-devel-1.3.2-5.x86_64.rpm

<!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_cmd.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&nbsp;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&nbsp;List</span></a></li>
    <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
  </ul></div>
<div class="nav">
<a class="el" href="dir_d95480e064f2cd25d4e283edd80a73aa.html">include</a>&nbsp;&raquo&nbsp;<a class="el" href="dir_847afe0584ab2be2f35afc524ae78865.html">cddb</a></div>
<h1>cddb_cmd.h File Reference</h1>
<p>
<a href="cddb__cmd_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&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#32b13bc98dd79fba36f36d908d88a837">CDDB_CMD_H</a>&nbsp;&nbsp;&nbsp;1</td></tr>

<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#9920c2ce0ebca2a943f3fe28049b5618">cddb_read</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Retrieve a disc record from the CDDB server.  <a href="#9920c2ce0ebca2a943f3fe28049b5618"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#3be764c9073b53160ed6560d5c25fe03">cddb_query</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Query the CDDB database for a list of possible disc matches.  <a href="#3be764c9073b53160ed6560d5c25fe03"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#0db3f96efbb125a5ebc11f2074431be5">cddb_query_next</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the next match in a CDDB query result set.  <a href="#0db3f96efbb125a5ebc11f2074431be5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#68e5f0a66815266245121aba7e82686e">cddb_search</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *str)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Perform a text search in the CDDB database.  <a href="#68e5f0a66815266245121aba7e82686e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#a648bcb583dae3e108a38bb514c24799">cddb_search_next</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the next match in a CDDB search result set.  <a href="#a648bcb583dae3e108a38bb514c24799"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#67a9d7df02df5191973eb7b0d97439df">cddb_album</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Perform a text search in the CDDB database.  <a href="#67a9d7df02df5191973eb7b0d97439df"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#6ccfa474b4fb202d51f5f4f3c62a4286">cddb_album_next</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the next match in a CDDB album result set.  <a href="#6ccfa474b4fb202d51f5f4f3c62a4286"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#0626f6b43a318f4102d6b6268abf52da">cddb_write</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Submit a new or updated disc to the CDDB database.  <a href="#0626f6b43a318f4102d6b6268abf52da"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__cmd_8h.html#709293423e9a376d49518900db445e67">cddb_sites</a> (<a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *c)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Query the currently configured server for a list of mirrors.  <a href="#709293423e9a376d49518900db445e67"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="32b13bc98dd79fba36f36d908d88a837"></a><!-- doxytag: member="cddb_cmd.h::CDDB_CMD_H" ref="32b13bc98dd79fba36f36d908d88a837" 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_CMD_H&nbsp;&nbsp;&nbsp;1          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="67a9d7df02df5191973eb7b0d97439df"></a><!-- doxytag: member="cddb_cmd.h::cddb_album" ref="67a9d7df02df5191973eb7b0d97439df" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_album           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Perform a text search in the CDDB database. 
<p>
It uses the album command implemented on the freedb2.org servers. Either the album title or artist's name should be filled in, in the disc structure.<p>
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 <a class="el" href="cddb__cmd_8h.html#6ccfa474b4fb202d51f5f4f3c62a4286">cddb_album_next</a> function.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of matches found or -1 on error. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="6ccfa474b4fb202d51f5f4f3c62a4286"></a><!-- doxytag: member="cddb_cmd.h::cddb_album_next" ref="6ccfa474b4fb202d51f5f4f3c62a4286" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_album_next           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Returns the next match in a CDDB album result set. 
<p>
This function should be used in conjunction with <a class="el" href="cddb__cmd_8h.html#67a9d7df02df5191973eb7b0d97439df">cddb_album</a>.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="3be764c9073b53160ed6560d5c25fe03"></a><!-- doxytag: member="cddb_cmd.h::cddb_query" ref="3be764c9073b53160ed6560d5c25fe03" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_query           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Query the CDDB database for a list of possible disc matches. 
<p>
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.<p>
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 <a class="el" href="cddb__cmd_8h.html#0db3f96efbb125a5ebc11f2074431be5">cddb_query_next</a> function.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of matches found or -1 on error. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="0db3f96efbb125a5ebc11f2074431be5"></a><!-- doxytag: member="cddb_cmd.h::cddb_query_next" ref="0db3f96efbb125a5ebc11f2074431be5" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_query_next           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Returns the next match in a CDDB query result set. 
<p>
This function should be used in conjunction with <a class="el" href="cddb__cmd_8h.html#3be764c9073b53160ed6560d5c25fe03">cddb_query</a>.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="9920c2ce0ebca2a943f3fe28049b5618"></a><!-- doxytag: member="cddb_cmd.h::cddb_read" ref="9920c2ce0ebca2a943f3fe28049b5618" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_read           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Retrieve a disc record from the CDDB server. 
<p>
This function requires that the category and disc ID of the provided disc structure are valid.<p>
If nothing goes wrong, the function will return 1 and the error code will be reset to:<ul>
<li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddbaa2cee0f4bdeea3a9149a09fe09505a4">CDDB_ERR_OK</a>: If everything went as planned.</li></ul>
<p>
If there is a problem with reading data from the CDDB server one of the following error codes will be set:<ul>
<li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddbc2cf772f62dd7e76a5333005359d0f02">CDDB_ERR_DATA_MISSING</a>: If some required data is missing from the given disc structure to execute this command.</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb7566874168706cdb256436c590112324">CDDB_ERR_DISC_NOT_FOUND</a>: If the requested disc is not known by the CDDB server.</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb3d8e15370b45caa58c30e72098dfa5b1">CDDB_ERR_SERVER_ERROR</a>: If the server encountered an error while trying to process your request.</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb9b44486ce39f7ab594390ccf0caf583f">CDDB_ERR_UNKNOWN</a>: If the server specified an unknown response code. Please report this as a libcddb bug.</li></ul>
<p>
When there are problems with the connection to the CDDB server one of the following error codes will be set:<ul>
<li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb75b90433f9528e8f0601c6fdccef45cd">CDDB_ERR_UNKNOWN_HOST_NAME</a>: If there was an error when resolving the host name of the CDDB server.</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb6a7a7203c0454b68972edd7392fb92d2">CDDB_ERR_CONNECT</a>: 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).</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb6c620418196319f2ac73f90b5c346cb5">CDDB_ERR_NOT_CONNECTED</a>: If something when wrong in the process and you got disconnected. Retrying might succeed (but no guarantees).</li><li><a class="el" href="cddb__error_8h.html#b8f3141dff6945177d70de613eff6ddb1e84e2930827641ade88a04a3ba09e6d">CDDB_ERR_PERMISSION_DENIED</a>: 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.</li></ul>
<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>1 on succes, 0 on failure </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="68e5f0a66815266245121aba7e82686e"></a><!-- doxytag: member="cddb_cmd.h::cddb_search" ref="68e5f0a66815266245121aba7e82686e" args="(cddb_conn_t *c, cddb_disc_t *disc, const char *str)" --><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_search           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>str</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Perform a text search in the CDDB database. 
<p>
Instead of actually needing information about a real disc like in <a class="el" href="cddb__cmd_8h.html#3be764c9073b53160ed6560d5c25fe03">cddb_query</a> this function accept a string that is used for searching the database.<p>
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 <a class="el" href="cddb__cmd_8h.html#a648bcb583dae3e108a38bb514c24799">cddb_search_next</a> function.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>str</em>&nbsp;</td><td>The search string</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of matches found or -1 on error. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="a648bcb583dae3e108a38bb514c24799"></a><!-- doxytag: member="cddb_cmd.h::cddb_search_next" ref="a648bcb583dae3e108a38bb514c24799" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_search_next           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Returns the next match in a CDDB search result set. 
<p>
This function should be used in conjunction with <a class="el" href="cddb__cmd_8h.html#68e5f0a66815266245121aba7e82686e">cddb_search</a>.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="709293423e9a376d49518900db445e67"></a><!-- doxytag: member="cddb_cmd.h::cddb_sites" ref="709293423e9a376d49518900db445e67" 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">int cddb_sites           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>c</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Query the currently configured server for a list of mirrors. 
<p>
Accessing the list of mirror sites is done with the iterator functions <a class="el" href="cddb__conn_8h.html#a567bd00e3102515bc48a7f8e2e1aadc">cddb_first_site</a> and <a class="el" href="cddb__conn_8h.html#10422062fb1bf7b1b34a17e6790dd38e">cddb_next_site</a>.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="0626f6b43a318f4102d6b6268abf52da"></a><!-- doxytag: member="cddb_cmd.h::cddb_write" ref="0626f6b43a318f4102d6b6268abf52da" args="(cddb_conn_t *c, cddb_disc_t *disc)" --><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_write           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="cddb__conn_8h.html#56aabb81a12e2653f737f1fde87285d9">cddb_conn_t</a> *&nbsp;</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><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>disc</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Submit a new or updated disc to the CDDB database. 
<p>
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.<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>&nbsp;</td><td>The CDDB connection structure. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>disc</em>&nbsp;</td><td>A non-null CDDB disc structure. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Sun Oct 15 14:49:14 2006 for libcddb by&nbsp;
<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>