dnssrv.h File Reference

#include <glib.h>

Include dependency graph for dnssrv.h:

This graph shows which files directly or indirectly include this file:

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