1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
3 /* GIO - GLib Input, Output and Streaming Library
5 * Copyright (C) 2008 Red Hat, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General
18 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
25 #include "gresolver.h"
26 #include "gnetworkingprivate.h"
27 #include "gasyncresult.h"
28 #include "ginetaddress.h"
29 #include "gsimpleasyncresult.h"
31 #include "gsrvtarget.h"
32 #include "gthreadedresolver.h"
43 * @short_description: Asynchronous and cancellable DNS resolver
46 * #GResolver provides cancellable synchronous and asynchronous DNS
47 * resolution, for hostnames (g_resolver_lookup_by_address(),
48 * g_resolver_lookup_by_name() and their async variants) and SRV
49 * (service) records (g_resolver_lookup_service()).
51 * #GNetworkAddress and #GNetworkService provide wrappers around
52 * #GResolver functionality that also implement #GSocketConnectable,
53 * making it easy to connect to a remote host/service.
61 static guint signals[LAST_SIGNAL] = { 0 };
63 struct _GResolverPrivate {
65 time_t resolv_conf_timestamp;
74 * The object that handles DNS resolution. Use g_resolver_get_default()
75 * to get the default resolver.
77 G_DEFINE_TYPE_WITH_CODE (GResolver, g_resolver, G_TYPE_OBJECT,
78 G_ADD_PRIVATE (GResolver)
79 g_networking_init ();)
82 srv_records_to_targets (GList *records)
84 const gchar *hostname;
85 guint16 port, priority, weight;
89 for (l = records; l != NULL; l = g_list_next (l))
91 g_variant_get (l->data, "(qqq&s)", &priority, &weight, &port, &hostname);
92 target = g_srv_target_new (hostname, port, priority, weight);
93 g_variant_unref (l->data);
97 return g_srv_target_list_sort (records);
101 g_resolver_real_lookup_service (GResolver *resolver,
103 GCancellable *cancellable,
108 records = G_RESOLVER_GET_CLASS (resolver)->lookup_records (resolver,
110 G_RESOLVER_RECORD_SRV,
114 return srv_records_to_targets (records);
118 g_resolver_real_lookup_service_async (GResolver *resolver,
120 GCancellable *cancellable,
121 GAsyncReadyCallback callback,
124 G_RESOLVER_GET_CLASS (resolver)->lookup_records_async (resolver,
126 G_RESOLVER_RECORD_SRV,
133 g_resolver_real_lookup_service_finish (GResolver *resolver,
134 GAsyncResult *result,
139 records = G_RESOLVER_GET_CLASS (resolver)->lookup_records_finish (resolver,
143 return srv_records_to_targets (records);
147 g_resolver_class_init (GResolverClass *resolver_class)
149 /* Automatically pass these over to the lookup_records methods */
150 resolver_class->lookup_service = g_resolver_real_lookup_service;
151 resolver_class->lookup_service_async = g_resolver_real_lookup_service_async;
152 resolver_class->lookup_service_finish = g_resolver_real_lookup_service_finish;
156 * @resolver: a #GResolver
158 * Emitted when the resolver notices that the system resolver
159 * configuration has changed.
162 g_signal_new (I_("reload"),
165 G_STRUCT_OFFSET (GResolverClass, reload),
167 g_cclosure_marshal_VOID__VOID,
172 g_resolver_init (GResolver *resolver)
178 resolver->priv = g_resolver_get_instance_private (resolver);
181 if (stat (_PATH_RESCONF, &st) == 0)
182 resolver->priv->resolv_conf_timestamp = st.st_mtime;
186 static GResolver *default_resolver;
189 * g_resolver_get_default:
191 * Gets the default #GResolver. You should unref it when you are done
192 * with it. #GResolver may use its reference count as a hint about how
193 * many threads it should allocate for concurrent DNS resolutions.
195 * Returns: (transfer full): the default #GResolver.
200 g_resolver_get_default (void)
202 if (!default_resolver)
203 default_resolver = g_object_new (G_TYPE_THREADED_RESOLVER, NULL);
205 return g_object_ref (default_resolver);
209 * g_resolver_set_default:
210 * @resolver: the new default #GResolver
212 * Sets @resolver to be the application's default resolver (reffing
213 * @resolver, and unreffing the previous default resolver, if any).
214 * Future calls to g_resolver_get_default() will return this resolver.
216 * This can be used if an application wants to perform any sort of DNS
217 * caching or "pinning"; it can implement its own #GResolver that
218 * calls the original default resolver for DNS operations, and
219 * implements its own cache policies on top of that, and then set
220 * itself as the default resolver for all later code to use.
225 g_resolver_set_default (GResolver *resolver)
227 if (default_resolver)
228 g_object_unref (default_resolver);
229 default_resolver = g_object_ref (resolver);
232 /* Bionic has res_init() but it's not in any header */
238 g_resolver_maybe_reload (GResolver *resolver)
243 if (stat (_PATH_RESCONF, &st) == 0)
245 if (st.st_mtime != resolver->priv->resolv_conf_timestamp)
247 resolver->priv->resolv_conf_timestamp = st.st_mtime;
251 g_signal_emit (resolver, signals[RELOAD], 0);
257 /* filter out duplicates, cf. https://bugzilla.gnome.org/show_bug.cgi?id=631379 */
259 remove_duplicates (GList *addrs)
265 /* TODO: if this is too slow (it's O(n^2) but n is typically really
266 * small), we can do something more clever but note that we must not
267 * change the order of elements...
269 for (l = addrs; l != NULL; l = l->next)
271 GInetAddress *address = G_INET_ADDRESS (l->data);
272 for (ll = l->next; ll != NULL; ll = lll)
274 GInetAddress *other_address = G_INET_ADDRESS (ll->data);
276 if (g_inet_address_equal (address, other_address))
278 g_object_unref (other_address);
279 /* we never return the first element */
280 g_warn_if_fail (g_list_delete_link (addrs, ll) == addrs);
286 /* Note that this does not follow the "FALSE means @error is set"
287 * convention. The return value tells the caller whether it should
288 * return @addrs and @error to the caller right away, or if it should
289 * continue and trying to resolve the name as a hostname.
292 handle_ip_address (const char *hostname,
298 struct in_addr ip4addr;
301 addr = g_inet_address_new_from_string (hostname);
304 *addrs = g_list_append (NULL, addr);
310 /* Reject non-standard IPv4 numbers-and-dots addresses.
311 * g_inet_address_new_from_string() will have accepted any "real" IP
312 * address, so if inet_aton() succeeds, then it's an address we want
313 * to reject. This check is not necessary for Windows, as getaddrinfo()
314 * already rejects such IPv4 addresses on Windows.
317 if (inet_aton (hostname, &ip4addr))
319 g_set_error (error, G_RESOLVER_ERROR, G_RESOLVER_ERROR_NOT_FOUND,
320 _("Error resolving '%s': %s"),
321 hostname, gai_strerror (EAI_NONAME));
330 * g_resolver_lookup_by_name:
331 * @resolver: a #GResolver
332 * @hostname: the hostname to look up
333 * @cancellable: (allow-none): a #GCancellable, or %NULL
334 * @error: return location for a #GError, or %NULL
336 * Synchronously resolves @hostname to determine its associated IP
337 * address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
338 * the textual form of an IP address (in which case this just becomes
339 * a wrapper around g_inet_address_new_from_string()).
341 * On success, g_resolver_lookup_by_name() will return a non-empty #GList of
342 * #GInetAddress, sorted in order of preference and guaranteed to not
343 * contain duplicates. That is, if using the result to connect to
344 * @hostname, you should attempt to connect to the first address
345 * first, then the second if the first fails, etc. If you are using
346 * the result to listen on a socket, it is appropriate to add each
347 * result using e.g. g_socket_listener_add_address().
349 * If the DNS resolution fails, @error (if non-%NULL) will be set to a
350 * value from #GResolverError and %NULL will be returned.
352 * If @cancellable is non-%NULL, it can be used to cancel the
353 * operation, in which case @error (if non-%NULL) will be set to
354 * %G_IO_ERROR_CANCELLED.
356 * If you are planning to connect to a socket on the resolved IP
357 * address, it may be easier to create a #GNetworkAddress and use its
358 * #GSocketConnectable interface.
360 * Returns: (element-type GInetAddress) (transfer full): a non-empty #GList
361 * of #GInetAddress, or %NULL on error. You
362 * must unref each of the addresses and free the list when you are
363 * done with it. (You can use g_resolver_free_addresses() to do this.)
368 g_resolver_lookup_by_name (GResolver *resolver,
369 const gchar *hostname,
370 GCancellable *cancellable,
374 gchar *ascii_hostname = NULL;
376 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
377 g_return_val_if_fail (hostname != NULL, NULL);
379 /* Check if @hostname is just an IP address */
380 if (handle_ip_address (hostname, &addrs, error))
383 if (g_hostname_is_non_ascii (hostname))
384 hostname = ascii_hostname = g_hostname_to_ascii (hostname);
386 g_resolver_maybe_reload (resolver);
387 addrs = G_RESOLVER_GET_CLASS (resolver)->
388 lookup_by_name (resolver, hostname, cancellable, error);
390 remove_duplicates (addrs);
392 g_free (ascii_hostname);
397 * g_resolver_lookup_by_name_async:
398 * @resolver: a #GResolver
399 * @hostname: the hostname to look up the address of
400 * @cancellable: (allow-none): a #GCancellable, or %NULL
401 * @callback: (scope async): callback to call after resolution completes
402 * @user_data: (closure): data for @callback
404 * Begins asynchronously resolving @hostname to determine its
405 * associated IP address(es), and eventually calls @callback, which
406 * must call g_resolver_lookup_by_name_finish() to get the result.
407 * See g_resolver_lookup_by_name() for more details.
412 g_resolver_lookup_by_name_async (GResolver *resolver,
413 const gchar *hostname,
414 GCancellable *cancellable,
415 GAsyncReadyCallback callback,
418 gchar *ascii_hostname = NULL;
420 GError *error = NULL;
422 g_return_if_fail (G_IS_RESOLVER (resolver));
423 g_return_if_fail (hostname != NULL);
425 /* Check if @hostname is just an IP address */
426 if (handle_ip_address (hostname, &addrs, &error))
430 task = g_task_new (resolver, cancellable, callback, user_data);
431 g_task_set_source_tag (task, g_resolver_lookup_by_name_async);
433 g_task_return_pointer (task, addrs, (GDestroyNotify) g_resolver_free_addresses);
435 g_task_return_error (task, error);
436 g_object_unref (task);
440 if (g_hostname_is_non_ascii (hostname))
441 hostname = ascii_hostname = g_hostname_to_ascii (hostname);
443 g_resolver_maybe_reload (resolver);
444 G_RESOLVER_GET_CLASS (resolver)->
445 lookup_by_name_async (resolver, hostname, cancellable, callback, user_data);
447 g_free (ascii_hostname);
451 * g_resolver_lookup_by_name_finish:
452 * @resolver: a #GResolver
453 * @result: the result passed to your #GAsyncReadyCallback
454 * @error: return location for a #GError, or %NULL
456 * Retrieves the result of a call to
457 * g_resolver_lookup_by_name_async().
459 * If the DNS resolution failed, @error (if non-%NULL) will be set to
460 * a value from #GResolverError. If the operation was cancelled,
461 * @error will be set to %G_IO_ERROR_CANCELLED.
463 * Returns: (element-type GInetAddress) (transfer full): a #GList
464 * of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
470 g_resolver_lookup_by_name_finish (GResolver *resolver,
471 GAsyncResult *result,
476 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
478 if (g_async_result_legacy_propagate_error (result, error))
480 else if (g_async_result_is_tagged (result, g_resolver_lookup_by_name_async))
482 /* Handle the stringified-IP-addr case */
483 return g_task_propagate_pointer (G_TASK (result), error);
486 addrs = G_RESOLVER_GET_CLASS (resolver)->
487 lookup_by_name_finish (resolver, result, error);
489 remove_duplicates (addrs);
495 * g_resolver_free_addresses: (skip)
496 * @addresses: a #GList of #GInetAddress
498 * Frees @addresses (which should be the return value from
499 * g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
500 * (This is a convenience method; you can also simply free the results
506 g_resolver_free_addresses (GList *addresses)
510 for (a = addresses; a; a = a->next)
511 g_object_unref (a->data);
512 g_list_free (addresses);
516 * g_resolver_lookup_by_address:
517 * @resolver: a #GResolver
518 * @address: the address to reverse-resolve
519 * @cancellable: (allow-none): a #GCancellable, or %NULL
520 * @error: return location for a #GError, or %NULL
522 * Synchronously reverse-resolves @address to determine its
523 * associated hostname.
525 * If the DNS resolution fails, @error (if non-%NULL) will be set to
526 * a value from #GResolverError.
528 * If @cancellable is non-%NULL, it can be used to cancel the
529 * operation, in which case @error (if non-%NULL) will be set to
530 * %G_IO_ERROR_CANCELLED.
532 * Returns: a hostname (either ASCII-only, or in ASCII-encoded
533 * form), or %NULL on error.
538 g_resolver_lookup_by_address (GResolver *resolver,
539 GInetAddress *address,
540 GCancellable *cancellable,
543 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
544 g_return_val_if_fail (G_IS_INET_ADDRESS (address), NULL);
546 g_resolver_maybe_reload (resolver);
547 return G_RESOLVER_GET_CLASS (resolver)->
548 lookup_by_address (resolver, address, cancellable, error);
552 * g_resolver_lookup_by_address_async:
553 * @resolver: a #GResolver
554 * @address: the address to reverse-resolve
555 * @cancellable: (allow-none): a #GCancellable, or %NULL
556 * @callback: (scope async): callback to call after resolution completes
557 * @user_data: (closure): data for @callback
559 * Begins asynchronously reverse-resolving @address to determine its
560 * associated hostname, and eventually calls @callback, which must
561 * call g_resolver_lookup_by_address_finish() to get the final result.
566 g_resolver_lookup_by_address_async (GResolver *resolver,
567 GInetAddress *address,
568 GCancellable *cancellable,
569 GAsyncReadyCallback callback,
572 g_return_if_fail (G_IS_RESOLVER (resolver));
573 g_return_if_fail (G_IS_INET_ADDRESS (address));
575 g_resolver_maybe_reload (resolver);
576 G_RESOLVER_GET_CLASS (resolver)->
577 lookup_by_address_async (resolver, address, cancellable, callback, user_data);
581 * g_resolver_lookup_by_address_finish:
582 * @resolver: a #GResolver
583 * @result: the result passed to your #GAsyncReadyCallback
584 * @error: return location for a #GError, or %NULL
586 * Retrieves the result of a previous call to
587 * g_resolver_lookup_by_address_async().
589 * If the DNS resolution failed, @error (if non-%NULL) will be set to
590 * a value from #GResolverError. If the operation was cancelled,
591 * @error will be set to %G_IO_ERROR_CANCELLED.
593 * Returns: a hostname (either ASCII-only, or in ASCII-encoded
594 * form), or %NULL on error.
599 g_resolver_lookup_by_address_finish (GResolver *resolver,
600 GAsyncResult *result,
603 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
605 if (g_async_result_legacy_propagate_error (result, error))
608 return G_RESOLVER_GET_CLASS (resolver)->
609 lookup_by_address_finish (resolver, result, error);
613 g_resolver_get_service_rrname (const char *service,
614 const char *protocol,
617 gchar *rrname, *ascii_domain = NULL;
619 if (g_hostname_is_non_ascii (domain))
620 domain = ascii_domain = g_hostname_to_ascii (domain);
622 rrname = g_strdup_printf ("_%s._%s.%s", service, protocol, domain);
624 g_free (ascii_domain);
629 * g_resolver_lookup_service:
630 * @resolver: a #GResolver
631 * @service: the service type to look up (eg, "ldap")
632 * @protocol: the networking protocol to use for @service (eg, "tcp")
633 * @domain: the DNS domain to look up the service in
634 * @cancellable: (allow-none): a #GCancellable, or %NULL
635 * @error: return location for a #GError, or %NULL
637 * Synchronously performs a DNS SRV lookup for the given @service and
638 * @protocol in the given @domain and returns an array of #GSrvTarget.
639 * @domain may be an ASCII-only or UTF-8 hostname. Note also that the
640 * @service and @protocol arguments do not include the leading underscore
641 * that appears in the actual DNS entry.
643 * On success, g_resolver_lookup_service() will return a non-empty #GList of
644 * #GSrvTarget, sorted in order of preference. (That is, you should
645 * attempt to connect to the first target first, then the second if
646 * the first fails, etc.)
648 * If the DNS resolution fails, @error (if non-%NULL) will be set to
649 * a value from #GResolverError and %NULL will be returned.
651 * If @cancellable is non-%NULL, it can be used to cancel the
652 * operation, in which case @error (if non-%NULL) will be set to
653 * %G_IO_ERROR_CANCELLED.
655 * If you are planning to connect to the service, it is usually easier
656 * to create a #GNetworkService and use its #GSocketConnectable
659 * Returns: (element-type GSrvTarget) (transfer full): a non-empty #GList of
660 * #GSrvTarget, or %NULL on error. You must free each of the targets and the
661 * list when you are done with it. (You can use g_resolver_free_targets() to do
667 g_resolver_lookup_service (GResolver *resolver,
668 const gchar *service,
669 const gchar *protocol,
671 GCancellable *cancellable,
677 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
678 g_return_val_if_fail (service != NULL, NULL);
679 g_return_val_if_fail (protocol != NULL, NULL);
680 g_return_val_if_fail (domain != NULL, NULL);
682 rrname = g_resolver_get_service_rrname (service, protocol, domain);
684 g_resolver_maybe_reload (resolver);
685 targets = G_RESOLVER_GET_CLASS (resolver)->
686 lookup_service (resolver, rrname, cancellable, error);
693 * g_resolver_lookup_service_async:
694 * @resolver: a #GResolver
695 * @service: the service type to look up (eg, "ldap")
696 * @protocol: the networking protocol to use for @service (eg, "tcp")
697 * @domain: the DNS domain to look up the service in
698 * @cancellable: (allow-none): a #GCancellable, or %NULL
699 * @callback: (scope async): callback to call after resolution completes
700 * @user_data: (closure): data for @callback
702 * Begins asynchronously performing a DNS SRV lookup for the given
703 * @service and @protocol in the given @domain, and eventually calls
704 * @callback, which must call g_resolver_lookup_service_finish() to
705 * get the final result. See g_resolver_lookup_service() for more
711 g_resolver_lookup_service_async (GResolver *resolver,
712 const gchar *service,
713 const gchar *protocol,
715 GCancellable *cancellable,
716 GAsyncReadyCallback callback,
721 g_return_if_fail (G_IS_RESOLVER (resolver));
722 g_return_if_fail (service != NULL);
723 g_return_if_fail (protocol != NULL);
724 g_return_if_fail (domain != NULL);
726 rrname = g_resolver_get_service_rrname (service, protocol, domain);
728 g_resolver_maybe_reload (resolver);
729 G_RESOLVER_GET_CLASS (resolver)->
730 lookup_service_async (resolver, rrname, cancellable, callback, user_data);
736 * g_resolver_lookup_service_finish:
737 * @resolver: a #GResolver
738 * @result: the result passed to your #GAsyncReadyCallback
739 * @error: return location for a #GError, or %NULL
741 * Retrieves the result of a previous call to
742 * g_resolver_lookup_service_async().
744 * If the DNS resolution failed, @error (if non-%NULL) will be set to
745 * a value from #GResolverError. If the operation was cancelled,
746 * @error will be set to %G_IO_ERROR_CANCELLED.
748 * Returns: (element-type GSrvTarget) (transfer full): a non-empty #GList of
749 * #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more
755 g_resolver_lookup_service_finish (GResolver *resolver,
756 GAsyncResult *result,
759 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
761 if (g_async_result_legacy_propagate_error (result, error))
764 return G_RESOLVER_GET_CLASS (resolver)->
765 lookup_service_finish (resolver, result, error);
769 * g_resolver_free_targets: (skip)
770 * @targets: a #GList of #GSrvTarget
772 * Frees @targets (which should be the return value from
773 * g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
774 * (This is a convenience method; you can also simply free the
780 g_resolver_free_targets (GList *targets)
784 for (t = targets; t; t = t->next)
785 g_srv_target_free (t->data);
786 g_list_free (targets);
790 * g_resolver_lookup_records:
791 * @resolver: a #GResolver
792 * @rrname: the DNS name to lookup the record for
793 * @record_type: the type of DNS record to lookup
794 * @cancellable: (allow-none): a #GCancellable, or %NULL
795 * @error: return location for a #GError, or %NULL
797 * Synchronously performs a DNS record lookup for the given @rrname and returns
798 * a list of records as #GVariant tuples. See #GResolverRecordType for
799 * information on what the records contain for each @record_type.
801 * If the DNS resolution fails, @error (if non-%NULL) will be set to
802 * a value from #GResolverError and %NULL will be returned.
804 * If @cancellable is non-%NULL, it can be used to cancel the
805 * operation, in which case @error (if non-%NULL) will be set to
806 * %G_IO_ERROR_CANCELLED.
808 * Returns: (element-type GVariant) (transfer full): a non-empty #GList of
809 * #GVariant, or %NULL on error. You must free each of the records and the list
810 * when you are done with it. (You can use g_list_free_full() with
811 * g_variant_unref() to do this.)
816 g_resolver_lookup_records (GResolver *resolver,
818 GResolverRecordType record_type,
819 GCancellable *cancellable,
824 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
825 g_return_val_if_fail (rrname != NULL, NULL);
827 g_resolver_maybe_reload (resolver);
828 records = G_RESOLVER_GET_CLASS (resolver)->
829 lookup_records (resolver, rrname, record_type, cancellable, error);
835 * g_resolver_lookup_records_async:
836 * @resolver: a #GResolver
837 * @rrname: the DNS name to lookup the record for
838 * @record_type: the type of DNS record to lookup
839 * @cancellable: (allow-none): a #GCancellable, or %NULL
840 * @callback: (scope async): callback to call after resolution completes
841 * @user_data: (closure): data for @callback
843 * Begins asynchronously performing a DNS lookup for the given
844 * @rrname, and eventually calls @callback, which must call
845 * g_resolver_lookup_records_finish() to get the final result. See
846 * g_resolver_lookup_records() for more details.
851 g_resolver_lookup_records_async (GResolver *resolver,
853 GResolverRecordType record_type,
854 GCancellable *cancellable,
855 GAsyncReadyCallback callback,
858 g_return_if_fail (G_IS_RESOLVER (resolver));
859 g_return_if_fail (rrname != NULL);
861 g_resolver_maybe_reload (resolver);
862 G_RESOLVER_GET_CLASS (resolver)->
863 lookup_records_async (resolver, rrname, record_type, cancellable, callback, user_data);
867 * g_resolver_lookup_records_finish:
868 * @resolver: a #GResolver
869 * @result: the result passed to your #GAsyncReadyCallback
870 * @error: return location for a #GError, or %NULL
872 * Retrieves the result of a previous call to
873 * g_resolver_lookup_records_async(). Returns a non-empty list of records as
874 * #GVariant tuples. See #GResolverRecordType for information on what the
877 * If the DNS resolution failed, @error (if non-%NULL) will be set to
878 * a value from #GResolverError. If the operation was cancelled,
879 * @error will be set to %G_IO_ERROR_CANCELLED.
881 * Returns: (element-type GVariant) (transfer full): a non-empty #GList of
882 * #GVariant, or %NULL on error. You must free each of the records and the list
883 * when you are done with it. (You can use g_list_free_full() with
884 * g_variant_unref() to do this.)
889 g_resolver_lookup_records_finish (GResolver *resolver,
890 GAsyncResult *result,
893 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
894 return G_RESOLVER_GET_CLASS (resolver)->
895 lookup_records_finish (resolver, result, error);
899 g_resolver_get_serial (GResolver *resolver)
901 g_return_val_if_fail (G_IS_RESOLVER (resolver), 0);
903 g_resolver_maybe_reload (resolver);
906 return (guint64) resolver->priv->resolv_conf_timestamp;
913 * g_resolver_error_quark:
915 * Gets the #GResolver Error Quark.
917 * Returns: a #GQuark.
921 G_DEFINE_QUARK (g-resolver-error-quark, g_resolver_error)