00001 /* libmpdclient 00002 (c) 2003-2010 The Music Player Daemon Project 00003 This project's homepage is: http://www.musicpd.org 00004 00005 Redistribution and use in source and binary forms, with or without 00006 modification, are permitted provided that the following conditions 00007 are met: 00008 00009 - Redistributions of source code must retain the above copyright 00010 notice, this list of conditions and the following disclaimer. 00011 00012 - Redistributions in binary form must reproduce the above copyright 00013 notice, this list of conditions and the following disclaimer in the 00014 documentation and/or other materials provided with the distribution. 00015 00016 - Neither the name of the Music Player Daemon nor the names of its 00017 contributors may be used to endorse or promote products derived from 00018 this software without specific prior written permission. 00019 00020 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00021 ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00022 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00023 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR 00024 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 00025 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 00026 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 00027 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 00028 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 00029 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 00030 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00031 */ 00032 00039 #ifndef MPD_CONNECTION_H 00040 #define MPD_CONNECTION_H 00041 00042 #include <mpd/protocol.h> 00043 #include <mpd/error.h> 00044 #include <mpd/compiler.h> 00045 00046 #include <stdbool.h> 00047 00048 struct mpd_async; 00049 00072 struct mpd_connection; 00073 00074 #ifdef __cplusplus 00075 extern "C" { 00076 #endif 00077 00099 mpd_malloc 00100 struct mpd_connection * 00101 mpd_connection_new(const char *host, unsigned port, unsigned timeout_ms); 00102 00116 mpd_malloc 00117 struct mpd_connection * 00118 mpd_connection_new_async(struct mpd_async *async, const char *welcome); 00119 00125 void mpd_connection_free(struct mpd_connection *connection); 00126 00139 void mpd_connection_set_timeout(struct mpd_connection *connection, 00140 unsigned timeout_ms); 00141 00148 mpd_pure 00149 int 00150 mpd_connection_get_fd(const struct mpd_connection *connection); 00151 00161 mpd_pure 00162 struct mpd_async * 00163 mpd_connection_get_async(struct mpd_connection *connection); 00164 00169 mpd_pure 00170 enum mpd_error 00171 mpd_connection_get_error(const struct mpd_connection *connection); 00172 00183 mpd_pure 00184 const char * 00185 mpd_connection_get_error_message(const struct mpd_connection *connection); 00186 00192 mpd_pure 00193 enum mpd_server_error 00194 mpd_connection_get_server_error(const struct mpd_connection *connection); 00195 00203 mpd_pure 00204 int 00205 mpd_connection_get_system_error(const struct mpd_connection *connection); 00206 00215 bool 00216 mpd_connection_clear_error(struct mpd_connection *connection); 00217 00222 mpd_pure 00223 const unsigned * 00224 mpd_connection_get_server_version(const struct mpd_connection *connection); 00225 00232 mpd_pure 00233 int 00234 mpd_connection_cmp_server_version(const struct mpd_connection *connection, 00235 unsigned major, unsigned minor, 00236 unsigned patch); 00237 00238 #ifdef __cplusplus 00239 } 00240 #endif 00241 00242 #endif