/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 | } |