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, write to the
19 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20 * Boston, MA 02111-1307, USA.
27 #include "gresolver.h"
28 #include "gnetworkingprivate.h"
29 #include "gasyncresult.h"
30 #include "ginetaddress.h"
31 #include "gsimpleasyncresult.h"
33 #include "gsrvtarget.h"
34 #include "gthreadedresolver.h"
45 * @short_description: Asynchronous and cancellable DNS resolver
48 * #GResolver provides cancellable synchronous and asynchronous DNS
49 * resolution, for hostnames (g_resolver_lookup_by_address(),
50 * g_resolver_lookup_by_name() and their async variants) and SRV
51 * (service) records (g_resolver_lookup_service()).
53 * #GNetworkAddress and #GNetworkService provide wrappers around
54 * #GResolver functionality that also implement #GSocketConnectable,
55 * making it easy to connect to a remote host/service.
63 static guint signals
[LAST_SIGNAL
] = { 0 };
65 struct _GResolverPrivate
{
67 time_t resolv_conf_timestamp
;
76 * The object that handles DNS resolution. Use g_resolver_get_default()
77 * to get the default resolver.
79 G_DEFINE_TYPE_WITH_CODE (GResolver
, g_resolver
, G_TYPE_OBJECT
,
80 G_ADD_PRIVATE (GResolver
)
81 g_networking_init ();)
84 srv_records_to_targets (GList
*records
)
86 const gchar
*hostname
;
87 guint16 port
, priority
, weight
;
91 for (l
= records
; l
!= NULL
; l
= g_list_next (l
))
93 g_variant_get (l
->data
, "(qqq&s)", &priority
, &weight
, &port
, &hostname
);
94 target
= g_srv_target_new (hostname
, port
, priority
, weight
);
95 g_variant_unref (l
->data
);
99 return g_srv_target_list_sort (records
);
103 g_resolver_real_lookup_service (GResolver
*resolver
,
105 GCancellable
*cancellable
,
110 records
= G_RESOLVER_GET_CLASS (resolver
)->lookup_records (resolver
,
112 G_RESOLVER_RECORD_SRV
,
116 return srv_records_to_targets (records
);
120 g_resolver_real_lookup_service_async (GResolver
*resolver
,
122 GCancellable
*cancellable
,
123 GAsyncReadyCallback callback
,
126 G_RESOLVER_GET_CLASS (resolver
)->lookup_records_async (resolver
,
128 G_RESOLVER_RECORD_SRV
,
135 g_resolver_real_lookup_service_finish (GResolver
*resolver
,
136 GAsyncResult
*result
,
141 records
= G_RESOLVER_GET_CLASS (resolver
)->lookup_records_finish (resolver
,
145 return srv_records_to_targets (records
);
149 g_resolver_class_init (GResolverClass
*resolver_class
)
151 /* Automatically pass these over to the lookup_records methods */
152 resolver_class
->lookup_service
= g_resolver_real_lookup_service
;
153 resolver_class
->lookup_service_async
= g_resolver_real_lookup_service_async
;
154 resolver_class
->lookup_service_finish
= g_resolver_real_lookup_service_finish
;
158 * @resolver: a #GResolver
160 * Emitted when the resolver notices that the system resolver
161 * configuration has changed.
164 g_signal_new (I_("reload"),
167 G_STRUCT_OFFSET (GResolverClass
, reload
),
169 g_cclosure_marshal_VOID__VOID
,
174 g_resolver_init (GResolver
*resolver
)
180 resolver
->priv
= g_resolver_get_instance_private (resolver
);
183 if (stat (_PATH_RESCONF
, &st
) == 0)
184 resolver
->priv
->resolv_conf_timestamp
= st
.st_mtime
;
188 static GResolver
*default_resolver
;
191 * g_resolver_get_default:
193 * Gets the default #GResolver. You should unref it when you are done
194 * with it. #GResolver may use its reference count as a hint about how
195 * many threads it should allocate for concurrent DNS resolutions.
197 * Return value: (transfer full): the default #GResolver.
202 g_resolver_get_default (void)
204 if (!default_resolver
)
205 default_resolver
= g_object_new (G_TYPE_THREADED_RESOLVER
, NULL
);
207 return g_object_ref (default_resolver
);
211 * g_resolver_set_default:
212 * @resolver: the new default #GResolver
214 * Sets @resolver to be the application's default resolver (reffing
215 * @resolver, and unreffing the previous default resolver, if any).
216 * Future calls to g_resolver_get_default() will return this resolver.
218 * This can be used if an application wants to perform any sort of DNS
219 * caching or "pinning"; it can implement its own #GResolver that
220 * calls the original default resolver for DNS operations, and
221 * implements its own cache policies on top of that, and then set
222 * itself as the default resolver for all later code to use.
227 g_resolver_set_default (GResolver
*resolver
)
229 if (default_resolver
)
230 g_object_unref (default_resolver
);
231 default_resolver
= g_object_ref (resolver
);
234 /* Bionic has res_init() but it's not in any header */
240 g_resolver_maybe_reload (GResolver
*resolver
)
245 if (stat (_PATH_RESCONF
, &st
) == 0)
247 if (st
.st_mtime
!= resolver
->priv
->resolv_conf_timestamp
)
249 resolver
->priv
->resolv_conf_timestamp
= st
.st_mtime
;
253 g_signal_emit (resolver
, signals
[RELOAD
], 0);
259 /* filter out duplicates, cf. https://bugzilla.gnome.org/show_bug.cgi?id=631379 */
261 remove_duplicates (GList
*addrs
)
267 /* TODO: if this is too slow (it's O(n^2) but n is typically really
268 * small), we can do something more clever but note that we must not
269 * change the order of elements...
271 for (l
= addrs
; l
!= NULL
; l
= l
->next
)
273 GInetAddress
*address
= G_INET_ADDRESS (l
->data
);
274 for (ll
= l
->next
; ll
!= NULL
; ll
= lll
)
276 GInetAddress
*other_address
= G_INET_ADDRESS (ll
->data
);
278 if (g_inet_address_equal (address
, other_address
))
280 g_object_unref (other_address
);
281 /* we never return the first element */
282 g_warn_if_fail (g_list_delete_link (addrs
, ll
) == addrs
);
290 * g_resolver_lookup_by_name:
291 * @resolver: a #GResolver
292 * @hostname: the hostname to look up
293 * @cancellable: (allow-none): a #GCancellable, or %NULL
294 * @error: return location for a #GError, or %NULL
296 * Synchronously resolves @hostname to determine its associated IP
297 * address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
298 * the textual form of an IP address (in which case this just becomes
299 * a wrapper around g_inet_address_new_from_string()).
301 * On success, g_resolver_lookup_by_name() will return a #GList of
302 * #GInetAddress, sorted in order of preference and guaranteed to not
303 * contain duplicates. That is, if using the result to connect to
304 * @hostname, you should attempt to connect to the first address
305 * first, then the second if the first fails, etc. If you are using
306 * the result to listen on a socket, it is appropriate to add each
307 * result using e.g. g_socket_listener_add_address().
309 * If the DNS resolution fails, @error (if non-%NULL) will be set to a
310 * value from #GResolverError.
312 * If @cancellable is non-%NULL, it can be used to cancel the
313 * operation, in which case @error (if non-%NULL) will be set to
314 * %G_IO_ERROR_CANCELLED.
316 * If you are planning to connect to a socket on the resolved IP
317 * address, it may be easier to create a #GNetworkAddress and use its
318 * #GSocketConnectable interface.
320 * Return value: (element-type GInetAddress) (transfer full): a #GList
321 * of #GInetAddress, or %NULL on error. You
322 * must unref each of the addresses and free the list when you are
323 * done with it. (You can use g_resolver_free_addresses() to do this.)
328 g_resolver_lookup_by_name (GResolver
*resolver
,
329 const gchar
*hostname
,
330 GCancellable
*cancellable
,
335 gchar
*ascii_hostname
= NULL
;
337 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
338 g_return_val_if_fail (hostname
!= NULL
, NULL
);
340 /* Check if @hostname is just an IP address */
341 addr
= g_inet_address_new_from_string (hostname
);
343 return g_list_append (NULL
, addr
);
345 if (g_hostname_is_non_ascii (hostname
))
346 hostname
= ascii_hostname
= g_hostname_to_ascii (hostname
);
348 g_resolver_maybe_reload (resolver
);
349 addrs
= G_RESOLVER_GET_CLASS (resolver
)->
350 lookup_by_name (resolver
, hostname
, cancellable
, error
);
352 remove_duplicates (addrs
);
354 g_free (ascii_hostname
);
359 * g_resolver_lookup_by_name_async:
360 * @resolver: a #GResolver
361 * @hostname: the hostname to look up the address of
362 * @cancellable: (allow-none): a #GCancellable, or %NULL
363 * @callback: (scope async): callback to call after resolution completes
364 * @user_data: (closure): data for @callback
366 * Begins asynchronously resolving @hostname to determine its
367 * associated IP address(es), and eventually calls @callback, which
368 * must call g_resolver_lookup_by_name_finish() to get the result.
369 * See g_resolver_lookup_by_name() for more details.
374 g_resolver_lookup_by_name_async (GResolver
*resolver
,
375 const gchar
*hostname
,
376 GCancellable
*cancellable
,
377 GAsyncReadyCallback callback
,
381 gchar
*ascii_hostname
= NULL
;
383 g_return_if_fail (G_IS_RESOLVER (resolver
));
384 g_return_if_fail (hostname
!= NULL
);
386 /* Check if @hostname is just an IP address */
387 addr
= g_inet_address_new_from_string (hostname
);
392 task
= g_task_new (resolver
, cancellable
, callback
, user_data
);
393 g_task_set_source_tag (task
, g_resolver_lookup_by_name_async
);
394 g_task_return_pointer (task
, g_list_append (NULL
, addr
),
395 (GDestroyNotify
) g_resolver_free_addresses
);
396 g_object_unref (task
);
400 if (g_hostname_is_non_ascii (hostname
))
401 hostname
= ascii_hostname
= g_hostname_to_ascii (hostname
);
403 g_resolver_maybe_reload (resolver
);
404 G_RESOLVER_GET_CLASS (resolver
)->
405 lookup_by_name_async (resolver
, hostname
, cancellable
, callback
, user_data
);
407 g_free (ascii_hostname
);
411 * g_resolver_lookup_by_name_finish:
412 * @resolver: a #GResolver
413 * @result: the result passed to your #GAsyncReadyCallback
414 * @error: return location for a #GError, or %NULL
416 * Retrieves the result of a call to
417 * g_resolver_lookup_by_name_async().
419 * If the DNS resolution failed, @error (if non-%NULL) will be set to
420 * a value from #GResolverError. If the operation was cancelled,
421 * @error will be set to %G_IO_ERROR_CANCELLED.
423 * Return value: (element-type GInetAddress) (transfer full): a #GList
424 * of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
430 g_resolver_lookup_by_name_finish (GResolver
*resolver
,
431 GAsyncResult
*result
,
436 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
438 if (g_async_result_legacy_propagate_error (result
, error
))
440 else if (g_async_result_is_tagged (result
, g_resolver_lookup_by_name_async
))
442 /* Handle the stringified-IP-addr case */
443 return g_task_propagate_pointer (G_TASK (result
), error
);
446 addrs
= G_RESOLVER_GET_CLASS (resolver
)->
447 lookup_by_name_finish (resolver
, result
, error
);
449 remove_duplicates (addrs
);
455 * g_resolver_free_addresses: (skip)
456 * @addresses: a #GList of #GInetAddress
458 * Frees @addresses (which should be the return value from
459 * g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
460 * (This is a convenience method; you can also simply free the results
466 g_resolver_free_addresses (GList
*addresses
)
470 for (a
= addresses
; a
; a
= a
->next
)
471 g_object_unref (a
->data
);
472 g_list_free (addresses
);
476 * g_resolver_lookup_by_address:
477 * @resolver: a #GResolver
478 * @address: the address to reverse-resolve
479 * @cancellable: (allow-none): a #GCancellable, or %NULL
480 * @error: return location for a #GError, or %NULL
482 * Synchronously reverse-resolves @address to determine its
483 * associated hostname.
485 * If the DNS resolution fails, @error (if non-%NULL) will be set to
486 * a value from #GResolverError.
488 * If @cancellable is non-%NULL, it can be used to cancel the
489 * operation, in which case @error (if non-%NULL) will be set to
490 * %G_IO_ERROR_CANCELLED.
492 * Return value: a hostname (either ASCII-only, or in ASCII-encoded
493 * form), or %NULL on error.
498 g_resolver_lookup_by_address (GResolver
*resolver
,
499 GInetAddress
*address
,
500 GCancellable
*cancellable
,
503 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
504 g_return_val_if_fail (G_IS_INET_ADDRESS (address
), NULL
);
506 g_resolver_maybe_reload (resolver
);
507 return G_RESOLVER_GET_CLASS (resolver
)->
508 lookup_by_address (resolver
, address
, cancellable
, error
);
512 * g_resolver_lookup_by_address_async:
513 * @resolver: a #GResolver
514 * @address: the address to reverse-resolve
515 * @cancellable: (allow-none): a #GCancellable, or %NULL
516 * @callback: (scope async): callback to call after resolution completes
517 * @user_data: (closure): data for @callback
519 * Begins asynchronously reverse-resolving @address to determine its
520 * associated hostname, and eventually calls @callback, which must
521 * call g_resolver_lookup_by_address_finish() to get the final result.
526 g_resolver_lookup_by_address_async (GResolver
*resolver
,
527 GInetAddress
*address
,
528 GCancellable
*cancellable
,
529 GAsyncReadyCallback callback
,
532 g_return_if_fail (G_IS_RESOLVER (resolver
));
533 g_return_if_fail (G_IS_INET_ADDRESS (address
));
535 g_resolver_maybe_reload (resolver
);
536 G_RESOLVER_GET_CLASS (resolver
)->
537 lookup_by_address_async (resolver
, address
, cancellable
, callback
, user_data
);
541 * g_resolver_lookup_by_address_finish:
542 * @resolver: a #GResolver
543 * @result: the result passed to your #GAsyncReadyCallback
544 * @error: return location for a #GError, or %NULL
546 * Retrieves the result of a previous call to
547 * g_resolver_lookup_by_address_async().
549 * If the DNS resolution failed, @error (if non-%NULL) will be set to
550 * a value from #GResolverError. If the operation was cancelled,
551 * @error will be set to %G_IO_ERROR_CANCELLED.
553 * Return value: a hostname (either ASCII-only, or in ASCII-encoded
554 * form), or %NULL on error.
559 g_resolver_lookup_by_address_finish (GResolver
*resolver
,
560 GAsyncResult
*result
,
563 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
565 if (g_async_result_legacy_propagate_error (result
, error
))
568 return G_RESOLVER_GET_CLASS (resolver
)->
569 lookup_by_address_finish (resolver
, result
, error
);
573 g_resolver_get_service_rrname (const char *service
,
574 const char *protocol
,
577 gchar
*rrname
, *ascii_domain
= NULL
;
579 if (g_hostname_is_non_ascii (domain
))
580 domain
= ascii_domain
= g_hostname_to_ascii (domain
);
582 rrname
= g_strdup_printf ("_%s._%s.%s", service
, protocol
, domain
);
584 g_free (ascii_domain
);
589 * g_resolver_lookup_service:
590 * @resolver: a #GResolver
591 * @service: the service type to look up (eg, "ldap")
592 * @protocol: the networking protocol to use for @service (eg, "tcp")
593 * @domain: the DNS domain to look up the service in
594 * @cancellable: (allow-none): a #GCancellable, or %NULL
595 * @error: return location for a #GError, or %NULL
597 * Synchronously performs a DNS SRV lookup for the given @service and
598 * @protocol in the given @domain and returns an array of #GSrvTarget.
599 * @domain may be an ASCII-only or UTF-8 hostname. Note also that the
600 * @service and @protocol arguments <emphasis>do not</emphasis>
601 * include the leading underscore that appears in the actual DNS
604 * On success, g_resolver_lookup_service() will return a #GList of
605 * #GSrvTarget, sorted in order of preference. (That is, you should
606 * attempt to connect to the first target first, then the second if
607 * the first fails, etc.)
609 * If the DNS resolution fails, @error (if non-%NULL) will be set to
610 * a value from #GResolverError.
612 * If @cancellable is non-%NULL, it can be used to cancel the
613 * operation, in which case @error (if non-%NULL) will be set to
614 * %G_IO_ERROR_CANCELLED.
616 * If you are planning to connect to the service, it is usually easier
617 * to create a #GNetworkService and use its #GSocketConnectable
620 * Return value: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
621 * or %NULL on error. You must free each of the targets and the list when you are
622 * done with it. (You can use g_resolver_free_targets() to do this.)
627 g_resolver_lookup_service (GResolver
*resolver
,
628 const gchar
*service
,
629 const gchar
*protocol
,
631 GCancellable
*cancellable
,
637 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
638 g_return_val_if_fail (service
!= NULL
, NULL
);
639 g_return_val_if_fail (protocol
!= NULL
, NULL
);
640 g_return_val_if_fail (domain
!= NULL
, NULL
);
642 rrname
= g_resolver_get_service_rrname (service
, protocol
, domain
);
644 g_resolver_maybe_reload (resolver
);
645 targets
= G_RESOLVER_GET_CLASS (resolver
)->
646 lookup_service (resolver
, rrname
, cancellable
, error
);
653 * g_resolver_lookup_service_async:
654 * @resolver: a #GResolver
655 * @service: the service type to look up (eg, "ldap")
656 * @protocol: the networking protocol to use for @service (eg, "tcp")
657 * @domain: the DNS domain to look up the service in
658 * @cancellable: (allow-none): a #GCancellable, or %NULL
659 * @callback: (scope async): callback to call after resolution completes
660 * @user_data: (closure): data for @callback
662 * Begins asynchronously performing a DNS SRV lookup for the given
663 * @service and @protocol in the given @domain, and eventually calls
664 * @callback, which must call g_resolver_lookup_service_finish() to
665 * get the final result. See g_resolver_lookup_service() for more
671 g_resolver_lookup_service_async (GResolver
*resolver
,
672 const gchar
*service
,
673 const gchar
*protocol
,
675 GCancellable
*cancellable
,
676 GAsyncReadyCallback callback
,
681 g_return_if_fail (G_IS_RESOLVER (resolver
));
682 g_return_if_fail (service
!= NULL
);
683 g_return_if_fail (protocol
!= NULL
);
684 g_return_if_fail (domain
!= NULL
);
686 rrname
= g_resolver_get_service_rrname (service
, protocol
, domain
);
688 g_resolver_maybe_reload (resolver
);
689 G_RESOLVER_GET_CLASS (resolver
)->
690 lookup_service_async (resolver
, rrname
, cancellable
, callback
, user_data
);
696 * g_resolver_lookup_service_finish:
697 * @resolver: a #GResolver
698 * @result: the result passed to your #GAsyncReadyCallback
699 * @error: return location for a #GError, or %NULL
701 * Retrieves the result of a previous call to
702 * g_resolver_lookup_service_async().
704 * If the DNS resolution failed, @error (if non-%NULL) will be set to
705 * a value from #GResolverError. If the operation was cancelled,
706 * @error will be set to %G_IO_ERROR_CANCELLED.
708 * Return value: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget,
709 * or %NULL on error. See g_resolver_lookup_service() for more details.
714 g_resolver_lookup_service_finish (GResolver
*resolver
,
715 GAsyncResult
*result
,
718 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
720 if (g_async_result_legacy_propagate_error (result
, error
))
723 return G_RESOLVER_GET_CLASS (resolver
)->
724 lookup_service_finish (resolver
, result
, error
);
728 * g_resolver_free_targets: (skip)
729 * @targets: a #GList of #GSrvTarget
731 * Frees @targets (which should be the return value from
732 * g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
733 * (This is a convenience method; you can also simply free the
739 g_resolver_free_targets (GList
*targets
)
743 for (t
= targets
; t
; t
= t
->next
)
744 g_srv_target_free (t
->data
);
745 g_list_free (targets
);
749 * g_resolver_lookup_records:
750 * @resolver: a #GResolver
751 * @rrname: the DNS name to lookup the record for
752 * @record_type: the type of DNS record to lookup
753 * @cancellable: (allow-none): a #GCancellable, or %NULL
754 * @error: return location for a #GError, or %NULL
756 * Synchronously performs a DNS record lookup for the given @rrname and returns
757 * a list of records as #GVariant tuples. See #GResolverRecordType for
758 * information on what the records contain for each @record_type.
760 * If the DNS resolution fails, @error (if non-%NULL) will be set to
761 * a value from #GResolverError.
763 * If @cancellable is non-%NULL, it can be used to cancel the
764 * operation, in which case @error (if non-%NULL) will be set to
765 * %G_IO_ERROR_CANCELLED.
767 * Return value: (element-type GVariant) (transfer full): a #GList of #GVariant,
768 * or %NULL on error. You must free each of the records and the list when you are
769 * done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
774 g_resolver_lookup_records (GResolver
*resolver
,
776 GResolverRecordType record_type
,
777 GCancellable
*cancellable
,
782 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
783 g_return_val_if_fail (rrname
!= NULL
, NULL
);
785 g_resolver_maybe_reload (resolver
);
786 records
= G_RESOLVER_GET_CLASS (resolver
)->
787 lookup_records (resolver
, rrname
, record_type
, cancellable
, error
);
793 * g_resolver_lookup_records_async:
794 * @resolver: a #GResolver
795 * @rrname: the DNS name to lookup the record for
796 * @record_type: the type of DNS record to lookup
797 * @cancellable: (allow-none): a #GCancellable, or %NULL
798 * @callback: (scope async): callback to call after resolution completes
799 * @user_data: (closure): data for @callback
801 * Begins asynchronously performing a DNS lookup for the given
802 * @rrname, and eventually calls @callback, which must call
803 * g_resolver_lookup_records_finish() to get the final result. See
804 * g_resolver_lookup_records() for more details.
809 g_resolver_lookup_records_async (GResolver
*resolver
,
811 GResolverRecordType record_type
,
812 GCancellable
*cancellable
,
813 GAsyncReadyCallback callback
,
816 g_return_if_fail (G_IS_RESOLVER (resolver
));
817 g_return_if_fail (rrname
!= NULL
);
819 g_resolver_maybe_reload (resolver
);
820 G_RESOLVER_GET_CLASS (resolver
)->
821 lookup_records_async (resolver
, rrname
, record_type
, cancellable
, callback
, user_data
);
825 * g_resolver_lookup_records_finish:
826 * @resolver: a #GResolver
827 * @result: the result passed to your #GAsyncReadyCallback
828 * @error: return location for a #GError, or %NULL
830 * Retrieves the result of a previous call to
831 * g_resolver_lookup_records_async(). Returns a list of records as #GVariant
832 * tuples. See #GResolverRecordType for information on what the records contain.
834 * If the DNS resolution failed, @error (if non-%NULL) will be set to
835 * a value from #GResolverError. If the operation was cancelled,
836 * @error will be set to %G_IO_ERROR_CANCELLED.
838 * Return value: (element-type GVariant) (transfer full): a #GList of #GVariant,
839 * or %NULL on error. You must free each of the records and the list when you are
840 * done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
845 g_resolver_lookup_records_finish (GResolver
*resolver
,
846 GAsyncResult
*result
,
849 g_return_val_if_fail (G_IS_RESOLVER (resolver
), NULL
);
850 return G_RESOLVER_GET_CLASS (resolver
)->
851 lookup_records_finish (resolver
, result
, error
);
855 g_resolver_get_serial (GResolver
*resolver
)
857 g_return_val_if_fail (G_IS_RESOLVER (resolver
), 0);
859 g_resolver_maybe_reload (resolver
);
862 return (guint64
) resolver
->priv
->resolv_conf_timestamp
;
869 * g_resolver_error_quark:
871 * Gets the #GResolver Error Quark.
873 * Return value: a #GQuark.
877 G_DEFINE_QUARK (g
-resolver
-error
-quark
, g_resolver_error
)