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 "ginetsocketaddress.h"
32 #include "gsimpleasyncresult.h"
33 #include "gsrvtarget.h"
36 #include "gunixresolver.h"
40 #include "gwin32resolver.h"
48 * @short_description: Asynchronous and cancellable DNS resolver
51 * #GResolver provides cancellable synchronous and asynchronous DNS
52 * resolution, for hostnames (g_resolver_lookup_by_address(),
53 * g_resolver_lookup_by_name() and their async variants) and SRV
54 * (service) records (g_resolver_lookup_service()).
56 * #GNetworkAddress and #GNetworkService provide wrappers around
57 * #GResolver functionality that also implement #GSocketConnectable,
58 * making it easy to connect to a remote host/service.
66 static guint signals[LAST_SIGNAL] = { 0 };
68 struct _GResolverPrivate {
70 time_t resolv_conf_timestamp;
79 * The object that handles DNS resolution. Use g_resolver_get_default()
80 * to get the default resolver.
82 G_DEFINE_TYPE (GResolver, g_resolver, G_TYPE_OBJECT)
85 g_resolver_class_init (GResolverClass *resolver_class)
89 g_type_class_add_private (resolver_class, sizeof (GResolverPrivate));
91 /* Make sure _g_networking_init() has been called */
92 type = g_inet_address_get_type ();
94 /* Initialize _g_resolver_addrinfo_hints */
96 _g_resolver_addrinfo_hints.ai_flags |= AI_ADDRCONFIG;
98 /* These two don't actually matter, they just get copied into the
99 * returned addrinfo structures (and then we ignore them). But if
100 * we leave them unset, we'll get back duplicate answers.
102 _g_resolver_addrinfo_hints.ai_socktype = SOCK_STREAM;
103 _g_resolver_addrinfo_hints.ai_protocol = IPPROTO_TCP;
107 * @resolver: a #GResolver
109 * Emitted when the resolver notices that the system resolver
110 * configuration has changed.
113 g_signal_new (I_("reload"),
116 G_STRUCT_OFFSET (GResolverClass, reload),
118 g_cclosure_marshal_VOID__VOID,
123 g_resolver_init (GResolver *resolver)
129 resolver->priv = G_TYPE_INSTANCE_GET_PRIVATE (resolver, G_TYPE_RESOLVER, GResolverPrivate);
132 if (stat (_PATH_RESCONF, &st) == 0)
133 resolver->priv->resolv_conf_timestamp = st.st_mtime;
137 static GResolver *default_resolver;
140 * g_resolver_get_default:
142 * Gets the default #GResolver. You should unref it when you are done
143 * with it. #GResolver may use its reference count as a hint about how
144 * many threads/processes, etc it should allocate for concurrent DNS
147 * Return value: the default #GResolver.
152 g_resolver_get_default (void)
154 if (!default_resolver)
156 if (g_thread_supported ())
157 default_resolver = g_object_new (G_TYPE_THREADED_RESOLVER, NULL);
160 #if defined(G_OS_UNIX)
161 default_resolver = g_object_new (G_TYPE_UNIX_RESOLVER, NULL);
162 #elif defined(G_OS_WIN32)
163 default_resolver = g_object_new (G_TYPE_WIN32_RESOLVER, NULL);
168 return g_object_ref (default_resolver);
172 * g_resolver_set_default:
173 * @resolver: the new default #GResolver
175 * Sets @resolver to be the application's default resolver (reffing
176 * @resolver, and unreffing the previous default resolver, if any).
177 * Future calls to g_resolver_get_default() will return this resolver.
179 * This can be used if an application wants to perform any sort of DNS
180 * caching or "pinning"; it can implement its own #GResolver that
181 * calls the original default resolver for DNS operations, and
182 * implements its own cache policies on top of that, and then set
183 * itself as the default resolver for all later code to use.
188 g_resolver_set_default (GResolver *resolver)
190 if (default_resolver)
191 g_object_unref (default_resolver);
192 default_resolver = g_object_ref (resolver);
197 g_resolver_maybe_reload (GResolver *resolver)
202 if (stat (_PATH_RESCONF, &st) == 0)
204 if (st.st_mtime != resolver->priv->resolv_conf_timestamp)
206 resolver->priv->resolv_conf_timestamp = st.st_mtime;
208 g_signal_emit (resolver, signals[RELOAD], 0);
215 * g_resolver_lookup_by_name:
216 * @resolver: a #GResolver
217 * @hostname: the hostname to look up
218 * @cancellable: a #GCancellable, or %NULL
219 * @error: return location for a #GError, or %NULL
221 * Synchronously resolves @hostname to determine its associated IP
222 * address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
223 * the textual form of an IP address (in which case this just becomes
224 * a wrapper around g_inet_address_new_from_string()).
226 * On success, g_resolver_lookup_by_name() will return a #GList of
227 * #GInetAddress, sorted in order of preference. (That is, you should
228 * attempt to connect to the first address first, then the second if
229 * the first fails, etc.)
231 * If the DNS resolution fails, @error (if non-%NULL) will be set to a
232 * value from #GResolverError.
234 * If @cancellable is non-%NULL, it can be used to cancel the
235 * operation, in which case @error (if non-%NULL) will be set to
236 * %G_IO_ERROR_CANCELLED.
238 * If you are planning to connect to a socket on the resolved IP
239 * address, it may be easier to create a #GNetworkAddress and use its
240 * #GSocketConnectable interface.
242 * Return value: a #GList of #GInetAddress, or %NULL on error. You
243 * must unref each of the addresses and free the list when you are
244 * done with it. (You can use g_resolver_free_addresses() to do this.)
249 g_resolver_lookup_by_name (GResolver *resolver,
250 const gchar *hostname,
251 GCancellable *cancellable,
256 gchar *ascii_hostname = NULL;
258 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
259 g_return_val_if_fail (hostname != NULL, NULL);
261 /* Check if @hostname is just an IP address */
262 addr = g_inet_address_new_from_string (hostname);
264 return g_list_append (NULL, addr);
266 if (g_hostname_is_non_ascii (hostname))
267 hostname = ascii_hostname = g_hostname_to_ascii (hostname);
269 g_resolver_maybe_reload (resolver);
270 addrs = G_RESOLVER_GET_CLASS (resolver)->
271 lookup_by_name (resolver, hostname, cancellable, error);
273 g_free (ascii_hostname);
278 * g_resolver_lookup_by_name_async:
279 * @resolver: a #GResolver
280 * @hostname: the hostname to look up the address of
281 * @cancellable: a #GCancellable, or %NULL
282 * @callback: callback to call after resolution completes
283 * @user_data: data for @callback
285 * Begins asynchronously resolving @hostname to determine its
286 * associated IP address(es), and eventually calls @callback, which
287 * must call g_resolver_lookup_by_name_finish() to get the result.
288 * See g_resolver_lookup_by_name() for more details.
293 g_resolver_lookup_by_name_async (GResolver *resolver,
294 const gchar *hostname,
295 GCancellable *cancellable,
296 GAsyncReadyCallback callback,
300 gchar *ascii_hostname = NULL;
302 g_return_if_fail (G_IS_RESOLVER (resolver));
303 g_return_if_fail (hostname != NULL);
305 /* Check if @hostname is just an IP address */
306 addr = g_inet_address_new_from_string (hostname);
309 GSimpleAsyncResult *simple;
311 simple = g_simple_async_result_new (G_OBJECT (resolver),
313 g_resolver_lookup_by_name_async);
315 g_simple_async_result_set_op_res_gpointer (simple, addr, g_object_unref);
316 g_simple_async_result_complete_in_idle (simple);
317 g_object_unref (simple);
321 if (g_hostname_is_non_ascii (hostname))
322 hostname = ascii_hostname = g_hostname_to_ascii (hostname);
324 g_resolver_maybe_reload (resolver);
325 G_RESOLVER_GET_CLASS (resolver)->
326 lookup_by_name_async (resolver, hostname, cancellable, callback, user_data);
328 g_free (ascii_hostname);
332 * g_resolver_lookup_by_name_finish:
333 * @resolver: a #GResolver
334 * @result: the result passed to your #GAsyncReadyCallback
335 * @error: return location for a #GError, or %NULL
337 * Retrieves the result of a call to
338 * g_resolver_lookup_by_name_async().
340 * If the DNS resolution failed, @error (if non-%NULL) will be set to
341 * a value from #GResolverError. If the operation was cancelled,
342 * @error will be set to %G_IO_ERROR_CANCELLED.
344 * Return value: a #GList of #GInetAddress, or %NULL on error. See
345 * g_resolver_lookup_by_name() for more details.
350 g_resolver_lookup_by_name_finish (GResolver *resolver,
351 GAsyncResult *result,
354 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
356 if (G_IS_SIMPLE_ASYNC_RESULT (result))
358 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
360 if (g_simple_async_result_propagate_error (simple, error))
363 /* Handle the stringified-IP-addr case */
364 if (g_simple_async_result_get_source_tag (simple) == g_resolver_lookup_by_name_async)
368 addr = g_simple_async_result_get_op_res_gpointer (simple);
369 return g_list_append (NULL, g_object_ref (addr));
373 return G_RESOLVER_GET_CLASS (resolver)->
374 lookup_by_name_finish (resolver, result, error);
378 * g_resolver_free_addresses:
379 * @addresses: a #GList of #GInetAddress
381 * Frees @addresses (which should be the return value from
382 * g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
383 * (This is a convenience method; you can also simply free the results
389 g_resolver_free_addresses (GList *addresses)
393 for (a = addresses; a; a = a->next)
394 g_object_unref (a->data);
395 g_list_free (addresses);
399 * g_resolver_lookup_by_address:
400 * @resolver: a #GResolver
401 * @address: the address to reverse-resolve
402 * @cancellable: a #GCancellable, or %NULL
403 * @error: return location for a #GError, or %NULL
405 * Synchronously reverse-resolves @address to determine its
406 * associated hostname.
408 * If the DNS resolution fails, @error (if non-%NULL) will be set to
409 * a value from #GResolverError.
411 * If @cancellable is non-%NULL, it can be used to cancel the
412 * operation, in which case @error (if non-%NULL) will be set to
413 * %G_IO_ERROR_CANCELLED.
415 * Return value: a hostname (either ASCII-only, or in ASCII-encoded
416 * form), or %NULL on error.
421 g_resolver_lookup_by_address (GResolver *resolver,
422 GInetAddress *address,
423 GCancellable *cancellable,
426 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
427 g_return_val_if_fail (G_IS_INET_ADDRESS (address), NULL);
429 g_resolver_maybe_reload (resolver);
430 return G_RESOLVER_GET_CLASS (resolver)->
431 lookup_by_address (resolver, address, cancellable, error);
435 * g_resolver_lookup_by_address_async:
436 * @resolver: a #GResolver
437 * @address: the address to reverse-resolve
438 * @cancellable: a #GCancellable, or %NULL
439 * @callback: callback to call after resolution completes
440 * @user_data: data for @callback
442 * Begins asynchronously reverse-resolving @address to determine its
443 * associated hostname, and eventually calls @callback, which must
444 * call g_resolver_lookup_by_address_finish() to get the final result.
449 g_resolver_lookup_by_address_async (GResolver *resolver,
450 GInetAddress *address,
451 GCancellable *cancellable,
452 GAsyncReadyCallback callback,
455 g_return_if_fail (G_IS_RESOLVER (resolver));
456 g_return_if_fail (G_IS_INET_ADDRESS (address));
458 g_resolver_maybe_reload (resolver);
459 G_RESOLVER_GET_CLASS (resolver)->
460 lookup_by_address_async (resolver, address, cancellable, callback, user_data);
464 * g_resolver_lookup_by_address_finish:
465 * @resolver: a #GResolver
466 * @result: the result passed to your #GAsyncReadyCallback
467 * @error: return location for a #GError, or %NULL
469 * Retrieves the result of a previous call to
470 * g_resolver_lookup_by_address_async().
472 * If the DNS resolution failed, @error (if non-%NULL) will be set to
473 * a value from #GResolverError. If the operation was cancelled,
474 * @error will be set to %G_IO_ERROR_CANCELLED.
476 * Return value: a hostname (either ASCII-only, or in ASCII-encoded
477 * form), or %NULL on error.
482 g_resolver_lookup_by_address_finish (GResolver *resolver,
483 GAsyncResult *result,
486 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
488 if (G_IS_SIMPLE_ASYNC_RESULT (result))
490 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
492 if (g_simple_async_result_propagate_error (simple, error))
496 return G_RESOLVER_GET_CLASS (resolver)->
497 lookup_by_address_finish (resolver, result, error);
501 g_resolver_get_service_rrname (const char *service,
502 const char *protocol,
505 gchar *rrname, *ascii_domain = NULL;
507 if (g_hostname_is_non_ascii (domain))
508 domain = ascii_domain = g_hostname_to_ascii (domain);
510 rrname = g_strdup_printf ("_%s._%s.%s", service, protocol, domain);
512 g_free (ascii_domain);
517 * g_resolver_lookup_service:
518 * @resolver: a #GResolver
519 * @service: the service type to look up (eg, "ldap")
520 * @protocol: the networking protocol to use for @service (eg, "tcp")
521 * @domain: the DNS domain to look up the service in
522 * @cancellable: a #GCancellable, or %NULL
523 * @error: return location for a #GError, or %NULL
525 * Synchronously performs a DNS SRV lookup for the given @service and
526 * @protocol in the given @domain and returns an array of #GSrvTarget.
527 * @domain may be an ASCII-only or UTF-8 hostname. Note also that the
528 * @service and @protocol arguments <emphasis>do not</emphasis>
529 * include the leading underscore that appears in the actual DNS
532 * On success, g_resolver_lookup_service() will return a #GList of
533 * #GSrvTarget, sorted in order of preference. (That is, you should
534 * attempt to connect to the first target first, then the second if
535 * the first fails, etc.)
537 * If the DNS resolution fails, @error (if non-%NULL) will be set to
538 * a value from #GResolverError.
540 * If @cancellable is non-%NULL, it can be used to cancel the
541 * operation, in which case @error (if non-%NULL) will be set to
542 * %G_IO_ERROR_CANCELLED.
544 * If you are planning to connect to the service, it is usually easier
545 * to create a #GNetworkService and use its #GSocketConnectable
548 * Return value: a #GList of #GSrvTarget, or %NULL on error. You must
549 * free each of the targets and the list when you are done with it.
550 * (You can use g_resolver_free_targets() to do this.)
555 g_resolver_lookup_service (GResolver *resolver,
556 const gchar *service,
557 const gchar *protocol,
559 GCancellable *cancellable,
565 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
566 g_return_val_if_fail (service != NULL, NULL);
567 g_return_val_if_fail (protocol != NULL, NULL);
568 g_return_val_if_fail (domain != NULL, NULL);
570 rrname = g_resolver_get_service_rrname (service, protocol, domain);
572 g_resolver_maybe_reload (resolver);
573 targets = G_RESOLVER_GET_CLASS (resolver)->
574 lookup_service (resolver, rrname, cancellable, error);
581 * g_resolver_lookup_service_async:
582 * @resolver: a #GResolver
583 * @service: the service type to look up (eg, "ldap")
584 * @protocol: the networking protocol to use for @service (eg, "tcp")
585 * @domain: the DNS domain to look up the service in
586 * @cancellable: a #GCancellable, or %NULL
587 * @callback: callback to call after resolution completes
588 * @user_data: data for @callback
590 * Begins asynchronously performing a DNS SRV lookup for the given
591 * @service and @protocol in the given @domain, and eventually calls
592 * @callback, which must call g_resolver_lookup_service_finish() to
593 * get the final result. See g_resolver_lookup_service() for more
599 g_resolver_lookup_service_async (GResolver *resolver,
600 const gchar *service,
601 const gchar *protocol,
603 GCancellable *cancellable,
604 GAsyncReadyCallback callback,
609 g_return_if_fail (G_IS_RESOLVER (resolver));
610 g_return_if_fail (service != NULL);
611 g_return_if_fail (protocol != NULL);
612 g_return_if_fail (domain != NULL);
614 rrname = g_resolver_get_service_rrname (service, protocol, domain);
616 g_resolver_maybe_reload (resolver);
617 G_RESOLVER_GET_CLASS (resolver)->
618 lookup_service_async (resolver, rrname, cancellable, callback, user_data);
624 * g_resolver_lookup_service_finish:
625 * @resolver: a #GResolver
626 * @result: the result passed to your #GAsyncReadyCallback
627 * @error: return location for a #GError, or %NULL
629 * Retrieves the result of a previous call to
630 * g_resolver_lookup_service_async().
632 * If the DNS resolution failed, @error (if non-%NULL) will be set to
633 * a value from #GResolverError. If the operation was cancelled,
634 * @error will be set to %G_IO_ERROR_CANCELLED.
636 * Return value: a #GList of #GSrvTarget, or %NULL on error. See
637 * g_resolver_lookup_service() for more details.
642 g_resolver_lookup_service_finish (GResolver *resolver,
643 GAsyncResult *result,
646 g_return_val_if_fail (G_IS_RESOLVER (resolver), NULL);
648 if (G_IS_SIMPLE_ASYNC_RESULT (result))
650 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
652 if (g_simple_async_result_propagate_error (simple, error))
656 return G_RESOLVER_GET_CLASS (resolver)->
657 lookup_service_finish (resolver, result, error);
661 * g_resolver_free_targets:
662 * @targets: a #GList of #GSrvTarget
664 * Frees @targets (which should be the return value from
665 * g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
666 * (This is a convenience method; you can also simply free the
672 g_resolver_free_targets (GList *targets)
676 for (t = targets; t; t = t->next)
677 g_srv_target_free (t->data);
678 g_list_free (targets);
682 * g_resolver_error_quark:
684 * Gets the #GResolver Error Quark.
686 * Return value: a #GQuark.
691 g_resolver_error_quark (void)
693 return g_quark_from_static_string ("g-resolver-error-quark");
697 static GResolverError
698 g_resolver_error_from_addrinfo_error (gint err)
703 #if defined(EAI_NODATA) && (EAI_NODATA != EAI_NONAME)
707 return G_RESOLVER_ERROR_NOT_FOUND;
710 return G_RESOLVER_ERROR_TEMPORARY_FAILURE;
713 return G_RESOLVER_ERROR_INTERNAL;
717 struct addrinfo _g_resolver_addrinfo_hints;
719 /* Private method to process a getaddrinfo() response. */
721 _g_resolver_addresses_from_addrinfo (const char *hostname,
722 struct addrinfo *res,
727 GSocketAddress *sockaddr;
733 g_set_error (error, G_RESOLVER_ERROR,
734 g_resolver_error_from_addrinfo_error (gai_retval),
735 _("Error resolving '%s': %s"),
736 hostname, gai_strerror (gai_retval));
740 g_return_val_if_fail (res != NULL, NULL);
743 for (ai = res; ai; ai = ai->ai_next)
745 sockaddr = g_socket_address_new_from_native (ai->ai_addr, ai->ai_addrlen);
746 if (!sockaddr || !G_IS_INET_SOCKET_ADDRESS (sockaddr))
749 addr = g_object_ref (g_inet_socket_address_get_address ((GInetSocketAddress *)sockaddr));
750 addrs = g_list_prepend (addrs, addr);
751 g_object_unref (sockaddr);
754 return g_list_reverse (addrs);
757 /* Private method to set up a getnameinfo() request */
759 _g_resolver_address_to_sockaddr (GInetAddress *address,
760 struct sockaddr_storage *sa,
763 GSocketAddress *sockaddr;
765 sockaddr = g_inet_socket_address_new (address, 0);
766 g_socket_address_to_native (sockaddr, (struct sockaddr *)sa, sizeof (*sa), NULL);
767 *len = g_socket_address_get_native_size (sockaddr);
768 g_object_unref (sockaddr);
771 /* Private method to process a getnameinfo() response. */
773 _g_resolver_name_from_nameinfo (GInetAddress *address,
782 phys = g_inet_address_to_string (address);
783 g_set_error (error, G_RESOLVER_ERROR,
784 g_resolver_error_from_addrinfo_error (gni_retval),
785 _("Error reverse-resolving '%s': %s"),
786 phys ? phys : "(unknown)", gai_strerror (gni_retval));
791 return g_strdup (name);
794 #if defined(G_OS_UNIX)
795 /* Private method to process a res_query response into GSrvTargets */
797 _g_resolver_targets_from_res_query (const gchar *rrname,
806 guint16 type, qclass, rdlength, priority, weight, port;
814 GResolverError errnum;
817 if (len == 0 || herr == HOST_NOT_FOUND || herr == NO_DATA)
819 errnum = G_RESOLVER_ERROR_NOT_FOUND;
820 format = _("No service record for '%s'");
822 else if (herr == TRY_AGAIN)
824 errnum = G_RESOLVER_ERROR_TEMPORARY_FAILURE;
825 format = _("Temporarily unable to resolve '%s'");
829 errnum = G_RESOLVER_ERROR_INTERNAL;
830 format = _("Error resolving '%s'");
833 g_set_error (error, G_RESOLVER_ERROR, errnum, format, rrname);
839 header = (HEADER *)answer;
840 p = answer + sizeof (HEADER);
844 count = ntohs (header->qdcount);
845 while (count-- && p < end)
847 p += dn_expand (answer, end, p, namebuf, sizeof (namebuf));
852 count = ntohs (header->ancount);
853 while (count-- && p < end)
855 p += dn_expand (answer, end, p, namebuf, sizeof (namebuf));
857 GETSHORT (qclass, p);
859 GETSHORT (rdlength, p);
861 if (type != T_SRV || qclass != C_IN)
867 GETSHORT (priority, p);
868 GETSHORT (weight, p);
870 p += dn_expand (answer, end, p, namebuf, sizeof (namebuf));
872 target = g_srv_target_new (namebuf, port, priority, weight);
873 targets = g_list_prepend (targets, target);
876 return g_srv_target_list_sort (targets);
878 #elif defined(G_OS_WIN32)
879 /* Private method to process a DnsQuery response into GSrvTargets */
881 _g_resolver_targets_from_DnsQuery (const gchar *rrname,
890 if (status != ERROR_SUCCESS)
892 GResolverError errnum;
895 if (status == DNS_ERROR_RCODE_NAME_ERROR)
897 errnum = G_RESOLVER_ERROR_NOT_FOUND;
898 format = _("No service record for '%s'");
900 else if (status == DNS_ERROR_RCODE_SERVER_FAILURE)
902 errnum = G_RESOLVER_ERROR_TEMPORARY_FAILURE;
903 format = _("Temporarily unable to resolve '%s'");
907 errnum = G_RESOLVER_ERROR_INTERNAL;
908 format = _("Error resolving '%s'");
911 g_set_error (error, G_RESOLVER_ERROR, errnum, format, rrname);
916 for (rec = results; rec; rec = rec->pNext)
918 if (rec->wType != DNS_TYPE_SRV)
921 target = g_srv_target_new (rec->Data.SRV.pNameTarget,
923 rec->Data.SRV.wPriority,
924 rec->Data.SRV.wWeight);
925 targets = g_list_prepend (targets, target);
928 return g_srv_target_list_sort (targets);