dnssrv.h File Reference

#include <glib.h>

Go to the source code of this file.

Data Structures
struct	_PurpleSrvResponse
Typedefs
typedef struct _PurpleSrvQueryData	PurpleSrvQueryData
typedef struct _PurpleSrvResponse	PurpleSrvResponse
typedef struct _PurpleTxtResponse	PurpleTxtResponse
typedef void(*	PurpleSrvCallback )(PurpleSrvResponse *resp, int results, gpointer data)
typedef void(*	PurpleTxtCallback )(GList *responses, gpointer data)
	Callback that returns the data retrieved from a DNS TXT lookup.
Functions
PurpleSrvQueryData *	purple_srv_resolve (const char *protocol, const char *transport, const char *domain, PurpleSrvCallback cb, gpointer extradata)
	Queries an SRV record.
void	purple_srv_cancel (PurpleSrvQueryData *query_data)
	Cancel an SRV DNS query.
PurpleSrvQueryData *	purple_txt_resolve (const char *owner, const char *domain, PurpleTxtCallback cb, gpointer extradata)
	Queries an TXT record.
void	purple_txt_cancel (PurpleSrvQueryData *query_data)
	Cancel an TXT DNS query.
const gchar *	purple_txt_response_get_content (PurpleTxtResponse *response)
	Get the value of the current TXT record.
void	purple_txt_response_destroy (PurpleTxtResponse *response)
	Destroy a TXT DNS response object.

---

Detailed Description

Definition in file dnssrv.h.

---

Typedef Documentation

typedef void(* PurpleSrvCallback)(PurpleSrvResponse *resp, int results, gpointer data)

Parameters:

resp

An array of PurpleSrvResponse of size results. The array is sorted based on the order described in the DNS SRV RFC. Users of this API should try each record in resp in order, starting at the beginning.

Definition at line 50 of file dnssrv.h.

typedef void(* PurpleTxtCallback)(GList *responses, gpointer data)

Callback that returns the data retrieved from a DNS TXT lookup.

Parameters:

	responses	A GList of PurpleTxtResponse objects.
	data	The extra data passed to purple_txt_resolve.

Definition at line 58 of file dnssrv.h.

---

Function Documentation

void purple_srv_cancel

(

PurpleSrvQueryData *

query_data

)

Cancel an SRV DNS query.

Parameters:

query_data

The request to cancel.

PurpleSrvQueryData* purple_srv_resolve	(	const char *	protocol,
		const char *	transport,
		const char *	domain,
		PurpleSrvCallback	cb,
		gpointer	extradata
	)

Queries an SRV record.

Parameters:

	protocol	Name of the protocol (e.g. "sip")
	transport	Name of the transport ("tcp" or "udp")
	domain	Domain name to query (e.g. "blubb.com")
	cb	A callback which will be called with the results
	extradata	Extra data to be passed to the callback

void purple_txt_cancel

(

PurpleSrvQueryData *

query_data

)

Cancel an TXT DNS query.

Parameters:

query_data

The request to cancel.

Since:

2.6.0

PurpleSrvQueryData* purple_txt_resolve	(	const char *	owner,
		const char *	domain,
		PurpleTxtCallback	cb,
		gpointer	extradata
	)

Queries an TXT record.

Parameters:

	owner	Name of the protocol (e.g. "_xmppconnect")
	domain	Domain name to query (e.g. "blubb.com")
	cb	A callback which will be called with the results
	extradata	Extra data to be passed to the callback

Since:

2.6.0

void purple_txt_response_destroy

(

PurpleTxtResponse *

response

)

Destroy a TXT DNS response object.

Parameters:

response

The PurpleTxtResponse to destroy.

Since:

2.6.0

const gchar* purple_txt_response_get_content

(

PurpleTxtResponse *

response

)

Get the value of the current TXT record.

Parameters:

response

The TXT response record

Returns:

The value of the current TXT record.

Since:

2.6.0