File: reglib.h

package info (click to toggle)
crda 4.14%2Bgit20191112.9856751-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 568 kB
  • sloc: ansic: 2,599; makefile: 195; python: 130; sh: 6
file content (241 lines) | stat: -rw-r--r-- 7,240 bytes parent folder | download | duplicates (2)
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
#ifndef REG_LIB_H
#define REG_LIB_H

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <stdbool.h>
#include <sys/stat.h>
#include <math.h>

#include "regdb.h"

/* Common regulatory structures, functions and helpers */

/* This matches the kernel's data structures */
struct ieee80211_freq_range {
	uint32_t start_freq_khz;
	uint32_t end_freq_khz;
	uint32_t max_bandwidth_khz;
};

struct ieee80211_power_rule {
	uint32_t max_antenna_gain;
	uint32_t max_eirp;
};

struct ieee80211_reg_rule {
	struct ieee80211_freq_range freq_range;
	struct ieee80211_power_rule power_rule;
	uint32_t flags;
	uint32_t dfs_cac_ms;
};

struct ieee80211_regdomain {
	uint32_t n_reg_rules;
	char alpha2[2];
	uint8_t dfs_region;
	struct ieee80211_reg_rule reg_rules[];
};

#define REGLIB_MHZ_TO_KHZ(freq) ((freq) * 1000)
#define REGLIB_KHZ_TO_MHZ(freq) ((freq) / 1000)
#define REGLIB_DBI_TO_MBI(gain) ((gain) * 100)
#define REGLIB_MBI_TO_DBI(gain) ((gain) / 100)
#define REGLIB_DBM_TO_MBM(gain) ((gain) * 100)
#define REGLIB_MBM_TO_DBM(gain) ((gain) / 100)

#define REGLIB_MW_TO_DBM(gain) (10 * log10(gain))
#define REGLIB_MW_TO_MBM(gain) (REGLIB_DBM_TO_MBM(REGLIB_MW_TO_DBM(gain)))

/**
 * struct reglib_regdb_ctx - reglib regdb context
 *
 * This can be used to interat with reglib without
 * having to open() / close() / mmap() / munmap()
 * and check the regdb binary file for integrity and
 * authorship.
 *
 * @fd: file descriptor of the db
 * @stat: @fd fstat()
 * @db: mmap() of the db of @real_dblen
 * @real_dblen: file size in bytes of @fd
 * @siglen: size in bytes of the signature at the end of the file
 * @dblen: database lenghth, this is the @real_dblen - @siglen
 * @verified: whether or not this regdb has been RSA verified.
 * 	This value is dependent on whether or not you enabled
 * 	signature verification with gcrypt, openssl, or none
 * 	at all. If no signature verification was not compiled
 * 	in then this will always be true otherwise this will
 * 	only be true if the RSA digital signature of the SHA1
 * 	sum of the regulatory database at the end of the
 * 	regulatory database can be verified with the one of
 * 	the trusted public keys.
 */
struct reglib_regdb_ctx {
	int fd;
	struct stat stat;
	uint8_t *db;
	uint32_t real_dblen;
	uint32_t siglen;
	uint32_t dblen;
	bool verified;

	struct regdb_file_header *header;
	uint32_t num_countries;
	struct regdb_file_reg_country *countries;
};

static inline int reglib_is_world_regdom(const char *alpha2)
{
	if (alpha2[0] == '0' && alpha2[1] == '0')
		return 1;
	return 0;
}

static inline int reglib_isalpha_upper(char letter)
{
	if (letter >= 'A' && letter <= 'Z')
		return 1;
	return 0;
}

static inline int reglib_is_alpha2(const char *alpha2)
{
	if (reglib_isalpha_upper(alpha2[0]) && reglib_isalpha_upper(alpha2[1]))
		return 1;
	return 0;
}

static inline int reglib_is_valid_regdom(const char *alpha2)
{
	if (!reglib_is_alpha2(alpha2) && !reglib_is_world_regdom(alpha2))
		return 0;

	return 1;
}

static inline uint32_t reglib_max(uint32_t a, uint32_t b)
{
	return (a > b) ? a : b;
}

static inline uint32_t reglib_min(uint32_t a, uint32_t b)
{
	return (a > b) ? b : a;
}

void *
reglib_get_file_ptr(uint8_t *db, size_t dblen, size_t structlen, uint32_t ptr);
int reglib_verify_db_signature(uint8_t *db, size_t dblen, size_t siglen);

/**
 * reglib_malloc_regdb_ctx - create a regdb context for usage with reglib
 *
 * @regdb_file: file name
 *
 * Most operations on reglib iterate over the database somehow and prior
 * to iterating over it it must check the signature. Use this context helper
 * to let you query the db within different contexts in your program and
 * just be sure to call reglib_free_regdb_ctx() when done. This helper will
 * open the file passed and mmap() it.
 */
const struct reglib_regdb_ctx *reglib_malloc_regdb_ctx(const char *regdb_file);

/**
 * reglib_free_regdb_ctx - free a regdb context used with reglib
 *
 * @regdb_ctx: the reglib regdb context created with reglib_malloc_regdb_ctx()
 *
 * This will do all the handy work to close up, munmap, and free the
 * reglib regdb context passed.
 */
void reglib_free_regdb_ctx(const struct reglib_regdb_ctx *regdb_ctx);

const struct ieee80211_regdomain *
reglib_get_rd_idx(unsigned int idx, const struct reglib_regdb_ctx *ctx);

#define reglib_for_each_country(__rd, __idx, __ctx)		\
	for (__rd = reglib_get_rd_idx(__idx, __ctx);		\
	     __rd != NULL;					\
	     __rd = reglib_get_rd_idx(++__idx, __ctx))		\

const struct ieee80211_regdomain *
reglib_get_rd_alpha2(const char *alpha2, const char *file);

/**
 * reglib_is_valid_rd - validate regulatory domain data structure
 *
 * @rd: regulatory domain data structure to validate
 *
 * You can use this to validate regulatory domain data structures
 * for possible inconsistencies.
 */
int reglib_is_valid_rd(const struct ieee80211_regdomain *rd);

/* reg helpers */
void reglib_print_regdom(const struct ieee80211_regdomain *rd);
struct ieee80211_regdomain *
reglib_intersect_rds(const struct ieee80211_regdomain *rd1,
		     const struct ieee80211_regdomain *rd2);

/**
 * reglib_intersect_regdb - intersects a regulatory database
 *
 * @regdb_file: the regulatory database to intersect
 *
 * Goes through an entire regulatory database and intersects all regulatory
 * domains. This will skip any regulatory marked with an alpha2 of '00', which
 * is used to indicate a world regulatory domain. If intersection is able
 * to find rules that fit all regulatory domains it return a regulatory
 * domain with such rules otherwise it returns NULL.
 */
const struct ieee80211_regdomain *
reglib_intersect_regdb(const struct reglib_regdb_ctx *ctx);

/**
 * @reglib_create_parse_stream - provide a clean new stream for processing
 *
 * @fp: FILE stream, could be stdin, or a stream from an open file.
 *
 * In order to parse a stream we recommend to create a new stream
 * using this helper. A new stream is preferred in order to work
 * with stdin, as otherwise we cannot rewind() and move around
 * the stream. This helper will create new stream using tmpfile()
 * and also remove all comments. It will be closed and the file
 * deleted when the process terminates.
 */
FILE *reglib_create_parse_stream(FILE *fp);

/**
 * @reglib_parse_country - parse stream to build a regulatory domain
 *
 * @fp: FILE stream, could be stdin, or a stream from an open file.
 *
 * Parse stream and return back a built regulatory domain. Returns
 * NULL if one could not be built.
 */
struct ieee80211_regdomain *reglib_parse_country(FILE *fp);

/**
 * @reglib_optimize_regdom - optimize a regulatory domain
 *
 * @rd: a regulatory domain to be optimized
 *
 * A regulatory domain may exist without optimal expressions
 * over its rules. This will look for regulatory rules that can
 * be combined together to reduce the size of the regulatory
 * domain and its expression.
 *
 * Regulatory rules will be combined if their max allowed
 * bandwidth, max EIRP, and flags all match.
 */
struct ieee80211_regdomain *
reglib_optimize_regdom(struct ieee80211_regdomain *rd);

#define reglib_for_each_country_stream(__fp, __rd)		\
	for (__rd = reglib_parse_country(__fp);			\
	     __rd != NULL;					\
	     __rd = reglib_parse_country(__fp))			\

#endif