Coverage Report

Created: 2026-09-03 06:30

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/bind9/lib/isc/sockaddr.c
Line
Count
Source
1
/*
2
 * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
3
 *
4
 * SPDX-License-Identifier: MPL-2.0
5
 *
6
 * This Source Code Form is subject to the terms of the Mozilla Public
7
 * License, v. 2.0. If a copy of the MPL was not distributed with this
8
 * file, you can obtain one at https://mozilla.org/MPL/2.0/.
9
 *
10
 * See the COPYRIGHT file distributed with this work for additional
11
 * information regarding copyright ownership.
12
 */
13
14
/*! \file */
15
16
#include <netdb.h>
17
#include <stdbool.h>
18
#include <stdio.h>
19
20
#include <isc/buffer.h>
21
#include <isc/hash.h>
22
#include <isc/netaddr.h>
23
#include <isc/region.h>
24
#include <isc/sockaddr.h>
25
#include <isc/string.h>
26
#include <isc/util.h>
27
28
bool
29
0
isc_sockaddr_equal(const isc_sockaddr_t *a, const isc_sockaddr_t *b) {
30
0
  return isc_sockaddr_compare(a, b,
31
0
            ISC_SOCKADDR_CMPADDR |
32
0
              ISC_SOCKADDR_CMPPORT |
33
0
              ISC_SOCKADDR_CMPSCOPE);
34
0
}
35
36
bool
37
0
isc_sockaddr_eqaddr(const isc_sockaddr_t *a, const isc_sockaddr_t *b) {
38
0
  return isc_sockaddr_compare(
39
0
    a, b, ISC_SOCKADDR_CMPADDR | ISC_SOCKADDR_CMPSCOPE);
40
0
}
41
42
bool
43
isc_sockaddr_compare(const isc_sockaddr_t *a, const isc_sockaddr_t *b,
44
0
         unsigned int flags) {
45
0
  REQUIRE(a != NULL && b != NULL);
46
47
0
  if (a->length != b->length) {
48
0
    return false;
49
0
  }
50
51
  /*
52
   * We don't just memcmp because the sin_zero field isn't always
53
   * zero.
54
   */
55
56
0
  if (a->type.sa.sa_family != b->type.sa.sa_family) {
57
0
    return false;
58
0
  }
59
0
  switch (a->type.sa.sa_family) {
60
0
  case AF_INET:
61
0
    if ((flags & ISC_SOCKADDR_CMPADDR) != 0 &&
62
0
        memcmp(&a->type.sin.sin_addr, &b->type.sin.sin_addr,
63
0
         sizeof(a->type.sin.sin_addr)) != 0)
64
0
    {
65
0
      return false;
66
0
    }
67
0
    if ((flags & ISC_SOCKADDR_CMPPORT) != 0 &&
68
0
        a->type.sin.sin_port != b->type.sin.sin_port)
69
0
    {
70
0
      return false;
71
0
    }
72
0
    break;
73
0
  case AF_INET6:
74
0
    if ((flags & ISC_SOCKADDR_CMPADDR) != 0 &&
75
0
        memcmp(&a->type.sin6.sin6_addr, &b->type.sin6.sin6_addr,
76
0
         sizeof(a->type.sin6.sin6_addr)) != 0)
77
0
    {
78
0
      return false;
79
0
    }
80
    /*
81
     * If ISC_SOCKADDR_CMPSCOPEZERO is set then don't return
82
     * false if one of the scopes in zero.
83
     */
84
0
    if ((flags & ISC_SOCKADDR_CMPSCOPE) != 0 &&
85
0
        a->type.sin6.sin6_scope_id != b->type.sin6.sin6_scope_id &&
86
0
        ((flags & ISC_SOCKADDR_CMPSCOPEZERO) == 0 ||
87
0
         (a->type.sin6.sin6_scope_id != 0 &&
88
0
          b->type.sin6.sin6_scope_id != 0)))
89
0
    {
90
0
      return false;
91
0
    }
92
0
    if ((flags & ISC_SOCKADDR_CMPPORT) != 0 &&
93
0
        a->type.sin6.sin6_port != b->type.sin6.sin6_port)
94
0
    {
95
0
      return false;
96
0
    }
97
0
    break;
98
0
  default:
99
0
    if (memcmp(&a->type, &b->type, a->length) != 0) {
100
0
      return false;
101
0
    }
102
0
  }
103
0
  return true;
104
0
}
105
106
bool
107
isc_sockaddr_eqaddrprefix(const isc_sockaddr_t *a, const isc_sockaddr_t *b,
108
0
        unsigned int prefixlen) {
109
0
  isc_netaddr_t na, nb;
110
0
  isc_netaddr_fromsockaddr(&na, a);
111
0
  isc_netaddr_fromsockaddr(&nb, b);
112
0
  return isc_netaddr_eqprefix(&na, &nb, prefixlen);
113
0
}
114
115
isc_result_t
116
0
isc_sockaddr_totext(const isc_sockaddr_t *sockaddr, isc_buffer_t *target) {
117
0
  isc_netaddr_t netaddr;
118
0
  char pbuf[sizeof("65000")];
119
0
  unsigned int plen;
120
0
  isc_region_t avail;
121
122
0
  REQUIRE(sockaddr != NULL);
123
124
  /*
125
   * Do the port first, giving us the opportunity to check for
126
   * unsupported address families before calling
127
   * isc_netaddr_fromsockaddr().
128
   */
129
0
  switch (sockaddr->type.sa.sa_family) {
130
0
  case AF_INET:
131
0
    snprintf(pbuf, sizeof(pbuf), "%u",
132
0
       ntohs(sockaddr->type.sin.sin_port));
133
0
    break;
134
0
  case AF_INET6:
135
0
    snprintf(pbuf, sizeof(pbuf), "%u",
136
0
       ntohs(sockaddr->type.sin6.sin6_port));
137
0
    break;
138
0
  default:
139
0
    return ISC_R_FAILURE;
140
0
  }
141
142
0
  plen = strlen(pbuf);
143
0
  INSIST(plen < sizeof(pbuf));
144
145
0
  isc_netaddr_fromsockaddr(&netaddr, sockaddr);
146
0
  RETERR(isc_netaddr_totext(&netaddr, target));
147
148
0
  if (1 + plen + 1 > isc_buffer_availablelength(target)) {
149
0
    return ISC_R_NOSPACE;
150
0
  }
151
152
0
  isc_buffer_putmem(target, (const unsigned char *)"#", 1);
153
0
  isc_buffer_putmem(target, (const unsigned char *)pbuf, plen);
154
155
  /*
156
   * Null terminate after used region.
157
   */
158
0
  isc_buffer_availableregion(target, &avail);
159
0
  INSIST(avail.length >= 1);
160
0
  avail.base[0] = '\0';
161
162
0
  return ISC_R_SUCCESS;
163
0
}
164
165
void
166
0
isc_sockaddr_format(const isc_sockaddr_t *sa, char *array, unsigned int size) {
167
0
  isc_result_t result;
168
0
  isc_buffer_t buf;
169
170
0
  if (size == 0U) {
171
0
    return;
172
0
  }
173
174
0
  isc_buffer_init(&buf, array, size);
175
0
  result = isc_sockaddr_totext(sa, &buf);
176
0
  if (result != ISC_R_SUCCESS) {
177
    /*
178
     * The message is the same as in netaddr.c.
179
     */
180
0
    snprintf(array, size, "<unknown address, family %u>",
181
0
       sa->type.sa.sa_family);
182
0
    array[size - 1] = '\0';
183
0
  }
184
0
}
185
186
void
187
isc_sockaddr_hash_ex(isc_hash32_t *hash, const isc_sockaddr_t *sockaddr,
188
0
         bool address_only) {
189
0
  REQUIRE(sockaddr != NULL);
190
191
0
  size_t len = 0;
192
0
  const uint8_t *s = NULL;
193
0
  unsigned int p = 0;
194
0
  const struct in6_addr *in6;
195
196
0
  switch (sockaddr->type.sa.sa_family) {
197
0
  case AF_INET:
198
0
    s = (const uint8_t *)&sockaddr->type.sin.sin_addr;
199
0
    len = sizeof(sockaddr->type.sin.sin_addr.s_addr);
200
0
    if (!address_only) {
201
0
      p = ntohs(sockaddr->type.sin.sin_port);
202
0
    }
203
0
    break;
204
0
  case AF_INET6:
205
0
    in6 = &sockaddr->type.sin6.sin6_addr;
206
0
    s = (const uint8_t *)in6;
207
0
    if (IN6_IS_ADDR_V4MAPPED(in6)) {
208
0
      s += 12;
209
0
      len = sizeof(sockaddr->type.sin.sin_addr.s_addr);
210
0
    } else {
211
0
      len = sizeof(sockaddr->type.sin6.sin6_addr);
212
0
    }
213
0
    if (!address_only) {
214
0
      p = ntohs(sockaddr->type.sin6.sin6_port);
215
0
    }
216
0
    break;
217
0
  default:
218
0
    UNREACHABLE();
219
0
  }
220
221
0
  isc_hash32_hash(hash, s, len, true);
222
0
  if (!address_only) {
223
0
    isc_hash32_hash(hash, &p, sizeof(p), true);
224
0
  }
225
0
}
226
227
uint32_t
228
0
isc_sockaddr_hash(const isc_sockaddr_t *sockaddr, bool address_only) {
229
0
  isc_hash32_t hash;
230
231
0
  isc_hash32_init(&hash);
232
233
0
  isc_sockaddr_hash_ex(&hash, sockaddr, address_only);
234
235
0
  return isc_hash32_finalize(&hash);
236
0
}
237
238
void
239
8
isc_sockaddr_any(isc_sockaddr_t *sockaddr) {
240
8
  memset(sockaddr, 0, sizeof(*sockaddr));
241
8
  sockaddr->type.sin.sin_family = AF_INET;
242
8
  sockaddr->type.sin.sin_addr.s_addr = INADDR_ANY;
243
8
  sockaddr->type.sin.sin_port = 0;
244
8
  sockaddr->length = sizeof(sockaddr->type.sin);
245
8
  ISC_LINK_INIT(sockaddr, link);
246
8
}
247
248
void
249
8
isc_sockaddr_any6(isc_sockaddr_t *sockaddr) {
250
8
  memset(sockaddr, 0, sizeof(*sockaddr));
251
8
  sockaddr->type.sin6.sin6_family = AF_INET6;
252
8
  sockaddr->type.sin6.sin6_addr = in6addr_any;
253
8
  sockaddr->type.sin6.sin6_port = 0;
254
8
  sockaddr->length = sizeof(sockaddr->type.sin6);
255
8
  ISC_LINK_INIT(sockaddr, link);
256
8
}
257
258
void
259
isc_sockaddr_fromin(isc_sockaddr_t *sockaddr, const struct in_addr *ina,
260
0
        in_port_t port) {
261
0
  memset(sockaddr, 0, sizeof(*sockaddr));
262
0
  sockaddr->type.sin.sin_family = AF_INET;
263
  /* Use memmove to avoid possible misaligned access. */
264
0
  memmove(&sockaddr->type.sin.sin_addr, ina, sizeof(*ina));
265
0
  sockaddr->type.sin.sin_port = htons(port);
266
0
  sockaddr->length = sizeof(sockaddr->type.sin);
267
0
  ISC_LINK_INIT(sockaddr, link);
268
0
}
269
270
void
271
0
isc_sockaddr_anyofpf(isc_sockaddr_t *sockaddr, int pf) {
272
0
  switch (pf) {
273
0
  case AF_INET:
274
0
    isc_sockaddr_any(sockaddr);
275
0
    break;
276
0
  case AF_INET6:
277
0
    isc_sockaddr_any6(sockaddr);
278
0
    break;
279
0
  default:
280
0
    UNREACHABLE();
281
0
  }
282
0
}
283
284
void
285
isc_sockaddr_fromin6(isc_sockaddr_t *sockaddr, const struct in6_addr *ina6,
286
0
         in_port_t port) {
287
0
  memset(sockaddr, 0, sizeof(*sockaddr));
288
0
  sockaddr->type.sin6.sin6_family = AF_INET6;
289
  /* Use memmove to avoid possible misaligned access. */
290
0
  memmove(&sockaddr->type.sin6.sin6_addr, ina6, sizeof(*ina6));
291
0
  sockaddr->type.sin6.sin6_port = htons(port);
292
0
  sockaddr->length = sizeof(sockaddr->type.sin6);
293
0
  ISC_LINK_INIT(sockaddr, link);
294
0
}
295
296
void
297
isc_sockaddr_v6fromin(isc_sockaddr_t *sockaddr, const struct in_addr *ina,
298
0
          in_port_t port) {
299
0
  memset(sockaddr, 0, sizeof(*sockaddr));
300
0
  sockaddr->type.sin6.sin6_family = AF_INET6;
301
0
  sockaddr->type.sin6.sin6_addr.s6_addr[10] = 0xff;
302
0
  sockaddr->type.sin6.sin6_addr.s6_addr[11] = 0xff;
303
0
  memmove(&sockaddr->type.sin6.sin6_addr.s6_addr[12], ina, 4);
304
0
  sockaddr->type.sin6.sin6_port = htons(port);
305
0
  sockaddr->length = sizeof(sockaddr->type.sin6);
306
0
  ISC_LINK_INIT(sockaddr, link);
307
0
}
308
309
int
310
0
isc_sockaddr_pf(const isc_sockaddr_t *sockaddr) {
311
  /*
312
   * Get the protocol family of 'sockaddr'.
313
   */
314
315
0
#if (AF_INET == PF_INET && AF_INET6 == PF_INET6)
316
  /*
317
   * Assume that PF_xxx == AF_xxx for all AF and PF.
318
   */
319
0
  return sockaddr->type.sa.sa_family;
320
#else  /* if (AF_INET == PF_INET && AF_INET6 == PF_INET6) */
321
  switch (sockaddr->type.sa.sa_family) {
322
  case AF_INET:
323
    return PF_INET;
324
  case AF_INET6:
325
    return PF_INET6;
326
  default:
327
    FATAL_ERROR("unknown address family: %d",
328
          (int)sockaddr->type.sa.sa_family);
329
  }
330
#endif /* if (AF_INET == PF_INET && AF_INET6 == PF_INET6) */
331
0
}
332
333
void
334
isc_sockaddr_fromnetaddr(isc_sockaddr_t *sockaddr, const isc_netaddr_t *na,
335
0
       in_port_t port) {
336
0
  memset(sockaddr, 0, sizeof(*sockaddr));
337
0
  sockaddr->type.sin.sin_family = na->family;
338
0
  switch (na->family) {
339
0
  case AF_INET:
340
0
    sockaddr->length = sizeof(sockaddr->type.sin);
341
0
    sockaddr->type.sin.sin_addr = na->type.in;
342
0
    sockaddr->type.sin.sin_port = htons(port);
343
0
    break;
344
0
  case AF_INET6:
345
0
    sockaddr->length = sizeof(sockaddr->type.sin6);
346
0
    memmove(&sockaddr->type.sin6.sin6_addr, &na->type.in6, 16);
347
0
    sockaddr->type.sin6.sin6_scope_id = isc_netaddr_getzone(na);
348
0
    sockaddr->type.sin6.sin6_port = htons(port);
349
0
    break;
350
0
  default:
351
0
    UNREACHABLE();
352
0
  }
353
0
  ISC_LINK_INIT(sockaddr, link);
354
0
}
355
356
void
357
0
isc_sockaddr_setport(isc_sockaddr_t *sockaddr, in_port_t port) {
358
0
  switch (sockaddr->type.sa.sa_family) {
359
0
  case AF_INET:
360
0
    sockaddr->type.sin.sin_port = htons(port);
361
0
    break;
362
0
  case AF_INET6:
363
0
    sockaddr->type.sin6.sin6_port = htons(port);
364
0
    break;
365
0
  default:
366
0
    FATAL_ERROR("unknown address family: %d",
367
0
          (int)sockaddr->type.sa.sa_family);
368
0
  }
369
0
}
370
371
in_port_t
372
0
isc_sockaddr_getport(const isc_sockaddr_t *sockaddr) {
373
0
  in_port_t port = 0;
374
375
0
  switch (sockaddr->type.sa.sa_family) {
376
0
  case AF_INET:
377
0
    port = ntohs(sockaddr->type.sin.sin_port);
378
0
    break;
379
0
  case AF_INET6:
380
0
    port = ntohs(sockaddr->type.sin6.sin6_port);
381
0
    break;
382
0
  default:
383
0
    FATAL_ERROR("unknown address family: %d",
384
0
          (int)sockaddr->type.sa.sa_family);
385
0
  }
386
387
0
  return port;
388
0
}
389
390
bool
391
0
isc_sockaddr_ismulticast(const isc_sockaddr_t *sockaddr) {
392
0
  isc_netaddr_t netaddr;
393
394
0
  if (sockaddr->type.sa.sa_family == AF_INET ||
395
0
      sockaddr->type.sa.sa_family == AF_INET6)
396
0
  {
397
0
    isc_netaddr_fromsockaddr(&netaddr, sockaddr);
398
0
    return isc_netaddr_ismulticast(&netaddr);
399
0
  }
400
0
  return false;
401
0
}
402
403
bool
404
0
isc_sockaddr_isexperimental(const isc_sockaddr_t *sockaddr) {
405
0
  isc_netaddr_t netaddr;
406
407
0
  if (sockaddr->type.sa.sa_family == AF_INET) {
408
0
    isc_netaddr_fromsockaddr(&netaddr, sockaddr);
409
0
    return isc_netaddr_isexperimental(&netaddr);
410
0
  }
411
0
  return false;
412
0
}
413
414
bool
415
0
isc_sockaddr_issitelocal(const isc_sockaddr_t *sockaddr) {
416
0
  isc_netaddr_t netaddr;
417
418
0
  if (sockaddr->type.sa.sa_family == AF_INET6) {
419
0
    isc_netaddr_fromsockaddr(&netaddr, sockaddr);
420
0
    return isc_netaddr_issitelocal(&netaddr);
421
0
  }
422
0
  return false;
423
0
}
424
425
bool
426
0
isc_sockaddr_islinklocal(const isc_sockaddr_t *sockaddr) {
427
0
  isc_netaddr_t netaddr;
428
429
0
  if (sockaddr->type.sa.sa_family == AF_INET6) {
430
0
    isc_netaddr_fromsockaddr(&netaddr, sockaddr);
431
0
    return isc_netaddr_islinklocal(&netaddr);
432
0
  }
433
0
  return false;
434
0
}
435
436
bool
437
0
isc_sockaddr_isnetzero(const isc_sockaddr_t *sockaddr) {
438
0
  isc_netaddr_t netaddr;
439
440
0
  if (sockaddr->type.sa.sa_family == AF_INET) {
441
0
    isc_netaddr_fromsockaddr(&netaddr, sockaddr);
442
0
    return isc_netaddr_isnetzero(&netaddr);
443
0
  }
444
0
  return false;
445
0
}
446
447
isc_result_t
448
0
isc_sockaddr_fromsockaddr(isc_sockaddr_t *isa, const struct sockaddr *sa) {
449
0
  unsigned int length = 0;
450
451
0
  switch (sa->sa_family) {
452
0
  case AF_INET:
453
0
    length = sizeof(isa->type.sin);
454
0
    break;
455
0
  case AF_INET6:
456
0
    length = sizeof(isa->type.sin6);
457
0
    break;
458
0
  default:
459
0
    return ISC_R_NOTIMPLEMENTED;
460
0
  }
461
462
0
  *isa = (isc_sockaddr_t){ .length = length,
463
0
         .link = ISC_LINK_INITIALIZER };
464
0
  memmove(isa, sa, length);
465
466
0
  return ISC_R_SUCCESS;
467
0
}
468
469
bool
470
0
isc_sockaddr_disabled(const isc_sockaddr_t *sockaddr) {
471
0
  if ((sockaddr->type.sa.sa_family == AF_INET &&
472
0
       isc_net_probeipv4() == ISC_R_DISABLED) ||
473
0
      (sockaddr->type.sa.sa_family == AF_INET6 &&
474
0
       isc_net_probeipv6() == ISC_R_DISABLED))
475
0
  {
476
0
    return true;
477
0
  }
478
0
  return false;
479
0
}