/usr/include/reglib/reglib.h is in crda 3.18-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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
|