libmpdclient
2.7
|
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 00131 const struct mpd_settings * 00132 mpd_connection_get_settings(const struct mpd_connection *connection); 00133 00146 void mpd_connection_set_timeout(struct mpd_connection *connection, 00147 unsigned timeout_ms); 00148 00155 mpd_pure 00156 int 00157 mpd_connection_get_fd(const struct mpd_connection *connection); 00158 00168 mpd_pure 00169 struct mpd_async * 00170 mpd_connection_get_async(struct mpd_connection *connection); 00171 00176 mpd_pure 00177 enum mpd_error 00178 mpd_connection_get_error(const struct mpd_connection *connection); 00179 00190 mpd_pure 00191 const char * 00192 mpd_connection_get_error_message(const struct mpd_connection *connection); 00193 00199 mpd_pure 00200 enum mpd_server_error 00201 mpd_connection_get_server_error(const struct mpd_connection *connection); 00202 00209 mpd_pure 00210 unsigned 00211 mpd_connection_get_server_error_location(const struct mpd_connection *connection); 00212 00220 mpd_pure 00221 int 00222 mpd_connection_get_system_error(const struct mpd_connection *connection); 00223 00232 bool 00233 mpd_connection_clear_error(struct mpd_connection *connection); 00234 00239 mpd_pure 00240 const unsigned * 00241 mpd_connection_get_server_version(const struct mpd_connection *connection); 00242 00249 mpd_pure 00250 int 00251 mpd_connection_cmp_server_version(const struct mpd_connection *connection, 00252 unsigned major, unsigned minor, 00253 unsigned patch); 00254 00255 #ifdef __cplusplus 00256 } 00257 #endif 00258 00259 #endif