Coverage Report

Created: 2025-07-23 08:13

/src/pango/subprojects/glib/gio/ginetsocketaddress.c
Line
Count
Source (jump to first uncovered line)
1
/* GIO - GLib Input, Output and Streaming Library
2
 *
3
 * Copyright (C) 2008 Christian Kellner, Samuel Cormier-Iijima
4
 *
5
 * SPDX-License-Identifier: LGPL-2.1-or-later
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.1 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, see <http://www.gnu.org/licenses/>.
19
 *
20
 * Authors: Christian Kellner <gicmo@gnome.org>
21
 *          Samuel Cormier-Iijima <sciyoshi@gmail.com>
22
 */
23
24
#include <config.h>
25
#include <glib.h>
26
#include <string.h>
27
28
#include "ginetsocketaddress.h"
29
#include "ginetaddress.h"
30
#include "gnetworkingprivate.h"
31
#include "gsocketconnectable.h"
32
#include "gioerror.h"
33
#include "glibintl.h"
34
35
36
/**
37
 * GInetSocketAddress:
38
 *
39
 * An IPv4 or IPv6 socket address. That is, the combination of a
40
 * [class@Gio.InetAddress] and a port number.
41
 *
42
 * In UNIX terms, `GInetSocketAddress` corresponds to a
43
 * [`struct sockaddr_in` or `struct sockaddr_in6`](man:sockaddr(3type)).
44
 */
45
46
struct _GInetSocketAddressPrivate
47
{
48
  GInetAddress *address;
49
  guint16       port;
50
  guint32       flowinfo;
51
  guint32       scope_id;
52
};
53
54
static void   g_inet_socket_address_connectable_iface_init (GSocketConnectableIface *iface);
55
static gchar *g_inet_socket_address_connectable_to_string  (GSocketConnectable      *connectable);
56
57
G_DEFINE_TYPE_WITH_CODE (GInetSocketAddress, g_inet_socket_address, G_TYPE_SOCKET_ADDRESS,
58
                         G_ADD_PRIVATE (GInetSocketAddress)
59
                         G_IMPLEMENT_INTERFACE (G_TYPE_SOCKET_CONNECTABLE,
60
                                                g_inet_socket_address_connectable_iface_init))
61
62
enum {
63
  PROP_0,
64
  PROP_ADDRESS,
65
  PROP_PORT,
66
  PROP_FLOWINFO,
67
  PROP_SCOPE_ID
68
};
69
70
static void
71
g_inet_socket_address_dispose (GObject *object)
72
0
{
73
0
  GInetSocketAddress *address = G_INET_SOCKET_ADDRESS (object);
74
75
0
  g_clear_object (&(address->priv->address));
76
77
0
  G_OBJECT_CLASS (g_inet_socket_address_parent_class)->dispose (object);
78
0
}
79
80
static void
81
g_inet_socket_address_get_property (GObject    *object,
82
                                    guint       prop_id,
83
                                    GValue     *value,
84
                                    GParamSpec *pspec)
85
0
{
86
0
  GInetSocketAddress *address = G_INET_SOCKET_ADDRESS (object);
87
88
0
  switch (prop_id)
89
0
    {
90
0
      case PROP_ADDRESS:
91
0
        g_value_set_object (value, address->priv->address);
92
0
        break;
93
94
0
      case PROP_PORT:
95
0
        g_value_set_uint (value, address->priv->port);
96
0
        break;
97
98
0
      case PROP_FLOWINFO:
99
0
  g_return_if_fail (g_inet_address_get_family (address->priv->address) == G_SOCKET_FAMILY_IPV6);
100
0
        g_value_set_uint (value, g_inet_socket_address_get_flowinfo (address));
101
0
        break;
102
103
0
      case PROP_SCOPE_ID:
104
0
  g_return_if_fail (g_inet_address_get_family (address->priv->address) == G_SOCKET_FAMILY_IPV6);
105
0
        g_value_set_uint (value, g_inet_socket_address_get_scope_id (address));
106
0
        break;
107
108
0
      default:
109
0
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
110
0
    }
111
0
}
112
113
static void
114
g_inet_socket_address_set_property (GObject      *object,
115
                                    guint         prop_id,
116
                                    const GValue *value,
117
                                    GParamSpec   *pspec)
118
0
{
119
0
  GInetSocketAddress *address = G_INET_SOCKET_ADDRESS (object);
120
121
0
  switch (prop_id)
122
0
    {
123
0
      case PROP_ADDRESS:
124
0
        address->priv->address = g_object_ref (g_value_get_object (value));
125
0
        break;
126
127
0
      case PROP_PORT:
128
0
        address->priv->port = (guint16) g_value_get_uint (value);
129
0
        break;
130
131
0
      case PROP_FLOWINFO:
132
  /* We can't test that address->priv->address is IPv6 here,
133
   * since this property might get set before PROP_ADDRESS.
134
   */
135
0
        address->priv->flowinfo = g_value_get_uint (value);
136
0
        break;
137
138
0
      case PROP_SCOPE_ID:
139
0
        address->priv->scope_id = g_value_get_uint (value);
140
0
        break;
141
142
0
      default:
143
0
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
144
0
    }
145
0
}
146
147
static GSocketFamily
148
g_inet_socket_address_get_family (GSocketAddress *address)
149
0
{
150
0
  GInetSocketAddress *addr;
151
152
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), 0);
153
154
0
  addr = G_INET_SOCKET_ADDRESS (address);
155
156
0
  return g_inet_address_get_family (addr->priv->address);
157
0
}
158
159
static gssize
160
g_inet_socket_address_get_native_size (GSocketAddress *address)
161
0
{
162
0
  GInetSocketAddress *addr;
163
0
  GSocketFamily family;
164
165
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), 0);
166
167
0
  addr = G_INET_SOCKET_ADDRESS (address);
168
0
  family = g_inet_address_get_family (addr->priv->address);
169
170
0
  if (family == AF_INET)
171
0
    return sizeof (struct sockaddr_in);
172
0
  else if (family == AF_INET6)
173
0
    return sizeof (struct sockaddr_in6);
174
0
  else
175
0
    return -1;
176
0
}
177
178
static gboolean
179
g_inet_socket_address_to_native (GSocketAddress  *address,
180
                                 gpointer         dest,
181
         gsize            destlen,
182
         GError         **error)
183
0
{
184
0
  GInetSocketAddress *addr;
185
0
  GSocketFamily family;
186
187
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), FALSE);
188
189
0
  addr = G_INET_SOCKET_ADDRESS (address);
190
0
  family = g_inet_address_get_family (addr->priv->address);
191
192
0
  if (family == AF_INET)
193
0
    {
194
0
      struct sockaddr_in *sock = (struct sockaddr_in *) dest;
195
196
0
      if (destlen < sizeof (*sock))
197
0
  {
198
0
    g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NO_SPACE,
199
0
             _("Not enough space for socket address"));
200
0
    return FALSE;
201
0
  }
202
203
0
      sock->sin_family = AF_INET;
204
0
      sock->sin_port = g_htons (addr->priv->port);
205
0
      memcpy (&(sock->sin_addr.s_addr), g_inet_address_to_bytes (addr->priv->address), sizeof (sock->sin_addr));
206
0
      memset (sock->sin_zero, 0, sizeof (sock->sin_zero));
207
0
      return TRUE;
208
0
    }
209
0
  else if (family == AF_INET6)
210
0
    {
211
0
      struct sockaddr_in6 *sock = (struct sockaddr_in6 *) dest;
212
213
0
      if (destlen < sizeof (*sock))
214
0
  {
215
0
    g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NO_SPACE,
216
0
             _("Not enough space for socket address"));
217
0
    return FALSE;
218
0
  }
219
220
0
      memset (sock, 0, sizeof (*sock));
221
0
      sock->sin6_family = AF_INET6;
222
0
      sock->sin6_port = g_htons (addr->priv->port);
223
0
      sock->sin6_flowinfo = g_inet_socket_address_get_flowinfo (addr);
224
0
      sock->sin6_scope_id = g_inet_socket_address_get_scope_id (addr);
225
0
      memcpy (&(sock->sin6_addr.s6_addr), g_inet_address_to_bytes (addr->priv->address), sizeof (sock->sin6_addr));
226
0
      return TRUE;
227
0
    }
228
0
  else
229
0
    {
230
0
      g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
231
0
         _("Unsupported socket address"));
232
0
      return FALSE;
233
0
    }
234
0
}
235
236
static void
237
g_inet_socket_address_class_init (GInetSocketAddressClass *klass)
238
0
{
239
0
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
240
0
  GSocketAddressClass *gsocketaddress_class = G_SOCKET_ADDRESS_CLASS (klass);
241
242
0
  gobject_class->dispose = g_inet_socket_address_dispose;
243
0
  gobject_class->set_property = g_inet_socket_address_set_property;
244
0
  gobject_class->get_property = g_inet_socket_address_get_property;
245
246
0
  gsocketaddress_class->get_family = g_inet_socket_address_get_family;
247
0
  gsocketaddress_class->to_native = g_inet_socket_address_to_native;
248
0
  gsocketaddress_class->get_native_size = g_inet_socket_address_get_native_size;
249
250
  /**
251
   * GInetSocketAddress:address:
252
   *
253
   * The address.
254
   *
255
   * Since: 2.22
256
   */
257
0
  g_object_class_install_property (gobject_class, PROP_ADDRESS,
258
0
                                   g_param_spec_object ("address", NULL, NULL,
259
0
                                                        G_TYPE_INET_ADDRESS,
260
0
                                                        G_PARAM_CONSTRUCT_ONLY |
261
0
                                                        G_PARAM_READWRITE |
262
0
                                                        G_PARAM_STATIC_STRINGS));
263
264
  /**
265
   * GInetSocketAddress:port:
266
   *
267
   * The port.
268
   *
269
   * Since: 2.22
270
   */
271
0
  g_object_class_install_property (gobject_class, PROP_PORT,
272
0
                                   g_param_spec_uint ("port", NULL, NULL,
273
0
                                                      0,
274
0
                                                      65535,
275
0
                                                      0,
276
0
                                                      G_PARAM_CONSTRUCT_ONLY |
277
0
                                                      G_PARAM_READWRITE |
278
0
                                                      G_PARAM_STATIC_STRINGS));
279
280
  /**
281
   * GInetSocketAddress:flowinfo:
282
   *
283
   * The `sin6_flowinfo` field, for IPv6 addresses.
284
   *
285
   * If unset this property is inherited from [property@Gio.InetSocketAddress:address].
286
   *
287
   * Since: 2.32
288
   */
289
0
  g_object_class_install_property (gobject_class, PROP_FLOWINFO,
290
0
                                   g_param_spec_uint ("flowinfo", NULL, NULL,
291
0
                                                      0,
292
0
                                                      G_MAXUINT32,
293
0
                                                      0,
294
0
                                                      G_PARAM_CONSTRUCT_ONLY |
295
0
                                                      G_PARAM_READWRITE |
296
0
                                                      G_PARAM_STATIC_STRINGS));
297
298
  /**
299
   * GInetSocketAddress:scope-id:
300
   *
301
   * The `sin6_scope_id` field, for IPv6 addresses.
302
   *
303
   * If unset this property is inherited from [property@Gio.InetSocketAddress:address].
304
   *
305
   * Since: 2.32
306
   */
307
0
  g_object_class_install_property (gobject_class, PROP_SCOPE_ID,
308
0
                                   g_param_spec_uint ("scope-id", NULL, NULL,
309
0
                                                      0,
310
0
                                                      G_MAXUINT32,
311
0
                                                      0,
312
0
                                                      G_PARAM_CONSTRUCT_ONLY |
313
0
                                                      G_PARAM_READWRITE |
314
0
                                                      G_PARAM_STATIC_STRINGS));
315
0
}
316
317
static void
318
g_inet_socket_address_connectable_iface_init (GSocketConnectableIface *iface)
319
0
{
320
0
  GSocketConnectableIface *parent_iface = g_type_interface_peek_parent (iface);
321
322
0
  iface->enumerate = parent_iface->enumerate;
323
0
  iface->proxy_enumerate = parent_iface->proxy_enumerate;
324
0
  iface->to_string = g_inet_socket_address_connectable_to_string;
325
0
}
326
327
static gchar *
328
g_inet_socket_address_connectable_to_string (GSocketConnectable *connectable)
329
0
{
330
0
  GInetSocketAddress *sa;
331
0
  GInetAddress *a;
332
0
  gchar *a_string;
333
0
  GString *out;
334
0
  guint16 port;
335
336
0
  sa = G_INET_SOCKET_ADDRESS (connectable);
337
0
  a = g_inet_socket_address_get_address (sa);
338
0
  out = g_string_new ("");
339
340
  /* Address. */
341
0
  a_string = g_inet_address_to_string (a);
342
0
  g_string_append (out, a_string);
343
0
  g_free (a_string);
344
345
  /* Scope ID (IPv6 only). */
346
0
  if (g_inet_address_get_family (a) == G_SOCKET_FAMILY_IPV6 &&
347
0
      g_inet_socket_address_get_scope_id (sa) != 0)
348
0
    {
349
0
      g_string_append_printf (out, "%%%u",
350
0
                              g_inet_socket_address_get_scope_id (sa));
351
0
    }
352
353
  /* Port. */
354
0
  port = g_inet_socket_address_get_port (sa);
355
0
  if (port != 0)
356
0
    {
357
      /* Disambiguate ports from IPv6 addresses using square brackets. */
358
0
      if (g_inet_address_get_family (a) == G_SOCKET_FAMILY_IPV6)
359
0
        {
360
0
          g_string_prepend (out, "[");
361
0
          g_string_append (out, "]");
362
0
        }
363
364
0
      g_string_append_printf (out, ":%u", port);
365
0
    }
366
367
0
  return g_string_free (out, FALSE);
368
0
}
369
370
static void
371
g_inet_socket_address_init (GInetSocketAddress *address)
372
0
{
373
0
  address->priv = g_inet_socket_address_get_instance_private (address);
374
0
}
375
376
/**
377
 * g_inet_socket_address_new:
378
 * @address: a #GInetAddress
379
 * @port: a port number
380
 *
381
 * Creates a new #GInetSocketAddress for @address and @port.
382
 *
383
 * Returns: a new #GInetSocketAddress
384
 *
385
 * Since: 2.22
386
 */
387
GSocketAddress *
388
g_inet_socket_address_new (GInetAddress *address,
389
                           guint16       port)
390
0
{
391
0
  return g_object_new (G_TYPE_INET_SOCKET_ADDRESS,
392
0
           "address", address,
393
0
           "port", port,
394
0
           NULL);
395
0
}
396
397
/**
398
 * g_inet_socket_address_new_from_string:
399
 * @address: the string form of an IP address
400
 * @port: a port number
401
 *
402
 * Creates a new #GInetSocketAddress for @address and @port.
403
 *
404
 * If @address is an IPv6 address, it can also contain a scope ID
405
 * (separated from the address by a `%`). Note that currently this
406
 * behavior is platform specific. This may change in a future release.
407
 *
408
 * Returns: (nullable) (transfer full): a new #GInetSocketAddress,
409
 * or %NULL if @address cannot be parsed.
410
 *
411
 * Since: 2.40
412
 */
413
GSocketAddress *
414
g_inet_socket_address_new_from_string (const char *address,
415
                                       guint       port)
416
0
{
417
0
  GSocketAddress *saddr;
418
0
  GInetAddress *iaddr;
419
420
0
  iaddr = g_inet_address_new_from_string (address);
421
0
  if (!iaddr)
422
0
    return NULL;
423
424
0
  saddr = g_inet_socket_address_new (iaddr, port);
425
426
0
  g_object_unref (iaddr);
427
0
  return saddr;
428
0
}
429
430
/**
431
 * g_inet_socket_address_get_address:
432
 * @address: a #GInetSocketAddress
433
 *
434
 * Gets @address's #GInetAddress.
435
 *
436
 * Returns: (transfer none): the #GInetAddress for @address, which must be
437
 * g_object_ref()'d if it will be stored
438
 *
439
 * Since: 2.22
440
 */
441
GInetAddress *
442
g_inet_socket_address_get_address (GInetSocketAddress *address)
443
0
{
444
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), NULL);
445
446
0
  return address->priv->address;
447
0
}
448
449
/**
450
 * g_inet_socket_address_get_port:
451
 * @address: a #GInetSocketAddress
452
 *
453
 * Gets @address's port.
454
 *
455
 * Returns: the port for @address
456
 *
457
 * Since: 2.22
458
 */
459
guint16
460
g_inet_socket_address_get_port (GInetSocketAddress *address)
461
0
{
462
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), 0);
463
464
0
  return address->priv->port;
465
0
}
466
467
468
/**
469
 * g_inet_socket_address_get_flowinfo:
470
 * @address: a %G_SOCKET_FAMILY_IPV6 #GInetSocketAddress
471
 *
472
 * Gets the `sin6_flowinfo` field from @address,
473
 * which must be an IPv6 address.
474
 *
475
 * If not overridden this value will be inherited from [property@Gio.InetSocketAddress:address].
476
 *
477
 * Returns: the flowinfo field
478
 *
479
 * Since: 2.32
480
 */
481
guint32
482
g_inet_socket_address_get_flowinfo (GInetSocketAddress *address)
483
0
{
484
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), 0);
485
0
  g_return_val_if_fail (g_inet_address_get_family (address->priv->address) == G_SOCKET_FAMILY_IPV6, 0);
486
487
0
  return address->priv->flowinfo ? address->priv->flowinfo : g_inet_address_get_flowinfo (address->priv->address);
488
0
}
489
490
/**
491
 * g_inet_socket_address_get_scope_id:
492
 * @address: a %G_SOCKET_FAMILY_IPV6 #GInetAddress
493
 *
494
 * Gets the `sin6_scope_id` field from @address,
495
 * which must be an IPv6 address.
496
 *
497
 * If not overridden this value will be inherited from [property@Gio.InetSocketAddress:address].
498
 *
499
 * Returns: the scope id field
500
 *
501
 * Since: 2.32
502
 */
503
guint32
504
g_inet_socket_address_get_scope_id (GInetSocketAddress *address)
505
0
{
506
0
  g_return_val_if_fail (G_IS_INET_SOCKET_ADDRESS (address), 0);
507
0
  g_return_val_if_fail (g_inet_address_get_family (address->priv->address) == G_SOCKET_FAMILY_IPV6, 0);
508
509
0
  return address->priv->scope_id ? address->priv->scope_id : g_inet_address_get_scope_id (address->priv->address);
510
0
}