Add a lot of missing annotations
[platform/upstream/glib.git] / gio / gnetworkservice.c
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2
3 /* GIO - GLib Input, Output and Streaming Library
4  *
5  * Copyright (C) 2008 Red Hat, Inc.
6  *
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.
11  *
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.
16  *
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.
21  */
22
23 #include "config.h"
24 #include <glib.h>
25 #include "glibintl.h"
26
27 #include "gnetworkservice.h"
28
29 #include "gcancellable.h"
30 #include "ginetaddress.h"
31 #include "ginetsocketaddress.h"
32 #include "gioerror.h"
33 #include "gnetworkaddress.h"
34 #include "gnetworkingprivate.h"
35 #include "gresolver.h"
36 #include "gsimpleasyncresult.h"
37 #include "gsocketaddressenumerator.h"
38 #include "gsocketconnectable.h"
39 #include "gsrvtarget.h"
40
41 #include <stdlib.h>
42 #include <string.h>
43
44
45 /**
46  * SECTION:gnetworkservice
47  * @short_description: A GSocketConnectable for resolving SRV records
48  * @include: gio/gio.h
49  *
50  * Like #GNetworkAddress does with hostnames, #GNetworkService
51  * provides an easy way to resolve a SRV record, and then attempt to
52  * connect to one of the hosts that implements that service, handling
53  * service priority/weighting, multiple IP addresses, and multiple
54  * address families.
55  *
56  * See #GSrvTarget for more information about SRV records, and see
57  * #GSocketConnectable for and example of using the connectable
58  * interface.
59  */
60
61 /**
62  * GNetworkService:
63  *
64  * A #GSocketConnectable for resolving a SRV record and connecting to
65  * that service.
66  */
67
68 struct _GNetworkServicePrivate
69 {
70   gchar *service, *protocol, *domain, *scheme;
71   GList *targets;
72 };
73
74 enum {
75   PROP_0,
76   PROP_SERVICE,
77   PROP_PROTOCOL,
78   PROP_DOMAIN,
79   PROP_SCHEME
80 };
81
82 static void g_network_service_set_property (GObject      *object,
83                                             guint         prop_id,
84                                             const GValue *value,
85                                             GParamSpec   *pspec);
86 static void g_network_service_get_property (GObject      *object,
87                                             guint         prop_id,
88                                             GValue       *value,
89                                             GParamSpec   *pspec);
90
91 static void                      g_network_service_connectable_iface_init       (GSocketConnectableIface *iface);
92 static GSocketAddressEnumerator *g_network_service_connectable_enumerate        (GSocketConnectable      *connectable);
93 static GSocketAddressEnumerator *g_network_service_connectable_proxy_enumerate  (GSocketConnectable      *connectable);
94
95 G_DEFINE_TYPE_WITH_CODE (GNetworkService, g_network_service, G_TYPE_OBJECT,
96                          G_IMPLEMENT_INTERFACE (G_TYPE_SOCKET_CONNECTABLE,
97                                                 g_network_service_connectable_iface_init))
98
99 static void
100 g_network_service_finalize (GObject *object)
101 {
102   GNetworkService *srv = G_NETWORK_SERVICE (object);
103
104   g_free (srv->priv->service);
105   g_free (srv->priv->protocol);
106   g_free (srv->priv->domain);
107   g_free (srv->priv->scheme);
108
109   if (srv->priv->targets)
110     g_resolver_free_targets (srv->priv->targets);
111
112   G_OBJECT_CLASS (g_network_service_parent_class)->finalize (object);
113 }
114
115 static void
116 g_network_service_class_init (GNetworkServiceClass *klass)
117 {
118   GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
119
120   g_type_class_add_private (klass, sizeof (GNetworkServicePrivate));
121
122   gobject_class->set_property = g_network_service_set_property;
123   gobject_class->get_property = g_network_service_get_property;
124   gobject_class->finalize = g_network_service_finalize;
125
126   g_object_class_install_property (gobject_class, PROP_SERVICE,
127                                    g_param_spec_string ("service",
128                                                         P_("Service"),
129                                                         P_("Service name, eg \"ldap\""),
130                                                         NULL,
131                                                         G_PARAM_READWRITE |
132                                                         G_PARAM_CONSTRUCT_ONLY |
133                                                         G_PARAM_STATIC_STRINGS));
134   g_object_class_install_property (gobject_class, PROP_PROTOCOL,
135                                    g_param_spec_string ("protocol",
136                                                         P_("Protocol"),
137                                                         P_("Network protocol, eg \"tcp\""),
138                                                         NULL,
139                                                         G_PARAM_READWRITE |
140                                                         G_PARAM_CONSTRUCT_ONLY |
141                                                         G_PARAM_STATIC_STRINGS));
142   g_object_class_install_property (gobject_class, PROP_DOMAIN,
143                                    g_param_spec_string ("domain",
144                                                         P_("Domain"),
145                                                         P_("Network domain, eg, \"example.com\""),
146                                                         NULL,
147                                                         G_PARAM_READWRITE |
148                                                         G_PARAM_CONSTRUCT_ONLY |
149                                                         G_PARAM_STATIC_STRINGS));
150   g_object_class_install_property (gobject_class, PROP_DOMAIN,
151                                    g_param_spec_string ("scheme",
152                                                         P_("Scheme"),
153                                                         P_("Network scheme (default is to use service)"),
154                                                         NULL,
155                                                         G_PARAM_READWRITE |
156                                                         G_PARAM_STATIC_STRINGS));
157
158 }
159
160 static void
161 g_network_service_connectable_iface_init (GSocketConnectableIface *connectable_iface)
162 {
163   connectable_iface->enumerate = g_network_service_connectable_enumerate;
164   connectable_iface->proxy_enumerate = g_network_service_connectable_proxy_enumerate;
165 }
166
167 static void
168 g_network_service_init (GNetworkService *srv)
169 {
170   srv->priv = G_TYPE_INSTANCE_GET_PRIVATE (srv, G_TYPE_NETWORK_SERVICE,
171                                            GNetworkServicePrivate);
172 }
173
174 static void
175 g_network_service_set_property (GObject      *object,
176                                 guint         prop_id,
177                                 const GValue *value,
178                                 GParamSpec   *pspec)
179 {
180   GNetworkService *srv = G_NETWORK_SERVICE (object);
181
182   switch (prop_id)
183     {
184     case PROP_SERVICE:
185       srv->priv->service = g_value_dup_string (value);
186       break;
187
188     case PROP_PROTOCOL:
189       srv->priv->protocol = g_value_dup_string (value);
190       break;
191
192     case PROP_DOMAIN:
193       srv->priv->domain = g_value_dup_string (value);
194       break;
195
196     case PROP_SCHEME:
197       g_network_service_set_scheme (srv, g_value_get_string (value));
198       break;
199
200     default:
201       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
202       break;
203     }
204 }
205
206 static void
207 g_network_service_get_property (GObject    *object,
208                                 guint       prop_id,
209                                 GValue     *value,
210                                 GParamSpec *pspec)
211 {
212   GNetworkService *srv = G_NETWORK_SERVICE (object);
213
214   switch (prop_id)
215     {
216     case PROP_SERVICE:
217       g_value_set_string (value, g_network_service_get_service (srv));
218       break;
219
220     case PROP_PROTOCOL:
221       g_value_set_string (value, g_network_service_get_protocol (srv));
222       break;
223
224     case PROP_DOMAIN:
225       g_value_set_string (value, g_network_service_get_domain (srv));
226       break;
227
228     case PROP_SCHEME:
229       g_value_set_string (value, g_network_service_get_scheme (srv));
230       break;
231
232     default:
233       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
234       break;
235     }
236 }
237
238 /**
239  * g_network_service_new:
240  * @service: the service type to look up (eg, "ldap")
241  * @protocol: the networking protocol to use for @service (eg, "tcp")
242  * @domain: the DNS domain to look up the service in
243  *
244  * Creates a new #GNetworkService representing the given @service,
245  * @protocol, and @domain. This will initially be unresolved; use the
246  * #GSocketConnectable interface to resolve it.
247  *
248  * Return value: (transfer full): a new #GNetworkService
249  *
250  * Since: 2.22
251  */
252 GSocketConnectable *
253 g_network_service_new (const gchar *service,
254                        const gchar *protocol,
255                        const gchar *domain)
256 {
257   return g_object_new (G_TYPE_NETWORK_SERVICE,
258                        "service", service,
259                        "protocol", protocol,
260                        "domain", domain,
261                        NULL);
262 }
263
264 /**
265  * g_network_service_get_service:
266  * @srv: a #GNetworkService
267  *
268  * Gets @srv's service name (eg, "ldap").
269  *
270  * Return value: @srv's service name
271  *
272  * Since: 2.22
273  */
274 const gchar *
275 g_network_service_get_service (GNetworkService *srv)
276 {
277   g_return_val_if_fail (G_IS_NETWORK_SERVICE (srv), NULL);
278
279   return srv->priv->service;
280 }
281
282 /**
283  * g_network_service_get_protocol:
284  * @srv: a #GNetworkService
285  *
286  * Gets @srv's protocol name (eg, "tcp").
287  *
288  * Return value: @srv's protocol name
289  *
290  * Since: 2.22
291  */
292 const gchar *
293 g_network_service_get_protocol (GNetworkService *srv)
294 {
295   g_return_val_if_fail (G_IS_NETWORK_SERVICE (srv), NULL);
296
297   return srv->priv->protocol;
298 }
299
300 /**
301  * g_network_service_get_domain:
302  * @srv: a #GNetworkService
303  *
304  * Gets the domain that @srv serves. This might be either UTF-8 or
305  * ASCII-encoded, depending on what @srv was created with.
306  *
307  * Return value: @srv's domain name
308  *
309  * Since: 2.22
310  */
311 const gchar *
312 g_network_service_get_domain (GNetworkService *srv)
313 {
314   g_return_val_if_fail (G_IS_NETWORK_SERVICE (srv), NULL);
315
316   return srv->priv->domain;
317 }
318
319 /**
320  * g_network_service_get_scheme:
321  * @srv: a #GNetworkService
322  *
323  * Get's the URI scheme used to resolve proxies. By default, the service name
324  * is used as scheme.
325  *
326  * Return value: @srv's scheme name
327  *
328  * Since: 2.26
329  */
330 const gchar *
331 g_network_service_get_scheme (GNetworkService *srv)
332 {
333   g_return_val_if_fail (G_IS_NETWORK_SERVICE (srv), NULL);
334
335   if (srv->priv->scheme)
336     return srv->priv->scheme;
337   else
338     return srv->priv->service;
339 }
340
341 /**
342  * g_network_service_set_scheme:
343  * @srv: a #GNetworkService
344  * @scheme: a URI scheme
345  *
346  * Set's the URI scheme used to resolve proxies. By default, the service name
347  * is used as scheme.
348  *
349  * Since: 2.26
350  */
351 void
352 g_network_service_set_scheme (GNetworkService *srv,
353                               const gchar     *scheme)
354 {
355   g_return_if_fail (G_IS_NETWORK_SERVICE (srv));
356
357   if (srv->priv->scheme)
358     g_free (srv->priv->scheme);
359   srv->priv->scheme = g_strdup (scheme);
360
361   g_object_notify (G_OBJECT (srv), "scheme");
362 }
363
364
365 #define G_TYPE_NETWORK_SERVICE_ADDRESS_ENUMERATOR (_g_network_service_address_enumerator_get_type ())
366 #define G_NETWORK_SERVICE_ADDRESS_ENUMERATOR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_NETWORK_SERVICE_ADDRESS_ENUMERATOR, GNetworkServiceAddressEnumerator))
367
368 typedef struct {
369   GSocketAddressEnumerator parent_instance;
370
371   GResolver *resolver;
372   GNetworkService *srv;
373   GSocketAddressEnumerator *addr_enum;
374   GList *t;
375   gboolean use_proxy;
376
377   GError *error;
378
379   /* For async operation */
380   GCancellable *cancellable;
381   GSimpleAsyncResult *result;
382 } GNetworkServiceAddressEnumerator;
383
384 typedef struct {
385   GSocketAddressEnumeratorClass parent_class;
386
387 } GNetworkServiceAddressEnumeratorClass;
388
389 G_DEFINE_TYPE (GNetworkServiceAddressEnumerator, _g_network_service_address_enumerator, G_TYPE_SOCKET_ADDRESS_ENUMERATOR)
390
391 static GSocketAddress *
392 g_network_service_address_enumerator_next (GSocketAddressEnumerator  *enumerator,
393                                            GCancellable              *cancellable,
394                                            GError                   **error)
395 {
396   GNetworkServiceAddressEnumerator *srv_enum =
397     G_NETWORK_SERVICE_ADDRESS_ENUMERATOR (enumerator);
398   GSocketAddress *ret = NULL;
399
400   /* If we haven't yet resolved srv, do that */
401   if (!srv_enum->srv->priv->targets)
402     {
403       GList *targets;
404
405       targets = g_resolver_lookup_service (srv_enum->resolver,
406                                            srv_enum->srv->priv->service,
407                                            srv_enum->srv->priv->protocol,
408                                            srv_enum->srv->priv->domain,
409                                            cancellable, error);
410       if (!targets)
411         return NULL;
412
413       srv_enum->srv->priv->targets = targets;
414       srv_enum->t = srv_enum->srv->priv->targets;
415     }
416
417   /* Delegate to GNetworkAddress */
418   do
419     {
420       if (srv_enum->addr_enum == NULL && srv_enum->t)
421         {
422           GError *error = NULL;
423           gchar *uri;
424           gchar *hostname;
425           GSocketConnectable *addr;
426           GSrvTarget *target = srv_enum->t->data;
427
428           srv_enum->t = g_list_next (srv_enum->t);
429
430           hostname = g_hostname_to_ascii (g_srv_target_get_hostname (target));
431
432           if (hostname == NULL)
433             {
434               if (srv_enum->error == NULL)
435                 srv_enum->error =
436                   g_error_new (G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
437                                "Received invalid hostname '%s' from GSrvTarget",
438                                g_srv_target_get_hostname (target));
439               continue;
440             }
441
442           uri = _g_uri_from_authority (g_network_service_get_scheme (srv_enum->srv),
443                                        hostname,
444                                        g_srv_target_get_port (target),
445                                        NULL);
446           g_free (hostname);
447
448           addr = g_network_address_parse_uri (uri,
449                                               g_srv_target_get_port (target),
450                                               &error);
451           g_free (uri);
452
453           if (addr == NULL)
454             {
455               if (srv_enum->error == NULL)
456                 srv_enum->error = error;
457               continue;
458             }
459
460           if (srv_enum->use_proxy)
461             srv_enum->addr_enum = g_socket_connectable_proxy_enumerate (addr);
462           else
463             srv_enum->addr_enum = g_socket_connectable_enumerate (addr);
464           g_object_unref (addr);
465         }
466
467       if (srv_enum->addr_enum)
468         {
469           GError *error = NULL;
470
471           ret = g_socket_address_enumerator_next (srv_enum->addr_enum,
472                                                   cancellable,
473                                                   &error);
474
475           if (error)
476             {
477               if (srv_enum->error == NULL)
478                 srv_enum->error = error;
479               else
480                 g_error_free (error);
481
482               g_object_unref (srv_enum->addr_enum);
483               srv_enum->addr_enum = NULL;
484             }
485         }
486     }
487   while (srv_enum->addr_enum == NULL && srv_enum->t);
488
489   if (ret == NULL && srv_enum->error)
490     {
491       g_propagate_error (error, srv_enum->error);
492       srv_enum->error = NULL;
493     }
494
495   return ret;
496 }
497
498 static void next_async_resolved_targets   (GObject                          *source_object,
499                                            GAsyncResult                     *result,
500                                            gpointer                          user_data);
501 static void next_async_have_targets       (GNetworkServiceAddressEnumerator *srv_enum);
502 static void next_async_have_address       (GObject                          *source_object,
503                                            GAsyncResult                     *result,
504                                            gpointer                          user_data);
505
506 static void
507 g_network_service_address_enumerator_next_async (GSocketAddressEnumerator  *enumerator,
508                                                  GCancellable              *cancellable,
509                                                  GAsyncReadyCallback        callback,
510                                                  gpointer                   user_data)
511 {
512   GNetworkServiceAddressEnumerator *srv_enum =
513     G_NETWORK_SERVICE_ADDRESS_ENUMERATOR (enumerator);
514
515   g_return_if_fail (srv_enum->result == NULL);
516
517   srv_enum->result = g_simple_async_result_new (G_OBJECT (enumerator),
518                                                 callback, user_data,
519                                                 g_network_service_address_enumerator_next_async);
520
521   if (cancellable)
522     srv_enum->cancellable = g_object_ref (cancellable);
523
524   /* If we haven't yet resolved srv, do that */
525   if (!srv_enum->srv->priv->targets)
526     {
527       g_resolver_lookup_service_async (srv_enum->resolver,
528                                        srv_enum->srv->priv->service,
529                                        srv_enum->srv->priv->protocol,
530                                        srv_enum->srv->priv->domain,
531                                        cancellable,
532                                        next_async_resolved_targets,
533                                        srv_enum);
534     }
535   else
536     next_async_have_targets (srv_enum);
537 }
538
539 static void
540 next_async_resolved_targets (GObject      *source_object,
541                              GAsyncResult *result,
542                              gpointer      user_data)
543 {
544   GNetworkServiceAddressEnumerator *srv_enum = user_data;
545   GError *error = NULL;
546
547   srv_enum->srv->priv->targets =
548     g_resolver_lookup_service_finish (srv_enum->resolver, result, &error);
549
550   if (error)
551     {
552       GSimpleAsyncResult *simple = srv_enum->result;
553
554       srv_enum->result = NULL;
555       g_simple_async_result_set_from_error (simple, error);
556       g_error_free (error);
557       g_simple_async_result_complete (simple);
558       g_object_unref (simple);
559     }
560   else
561     {
562       srv_enum->t = srv_enum->srv->priv->targets;
563       next_async_have_targets (srv_enum);
564     }
565 }
566
567 static void
568 next_async_have_targets (GNetworkServiceAddressEnumerator *srv_enum)
569 {
570   /* Delegate to GNetworkAddress */
571   if (srv_enum->addr_enum == NULL && srv_enum->t)
572     {
573       GSocketConnectable *addr;
574       GSrvTarget *target = srv_enum->t->data;
575
576       srv_enum->t = g_list_next (srv_enum->t);
577       addr = g_network_address_new (g_srv_target_get_hostname (target),
578                                     (guint16) g_srv_target_get_port (target));
579
580       if (srv_enum->use_proxy)
581         srv_enum->addr_enum = g_socket_connectable_proxy_enumerate (addr);
582       else
583         srv_enum->addr_enum = g_socket_connectable_enumerate (addr);
584
585       g_object_unref (addr);
586     }
587
588   if (srv_enum->addr_enum)
589     {
590       g_socket_address_enumerator_next_async (srv_enum->addr_enum,
591                                               srv_enum->cancellable,
592                                               next_async_have_address,
593                                               srv_enum);
594     }
595   else
596     {
597       GSimpleAsyncResult *simple = srv_enum->result;
598       srv_enum->result = NULL;
599
600       if (srv_enum->error)
601         {
602           g_simple_async_result_set_from_error (simple, srv_enum->error);
603           g_error_free (srv_enum->error);
604           srv_enum->error = NULL;
605         }
606
607       g_simple_async_result_complete (simple);
608       g_object_unref (simple);
609     }
610 }
611
612 static void
613 next_async_have_address (GObject      *source_object,
614                          GAsyncResult *result,
615                          gpointer      user_data)
616 {
617   GNetworkServiceAddressEnumerator *srv_enum = user_data;
618   GSocketAddress *address;
619   GError *error = NULL;
620   
621   address = g_socket_address_enumerator_next_finish (srv_enum->addr_enum,
622                                                      result,
623                                                      &error);
624
625   if (error)
626     {
627       if (srv_enum->error == NULL)
628         srv_enum->error = error;
629       else
630         g_error_free (error);
631
632       g_object_unref (srv_enum->addr_enum);
633       srv_enum->addr_enum = NULL;
634
635       next_async_have_targets (srv_enum);
636     }
637   else
638     {
639       GSimpleAsyncResult *simple = srv_enum->result;
640
641       srv_enum->result = NULL;
642
643       if (address)
644         g_simple_async_result_set_op_res_gpointer (simple,
645                                                    address, g_object_unref);
646
647       g_simple_async_result_complete (simple);
648       g_object_unref (simple);
649     }
650 }
651
652 static GSocketAddress *
653 g_network_service_address_enumerator_next_finish (GSocketAddressEnumerator  *enumerator,
654                                                   GAsyncResult              *result,
655                                                   GError                   **error)
656 {
657   GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
658   GSocketAddress *sockaddr;
659
660   if (g_simple_async_result_propagate_error (simple, error))
661     return NULL;
662
663   sockaddr = g_simple_async_result_get_op_res_gpointer (simple);
664   return sockaddr ? g_object_ref (sockaddr) : NULL;
665 }
666
667 static void
668 _g_network_service_address_enumerator_init (GNetworkServiceAddressEnumerator *enumerator)
669 {
670 }
671
672 static void
673 g_network_service_address_enumerator_finalize (GObject *object)
674 {
675   GNetworkServiceAddressEnumerator *srv_enum =
676     G_NETWORK_SERVICE_ADDRESS_ENUMERATOR (object);
677
678   if (srv_enum->srv)
679     g_object_unref (srv_enum->srv);
680
681   if (srv_enum->addr_enum)
682     g_object_unref (srv_enum->addr_enum);
683
684   if (srv_enum->resolver)
685     g_object_unref (srv_enum->resolver);
686
687   if (srv_enum->result)
688     g_object_unref (srv_enum->result);
689
690   if (srv_enum->cancellable)
691     g_object_unref (srv_enum->cancellable);
692
693   if (srv_enum->error)
694     g_error_free (srv_enum->error);
695
696   G_OBJECT_CLASS (_g_network_service_address_enumerator_parent_class)->finalize (object);
697 }
698
699 static void
700 _g_network_service_address_enumerator_class_init (GNetworkServiceAddressEnumeratorClass *srvenum_class)
701 {
702   GObjectClass *object_class = G_OBJECT_CLASS (srvenum_class);
703   GSocketAddressEnumeratorClass *enumerator_class =
704     G_SOCKET_ADDRESS_ENUMERATOR_CLASS (srvenum_class);
705
706   enumerator_class->next        = g_network_service_address_enumerator_next;
707   enumerator_class->next_async  = g_network_service_address_enumerator_next_async;
708   enumerator_class->next_finish = g_network_service_address_enumerator_next_finish;
709
710   object_class->finalize = g_network_service_address_enumerator_finalize;
711 }
712
713 static GSocketAddressEnumerator *
714 g_network_service_connectable_enumerate (GSocketConnectable *connectable)
715 {
716   GNetworkServiceAddressEnumerator *srv_enum;
717
718   srv_enum = g_object_new (G_TYPE_NETWORK_SERVICE_ADDRESS_ENUMERATOR, NULL);
719   srv_enum->srv = g_object_ref (connectable);
720   srv_enum->resolver = g_resolver_get_default ();
721   srv_enum->use_proxy = FALSE;
722
723   return G_SOCKET_ADDRESS_ENUMERATOR (srv_enum);
724 }
725
726 static GSocketAddressEnumerator *
727 g_network_service_connectable_proxy_enumerate (GSocketConnectable *connectable)
728 {
729   GSocketAddressEnumerator *addr_enum;
730   GNetworkServiceAddressEnumerator *srv_enum;
731
732   addr_enum = g_network_service_connectable_enumerate (connectable);
733   srv_enum = G_NETWORK_SERVICE_ADDRESS_ENUMERATOR (addr_enum);
734   srv_enum->use_proxy = TRUE;
735
736   return addr_enum;
737 }