| libsoup Reference Manual | ||||
|---|---|---|---|---|
void soup_dns_init (void); char* soup_dns_ntop (struct sockaddr *sa); typedef SoupDNSLookup; SoupDNSLookup* soup_dns_lookup_name (const char *name); SoupDNSLookup* soup_dns_lookup_address (struct sockaddr *sockaddr); gboolean soup_dns_lookup_resolve (SoupDNSLookup *lookup); void (*SoupDNSCallback) (SoupDNSLookup *lookup, gboolean success, gpointer user_data); void soup_dns_lookup_resolve_async (SoupDNSLookup *lookup, GMainContext *async_context, SoupDNSCallback callback, gpointer user_data); void soup_dns_lookup_cancel (SoupDNSLookup *lookup); char* soup_dns_lookup_get_hostname (SoupDNSLookup *lookup); struct sockaddr* soup_dns_lookup_get_address (SoupDNSLookup *lookup); void soup_dns_lookup_free (SoupDNSLookup *lookup);
void soup_dns_init (void);
Initializes the libsoup DNS system. Must be called before any other soup_dns method is called. Normally this gets called automatically by SoupAddress's class_init function.
char* soup_dns_ntop (struct sockaddr *sa);
Converts sa's address into textual form (eg, "141.213.8.59"), like
the standard library function inet_ntop(), except that the returned
string must be freed.
|
pointer to a sockaddr |
Returns : |
the text form or sa, which must be freed.
|
typedef struct SoupDNSLookup SoupDNSLookup;
An opaque type that represents a DNS lookup operation.
SoupDNSLookup* soup_dns_lookup_name (const char *name);
Creates a SoupDNSLookup for name. This should be passed to
soup_dns_lookup_resolve() or soup_dns_lookup_resolve_async().
|
a hostname (eg, "www.gnome.org") or physical address (eg, "12.107.209.247"). |
Returns : |
a SoupDNSLookup, which should eventually be freed with
soup_dns_lookup_free().
|
SoupDNSLookup* soup_dns_lookup_address (struct sockaddr *sockaddr);
Creates a SoupDNSLookup for sockaddr. This should be passed to
soup_dns_lookup_resolve() or soup_dns_lookup_resolve_async().
|
pointer to a sockaddr |
Returns : |
a SoupDNSLookup, which should eventually be freed with
soup_dns_lookup_free()
|
gboolean soup_dns_lookup_resolve (SoupDNSLookup *lookup);
Synchronously resolves lookup. You can cancel a pending resolution
using soup_dns_lookup_cancel().
|
a SoupDNSLookup |
Returns : |
success or failure. |
void (*SoupDNSCallback) (SoupDNSLookup *lookup, gboolean success, gpointer user_data);
The callback function passed to soup_dns_lookup_resolve_async().
|
the completed lookup |
|
TRUE if lookup completed successfully, FALSE if it failed
|
|
the data passed to soup_dns_lookup_resolve_async()
|
void soup_dns_lookup_resolve_async (SoupDNSLookup *lookup, GMainContext *async_context, SoupDNSCallback callback, gpointer user_data);
Tries to asynchronously resolve lookup. Invokes callback when it
has succeeded or failed. You can cancel a pending resolution using
soup_dns_lookup_cancel().
|
a SoupDNSLookup |
|
GMainContext to call callback in
|
|
callback to call when lookup is resolved
|
|
data to pass to callback;
|
void soup_dns_lookup_cancel (SoupDNSLookup *lookup);
Cancels lookup. If lookup was running synchronously in another
thread, it will immediately return FALSE. If lookup was running
asynchronously, its callback function will not be called.
|
a SoupDNSLookup |
char* soup_dns_lookup_get_hostname (SoupDNSLookup *lookup);
Gets the hostname of lookup.
|
a SoupDNSLookup |
Returns : |
the hostname, which the caller owns and must free, or
NULL if lookup has not been completely resolved.
|
struct sockaddr* soup_dns_lookup_get_address (SoupDNSLookup *lookup);
Gets the address of lookup.
|
a SoupDNSLookup |
Returns : |
the address, which the caller owns and must free, or
NULL if lookup has not been completely resolved.
|
void soup_dns_lookup_free (SoupDNSLookup *lookup);
Frees lookup. If lookup is still running, it will be canceled
first.
|
a SoupDNSLookup |