ISC DHCP  4.4.1
A reference DHCPv4 and DHCPv6 implementation
tree.h
Go to the documentation of this file.
1 /* tree.h
2 
3  Definitions for address trees... */
4 
5 /*
6  * Copyright (c) 2004-2017 by Internet Systems Consortium, Inc. ("ISC")
7  * Copyright (c) 1996-2003 by Internet Software Consortium
8  *
9  * This Source Code Form is subject to the terms of the Mozilla Public
10  * License, v. 2.0. If a copy of the MPL was not distributed with this
11  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
12  *
13  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
14  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
15  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
16  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
17  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
18  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
19  * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20  *
21  * Internet Systems Consortium, Inc.
22  * 950 Charter Street
23  * Redwood City, CA 94063
24  * <info@isc.org>
25  * https://www.isc.org/
26  *
27  */
28 
29 /* A pair of pointers, suitable for making a linked list. */
30 typedef struct _pair {
31  caddr_t car;
32  struct _pair *cdr;
33 } *pair;
34 
36  int refcnt;
38 };
39 
41  const char *name;
42  u_int8_t value;
43 };
44 
45 struct enumeration {
46  struct enumeration *next;
47  const char *name;
48  unsigned width;
50 };
51 
52 /* Tree node types... */
53 #define TREE_CONCAT 1
54 #define TREE_HOST_LOOKUP 2
55 #define TREE_CONST 3
56 #define TREE_LIMIT 4
57 #define TREE_DATA_EXPR 5
58 
59 /* A data buffer with a reference count. */
60 struct buffer {
61  int refcnt;
62  unsigned char data [1];
63 };
64 
65 /* XXX The mechanism by which data strings are returned is currently
66  XXX broken: rather than returning an ephemeral pointer, we create
67  XXX a reference to the data in the caller's space, which the caller
68  XXX then has to dereference - instead, the reference should be
69  XXX ephemeral by default and be made a persistent reference explicitly. */
70 /* XXX on the other hand, it seems to work pretty nicely, so maybe the
71  XXX above comment is meshuggenah. */
72 /* XXX I think the above comment tries to say this:
73  XXX http://tinyurl.com/2tjqre */
74 
75 /* A string of data bytes, possibly accompanied by a larger buffer. */
76 struct data_string {
77  struct buffer *buffer;
78  const unsigned char *data;
79  unsigned len; /* Does not include NUL terminator, if any. */
81 };
82 
84  context_any, /* indefinite */
89  context_data_or_numeric, /* indefinite */
91 };
92 
93 struct fundef {
94  int refcnt;
95  struct string_list *args;
97 };
98 
99 struct binding_value {
100  int refcnt;
101  enum {
107  } type;
108  union value {
110  unsigned long intval;
111  int boolean;
112  struct fundef *fundef;
113  struct binding_value *bv;
114  } value;
115 };
116 
117 struct binding {
118  struct binding *next;
119  char *name;
121 };
122 
124  int refcnt;
126  struct binding *bindings;
127 };
128 
129 /* Expression tree structure. */
130 
131 enum expr_op {
195 };
196 
197 struct expression {
198  int refcnt;
199  enum expr_op op;
200  union expr_union {
201  struct {
202  struct expression *expr;
204  struct expression *len;
205  } substring;
206  struct expression *equal [2];
207  struct expression *and [2];
208  struct expression *or [2];
209  struct expression *not;
210  struct expression *add;
215  struct collection *check;
216  struct {
217  struct expression *expr;
218  struct expression *len;
219  } suffix;
220  struct expression *lcase;
221  struct expression *ucase;
222  struct option *option;
224  struct {
225  struct expression *offset;
226  struct expression *len;
227  } packet;
231  unsigned long const_int;
232  struct expression *concat [2];
234  struct option *exists;
236  struct {
237  struct expression *base;
238  struct expression *width;
241  } b2a;
242  struct {
243  struct expression *width;
244  struct expression *buffer;
245  } reverse;
246  struct {
247  struct expression *car;
248  struct expression *cdr;
250  struct {
251  struct expression *car;
252  struct expression *cdr;
253  } dns_transaction;
254  struct {
255  unsigned rrclass;
256  unsigned rrtype;
259  struct expression *ttl;
260  } ns_add;
261  struct {
262  unsigned rrclass;
263  unsigned rrtype;
264  struct expression *rrname;
265  struct expression *rrdata;
267  char *variable;
268  struct {
269  struct expression *val;
270  struct expression *next;
271  } arg;
272  struct {
273  char *name;
275  } funcall;
276  struct fundef *func;
277  struct {
278  struct expression *relay;
280  } v6relay;
281  } data;
282  int flags;
283 # define EXPR_EPHEMERAL 1
284 };
285 
286 /* DNS host entry structure... */
288  int refcnt;
291  char hostname [1];
292 };
293 
294 struct option_cache; /* forward */
295 struct packet; /* forward */
296 struct option_state; /* forward */
297 struct decoded_option_state; /* forward */
298 struct lease; /* forward */
299 struct client_state; /* forward */
300 
301 struct universe {
302  const char *name;
303  struct option_cache *(*lookup_func) (struct universe *,
304  struct option_state *,
305  unsigned);
306  void (*save_func) (struct universe *, struct option_state *,
307  struct option_cache *, isc_boolean_t);
308  void (*foreach) (struct packet *,
309  struct lease *, struct client_state *,
310  struct option_state *, struct option_state *,
311  struct binding_scope **, struct universe *, void *,
312  void (*) (struct option_cache *, struct packet *,
313  struct lease *, struct client_state *,
314  struct option_state *,
315  struct option_state *,
316  struct binding_scope **,
317  struct universe *, void *));
318  void (*delete_func) (struct universe *universe,
319  struct option_state *, int);
321  struct option_state *,
322  const char *, int);
323  int (*decode) (struct option_state *,
324  const unsigned char *, unsigned, struct universe *);
325  int (*encapsulate) (struct data_string *, struct packet *,
326  struct lease *, struct client_state *,
327  struct option_state *, struct option_state *,
328  struct binding_scope **,
329  struct universe *);
330  u_int32_t (*get_tag) (const unsigned char *);
331  void (*store_tag) (unsigned char *, u_int32_t);
332  u_int32_t (*get_length) (const unsigned char *);
333  void (*store_length) (unsigned char *, u_int32_t);
335  unsigned site_code_min, end;
338  struct option *enc_opt;
339  int index;
340 
341  /* Flags should probably become condensed. */
343 };
344 
345 struct option {
346  const char *name;
347  const char *format;
349  unsigned code;
350  int refcnt;
351 };
const char * name
Definition: tree.h:302
enum expr_op op
Definition: tree.h:199
Definition: tree.h:30
struct _pair * cdr
Definition: tree.h:32
struct expression::expr_union::@24 ns_exists
void(* save_func)(struct universe *, struct option_state *, struct option_cache *, isc_boolean_t)
Definition: tree.h:306
struct universe * universe
Definition: tree.h:348
Definition: tree.h:141
Definition: dhcpd.h:560
unsigned len
Definition: tree.h:79
u_int32_t(* get_length)(const unsigned char *)
Definition: tree.h:332
Definition: tree.h:93
struct expression * val
Definition: tree.h:269
u_int8_t value
Definition: tree.h:42
const char * name
Definition: tree.h:41
struct expression::expr_union::@25 arg
struct expression * equal[2]
Definition: tree.h:206
struct binding_scope * outer
Definition: tree.h:125
struct data_string encapsulate
Definition: tree.h:235
int tag_size
Definition: tree.h:334
struct option * config_option
Definition: tree.h:223
struct expression::expr_union::@21 pick_first_value
int refcnt
Definition: tree.h:124
int refcnt
Definition: tree.h:198
struct executable_statement * statements
Definition: tree.h:96
unsigned long const_int
Definition: tree.h:231
struct expression * lcase
Definition: tree.h:220
struct data_string data
Definition: tree.h:109
struct binding * next
Definition: tree.h:118
struct expression * arglist
Definition: tree.h:274
struct expression::expr_union::@16 substring
pair first
Definition: tree.h:37
int(* option_state_dereference)(struct universe *, struct option_state *, const char *, int)
Definition: tree.h:320
unsigned end
Definition: tree.h:335
void(* delete_func)(struct universe *universe, struct option_state *, int)
Definition: tree.h:318
struct expression * concat[2]
Definition: tree.h:232
Definition: tree.h:140
enum binding_value::@15 type
struct expression * offset
Definition: tree.h:203
int flags
Definition: tree.h:282
Definition: tree.h:176
struct fundef * func
Definition: tree.h:276
struct expression * rrdata
Definition: tree.h:258
struct _pair * pair
unsigned site_code_min
Definition: tree.h:335
struct expression * not
Definition: tree.h:209
caddr_t car
Definition: tree.h:31
int(* decode)(struct option_state *, const unsigned char *, unsigned, struct universe *)
Definition: tree.h:323
int terminated
Definition: tree.h:80
int refcnt
Definition: tree.h:350
Definition: tree.h:301
struct expression::expr_union::@17 suffix
char hostname[1]
Definition: tree.h:291
struct expression * add
Definition: tree.h:210
struct fundef * fundef
Definition: tree.h:112
union expression::expr_union data
struct expression * encode_int
Definition: tree.h:230
int concat_duplicates
Definition: tree.h:342
struct expression * remainder
Definition: tree.h:214
Definition: tree.h:345
char * name
Definition: tree.h:119
int refcnt
Definition: tree.h:94
struct expression * or[2]
Definition: tree.h:208
struct expression::expr_union::@20 reverse
struct expression * width
Definition: tree.h:238
void(* store_length)(unsigned char *, u_int32_t)
Definition: tree.h:333
struct expression * roption
Definition: tree.h:279
struct expression::expr_union::@22 dns_transaction
unsigned code
Definition: tree.h:349
struct enumeration_value * values
Definition: tree.h:49
Definition: dhcpd.h:405
struct expression * next
Definition: tree.h:270
option_name_hash_t * name_hash
Definition: tree.h:336
struct expression * expr
Definition: tree.h:202
int index
Definition: tree.h:339
struct expression::expr_union::@24 ns_not_exists
struct expression * buffer
Definition: tree.h:240
const char * name
Definition: tree.h:47
const char * name
Definition: tree.h:346
struct expression * and[2]
Definition: tree.h:207
struct expression * multiply
Definition: tree.h:212
struct expression * base
Definition: tree.h:237
struct expression * subtract
Definition: tree.h:211
struct enumeration * next
Definition: tree.h:46
struct expression * relay
Definition: tree.h:278
struct expression::expr_union::@19 b2a
struct expression * extract_int
Definition: tree.h:229
Definition: tree.h:287
struct option * option
Definition: tree.h:222
unsigned width
Definition: tree.h:48
unsigned rrclass
Definition: tree.h:255
Definition: tree.h:142
union binding_value::value value
struct expression * divide
Definition: tree.h:213
struct data_string const_data
Definition: tree.h:228
const char * format
Definition: tree.h:347
struct binding * bindings
Definition: tree.h:126
expr_op
Definition: tree.h:131
struct expression * len
Definition: tree.h:204
unsigned rrtype
Definition: tree.h:256
struct expression::expr_union::@24 ns_delete
struct string_list * args
Definition: tree.h:95
struct option * exists
Definition: tree.h:234
struct data_string data
Definition: tree.h:290
const char int
Definition: omapip.h:442
struct binding_value * value
Definition: tree.h:120
time_t TIME
Definition: dhcpd.h:85
struct expression * ucase
Definition: tree.h:221
unsigned char data[1]
Definition: tree.h:62
Definition: tree.h:60
int length_size
Definition: tree.h:334
struct expression::expr_union::@23 ns_add
struct collection * check
Definition: tree.h:215
int(* encapsulate)(struct data_string *, struct packet *, struct lease *, struct client_state *, struct option_state *, struct option_state *, struct binding_scope **, struct universe *)
Definition: tree.h:325
u_int32_t(* get_tag)(const unsigned char *)
Definition: tree.h:330
int refcnt
Definition: tree.h:100
expression_context
Definition: tree.h:83
struct expression * ttl
Definition: tree.h:259
Definition: tree.h:117
struct expression * cdr
Definition: tree.h:248
struct expression * rrname
Definition: tree.h:257
option_code_hash_t * code_hash
Definition: tree.h:337
struct binding_value * bv
Definition: tree.h:113
struct expression::expr_union::@27 v6relay
struct dns_host_entry * host_lookup
Definition: tree.h:233
TIME timeout
Definition: tree.h:289
struct expression * car
Definition: tree.h:247
unsigned long intval
Definition: tree.h:110
const unsigned char * data
Definition: tree.h:78
struct option * enc_opt
Definition: tree.h:338
struct expression::expr_union::@26 funcall
void(* store_tag)(unsigned char *, u_int32_t)
Definition: tree.h:331
int refcnt
Definition: tree.h:288
int refcnt
Definition: tree.h:61
struct expression::expr_union::@18 packet
struct buffer * buffer
Definition: tree.h:77
struct expression * separator
Definition: tree.h:239
Definition: tree.h:179