Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Gio.Resolver

Class Gio.Resolver

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GResolver
Class :	Resolver
Extends:	GObject.Object

GResolver provides cancellable synchronous and asynchronous DNS
resolution, for hostnames (g_resolver_lookup_by_address(),
g_resolver_lookup_by_name() and their async variants) and SRV
(service) records (g_resolver_lookup_service()).
GNetworkAddress and GNetworkService provide wrappers around
GResolver functionality that also implement GSocketConnectable,
making it easy to connect to a remote host/service.

Properties
Properties		Defined By
	parent_instance : GObject.Object read only	Gio.Resolver
	priv : Gio.ResolverPrivate read only	Gio.Resolver

Methods / Constructors
Method / Constructor		Defined By
	new Gio.Resolver (Object *properties) Create a new Gio.Resolver Create a new Gio.Resolver Parameters: Object properties*
	Gio.Resolver.get_default () : Gio.Resolver Gets the default GResolver. Gets the default GResolver. You should unref it when you are done with it. GResolver may use its reference count as a hint about how many threads/processes, etc it should allocate for concurrent DNS resolutions. Returns: Gio.Resolver the default GResolver.	Gio.Resolver
	lookup_by_address (InetAddress *address, Cancellable cancellable) : String Synchronously reverse-resolves address* to determine its associated hostname. Synchronously reverse-resolves address to determine its associated hostname. If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError. If cancellable is non-NULL, it can be used to cancel the operation, in which case error (if non-NULL) will be set to G_IO_ERROR_CANCELLED. form), or NULL on error. Parameters: Gio.InetAddress address Required (not null) the address to reverse-resolve Gio.Cancellable cancellable a GCancellable, or NULL Returns: String a hostname (either ASCII-only, or in ASCII-encoded	Gio.Resolver
	lookup_by_address_async (InetAddress *address, Cancellable cancellable, Function callback, void *user_data) : none Begins asynchronously reverse-resolving address* to determine its associated hostname, and eventually calls callback, which must call g_resolver_lookup_by_address_finish() to get the final result. Begins asynchronously reverse-resolving address to determine its associated hostname, and eventually calls callback, which must call g_resolver_lookup_by_address_finish() to get the final result. Parameters: Gio.InetAddress address Required (not null) the address to reverse-resolve Gio.Cancellable cancellable a GCancellable, or NULL Function (Object *source_object, AsyncResult res, void *user_data) : none Required (not null) callback to call after resolution completes void user_data Required (not null) data for callback Returns: none	Gio.Resolver
	lookup_by_address_finish (AsyncResult *result) : String Retrieves the result of a previous call to g_resolver_lookup_by_address_async(). Retrieves the result of a previous call to g_resolver_lookup_by_address_async(). If the DNS resolution failed, error* (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, form), or NULL on error. Parameters: Gio.AsyncResult result Required (not null) the result passed to your GAsyncReadyCallback Returns: String a hostname (either ASCII-only, or in ASCII-encoded	Gio.Resolver
	lookup_by_name (String *hostname, Cancellable cancellable) : Array Synchronously resolves hostname* to determine its associated IP address(es). Synchronously resolves hostname to determine its associated IP address(es). hostname may be an ASCII-only or UTF-8 hostname, or the textual form of an IP address (in which case this just becomes a wrapper around g_inet_address_new_from_string()). On success, g_resolver_lookup_by_name() will return a GList of GInetAddress, sorted in order of preference. (That is, you should attempt to connect to the first address first, then the second if the first fails, etc.) If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError. If cancellable is non-NULL, it can be used to cancel the operation, in which case error (if non-NULL) will be set to G_IO_ERROR_CANCELLED. If you are planning to connect to a socket on the resolved IP address, it may be easier to create a GNetworkAddress and use its GSocketConnectable interface. of GInetAddress, or NULL on error. You must unref each of the addresses and free the list when you are done with it. (You can use g_resolver_free_addresses() to do this.) Parameters: String hostname Required (not null) the hostname to look up Gio.Cancellable cancellable a GCancellable, or NULL Returns: Array a GList	Gio.Resolver
	lookup_by_name_async (String *hostname, Cancellable cancellable, Function callback, void *user_data) : none Begins asynchronously resolving hostname* to determine its associated IP address(es), and eventually calls callback, which must call g_resolver_lookup_by_name_finish() to get the result. Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls callback, which must call g_resolver_lookup_by_name_finish() to get the result. See g_resolver_lookup_by_name() for more details. Parameters: String hostname Required (not null) the hostname to look up the address of Gio.Cancellable cancellable a GCancellable, or NULL Function (Object *source_object, AsyncResult res, void *user_data) : none Required (not null) callback to call after resolution completes void user_data Required (not null) data for callback Returns: none	Gio.Resolver
	lookup_by_name_finish (AsyncResult *result) : Array Retrieves the result of a call to g_resolver_lookup_by_name_async(). Retrieves the result of a call to g_resolver_lookup_by_name_async(). If the DNS resolution failed, error* (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, of GInetAddress, or NULL on error. See g_resolver_lookup_by_name() for more details. Parameters: Gio.AsyncResult result Required (not null) the result passed to your GAsyncReadyCallback Returns: Array a GList	Gio.Resolver
	lookup_service (String *service, String protocol, String domain, Cancellable cancellable) : Array Synchronously performs a DNS SRV lookup for the given service* and include the leading underscore that appears in the actual DNS entry. Synchronously performs a DNS SRV lookup for the given service and include the leading underscore that appears in the actual DNS entry. On success, g_resolver_lookup_service() will return a GList of GSrvTarget, sorted in order of preference. (That is, you should attempt to connect to the first target first, then the second if the first fails, etc.) If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError. If cancellable is non-NULL, it can be used to cancel the operation, in which case error (if non-NULL) will be set to G_IO_ERROR_CANCELLED. If you are planning to connect to the service, it is usually easier to create a GNetworkService and use its GSocketConnectable interface. or NULL on error. You must free each of the targets and the list when you are done with it. (You can use g_resolver_free_targets() to do this.) Parameters: String service Required (not null) the service type to look up (eg, "ldap") String protocol Required (not null) the networking protocol to use for service (eg, "tcp") String domain Required (not null) the DNS domain to look up the service in Gio.Cancellable cancellable a GCancellable, or NULL Returns: Array a GList of GSrvTarget,	Gio.Resolver
	lookup_service_async (String *service, String protocol, String domain, Cancellable cancellable, Function callback, void *user_data) : none Begins asynchronously performing a DNS SRV lookup for the given get the final result. Begins asynchronously performing a DNS SRV lookup for the given get the final result. See g_resolver_lookup_service() for more details. Parameters: String service* Required (not null) the service type to look up (eg, "ldap") String protocol Required (not null) the networking protocol to use for service (eg, "tcp") String domain Required (not null) the DNS domain to look up the service in Gio.Cancellable cancellable a GCancellable, or NULL Function (Object *source_object, AsyncResult res, void *user_data) : none Required (not null) callback to call after resolution completes void user_data Required (not null) data for callback Returns: none	Gio.Resolver
	lookup_service_finish (AsyncResult *result) : Array Retrieves the result of a previous call to g_resolver_lookup_service_async(). Retrieves the result of a previous call to g_resolver_lookup_service_async(). If the DNS resolution failed, error* (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, or NULL on error. See g_resolver_lookup_service() for more details. Parameters: Gio.AsyncResult result Required (not null) the result passed to your GAsyncReadyCallback Returns: Array a GList of GSrvTarget,	Gio.Resolver
	set_default () : none Sets resolver to be the application's default resolver (reffing Future calls to g_resolver_get_default() will return this resolver. Sets resolver to be the application's default resolver (reffing Future calls to g_resolver_get_default() will return this resolver. This can be used if an application wants to perform any sort of DNS caching or "pinning"; it can implement its own GResolver that calls the original default resolver for DNS operations, and implements its own cache policies on top of that, and then set itself as the default resolver for all later code to use. Returns: none	Gio.Resolver

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	reload (Resolver *self) : none Emitted when the resolver notices that the system resolver configuration has changed. Emitted when the resolver notices that the system resolver configuration has changed. Parameters: Gio.Resolver self* Returns: {none}	Gio.Resolver