1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/* ip subnet, for libreswan
*
* Copyright (C) 1998, 1999, 2000 Henry Spencer.
* Copyright (C) 1999, 2000, 2001 Richard Guy Briggs
* Copyright (C) 2019-2020 Andrew Cagney <cagney@gnu.org>
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Library General Public License as published by
* the Free Software Foundation; either version 2 of the License, or (at your
* option) any later version. See <https://www.gnu.org/licenses/lgpl-2.1.txt>.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
* License for more details.
*
*/
#ifndef IP_SUBNET_H
#define IP_SUBNET_H
/*
* This is not the subnet you're looking for.
*
* In libreswan ip_subnet is used to store multiple things:
*
*
* #1 addresses i.e., NETWORK_PREFIX|HOST_IDENTIFIER / MASK
* #2 subnets i.e., NETWORK_PREFIX|0 / MASK
*
* OK, so far so good, they are kind of equivalent.
*
* #3 selectors i.e., NETWORK_PREFIX | 0 / MASK : PORT
*
* where PORT==0 imples 0..65535, and (presumably) port can only be
* non-zero when the NETWORK_PREFIX/MASK is for a single address.
*
* the latter being a less general form of:
*
* LO_ADDRESS..HI_ADDRESS : LO_PORT..HI_PORT
*
*
*/
/*
* Define SUBNET_TYPE to enable traditional subnets; expect everything
* to break.
*/
#include "ip_address.h"
#include "ip_endpoint.h"
struct jambuf;
typedef struct {
bool is_subnet;
/* (routing)prefix|host(id):port */
ip_endpoint addr;
/* (routing prefix) bits */
unsigned maskbits;
/* to-be-deleted - selector */
bool is_selector;
} ip_subnet;
#define PRI_SUBNET "%s; maskbits=%u is_subnet=%s is_selector=%s"
#define pri_subnet(S, B) \
str_subnet(S, B), \
(S)->maskbits, \
bool_str((S)->is_subnet), \
bool_str((S)->is_selector)
void pexpect_subnet(const ip_subnet *s, const char *t, where_t where);
#define psubnet(S) pexpect_subnet(S, #S, HERE)
/*
* Constructors
*/
/* ADDRESS..ADDRESS:0..65535 */
ip_subnet subnet_from_address(const ip_address *address);
ip_subnet subnet_from_address_maskbits(const ip_address *address, unsigned maskbits);
err_t address_mask_to_subnet(const ip_address *address, const ip_address *mask,
ip_subnet *subnet);
/*
* Format as a string.
*/
typedef struct {
char buf[sizeof(address_buf) + 4/*"/NNN"*/];
} subnet_buf;
extern const char *str_subnet(const ip_subnet *subnet, subnet_buf *out);
extern size_t jam_subnet(struct jambuf *buf, const ip_subnet *subnet);
/*
* Magic values.
*
* XXX: While the headers call the all-zero address "ANY" (INADDR_ANY,
* IN6ADDR_ANY_INIT), the headers also refer to the IPv6 value as
* unspecified (for instance IN6_IS_ADDR_UNSPECIFIED()) leaving the
* term "unspecified" underspecified.
*
* Consequently an AF_UNSPEC address (i.e., uninitialized or unset),
* is identified by *_unset().
*/
extern const ip_subnet unset_subnet;
bool subnet_is_unset(const ip_subnet *subnet);
const struct ip_info *subnet_type(const ip_subnet *subnet);
/* default route - ::/0 or 0.0.0.0/0 - matches all addresses */
bool subnet_contains_all_addresses(const ip_subnet *subnet);
/* !unset, !all, !none */
bool subnet_is_specified(const ip_subnet *subnet);
/* ADDRESS..ADDRESS; unlike subnetishost() this rejects 0.0.0.0/32. */
bool subnet_contains_one_address(const ip_subnet *subnet);
/* unspecified address - ::/128 or 0.0.0.0/32 - matches no addresses */
bool subnet_contains_no_addresses(const ip_subnet *subnet);
/* ADDRESS..ADDRESS in SUBNET */
bool address_in_subnet(const ip_address *address, const ip_subnet *subnet);
/* when applied to an address, leaves just the routing prefix */
extern ip_address subnet_mask(const ip_subnet *subnet);
/* Given ROUTING_PREFIX|HOST_ID return ROUTING_PREFIX|0 */
ip_address subnet_prefix(const ip_subnet *subnet);
/* Given ROUTING_PREFIX|HOST_ID return ROUTING_PREFIX|HOST_ID */
ip_address subnet_address(const ip_subnet *subnet);
/*
* old
*/
#include "err.h"
extern err_t ttosubnet(shunk_t src, const struct ip_info *afi,
int clash, ip_subnet *dst, struct logger *logger);
#define SUBNETTOT_BUF sizeof(subnet_buf)
/* misc. conversions and related */
extern err_t rangetosubnet(const ip_address *from, const ip_address *to,
ip_subnet *dst);
/* tests */
bool subnet_eq(const ip_subnet *a, const ip_subnet *b);
extern bool samesubnet(const ip_subnet *a, const ip_subnet *b);
extern bool addrinsubnet(const ip_address *a, const ip_subnet *s);
extern bool subnetinsubnet(const ip_subnet *a, const ip_subnet *b);
extern bool subnetishost(const ip_subnet *s);
#define subnetisaddr(sn, a) (subnetishost(sn) && addrinsubnet((a), (sn)))
#endif
|
