| |
1 /** |
| |
2 * @file dnssrv.h |
| |
3 * |
| |
4 * gaim |
| |
5 * |
| |
6 * Copyright (C) 2005, Thomas Butter <butter@uni-mannheim.de> |
| |
7 *i |
| |
8 * This program is free software; you can redistribute it and/or modify |
| |
9 * it under the terms of the GNU General Public License as published by |
| |
10 * the Free Software Foundation; either version 2 of the License, or |
| |
11 * (at your option) any later version. |
| |
12 * |
| |
13 * This program is distributed in the hope that it will be useful, |
| |
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| |
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| |
16 * GNU General Public License for more details. |
| |
17 * |
| |
18 * You should have received a copy of the GNU General Public License |
| |
19 * along with this program; if not, write to the Free Software |
| |
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| |
21 */ |
| |
22 |
| |
23 #ifndef _GAIM_DNSSRV_H |
| |
24 #define _GAIM_DNSSRV_H |
| |
25 |
| |
26 #ifdef __cplusplus |
| |
27 extern "C" { |
| |
28 #endif |
| |
29 |
| |
30 typedef struct _GaimSrvResponse GaimSrvResponse; |
| |
31 typedef struct _GaimSrvQueryData GaimSrvQueryData; |
| |
32 |
| |
33 struct _GaimSrvResponse { |
| |
34 char hostname[256]; |
| |
35 int port; |
| |
36 int weight; |
| |
37 int pref; |
| |
38 }; |
| |
39 |
| |
40 typedef void (*GaimSrvCallback)(GaimSrvResponse *resp, int results, gpointer data); |
| |
41 |
| |
42 /** |
| |
43 * Queries an SRV record. |
| |
44 * |
| |
45 * @param protocol Name of the protocol (e.g. "sip") |
| |
46 * @param transport Name of the transport ("tcp" or "udp") |
| |
47 * @param domain Domain name to query (e.g. "blubb.com") |
| |
48 * @param cb A callback which will be called with the results |
| |
49 * @param extradata Extra data to be passed to the callback |
| |
50 */ |
| |
51 GaimSrvQueryData *gaim_srv_resolve(const char *protocol, const char *transport, const char *domain, GaimSrvCallback cb, gpointer extradata); |
| |
52 |
| |
53 /** |
| |
54 * Cancel an SRV DNS query. |
| |
55 * |
| |
56 * @param query_data The request to cancel. |
| |
57 */ |
| |
58 void gaim_srv_cancel(GaimSrvQueryData *query_data); |
| |
59 |
| |
60 #ifdef __cplusplus |
| |
61 } |
| |
62 #endif |
| |
63 |
| |
64 #endif /* _GAIM_DNSSRV_H */ |