mpd/database.h File Reference
Database.
More...
Go to the source code of this file.
Detailed Description
Database.
This file declares functions which query or update MPD's music database.
Do not include this header directly. Use mpd/client.h instead.
Definition in file database.h.
Function Documentation
Receives the id the of the update job which was submitted by mpd_send_update().
- Parameters:
-
| connection | the connection to MPD |
- Returns:
- a positive job id on success, 0 on error
unsigned mpd_run_rescan |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Like mpd_run_update(), but also rescans unmodified files.
- Parameters:
-
| connection | the connection to MPD |
| path | optional path to update; if NULL, then all of the music directory is updated |
- Returns:
- a positive job id on success, 0 on error
unsigned mpd_run_update |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Shortcut for mpd_send_update() and mpd_recv_update_id().
- Parameters:
-
| connection | the connection to MPD |
| path | optional path to update; if NULL, then all of the music directory is updated |
- Returns:
- a positive job id on success, 0 on error
bool mpd_send_list_all |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Get a recursive list of all directories, songs and playlist from MPD. They are returned without metadata. This is a rather expensive operation, because the response may be large.
- Parameters:
-
| connection | the connection to MPD |
| path | an optional base path for the query |
- Returns:
- true on success, false on error
bool mpd_send_list_all_meta |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Like mpd_send_list_all(), but return metadata. This operation is even more expensive, because the response is larger. If it is larger than a configurable server-side limit, MPD may disconnect you.
To read the response, you may use mpd_recv_entity().
- Parameters:
-
| connection | the connection to MPD |
| path | an optional base path for the query |
- Returns:
- true on success, false on error
bool mpd_send_list_meta |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Get a list of all directories, songs and playlist in a directory from MPD, including metadata.
To read the response, you may use mpd_recv_entity().
- Parameters:
-
| connection | the connection to MPD |
| path | the directory to be listed |
- Returns:
- true on success, false on error
bool mpd_send_rescan |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Like mpd_send_update(), but also rescans unmodified files.
- Parameters:
-
| connection | the connection to MPD |
| path | optional path to update; if NULL, then all of the music directory is updated |
- Returns:
- true on success, false on error
bool mpd_send_update |
( |
struct mpd_connection * |
connection, |
|
|
const char * |
path | |
|
) |
| | |
Instructs MPD to update the music database: find new files, remove deleted files, update modified files.
- Parameters:
-
| connection | the connection to MPD |
| path | optional path to update; if NULL, then all of the music directory is updated |
- Returns:
- true on success, false on error