Data Structures | Typedefs | Functions

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:
respAn 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:
responsesA GList of PurpleTxtResponse objects.
dataThe 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_dataThe 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:
protocolName of the protocol (e.g. "sip")
transportName of the transport ("tcp" or "udp")
domainDomain name to query (e.g. "blubb.com")
cbA callback which will be called with the results
extradataExtra data to be passed to the callback
void purple_txt_cancel ( PurpleSrvQueryData *  query_data )

Cancel an TXT DNS query.

Parameters:
query_dataThe 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:
ownerName of the protocol (e.g. "_xmppconnect")
domainDomain name to query (e.g. "blubb.com")
cbA callback which will be called with the results
extradataExtra 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:
responseThe 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:
responseThe TXT response record
Returns:
The value of the current TXT record.
Since:
2.6.0