![]() |
![]() |
![]() |
libsoup Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
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 |