xref: /linux/tools/net/ynl/ynl-gen-c.py (revision 9410645520e9b820069761f3450ef6661418e279)
1#!/usr/bin/env python3
2# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
3
4import argparse
5import collections
6import filecmp
7import os
8import re
9import shutil
10import tempfile
11import yaml
12
13from lib import SpecFamily, SpecAttrSet, SpecAttr, SpecOperation, SpecEnumSet, SpecEnumEntry
14
15
16def c_upper(name):
17    return name.upper().replace('-', '_')
18
19
20def c_lower(name):
21    return name.lower().replace('-', '_')
22
23
24def limit_to_number(name):
25    """
26    Turn a string limit like u32-max or s64-min into its numerical value
27    """
28    if name[0] == 'u' and name.endswith('-min'):
29        return 0
30    width = int(name[1:-4])
31    if name[0] == 's':
32        width -= 1
33    value = (1 << width) - 1
34    if name[0] == 's' and name.endswith('-min'):
35        value = -value - 1
36    return value
37
38
39class BaseNlLib:
40    def get_family_id(self):
41        return 'ys->family_id'
42
43
44class Type(SpecAttr):
45    def __init__(self, family, attr_set, attr, value):
46        super().__init__(family, attr_set, attr, value)
47
48        self.attr = attr
49        self.attr_set = attr_set
50        self.type = attr['type']
51        self.checks = attr.get('checks', {})
52
53        self.request = False
54        self.reply = False
55
56        if 'len' in attr:
57            self.len = attr['len']
58
59        if 'nested-attributes' in attr:
60            self.nested_attrs = attr['nested-attributes']
61            if self.nested_attrs == family.name:
62                self.nested_render_name = c_lower(f"{family.ident_name}")
63            else:
64                self.nested_render_name = c_lower(f"{family.ident_name}_{self.nested_attrs}")
65
66            if self.nested_attrs in self.family.consts:
67                self.nested_struct_type = 'struct ' + self.nested_render_name + '_'
68            else:
69                self.nested_struct_type = 'struct ' + self.nested_render_name
70
71        self.c_name = c_lower(self.name)
72        if self.c_name in _C_KW:
73            self.c_name += '_'
74
75        # Added by resolve():
76        self.enum_name = None
77        delattr(self, "enum_name")
78
79    def get_limit(self, limit, default=None):
80        value = self.checks.get(limit, default)
81        if value is None:
82            return value
83        elif value in self.family.consts:
84            return c_upper(f"{self.family['name']}-{value}")
85        if not isinstance(value, int):
86            value = limit_to_number(value)
87        return value
88
89    def resolve(self):
90        if 'name-prefix' in self.attr:
91            enum_name = f"{self.attr['name-prefix']}{self.name}"
92        else:
93            enum_name = f"{self.attr_set.name_prefix}{self.name}"
94        self.enum_name = c_upper(enum_name)
95
96    def is_multi_val(self):
97        return None
98
99    def is_scalar(self):
100        return self.type in {'u8', 'u16', 'u32', 'u64', 's32', 's64'}
101
102    def is_recursive(self):
103        return False
104
105    def is_recursive_for_op(self, ri):
106        return self.is_recursive() and not ri.op
107
108    def presence_type(self):
109        return 'bit'
110
111    def presence_member(self, space, type_filter):
112        if self.presence_type() != type_filter:
113            return
114
115        if self.presence_type() == 'bit':
116            pfx = '__' if space == 'user' else ''
117            return f"{pfx}u32 {self.c_name}:1;"
118
119        if self.presence_type() == 'len':
120            pfx = '__' if space == 'user' else ''
121            return f"{pfx}u32 {self.c_name}_len;"
122
123    def _complex_member_type(self, ri):
124        return None
125
126    def free_needs_iter(self):
127        return False
128
129    def free(self, ri, var, ref):
130        if self.is_multi_val() or self.presence_type() == 'len':
131            ri.cw.p(f'free({var}->{ref}{self.c_name});')
132
133    def arg_member(self, ri):
134        member = self._complex_member_type(ri)
135        if member:
136            arg = [member + ' *' + self.c_name]
137            if self.presence_type() == 'count':
138                arg += ['unsigned int n_' + self.c_name]
139            return arg
140        raise Exception(f"Struct member not implemented for class type {self.type}")
141
142    def struct_member(self, ri):
143        if self.is_multi_val():
144            ri.cw.p(f"unsigned int n_{self.c_name};")
145        member = self._complex_member_type(ri)
146        if member:
147            ptr = '*' if self.is_multi_val() else ''
148            if self.is_recursive_for_op(ri):
149                ptr = '*'
150            ri.cw.p(f"{member} {ptr}{self.c_name};")
151            return
152        members = self.arg_member(ri)
153        for one in members:
154            ri.cw.p(one + ';')
155
156    def _attr_policy(self, policy):
157        return '{ .type = ' + policy + ', }'
158
159    def attr_policy(self, cw):
160        policy = c_upper('nla-' + self.attr['type'])
161
162        spec = self._attr_policy(policy)
163        cw.p(f"\t[{self.enum_name}] = {spec},")
164
165    def _attr_typol(self):
166        raise Exception(f"Type policy not implemented for class type {self.type}")
167
168    def attr_typol(self, cw):
169        typol = self._attr_typol()
170        cw.p(f'[{self.enum_name}] = {"{"} .name = "{self.name}", {typol}{"}"},')
171
172    def _attr_put_line(self, ri, var, line):
173        if self.presence_type() == 'bit':
174            ri.cw.p(f"if ({var}->_present.{self.c_name})")
175        elif self.presence_type() == 'len':
176            ri.cw.p(f"if ({var}->_present.{self.c_name}_len)")
177        ri.cw.p(f"{line};")
178
179    def _attr_put_simple(self, ri, var, put_type):
180        line = f"ynl_attr_put_{put_type}(nlh, {self.enum_name}, {var}->{self.c_name})"
181        self._attr_put_line(ri, var, line)
182
183    def attr_put(self, ri, var):
184        raise Exception(f"Put not implemented for class type {self.type}")
185
186    def _attr_get(self, ri, var):
187        raise Exception(f"Attr get not implemented for class type {self.type}")
188
189    def attr_get(self, ri, var, first):
190        lines, init_lines, local_vars = self._attr_get(ri, var)
191        if type(lines) is str:
192            lines = [lines]
193        if type(init_lines) is str:
194            init_lines = [init_lines]
195
196        kw = 'if' if first else 'else if'
197        ri.cw.block_start(line=f"{kw} (type == {self.enum_name})")
198        if local_vars:
199            for local in local_vars:
200                ri.cw.p(local)
201            ri.cw.nl()
202
203        if not self.is_multi_val():
204            ri.cw.p("if (ynl_attr_validate(yarg, attr))")
205            ri.cw.p("return YNL_PARSE_CB_ERROR;")
206            if self.presence_type() == 'bit':
207                ri.cw.p(f"{var}->_present.{self.c_name} = 1;")
208
209        if init_lines:
210            ri.cw.nl()
211            for line in init_lines:
212                ri.cw.p(line)
213
214        for line in lines:
215            ri.cw.p(line)
216        ri.cw.block_end()
217        return True
218
219    def _setter_lines(self, ri, member, presence):
220        raise Exception(f"Setter not implemented for class type {self.type}")
221
222    def setter(self, ri, space, direction, deref=False, ref=None):
223        ref = (ref if ref else []) + [self.c_name]
224        var = "req"
225        member = f"{var}->{'.'.join(ref)}"
226
227        code = []
228        presence = ''
229        for i in range(0, len(ref)):
230            presence = f"{var}->{'.'.join(ref[:i] + [''])}_present.{ref[i]}"
231            # Every layer below last is a nest, so we know it uses bit presence
232            # last layer is "self" and may be a complex type
233            if i == len(ref) - 1 and self.presence_type() != 'bit':
234                continue
235            code.append(presence + ' = 1;')
236        code += self._setter_lines(ri, member, presence)
237
238        func_name = f"{op_prefix(ri, direction, deref=deref)}_set_{'_'.join(ref)}"
239        free = bool([x for x in code if 'free(' in x])
240        alloc = bool([x for x in code if 'alloc(' in x])
241        if free and not alloc:
242            func_name = '__' + func_name
243        ri.cw.write_func('static inline void', func_name, body=code,
244                         args=[f'{type_name(ri, direction, deref=deref)} *{var}'] + self.arg_member(ri))
245
246
247class TypeUnused(Type):
248    def presence_type(self):
249        return ''
250
251    def arg_member(self, ri):
252        return []
253
254    def _attr_get(self, ri, var):
255        return ['return YNL_PARSE_CB_ERROR;'], None, None
256
257    def _attr_typol(self):
258        return '.type = YNL_PT_REJECT, '
259
260    def attr_policy(self, cw):
261        pass
262
263    def attr_put(self, ri, var):
264        pass
265
266    def attr_get(self, ri, var, first):
267        pass
268
269    def setter(self, ri, space, direction, deref=False, ref=None):
270        pass
271
272
273class TypePad(Type):
274    def presence_type(self):
275        return ''
276
277    def arg_member(self, ri):
278        return []
279
280    def _attr_typol(self):
281        return '.type = YNL_PT_IGNORE, '
282
283    def attr_put(self, ri, var):
284        pass
285
286    def attr_get(self, ri, var, first):
287        pass
288
289    def attr_policy(self, cw):
290        pass
291
292    def setter(self, ri, space, direction, deref=False, ref=None):
293        pass
294
295
296class TypeScalar(Type):
297    def __init__(self, family, attr_set, attr, value):
298        super().__init__(family, attr_set, attr, value)
299
300        self.byte_order_comment = ''
301        if 'byte-order' in attr:
302            self.byte_order_comment = f" /* {attr['byte-order']} */"
303
304        if 'enum' in self.attr:
305            enum = self.family.consts[self.attr['enum']]
306            low, high = enum.value_range()
307            if 'min' not in self.checks:
308                if low != 0 or self.type[0] == 's':
309                    self.checks['min'] = low
310            if 'max' not in self.checks:
311                self.checks['max'] = high
312
313        if 'min' in self.checks and 'max' in self.checks:
314            if self.get_limit('min') > self.get_limit('max'):
315                raise Exception(f'Invalid limit for "{self.name}" min: {self.get_limit("min")} max: {self.get_limit("max")}')
316            self.checks['range'] = True
317
318        low = min(self.get_limit('min', 0), self.get_limit('max', 0))
319        high = max(self.get_limit('min', 0), self.get_limit('max', 0))
320        if low < 0 and self.type[0] == 'u':
321            raise Exception(f'Invalid limit for "{self.name}" negative limit for unsigned type')
322        if low < -32768 or high > 32767:
323            self.checks['full-range'] = True
324
325        # Added by resolve():
326        self.is_bitfield = None
327        delattr(self, "is_bitfield")
328        self.type_name = None
329        delattr(self, "type_name")
330
331    def resolve(self):
332        self.resolve_up(super())
333
334        if 'enum-as-flags' in self.attr and self.attr['enum-as-flags']:
335            self.is_bitfield = True
336        elif 'enum' in self.attr:
337            self.is_bitfield = self.family.consts[self.attr['enum']]['type'] == 'flags'
338        else:
339            self.is_bitfield = False
340
341        if not self.is_bitfield and 'enum' in self.attr:
342            self.type_name = self.family.consts[self.attr['enum']].user_type
343        elif self.is_auto_scalar:
344            self.type_name = '__' + self.type[0] + '64'
345        else:
346            self.type_name = '__' + self.type
347
348    def _attr_policy(self, policy):
349        if 'flags-mask' in self.checks or self.is_bitfield:
350            if self.is_bitfield:
351                enum = self.family.consts[self.attr['enum']]
352                mask = enum.get_mask(as_flags=True)
353            else:
354                flags = self.family.consts[self.checks['flags-mask']]
355                flag_cnt = len(flags['entries'])
356                mask = (1 << flag_cnt) - 1
357            return f"NLA_POLICY_MASK({policy}, 0x{mask:x})"
358        elif 'full-range' in self.checks:
359            return f"NLA_POLICY_FULL_RANGE({policy}, &{c_lower(self.enum_name)}_range)"
360        elif 'range' in self.checks:
361            return f"NLA_POLICY_RANGE({policy}, {self.get_limit('min')}, {self.get_limit('max')})"
362        elif 'min' in self.checks:
363            return f"NLA_POLICY_MIN({policy}, {self.get_limit('min')})"
364        elif 'max' in self.checks:
365            return f"NLA_POLICY_MAX({policy}, {self.get_limit('max')})"
366        return super()._attr_policy(policy)
367
368    def _attr_typol(self):
369        return f'.type = YNL_PT_U{c_upper(self.type[1:])}, '
370
371    def arg_member(self, ri):
372        return [f'{self.type_name} {self.c_name}{self.byte_order_comment}']
373
374    def attr_put(self, ri, var):
375        self._attr_put_simple(ri, var, self.type)
376
377    def _attr_get(self, ri, var):
378        return f"{var}->{self.c_name} = ynl_attr_get_{self.type}(attr);", None, None
379
380    def _setter_lines(self, ri, member, presence):
381        return [f"{member} = {self.c_name};"]
382
383
384class TypeFlag(Type):
385    def arg_member(self, ri):
386        return []
387
388    def _attr_typol(self):
389        return '.type = YNL_PT_FLAG, '
390
391    def attr_put(self, ri, var):
392        self._attr_put_line(ri, var, f"ynl_attr_put(nlh, {self.enum_name}, NULL, 0)")
393
394    def _attr_get(self, ri, var):
395        return [], None, None
396
397    def _setter_lines(self, ri, member, presence):
398        return []
399
400
401class TypeString(Type):
402    def arg_member(self, ri):
403        return [f"const char *{self.c_name}"]
404
405    def presence_type(self):
406        return 'len'
407
408    def struct_member(self, ri):
409        ri.cw.p(f"char *{self.c_name};")
410
411    def _attr_typol(self):
412        return f'.type = YNL_PT_NUL_STR, '
413
414    def _attr_policy(self, policy):
415        if 'exact-len' in self.checks:
416            mem = 'NLA_POLICY_EXACT_LEN(' + str(self.get_limit('exact-len')) + ')'
417        else:
418            mem = '{ .type = ' + policy
419            if 'max-len' in self.checks:
420                mem += ', .len = ' + str(self.get_limit('max-len'))
421            mem += ', }'
422        return mem
423
424    def attr_policy(self, cw):
425        if self.checks.get('unterminated-ok', False):
426            policy = 'NLA_STRING'
427        else:
428            policy = 'NLA_NUL_STRING'
429
430        spec = self._attr_policy(policy)
431        cw.p(f"\t[{self.enum_name}] = {spec},")
432
433    def attr_put(self, ri, var):
434        self._attr_put_simple(ri, var, 'str')
435
436    def _attr_get(self, ri, var):
437        len_mem = var + '->_present.' + self.c_name + '_len'
438        return [f"{len_mem} = len;",
439                f"{var}->{self.c_name} = malloc(len + 1);",
440                f"memcpy({var}->{self.c_name}, ynl_attr_get_str(attr), len);",
441                f"{var}->{self.c_name}[len] = 0;"], \
442               ['len = strnlen(ynl_attr_get_str(attr), ynl_attr_data_len(attr));'], \
443               ['unsigned int len;']
444
445    def _setter_lines(self, ri, member, presence):
446        return [f"free({member});",
447                f"{presence}_len = strlen({self.c_name});",
448                f"{member} = malloc({presence}_len + 1);",
449                f'memcpy({member}, {self.c_name}, {presence}_len);',
450                f'{member}[{presence}_len] = 0;']
451
452
453class TypeBinary(Type):
454    def arg_member(self, ri):
455        return [f"const void *{self.c_name}", 'size_t len']
456
457    def presence_type(self):
458        return 'len'
459
460    def struct_member(self, ri):
461        ri.cw.p(f"void *{self.c_name};")
462
463    def _attr_typol(self):
464        return f'.type = YNL_PT_BINARY,'
465
466    def _attr_policy(self, policy):
467        if 'exact-len' in self.checks:
468            mem = 'NLA_POLICY_EXACT_LEN(' + str(self.get_limit('exact-len')) + ')'
469        else:
470            mem = '{ '
471            if len(self.checks) == 1 and 'min-len' in self.checks:
472                mem += '.len = ' + str(self.get_limit('min-len'))
473            elif len(self.checks) == 0:
474                mem += '.type = NLA_BINARY'
475            else:
476                raise Exception('One or more of binary type checks not implemented, yet')
477            mem += ', }'
478        return mem
479
480    def attr_put(self, ri, var):
481        self._attr_put_line(ri, var, f"ynl_attr_put(nlh, {self.enum_name}, " +
482                            f"{var}->{self.c_name}, {var}->_present.{self.c_name}_len)")
483
484    def _attr_get(self, ri, var):
485        len_mem = var + '->_present.' + self.c_name + '_len'
486        return [f"{len_mem} = len;",
487                f"{var}->{self.c_name} = malloc(len);",
488                f"memcpy({var}->{self.c_name}, ynl_attr_data(attr), len);"], \
489               ['len = ynl_attr_data_len(attr);'], \
490               ['unsigned int len;']
491
492    def _setter_lines(self, ri, member, presence):
493        return [f"free({member});",
494                f"{presence}_len = len;",
495                f"{member} = malloc({presence}_len);",
496                f'memcpy({member}, {self.c_name}, {presence}_len);']
497
498
499class TypeBitfield32(Type):
500    def _complex_member_type(self, ri):
501        return "struct nla_bitfield32"
502
503    def _attr_typol(self):
504        return f'.type = YNL_PT_BITFIELD32, '
505
506    def _attr_policy(self, policy):
507        if not 'enum' in self.attr:
508            raise Exception('Enum required for bitfield32 attr')
509        enum = self.family.consts[self.attr['enum']]
510        mask = enum.get_mask(as_flags=True)
511        return f"NLA_POLICY_BITFIELD32({mask})"
512
513    def attr_put(self, ri, var):
514        line = f"ynl_attr_put(nlh, {self.enum_name}, &{var}->{self.c_name}, sizeof(struct nla_bitfield32))"
515        self._attr_put_line(ri, var, line)
516
517    def _attr_get(self, ri, var):
518        return f"memcpy(&{var}->{self.c_name}, ynl_attr_data(attr), sizeof(struct nla_bitfield32));", None, None
519
520    def _setter_lines(self, ri, member, presence):
521        return [f"memcpy(&{member}, {self.c_name}, sizeof(struct nla_bitfield32));"]
522
523
524class TypeNest(Type):
525    def is_recursive(self):
526        return self.family.pure_nested_structs[self.nested_attrs].recursive
527
528    def _complex_member_type(self, ri):
529        return self.nested_struct_type
530
531    def free(self, ri, var, ref):
532        at = '&'
533        if self.is_recursive_for_op(ri):
534            at = ''
535            ri.cw.p(f'if ({var}->{ref}{self.c_name})')
536        ri.cw.p(f'{self.nested_render_name}_free({at}{var}->{ref}{self.c_name});')
537
538    def _attr_typol(self):
539        return f'.type = YNL_PT_NEST, .nest = &{self.nested_render_name}_nest, '
540
541    def _attr_policy(self, policy):
542        return 'NLA_POLICY_NESTED(' + self.nested_render_name + '_nl_policy)'
543
544    def attr_put(self, ri, var):
545        at = '' if self.is_recursive_for_op(ri) else '&'
546        self._attr_put_line(ri, var, f"{self.nested_render_name}_put(nlh, " +
547                            f"{self.enum_name}, {at}{var}->{self.c_name})")
548
549    def _attr_get(self, ri, var):
550        get_lines = [f"if ({self.nested_render_name}_parse(&parg, attr))",
551                     "return YNL_PARSE_CB_ERROR;"]
552        init_lines = [f"parg.rsp_policy = &{self.nested_render_name}_nest;",
553                      f"parg.data = &{var}->{self.c_name};"]
554        return get_lines, init_lines, None
555
556    def setter(self, ri, space, direction, deref=False, ref=None):
557        ref = (ref if ref else []) + [self.c_name]
558
559        for _, attr in ri.family.pure_nested_structs[self.nested_attrs].member_list():
560            if attr.is_recursive():
561                continue
562            attr.setter(ri, self.nested_attrs, direction, deref=deref, ref=ref)
563
564
565class TypeMultiAttr(Type):
566    def __init__(self, family, attr_set, attr, value, base_type):
567        super().__init__(family, attr_set, attr, value)
568
569        self.base_type = base_type
570
571    def is_multi_val(self):
572        return True
573
574    def presence_type(self):
575        return 'count'
576
577    def _complex_member_type(self, ri):
578        if 'type' not in self.attr or self.attr['type'] == 'nest':
579            return self.nested_struct_type
580        elif self.attr['type'] in scalars:
581            scalar_pfx = '__' if ri.ku_space == 'user' else ''
582            return scalar_pfx + self.attr['type']
583        else:
584            raise Exception(f"Sub-type {self.attr['type']} not supported yet")
585
586    def free_needs_iter(self):
587        return 'type' not in self.attr or self.attr['type'] == 'nest'
588
589    def free(self, ri, var, ref):
590        if self.attr['type'] in scalars:
591            ri.cw.p(f"free({var}->{ref}{self.c_name});")
592        elif 'type' not in self.attr or self.attr['type'] == 'nest':
593            ri.cw.p(f"for (i = 0; i < {var}->{ref}n_{self.c_name}; i++)")
594            ri.cw.p(f'{self.nested_render_name}_free(&{var}->{ref}{self.c_name}[i]);')
595            ri.cw.p(f"free({var}->{ref}{self.c_name});")
596        else:
597            raise Exception(f"Free of MultiAttr sub-type {self.attr['type']} not supported yet")
598
599    def _attr_policy(self, policy):
600        return self.base_type._attr_policy(policy)
601
602    def _attr_typol(self):
603        return self.base_type._attr_typol()
604
605    def _attr_get(self, ri, var):
606        return f'n_{self.c_name}++;', None, None
607
608    def attr_put(self, ri, var):
609        if self.attr['type'] in scalars:
610            put_type = self.type
611            ri.cw.p(f"for (unsigned int i = 0; i < {var}->n_{self.c_name}; i++)")
612            ri.cw.p(f"ynl_attr_put_{put_type}(nlh, {self.enum_name}, {var}->{self.c_name}[i]);")
613        elif 'type' not in self.attr or self.attr['type'] == 'nest':
614            ri.cw.p(f"for (unsigned int i = 0; i < {var}->n_{self.c_name}; i++)")
615            self._attr_put_line(ri, var, f"{self.nested_render_name}_put(nlh, " +
616                                f"{self.enum_name}, &{var}->{self.c_name}[i])")
617        else:
618            raise Exception(f"Put of MultiAttr sub-type {self.attr['type']} not supported yet")
619
620    def _setter_lines(self, ri, member, presence):
621        # For multi-attr we have a count, not presence, hack up the presence
622        presence = presence[:-(len('_present.') + len(self.c_name))] + "n_" + self.c_name
623        return [f"free({member});",
624                f"{member} = {self.c_name};",
625                f"{presence} = n_{self.c_name};"]
626
627
628class TypeArrayNest(Type):
629    def is_multi_val(self):
630        return True
631
632    def presence_type(self):
633        return 'count'
634
635    def _complex_member_type(self, ri):
636        if 'sub-type' not in self.attr or self.attr['sub-type'] == 'nest':
637            return self.nested_struct_type
638        elif self.attr['sub-type'] in scalars:
639            scalar_pfx = '__' if ri.ku_space == 'user' else ''
640            return scalar_pfx + self.attr['sub-type']
641        else:
642            raise Exception(f"Sub-type {self.attr['sub-type']} not supported yet")
643
644    def _attr_typol(self):
645        return f'.type = YNL_PT_NEST, .nest = &{self.nested_render_name}_nest, '
646
647    def _attr_get(self, ri, var):
648        local_vars = ['const struct nlattr *attr2;']
649        get_lines = [f'attr_{self.c_name} = attr;',
650                     'ynl_attr_for_each_nested(attr2, attr)',
651                     f'\t{var}->n_{self.c_name}++;']
652        return get_lines, None, local_vars
653
654
655class TypeNestTypeValue(Type):
656    def _complex_member_type(self, ri):
657        return self.nested_struct_type
658
659    def _attr_typol(self):
660        return f'.type = YNL_PT_NEST, .nest = &{self.nested_render_name}_nest, '
661
662    def _attr_get(self, ri, var):
663        prev = 'attr'
664        tv_args = ''
665        get_lines = []
666        local_vars = []
667        init_lines = [f"parg.rsp_policy = &{self.nested_render_name}_nest;",
668                      f"parg.data = &{var}->{self.c_name};"]
669        if 'type-value' in self.attr:
670            tv_names = [c_lower(x) for x in self.attr["type-value"]]
671            local_vars += [f'const struct nlattr *attr_{", *attr_".join(tv_names)};']
672            local_vars += [f'__u32 {", ".join(tv_names)};']
673            for level in self.attr["type-value"]:
674                level = c_lower(level)
675                get_lines += [f'attr_{level} = ynl_attr_data({prev});']
676                get_lines += [f'{level} = ynl_attr_type(attr_{level});']
677                prev = 'attr_' + level
678
679            tv_args = f", {', '.join(tv_names)}"
680
681        get_lines += [f"{self.nested_render_name}_parse(&parg, {prev}{tv_args});"]
682        return get_lines, init_lines, local_vars
683
684
685class Struct:
686    def __init__(self, family, space_name, type_list=None, inherited=None):
687        self.family = family
688        self.space_name = space_name
689        self.attr_set = family.attr_sets[space_name]
690        # Use list to catch comparisons with empty sets
691        self._inherited = inherited if inherited is not None else []
692        self.inherited = []
693
694        self.nested = type_list is None
695        if family.name == c_lower(space_name):
696            self.render_name = c_lower(family.ident_name)
697        else:
698            self.render_name = c_lower(family.ident_name + '-' + space_name)
699        self.struct_name = 'struct ' + self.render_name
700        if self.nested and space_name in family.consts:
701            self.struct_name += '_'
702        self.ptr_name = self.struct_name + ' *'
703        # All attr sets this one contains, directly or multiple levels down
704        self.child_nests = set()
705
706        self.request = False
707        self.reply = False
708        self.recursive = False
709
710        self.attr_list = []
711        self.attrs = dict()
712        if type_list is not None:
713            for t in type_list:
714                self.attr_list.append((t, self.attr_set[t]),)
715        else:
716            for t in self.attr_set:
717                self.attr_list.append((t, self.attr_set[t]),)
718
719        max_val = 0
720        self.attr_max_val = None
721        for name, attr in self.attr_list:
722            if attr.value >= max_val:
723                max_val = attr.value
724                self.attr_max_val = attr
725            self.attrs[name] = attr
726
727    def __iter__(self):
728        yield from self.attrs
729
730    def __getitem__(self, key):
731        return self.attrs[key]
732
733    def member_list(self):
734        return self.attr_list
735
736    def set_inherited(self, new_inherited):
737        if self._inherited != new_inherited:
738            raise Exception("Inheriting different members not supported")
739        self.inherited = [c_lower(x) for x in sorted(self._inherited)]
740
741
742class EnumEntry(SpecEnumEntry):
743    def __init__(self, enum_set, yaml, prev, value_start):
744        super().__init__(enum_set, yaml, prev, value_start)
745
746        if prev:
747            self.value_change = (self.value != prev.value + 1)
748        else:
749            self.value_change = (self.value != 0)
750        self.value_change = self.value_change or self.enum_set['type'] == 'flags'
751
752        # Added by resolve:
753        self.c_name = None
754        delattr(self, "c_name")
755
756    def resolve(self):
757        self.resolve_up(super())
758
759        self.c_name = c_upper(self.enum_set.value_pfx + self.name)
760
761
762class EnumSet(SpecEnumSet):
763    def __init__(self, family, yaml):
764        self.render_name = c_lower(family.ident_name + '-' + yaml['name'])
765
766        if 'enum-name' in yaml:
767            if yaml['enum-name']:
768                self.enum_name = 'enum ' + c_lower(yaml['enum-name'])
769                self.user_type = self.enum_name
770            else:
771                self.enum_name = None
772        else:
773            self.enum_name = 'enum ' + self.render_name
774
775        if self.enum_name:
776            self.user_type = self.enum_name
777        else:
778            self.user_type = 'int'
779
780        self.value_pfx = yaml.get('name-prefix', f"{family.ident_name}-{yaml['name']}-")
781
782        super().__init__(family, yaml)
783
784    def new_entry(self, entry, prev_entry, value_start):
785        return EnumEntry(self, entry, prev_entry, value_start)
786
787    def value_range(self):
788        low = min([x.value for x in self.entries.values()])
789        high = max([x.value for x in self.entries.values()])
790
791        if high - low + 1 != len(self.entries):
792            raise Exception("Can't get value range for a noncontiguous enum")
793
794        return low, high
795
796
797class AttrSet(SpecAttrSet):
798    def __init__(self, family, yaml):
799        super().__init__(family, yaml)
800
801        if self.subset_of is None:
802            if 'name-prefix' in yaml:
803                pfx = yaml['name-prefix']
804            elif self.name == family.name:
805                pfx = family.ident_name + '-a-'
806            else:
807                pfx = f"{family.ident_name}-a-{self.name}-"
808            self.name_prefix = c_upper(pfx)
809            self.max_name = c_upper(self.yaml.get('attr-max-name', f"{self.name_prefix}max"))
810            self.cnt_name = c_upper(self.yaml.get('attr-cnt-name', f"__{self.name_prefix}max"))
811        else:
812            self.name_prefix = family.attr_sets[self.subset_of].name_prefix
813            self.max_name = family.attr_sets[self.subset_of].max_name
814            self.cnt_name = family.attr_sets[self.subset_of].cnt_name
815
816        # Added by resolve:
817        self.c_name = None
818        delattr(self, "c_name")
819
820    def resolve(self):
821        self.c_name = c_lower(self.name)
822        if self.c_name in _C_KW:
823            self.c_name += '_'
824        if self.c_name == self.family.c_name:
825            self.c_name = ''
826
827    def new_attr(self, elem, value):
828        if elem['type'] in scalars:
829            t = TypeScalar(self.family, self, elem, value)
830        elif elem['type'] == 'unused':
831            t = TypeUnused(self.family, self, elem, value)
832        elif elem['type'] == 'pad':
833            t = TypePad(self.family, self, elem, value)
834        elif elem['type'] == 'flag':
835            t = TypeFlag(self.family, self, elem, value)
836        elif elem['type'] == 'string':
837            t = TypeString(self.family, self, elem, value)
838        elif elem['type'] == 'binary':
839            t = TypeBinary(self.family, self, elem, value)
840        elif elem['type'] == 'bitfield32':
841            t = TypeBitfield32(self.family, self, elem, value)
842        elif elem['type'] == 'nest':
843            t = TypeNest(self.family, self, elem, value)
844        elif elem['type'] == 'indexed-array' and 'sub-type' in elem:
845            if elem["sub-type"] == 'nest':
846                t = TypeArrayNest(self.family, self, elem, value)
847            else:
848                raise Exception(f'new_attr: unsupported sub-type {elem["sub-type"]}')
849        elif elem['type'] == 'nest-type-value':
850            t = TypeNestTypeValue(self.family, self, elem, value)
851        else:
852            raise Exception(f"No typed class for type {elem['type']}")
853
854        if 'multi-attr' in elem and elem['multi-attr']:
855            t = TypeMultiAttr(self.family, self, elem, value, t)
856
857        return t
858
859
860class Operation(SpecOperation):
861    def __init__(self, family, yaml, req_value, rsp_value):
862        super().__init__(family, yaml, req_value, rsp_value)
863
864        self.render_name = c_lower(family.ident_name + '_' + self.name)
865
866        self.dual_policy = ('do' in yaml and 'request' in yaml['do']) and \
867                         ('dump' in yaml and 'request' in yaml['dump'])
868
869        self.has_ntf = False
870
871        # Added by resolve:
872        self.enum_name = None
873        delattr(self, "enum_name")
874
875    def resolve(self):
876        self.resolve_up(super())
877
878        if not self.is_async:
879            self.enum_name = self.family.op_prefix + c_upper(self.name)
880        else:
881            self.enum_name = self.family.async_op_prefix + c_upper(self.name)
882
883    def mark_has_ntf(self):
884        self.has_ntf = True
885
886
887class Family(SpecFamily):
888    def __init__(self, file_name, exclude_ops):
889        # Added by resolve:
890        self.c_name = None
891        delattr(self, "c_name")
892        self.op_prefix = None
893        delattr(self, "op_prefix")
894        self.async_op_prefix = None
895        delattr(self, "async_op_prefix")
896        self.mcgrps = None
897        delattr(self, "mcgrps")
898        self.consts = None
899        delattr(self, "consts")
900        self.hooks = None
901        delattr(self, "hooks")
902
903        super().__init__(file_name, exclude_ops=exclude_ops)
904
905        self.fam_key = c_upper(self.yaml.get('c-family-name', self.yaml["name"] + '_FAMILY_NAME'))
906        self.ver_key = c_upper(self.yaml.get('c-version-name', self.yaml["name"] + '_FAMILY_VERSION'))
907
908        if 'definitions' not in self.yaml:
909            self.yaml['definitions'] = []
910
911        if 'uapi-header' in self.yaml:
912            self.uapi_header = self.yaml['uapi-header']
913        else:
914            self.uapi_header = f"linux/{self.ident_name}.h"
915        if self.uapi_header.startswith("linux/") and self.uapi_header.endswith('.h'):
916            self.uapi_header_name = self.uapi_header[6:-2]
917        else:
918            self.uapi_header_name = self.ident_name
919
920    def resolve(self):
921        self.resolve_up(super())
922
923        if self.yaml.get('protocol', 'genetlink') not in {'genetlink', 'genetlink-c', 'genetlink-legacy'}:
924            raise Exception("Codegen only supported for genetlink")
925
926        self.c_name = c_lower(self.ident_name)
927        if 'name-prefix' in self.yaml['operations']:
928            self.op_prefix = c_upper(self.yaml['operations']['name-prefix'])
929        else:
930            self.op_prefix = c_upper(self.yaml['name'] + '-cmd-')
931        if 'async-prefix' in self.yaml['operations']:
932            self.async_op_prefix = c_upper(self.yaml['operations']['async-prefix'])
933        else:
934            self.async_op_prefix = self.op_prefix
935
936        self.mcgrps = self.yaml.get('mcast-groups', {'list': []})
937
938        self.hooks = dict()
939        for when in ['pre', 'post']:
940            self.hooks[when] = dict()
941            for op_mode in ['do', 'dump']:
942                self.hooks[when][op_mode] = dict()
943                self.hooks[when][op_mode]['set'] = set()
944                self.hooks[when][op_mode]['list'] = []
945
946        # dict space-name -> 'request': set(attrs), 'reply': set(attrs)
947        self.root_sets = dict()
948        # dict space-name -> set('request', 'reply')
949        self.pure_nested_structs = dict()
950
951        self._mark_notify()
952        self._mock_up_events()
953
954        self._load_root_sets()
955        self._load_nested_sets()
956        self._load_attr_use()
957        self._load_hooks()
958
959        self.kernel_policy = self.yaml.get('kernel-policy', 'split')
960        if self.kernel_policy == 'global':
961            self._load_global_policy()
962
963    def new_enum(self, elem):
964        return EnumSet(self, elem)
965
966    def new_attr_set(self, elem):
967        return AttrSet(self, elem)
968
969    def new_operation(self, elem, req_value, rsp_value):
970        return Operation(self, elem, req_value, rsp_value)
971
972    def _mark_notify(self):
973        for op in self.msgs.values():
974            if 'notify' in op:
975                self.ops[op['notify']].mark_has_ntf()
976
977    # Fake a 'do' equivalent of all events, so that we can render their response parsing
978    def _mock_up_events(self):
979        for op in self.yaml['operations']['list']:
980            if 'event' in op:
981                op['do'] = {
982                    'reply': {
983                        'attributes': op['event']['attributes']
984                    }
985                }
986
987    def _load_root_sets(self):
988        for op_name, op in self.msgs.items():
989            if 'attribute-set' not in op:
990                continue
991
992            req_attrs = set()
993            rsp_attrs = set()
994            for op_mode in ['do', 'dump']:
995                if op_mode in op and 'request' in op[op_mode]:
996                    req_attrs.update(set(op[op_mode]['request']['attributes']))
997                if op_mode in op and 'reply' in op[op_mode]:
998                    rsp_attrs.update(set(op[op_mode]['reply']['attributes']))
999            if 'event' in op:
1000                rsp_attrs.update(set(op['event']['attributes']))
1001
1002            if op['attribute-set'] not in self.root_sets:
1003                self.root_sets[op['attribute-set']] = {'request': req_attrs, 'reply': rsp_attrs}
1004            else:
1005                self.root_sets[op['attribute-set']]['request'].update(req_attrs)
1006                self.root_sets[op['attribute-set']]['reply'].update(rsp_attrs)
1007
1008    def _sort_pure_types(self):
1009        # Try to reorder according to dependencies
1010        pns_key_list = list(self.pure_nested_structs.keys())
1011        pns_key_seen = set()
1012        rounds = len(pns_key_list) ** 2  # it's basically bubble sort
1013        for _ in range(rounds):
1014            if len(pns_key_list) == 0:
1015                break
1016            name = pns_key_list.pop(0)
1017            finished = True
1018            for _, spec in self.attr_sets[name].items():
1019                if 'nested-attributes' in spec:
1020                    nested = spec['nested-attributes']
1021                    # If the unknown nest we hit is recursive it's fine, it'll be a pointer
1022                    if self.pure_nested_structs[nested].recursive:
1023                        continue
1024                    if nested not in pns_key_seen:
1025                        # Dicts are sorted, this will make struct last
1026                        struct = self.pure_nested_structs.pop(name)
1027                        self.pure_nested_structs[name] = struct
1028                        finished = False
1029                        break
1030            if finished:
1031                pns_key_seen.add(name)
1032            else:
1033                pns_key_list.append(name)
1034
1035    def _load_nested_sets(self):
1036        attr_set_queue = list(self.root_sets.keys())
1037        attr_set_seen = set(self.root_sets.keys())
1038
1039        while len(attr_set_queue):
1040            a_set = attr_set_queue.pop(0)
1041            for attr, spec in self.attr_sets[a_set].items():
1042                if 'nested-attributes' not in spec:
1043                    continue
1044
1045                nested = spec['nested-attributes']
1046                if nested not in attr_set_seen:
1047                    attr_set_queue.append(nested)
1048                    attr_set_seen.add(nested)
1049
1050                inherit = set()
1051                if nested not in self.root_sets:
1052                    if nested not in self.pure_nested_structs:
1053                        self.pure_nested_structs[nested] = Struct(self, nested, inherited=inherit)
1054                else:
1055                    raise Exception(f'Using attr set as root and nested not supported - {nested}')
1056
1057                if 'type-value' in spec:
1058                    if nested in self.root_sets:
1059                        raise Exception("Inheriting members to a space used as root not supported")
1060                    inherit.update(set(spec['type-value']))
1061                elif spec['type'] == 'indexed-array':
1062                    inherit.add('idx')
1063                self.pure_nested_structs[nested].set_inherited(inherit)
1064
1065        for root_set, rs_members in self.root_sets.items():
1066            for attr, spec in self.attr_sets[root_set].items():
1067                if 'nested-attributes' in spec:
1068                    nested = spec['nested-attributes']
1069                    if attr in rs_members['request']:
1070                        self.pure_nested_structs[nested].request = True
1071                    if attr in rs_members['reply']:
1072                        self.pure_nested_structs[nested].reply = True
1073
1074        self._sort_pure_types()
1075
1076        # Propagate the request / reply / recursive
1077        for attr_set, struct in reversed(self.pure_nested_structs.items()):
1078            for _, spec in self.attr_sets[attr_set].items():
1079                if 'nested-attributes' in spec:
1080                    child_name = spec['nested-attributes']
1081                    struct.child_nests.add(child_name)
1082                    child = self.pure_nested_structs.get(child_name)
1083                    if child:
1084                        if not child.recursive:
1085                            struct.child_nests.update(child.child_nests)
1086                        child.request |= struct.request
1087                        child.reply |= struct.reply
1088                if attr_set in struct.child_nests:
1089                    struct.recursive = True
1090
1091        self._sort_pure_types()
1092
1093    def _load_attr_use(self):
1094        for _, struct in self.pure_nested_structs.items():
1095            if struct.request:
1096                for _, arg in struct.member_list():
1097                    arg.request = True
1098            if struct.reply:
1099                for _, arg in struct.member_list():
1100                    arg.reply = True
1101
1102        for root_set, rs_members in self.root_sets.items():
1103            for attr, spec in self.attr_sets[root_set].items():
1104                if attr in rs_members['request']:
1105                    spec.request = True
1106                if attr in rs_members['reply']:
1107                    spec.reply = True
1108
1109    def _load_global_policy(self):
1110        global_set = set()
1111        attr_set_name = None
1112        for op_name, op in self.ops.items():
1113            if not op:
1114                continue
1115            if 'attribute-set' not in op:
1116                continue
1117
1118            if attr_set_name is None:
1119                attr_set_name = op['attribute-set']
1120            if attr_set_name != op['attribute-set']:
1121                raise Exception('For a global policy all ops must use the same set')
1122
1123            for op_mode in ['do', 'dump']:
1124                if op_mode in op:
1125                    req = op[op_mode].get('request')
1126                    if req:
1127                        global_set.update(req.get('attributes', []))
1128
1129        self.global_policy = []
1130        self.global_policy_set = attr_set_name
1131        for attr in self.attr_sets[attr_set_name]:
1132            if attr in global_set:
1133                self.global_policy.append(attr)
1134
1135    def _load_hooks(self):
1136        for op in self.ops.values():
1137            for op_mode in ['do', 'dump']:
1138                if op_mode not in op:
1139                    continue
1140                for when in ['pre', 'post']:
1141                    if when not in op[op_mode]:
1142                        continue
1143                    name = op[op_mode][when]
1144                    if name in self.hooks[when][op_mode]['set']:
1145                        continue
1146                    self.hooks[when][op_mode]['set'].add(name)
1147                    self.hooks[when][op_mode]['list'].append(name)
1148
1149
1150class RenderInfo:
1151    def __init__(self, cw, family, ku_space, op, op_mode, attr_set=None):
1152        self.family = family
1153        self.nl = cw.nlib
1154        self.ku_space = ku_space
1155        self.op_mode = op_mode
1156        self.op = op
1157
1158        self.fixed_hdr = None
1159        if op and op.fixed_header:
1160            self.fixed_hdr = 'struct ' + c_lower(op.fixed_header)
1161
1162        # 'do' and 'dump' response parsing is identical
1163        self.type_consistent = True
1164        if op_mode != 'do' and 'dump' in op:
1165            if 'do' in op:
1166                if ('reply' in op['do']) != ('reply' in op["dump"]):
1167                    self.type_consistent = False
1168                elif 'reply' in op['do'] and op["do"]["reply"] != op["dump"]["reply"]:
1169                    self.type_consistent = False
1170            else:
1171                self.type_consistent = False
1172
1173        self.attr_set = attr_set
1174        if not self.attr_set:
1175            self.attr_set = op['attribute-set']
1176
1177        self.type_name_conflict = False
1178        if op:
1179            self.type_name = c_lower(op.name)
1180        else:
1181            self.type_name = c_lower(attr_set)
1182            if attr_set in family.consts:
1183                self.type_name_conflict = True
1184
1185        self.cw = cw
1186
1187        self.struct = dict()
1188        if op_mode == 'notify':
1189            op_mode = 'do'
1190        for op_dir in ['request', 'reply']:
1191            if op:
1192                type_list = []
1193                if op_dir in op[op_mode]:
1194                    type_list = op[op_mode][op_dir]['attributes']
1195                self.struct[op_dir] = Struct(family, self.attr_set, type_list=type_list)
1196        if op_mode == 'event':
1197            self.struct['reply'] = Struct(family, self.attr_set, type_list=op['event']['attributes'])
1198
1199
1200class CodeWriter:
1201    def __init__(self, nlib, out_file=None, overwrite=True):
1202        self.nlib = nlib
1203        self._overwrite = overwrite
1204
1205        self._nl = False
1206        self._block_end = False
1207        self._silent_block = False
1208        self._ind = 0
1209        self._ifdef_block = None
1210        if out_file is None:
1211            self._out = os.sys.stdout
1212        else:
1213            self._out = tempfile.NamedTemporaryFile('w+')
1214            self._out_file = out_file
1215
1216    def __del__(self):
1217        self.close_out_file()
1218
1219    def close_out_file(self):
1220        if self._out == os.sys.stdout:
1221            return
1222        # Avoid modifying the file if contents didn't change
1223        self._out.flush()
1224        if not self._overwrite and os.path.isfile(self._out_file):
1225            if filecmp.cmp(self._out.name, self._out_file, shallow=False):
1226                return
1227        with open(self._out_file, 'w+') as out_file:
1228            self._out.seek(0)
1229            shutil.copyfileobj(self._out, out_file)
1230            self._out.close()
1231        self._out = os.sys.stdout
1232
1233    @classmethod
1234    def _is_cond(cls, line):
1235        return line.startswith('if') or line.startswith('while') or line.startswith('for')
1236
1237    def p(self, line, add_ind=0):
1238        if self._block_end:
1239            self._block_end = False
1240            if line.startswith('else'):
1241                line = '} ' + line
1242            else:
1243                self._out.write('\t' * self._ind + '}\n')
1244
1245        if self._nl:
1246            self._out.write('\n')
1247            self._nl = False
1248
1249        ind = self._ind
1250        if line[-1] == ':':
1251            ind -= 1
1252        if self._silent_block:
1253            ind += 1
1254        self._silent_block = line.endswith(')') and CodeWriter._is_cond(line)
1255        if line[0] == '#':
1256            ind = 0
1257        if add_ind:
1258            ind += add_ind
1259        self._out.write('\t' * ind + line + '\n')
1260
1261    def nl(self):
1262        self._nl = True
1263
1264    def block_start(self, line=''):
1265        if line:
1266            line = line + ' '
1267        self.p(line + '{')
1268        self._ind += 1
1269
1270    def block_end(self, line=''):
1271        if line and line[0] not in {';', ','}:
1272            line = ' ' + line
1273        self._ind -= 1
1274        self._nl = False
1275        if not line:
1276            # Delay printing closing bracket in case "else" comes next
1277            if self._block_end:
1278                self._out.write('\t' * (self._ind + 1) + '}\n')
1279            self._block_end = True
1280        else:
1281            self.p('}' + line)
1282
1283    def write_doc_line(self, doc, indent=True):
1284        words = doc.split()
1285        line = ' *'
1286        for word in words:
1287            if len(line) + len(word) >= 79:
1288                self.p(line)
1289                line = ' *'
1290                if indent:
1291                    line += '  '
1292            line += ' ' + word
1293        self.p(line)
1294
1295    def write_func_prot(self, qual_ret, name, args=None, doc=None, suffix=''):
1296        if not args:
1297            args = ['void']
1298
1299        if doc:
1300            self.p('/*')
1301            self.p(' * ' + doc)
1302            self.p(' */')
1303
1304        oneline = qual_ret
1305        if qual_ret[-1] != '*':
1306            oneline += ' '
1307        oneline += f"{name}({', '.join(args)}){suffix}"
1308
1309        if len(oneline) < 80:
1310            self.p(oneline)
1311            return
1312
1313        v = qual_ret
1314        if len(v) > 3:
1315            self.p(v)
1316            v = ''
1317        elif qual_ret[-1] != '*':
1318            v += ' '
1319        v += name + '('
1320        ind = '\t' * (len(v) // 8) + ' ' * (len(v) % 8)
1321        delta_ind = len(v) - len(ind)
1322        v += args[0]
1323        i = 1
1324        while i < len(args):
1325            next_len = len(v) + len(args[i])
1326            if v[0] == '\t':
1327                next_len += delta_ind
1328            if next_len > 76:
1329                self.p(v + ',')
1330                v = ind
1331            else:
1332                v += ', '
1333            v += args[i]
1334            i += 1
1335        self.p(v + ')' + suffix)
1336
1337    def write_func_lvar(self, local_vars):
1338        if not local_vars:
1339            return
1340
1341        if type(local_vars) is str:
1342            local_vars = [local_vars]
1343
1344        local_vars.sort(key=len, reverse=True)
1345        for var in local_vars:
1346            self.p(var)
1347        self.nl()
1348
1349    def write_func(self, qual_ret, name, body, args=None, local_vars=None):
1350        self.write_func_prot(qual_ret=qual_ret, name=name, args=args)
1351        self.write_func_lvar(local_vars=local_vars)
1352
1353        self.block_start()
1354        for line in body:
1355            self.p(line)
1356        self.block_end()
1357
1358    def writes_defines(self, defines):
1359        longest = 0
1360        for define in defines:
1361            if len(define[0]) > longest:
1362                longest = len(define[0])
1363        longest = ((longest + 8) // 8) * 8
1364        for define in defines:
1365            line = '#define ' + define[0]
1366            line += '\t' * ((longest - len(define[0]) + 7) // 8)
1367            if type(define[1]) is int:
1368                line += str(define[1])
1369            elif type(define[1]) is str:
1370                line += '"' + define[1] + '"'
1371            self.p(line)
1372
1373    def write_struct_init(self, members):
1374        longest = max([len(x[0]) for x in members])
1375        longest += 1  # because we prepend a .
1376        longest = ((longest + 8) // 8) * 8
1377        for one in members:
1378            line = '.' + one[0]
1379            line += '\t' * ((longest - len(one[0]) - 1 + 7) // 8)
1380            line += '= ' + str(one[1]) + ','
1381            self.p(line)
1382
1383    def ifdef_block(self, config):
1384        config_option = None
1385        if config:
1386            config_option = 'CONFIG_' + c_upper(config)
1387        if self._ifdef_block == config_option:
1388            return
1389
1390        if self._ifdef_block:
1391            self.p('#endif /* ' + self._ifdef_block + ' */')
1392        if config_option:
1393            self.p('#ifdef ' + config_option)
1394        self._ifdef_block = config_option
1395
1396
1397scalars = {'u8', 'u16', 'u32', 'u64', 's32', 's64', 'uint', 'sint'}
1398
1399direction_to_suffix = {
1400    'reply': '_rsp',
1401    'request': '_req',
1402    '': ''
1403}
1404
1405op_mode_to_wrapper = {
1406    'do': '',
1407    'dump': '_list',
1408    'notify': '_ntf',
1409    'event': '',
1410}
1411
1412_C_KW = {
1413    'auto',
1414    'bool',
1415    'break',
1416    'case',
1417    'char',
1418    'const',
1419    'continue',
1420    'default',
1421    'do',
1422    'double',
1423    'else',
1424    'enum',
1425    'extern',
1426    'float',
1427    'for',
1428    'goto',
1429    'if',
1430    'inline',
1431    'int',
1432    'long',
1433    'register',
1434    'return',
1435    'short',
1436    'signed',
1437    'sizeof',
1438    'static',
1439    'struct',
1440    'switch',
1441    'typedef',
1442    'union',
1443    'unsigned',
1444    'void',
1445    'volatile',
1446    'while'
1447}
1448
1449
1450def rdir(direction):
1451    if direction == 'reply':
1452        return 'request'
1453    if direction == 'request':
1454        return 'reply'
1455    return direction
1456
1457
1458def op_prefix(ri, direction, deref=False):
1459    suffix = f"_{ri.type_name}"
1460
1461    if not ri.op_mode or ri.op_mode == 'do':
1462        suffix += f"{direction_to_suffix[direction]}"
1463    else:
1464        if direction == 'request':
1465            suffix += '_req_dump'
1466        else:
1467            if ri.type_consistent:
1468                if deref:
1469                    suffix += f"{direction_to_suffix[direction]}"
1470                else:
1471                    suffix += op_mode_to_wrapper[ri.op_mode]
1472            else:
1473                suffix += '_rsp'
1474                suffix += '_dump' if deref else '_list'
1475
1476    return f"{ri.family.c_name}{suffix}"
1477
1478
1479def type_name(ri, direction, deref=False):
1480    return f"struct {op_prefix(ri, direction, deref=deref)}"
1481
1482
1483def print_prototype(ri, direction, terminate=True, doc=None):
1484    suffix = ';' if terminate else ''
1485
1486    fname = ri.op.render_name
1487    if ri.op_mode == 'dump':
1488        fname += '_dump'
1489
1490    args = ['struct ynl_sock *ys']
1491    if 'request' in ri.op[ri.op_mode]:
1492        args.append(f"{type_name(ri, direction)} *" + f"{direction_to_suffix[direction][1:]}")
1493
1494    ret = 'int'
1495    if 'reply' in ri.op[ri.op_mode]:
1496        ret = f"{type_name(ri, rdir(direction))} *"
1497
1498    ri.cw.write_func_prot(ret, fname, args, doc=doc, suffix=suffix)
1499
1500
1501def print_req_prototype(ri):
1502    print_prototype(ri, "request", doc=ri.op['doc'])
1503
1504
1505def print_dump_prototype(ri):
1506    print_prototype(ri, "request")
1507
1508
1509def put_typol_fwd(cw, struct):
1510    cw.p(f'extern const struct ynl_policy_nest {struct.render_name}_nest;')
1511
1512
1513def put_typol(cw, struct):
1514    type_max = struct.attr_set.max_name
1515    cw.block_start(line=f'const struct ynl_policy_attr {struct.render_name}_policy[{type_max} + 1] =')
1516
1517    for _, arg in struct.member_list():
1518        arg.attr_typol(cw)
1519
1520    cw.block_end(line=';')
1521    cw.nl()
1522
1523    cw.block_start(line=f'const struct ynl_policy_nest {struct.render_name}_nest =')
1524    cw.p(f'.max_attr = {type_max},')
1525    cw.p(f'.table = {struct.render_name}_policy,')
1526    cw.block_end(line=';')
1527    cw.nl()
1528
1529
1530def _put_enum_to_str_helper(cw, render_name, map_name, arg_name, enum=None):
1531    args = [f'int {arg_name}']
1532    if enum:
1533        args = [enum.user_type + ' ' + arg_name]
1534    cw.write_func_prot('const char *', f'{render_name}_str', args)
1535    cw.block_start()
1536    if enum and enum.type == 'flags':
1537        cw.p(f'{arg_name} = ffs({arg_name}) - 1;')
1538    cw.p(f'if ({arg_name} < 0 || {arg_name} >= (int)YNL_ARRAY_SIZE({map_name}))')
1539    cw.p('return NULL;')
1540    cw.p(f'return {map_name}[{arg_name}];')
1541    cw.block_end()
1542    cw.nl()
1543
1544
1545def put_op_name_fwd(family, cw):
1546    cw.write_func_prot('const char *', f'{family.c_name}_op_str', ['int op'], suffix=';')
1547
1548
1549def put_op_name(family, cw):
1550    map_name = f'{family.c_name}_op_strmap'
1551    cw.block_start(line=f"static const char * const {map_name}[] =")
1552    for op_name, op in family.msgs.items():
1553        if op.rsp_value:
1554            # Make sure we don't add duplicated entries, if multiple commands
1555            # produce the same response in legacy families.
1556            if family.rsp_by_value[op.rsp_value] != op:
1557                cw.p(f'// skip "{op_name}", duplicate reply value')
1558                continue
1559
1560            if op.req_value == op.rsp_value:
1561                cw.p(f'[{op.enum_name}] = "{op_name}",')
1562            else:
1563                cw.p(f'[{op.rsp_value}] = "{op_name}",')
1564    cw.block_end(line=';')
1565    cw.nl()
1566
1567    _put_enum_to_str_helper(cw, family.c_name + '_op', map_name, 'op')
1568
1569
1570def put_enum_to_str_fwd(family, cw, enum):
1571    args = [enum.user_type + ' value']
1572    cw.write_func_prot('const char *', f'{enum.render_name}_str', args, suffix=';')
1573
1574
1575def put_enum_to_str(family, cw, enum):
1576    map_name = f'{enum.render_name}_strmap'
1577    cw.block_start(line=f"static const char * const {map_name}[] =")
1578    for entry in enum.entries.values():
1579        cw.p(f'[{entry.value}] = "{entry.name}",')
1580    cw.block_end(line=';')
1581    cw.nl()
1582
1583    _put_enum_to_str_helper(cw, enum.render_name, map_name, 'value', enum=enum)
1584
1585
1586def put_req_nested_prototype(ri, struct, suffix=';'):
1587    func_args = ['struct nlmsghdr *nlh',
1588                 'unsigned int attr_type',
1589                 f'{struct.ptr_name}obj']
1590
1591    ri.cw.write_func_prot('int', f'{struct.render_name}_put', func_args,
1592                          suffix=suffix)
1593
1594
1595def put_req_nested(ri, struct):
1596    put_req_nested_prototype(ri, struct, suffix='')
1597    ri.cw.block_start()
1598    ri.cw.write_func_lvar('struct nlattr *nest;')
1599
1600    ri.cw.p("nest = ynl_attr_nest_start(nlh, attr_type);")
1601
1602    for _, arg in struct.member_list():
1603        arg.attr_put(ri, "obj")
1604
1605    ri.cw.p("ynl_attr_nest_end(nlh, nest);")
1606
1607    ri.cw.nl()
1608    ri.cw.p('return 0;')
1609    ri.cw.block_end()
1610    ri.cw.nl()
1611
1612
1613def _multi_parse(ri, struct, init_lines, local_vars):
1614    if struct.nested:
1615        iter_line = "ynl_attr_for_each_nested(attr, nested)"
1616    else:
1617        if ri.fixed_hdr:
1618            local_vars += ['void *hdr;']
1619        iter_line = "ynl_attr_for_each(attr, nlh, yarg->ys->family->hdr_len)"
1620
1621    array_nests = set()
1622    multi_attrs = set()
1623    needs_parg = False
1624    for arg, aspec in struct.member_list():
1625        if aspec['type'] == 'indexed-array' and 'sub-type' in aspec:
1626            if aspec["sub-type"] == 'nest':
1627                local_vars.append(f'const struct nlattr *attr_{aspec.c_name};')
1628                array_nests.add(arg)
1629            else:
1630                raise Exception(f'Not supported sub-type {aspec["sub-type"]}')
1631        if 'multi-attr' in aspec:
1632            multi_attrs.add(arg)
1633        needs_parg |= 'nested-attributes' in aspec
1634    if array_nests or multi_attrs:
1635        local_vars.append('int i;')
1636    if needs_parg:
1637        local_vars.append('struct ynl_parse_arg parg;')
1638        init_lines.append('parg.ys = yarg->ys;')
1639
1640    all_multi = array_nests | multi_attrs
1641
1642    for anest in sorted(all_multi):
1643        local_vars.append(f"unsigned int n_{struct[anest].c_name} = 0;")
1644
1645    ri.cw.block_start()
1646    ri.cw.write_func_lvar(local_vars)
1647
1648    for line in init_lines:
1649        ri.cw.p(line)
1650    ri.cw.nl()
1651
1652    for arg in struct.inherited:
1653        ri.cw.p(f'dst->{arg} = {arg};')
1654
1655    if ri.fixed_hdr:
1656        ri.cw.p('hdr = ynl_nlmsg_data_offset(nlh, sizeof(struct genlmsghdr));')
1657        ri.cw.p(f"memcpy(&dst->_hdr, hdr, sizeof({ri.fixed_hdr}));")
1658    for anest in sorted(all_multi):
1659        aspec = struct[anest]
1660        ri.cw.p(f"if (dst->{aspec.c_name})")
1661        ri.cw.p(f'return ynl_error_parse(yarg, "attribute already present ({struct.attr_set.name}.{aspec.name})");')
1662
1663    ri.cw.nl()
1664    ri.cw.block_start(line=iter_line)
1665    ri.cw.p('unsigned int type = ynl_attr_type(attr);')
1666    ri.cw.nl()
1667
1668    first = True
1669    for _, arg in struct.member_list():
1670        good = arg.attr_get(ri, 'dst', first=first)
1671        # First may be 'unused' or 'pad', ignore those
1672        first &= not good
1673
1674    ri.cw.block_end()
1675    ri.cw.nl()
1676
1677    for anest in sorted(array_nests):
1678        aspec = struct[anest]
1679
1680        ri.cw.block_start(line=f"if (n_{aspec.c_name})")
1681        ri.cw.p(f"dst->{aspec.c_name} = calloc(n_{aspec.c_name}, sizeof(*dst->{aspec.c_name}));")
1682        ri.cw.p(f"dst->n_{aspec.c_name} = n_{aspec.c_name};")
1683        ri.cw.p('i = 0;')
1684        ri.cw.p(f"parg.rsp_policy = &{aspec.nested_render_name}_nest;")
1685        ri.cw.block_start(line=f"ynl_attr_for_each_nested(attr, attr_{aspec.c_name})")
1686        ri.cw.p(f"parg.data = &dst->{aspec.c_name}[i];")
1687        ri.cw.p(f"if ({aspec.nested_render_name}_parse(&parg, attr, ynl_attr_type(attr)))")
1688        ri.cw.p('return YNL_PARSE_CB_ERROR;')
1689        ri.cw.p('i++;')
1690        ri.cw.block_end()
1691        ri.cw.block_end()
1692    ri.cw.nl()
1693
1694    for anest in sorted(multi_attrs):
1695        aspec = struct[anest]
1696        ri.cw.block_start(line=f"if (n_{aspec.c_name})")
1697        ri.cw.p(f"dst->{aspec.c_name} = calloc(n_{aspec.c_name}, sizeof(*dst->{aspec.c_name}));")
1698        ri.cw.p(f"dst->n_{aspec.c_name} = n_{aspec.c_name};")
1699        ri.cw.p('i = 0;')
1700        if 'nested-attributes' in aspec:
1701            ri.cw.p(f"parg.rsp_policy = &{aspec.nested_render_name}_nest;")
1702        ri.cw.block_start(line=iter_line)
1703        ri.cw.block_start(line=f"if (ynl_attr_type(attr) == {aspec.enum_name})")
1704        if 'nested-attributes' in aspec:
1705            ri.cw.p(f"parg.data = &dst->{aspec.c_name}[i];")
1706            ri.cw.p(f"if ({aspec.nested_render_name}_parse(&parg, attr))")
1707            ri.cw.p('return YNL_PARSE_CB_ERROR;')
1708        elif aspec.type in scalars:
1709            ri.cw.p(f"dst->{aspec.c_name}[i] = ynl_attr_get_{aspec.type}(attr);")
1710        else:
1711            raise Exception('Nest parsing type not supported yet')
1712        ri.cw.p('i++;')
1713        ri.cw.block_end()
1714        ri.cw.block_end()
1715        ri.cw.block_end()
1716    ri.cw.nl()
1717
1718    if struct.nested:
1719        ri.cw.p('return 0;')
1720    else:
1721        ri.cw.p('return YNL_PARSE_CB_OK;')
1722    ri.cw.block_end()
1723    ri.cw.nl()
1724
1725
1726def parse_rsp_nested_prototype(ri, struct, suffix=';'):
1727    func_args = ['struct ynl_parse_arg *yarg',
1728                 'const struct nlattr *nested']
1729    for arg in struct.inherited:
1730        func_args.append('__u32 ' + arg)
1731
1732    ri.cw.write_func_prot('int', f'{struct.render_name}_parse', func_args,
1733                          suffix=suffix)
1734
1735
1736def parse_rsp_nested(ri, struct):
1737    parse_rsp_nested_prototype(ri, struct, suffix='')
1738
1739    local_vars = ['const struct nlattr *attr;',
1740                  f'{struct.ptr_name}dst = yarg->data;']
1741    init_lines = []
1742
1743    _multi_parse(ri, struct, init_lines, local_vars)
1744
1745
1746def parse_rsp_msg(ri, deref=False):
1747    if 'reply' not in ri.op[ri.op_mode] and ri.op_mode != 'event':
1748        return
1749
1750    func_args = ['const struct nlmsghdr *nlh',
1751                 'struct ynl_parse_arg *yarg']
1752
1753    local_vars = [f'{type_name(ri, "reply", deref=deref)} *dst;',
1754                  'const struct nlattr *attr;']
1755    init_lines = ['dst = yarg->data;']
1756
1757    ri.cw.write_func_prot('int', f'{op_prefix(ri, "reply", deref=deref)}_parse', func_args)
1758
1759    if ri.struct["reply"].member_list():
1760        _multi_parse(ri, ri.struct["reply"], init_lines, local_vars)
1761    else:
1762        # Empty reply
1763        ri.cw.block_start()
1764        ri.cw.p('return YNL_PARSE_CB_OK;')
1765        ri.cw.block_end()
1766        ri.cw.nl()
1767
1768
1769def print_req(ri):
1770    ret_ok = '0'
1771    ret_err = '-1'
1772    direction = "request"
1773    local_vars = ['struct ynl_req_state yrs = { .yarg = { .ys = ys, }, };',
1774                  'struct nlmsghdr *nlh;',
1775                  'int err;']
1776
1777    if 'reply' in ri.op[ri.op_mode]:
1778        ret_ok = 'rsp'
1779        ret_err = 'NULL'
1780        local_vars += [f'{type_name(ri, rdir(direction))} *rsp;']
1781
1782    if ri.fixed_hdr:
1783        local_vars += ['size_t hdr_len;',
1784                       'void *hdr;']
1785
1786    print_prototype(ri, direction, terminate=False)
1787    ri.cw.block_start()
1788    ri.cw.write_func_lvar(local_vars)
1789
1790    ri.cw.p(f"nlh = ynl_gemsg_start_req(ys, {ri.nl.get_family_id()}, {ri.op.enum_name}, 1);")
1791
1792    ri.cw.p(f"ys->req_policy = &{ri.struct['request'].render_name}_nest;")
1793    if 'reply' in ri.op[ri.op_mode]:
1794        ri.cw.p(f"yrs.yarg.rsp_policy = &{ri.struct['reply'].render_name}_nest;")
1795    ri.cw.nl()
1796
1797    if ri.fixed_hdr:
1798        ri.cw.p("hdr_len = sizeof(req->_hdr);")
1799        ri.cw.p("hdr = ynl_nlmsg_put_extra_header(nlh, hdr_len);")
1800        ri.cw.p("memcpy(hdr, &req->_hdr, hdr_len);")
1801        ri.cw.nl()
1802
1803    for _, attr in ri.struct["request"].member_list():
1804        attr.attr_put(ri, "req")
1805    ri.cw.nl()
1806
1807    if 'reply' in ri.op[ri.op_mode]:
1808        ri.cw.p('rsp = calloc(1, sizeof(*rsp));')
1809        ri.cw.p('yrs.yarg.data = rsp;')
1810        ri.cw.p(f"yrs.cb = {op_prefix(ri, 'reply')}_parse;")
1811        if ri.op.value is not None:
1812            ri.cw.p(f'yrs.rsp_cmd = {ri.op.enum_name};')
1813        else:
1814            ri.cw.p(f'yrs.rsp_cmd = {ri.op.rsp_value};')
1815        ri.cw.nl()
1816    ri.cw.p("err = ynl_exec(ys, nlh, &yrs);")
1817    ri.cw.p('if (err < 0)')
1818    if 'reply' in ri.op[ri.op_mode]:
1819        ri.cw.p('goto err_free;')
1820    else:
1821        ri.cw.p('return -1;')
1822    ri.cw.nl()
1823
1824    ri.cw.p(f"return {ret_ok};")
1825    ri.cw.nl()
1826
1827    if 'reply' in ri.op[ri.op_mode]:
1828        ri.cw.p('err_free:')
1829        ri.cw.p(f"{call_free(ri, rdir(direction), 'rsp')}")
1830        ri.cw.p(f"return {ret_err};")
1831
1832    ri.cw.block_end()
1833
1834
1835def print_dump(ri):
1836    direction = "request"
1837    print_prototype(ri, direction, terminate=False)
1838    ri.cw.block_start()
1839    local_vars = ['struct ynl_dump_state yds = {};',
1840                  'struct nlmsghdr *nlh;',
1841                  'int err;']
1842
1843    if ri.fixed_hdr:
1844        local_vars += ['size_t hdr_len;',
1845                       'void *hdr;']
1846
1847    ri.cw.write_func_lvar(local_vars)
1848
1849    ri.cw.p('yds.yarg.ys = ys;')
1850    ri.cw.p(f"yds.yarg.rsp_policy = &{ri.struct['reply'].render_name}_nest;")
1851    ri.cw.p("yds.yarg.data = NULL;")
1852    ri.cw.p(f"yds.alloc_sz = sizeof({type_name(ri, rdir(direction))});")
1853    ri.cw.p(f"yds.cb = {op_prefix(ri, 'reply', deref=True)}_parse;")
1854    if ri.op.value is not None:
1855        ri.cw.p(f'yds.rsp_cmd = {ri.op.enum_name};')
1856    else:
1857        ri.cw.p(f'yds.rsp_cmd = {ri.op.rsp_value};')
1858    ri.cw.nl()
1859    ri.cw.p(f"nlh = ynl_gemsg_start_dump(ys, {ri.nl.get_family_id()}, {ri.op.enum_name}, 1);")
1860
1861    if ri.fixed_hdr:
1862        ri.cw.p("hdr_len = sizeof(req->_hdr);")
1863        ri.cw.p("hdr = ynl_nlmsg_put_extra_header(nlh, hdr_len);")
1864        ri.cw.p("memcpy(hdr, &req->_hdr, hdr_len);")
1865        ri.cw.nl()
1866
1867    if "request" in ri.op[ri.op_mode]:
1868        ri.cw.p(f"ys->req_policy = &{ri.struct['request'].render_name}_nest;")
1869        ri.cw.nl()
1870        for _, attr in ri.struct["request"].member_list():
1871            attr.attr_put(ri, "req")
1872    ri.cw.nl()
1873
1874    ri.cw.p('err = ynl_exec_dump(ys, nlh, &yds);')
1875    ri.cw.p('if (err < 0)')
1876    ri.cw.p('goto free_list;')
1877    ri.cw.nl()
1878
1879    ri.cw.p('return yds.first;')
1880    ri.cw.nl()
1881    ri.cw.p('free_list:')
1882    ri.cw.p(call_free(ri, rdir(direction), 'yds.first'))
1883    ri.cw.p('return NULL;')
1884    ri.cw.block_end()
1885
1886
1887def call_free(ri, direction, var):
1888    return f"{op_prefix(ri, direction)}_free({var});"
1889
1890
1891def free_arg_name(direction):
1892    if direction:
1893        return direction_to_suffix[direction][1:]
1894    return 'obj'
1895
1896
1897def print_alloc_wrapper(ri, direction):
1898    name = op_prefix(ri, direction)
1899    ri.cw.write_func_prot(f'static inline struct {name} *', f"{name}_alloc", [f"void"])
1900    ri.cw.block_start()
1901    ri.cw.p(f'return calloc(1, sizeof(struct {name}));')
1902    ri.cw.block_end()
1903
1904
1905def print_free_prototype(ri, direction, suffix=';'):
1906    name = op_prefix(ri, direction)
1907    struct_name = name
1908    if ri.type_name_conflict:
1909        struct_name += '_'
1910    arg = free_arg_name(direction)
1911    ri.cw.write_func_prot('void', f"{name}_free", [f"struct {struct_name} *{arg}"], suffix=suffix)
1912
1913
1914def _print_type(ri, direction, struct):
1915    suffix = f'_{ri.type_name}{direction_to_suffix[direction]}'
1916    if not direction and ri.type_name_conflict:
1917        suffix += '_'
1918
1919    if ri.op_mode == 'dump':
1920        suffix += '_dump'
1921
1922    ri.cw.block_start(line=f"struct {ri.family.c_name}{suffix}")
1923
1924    if ri.fixed_hdr:
1925        ri.cw.p(ri.fixed_hdr + ' _hdr;')
1926        ri.cw.nl()
1927
1928    meta_started = False
1929    for _, attr in struct.member_list():
1930        for type_filter in ['len', 'bit']:
1931            line = attr.presence_member(ri.ku_space, type_filter)
1932            if line:
1933                if not meta_started:
1934                    ri.cw.block_start(line=f"struct")
1935                    meta_started = True
1936                ri.cw.p(line)
1937    if meta_started:
1938        ri.cw.block_end(line='_present;')
1939        ri.cw.nl()
1940
1941    for arg in struct.inherited:
1942        ri.cw.p(f"__u32 {arg};")
1943
1944    for _, attr in struct.member_list():
1945        attr.struct_member(ri)
1946
1947    ri.cw.block_end(line=';')
1948    ri.cw.nl()
1949
1950
1951def print_type(ri, direction):
1952    _print_type(ri, direction, ri.struct[direction])
1953
1954
1955def print_type_full(ri, struct):
1956    _print_type(ri, "", struct)
1957
1958
1959def print_type_helpers(ri, direction, deref=False):
1960    print_free_prototype(ri, direction)
1961    ri.cw.nl()
1962
1963    if ri.ku_space == 'user' and direction == 'request':
1964        for _, attr in ri.struct[direction].member_list():
1965            attr.setter(ri, ri.attr_set, direction, deref=deref)
1966    ri.cw.nl()
1967
1968
1969def print_req_type_helpers(ri):
1970    if len(ri.struct["request"].attr_list) == 0:
1971        return
1972    print_alloc_wrapper(ri, "request")
1973    print_type_helpers(ri, "request")
1974
1975
1976def print_rsp_type_helpers(ri):
1977    if 'reply' not in ri.op[ri.op_mode]:
1978        return
1979    print_type_helpers(ri, "reply")
1980
1981
1982def print_parse_prototype(ri, direction, terminate=True):
1983    suffix = "_rsp" if direction == "reply" else "_req"
1984    term = ';' if terminate else ''
1985
1986    ri.cw.write_func_prot('void', f"{ri.op.render_name}{suffix}_parse",
1987                          ['const struct nlattr **tb',
1988                           f"struct {ri.op.render_name}{suffix} *req"],
1989                          suffix=term)
1990
1991
1992def print_req_type(ri):
1993    if len(ri.struct["request"].attr_list) == 0:
1994        return
1995    print_type(ri, "request")
1996
1997
1998def print_req_free(ri):
1999    if 'request' not in ri.op[ri.op_mode]:
2000        return
2001    _free_type(ri, 'request', ri.struct['request'])
2002
2003
2004def print_rsp_type(ri):
2005    if (ri.op_mode == 'do' or ri.op_mode == 'dump') and 'reply' in ri.op[ri.op_mode]:
2006        direction = 'reply'
2007    elif ri.op_mode == 'event':
2008        direction = 'reply'
2009    else:
2010        return
2011    print_type(ri, direction)
2012
2013
2014def print_wrapped_type(ri):
2015    ri.cw.block_start(line=f"{type_name(ri, 'reply')}")
2016    if ri.op_mode == 'dump':
2017        ri.cw.p(f"{type_name(ri, 'reply')} *next;")
2018    elif ri.op_mode == 'notify' or ri.op_mode == 'event':
2019        ri.cw.p('__u16 family;')
2020        ri.cw.p('__u8 cmd;')
2021        ri.cw.p('struct ynl_ntf_base_type *next;')
2022        ri.cw.p(f"void (*free)({type_name(ri, 'reply')} *ntf);")
2023    ri.cw.p(f"{type_name(ri, 'reply', deref=True)} obj __attribute__((aligned(8)));")
2024    ri.cw.block_end(line=';')
2025    ri.cw.nl()
2026    print_free_prototype(ri, 'reply')
2027    ri.cw.nl()
2028
2029
2030def _free_type_members_iter(ri, struct):
2031    for _, attr in struct.member_list():
2032        if attr.free_needs_iter():
2033            ri.cw.p('unsigned int i;')
2034            ri.cw.nl()
2035            break
2036
2037
2038def _free_type_members(ri, var, struct, ref=''):
2039    for _, attr in struct.member_list():
2040        attr.free(ri, var, ref)
2041
2042
2043def _free_type(ri, direction, struct):
2044    var = free_arg_name(direction)
2045
2046    print_free_prototype(ri, direction, suffix='')
2047    ri.cw.block_start()
2048    _free_type_members_iter(ri, struct)
2049    _free_type_members(ri, var, struct)
2050    if direction:
2051        ri.cw.p(f'free({var});')
2052    ri.cw.block_end()
2053    ri.cw.nl()
2054
2055
2056def free_rsp_nested_prototype(ri):
2057        print_free_prototype(ri, "")
2058
2059
2060def free_rsp_nested(ri, struct):
2061    _free_type(ri, "", struct)
2062
2063
2064def print_rsp_free(ri):
2065    if 'reply' not in ri.op[ri.op_mode]:
2066        return
2067    _free_type(ri, 'reply', ri.struct['reply'])
2068
2069
2070def print_dump_type_free(ri):
2071    sub_type = type_name(ri, 'reply')
2072
2073    print_free_prototype(ri, 'reply', suffix='')
2074    ri.cw.block_start()
2075    ri.cw.p(f"{sub_type} *next = rsp;")
2076    ri.cw.nl()
2077    ri.cw.block_start(line='while ((void *)next != YNL_LIST_END)')
2078    _free_type_members_iter(ri, ri.struct['reply'])
2079    ri.cw.p('rsp = next;')
2080    ri.cw.p('next = rsp->next;')
2081    ri.cw.nl()
2082
2083    _free_type_members(ri, 'rsp', ri.struct['reply'], ref='obj.')
2084    ri.cw.p(f'free(rsp);')
2085    ri.cw.block_end()
2086    ri.cw.block_end()
2087    ri.cw.nl()
2088
2089
2090def print_ntf_type_free(ri):
2091    print_free_prototype(ri, 'reply', suffix='')
2092    ri.cw.block_start()
2093    _free_type_members_iter(ri, ri.struct['reply'])
2094    _free_type_members(ri, 'rsp', ri.struct['reply'], ref='obj.')
2095    ri.cw.p(f'free(rsp);')
2096    ri.cw.block_end()
2097    ri.cw.nl()
2098
2099
2100def print_req_policy_fwd(cw, struct, ri=None, terminate=True):
2101    if terminate and ri and policy_should_be_static(struct.family):
2102        return
2103
2104    if terminate:
2105        prefix = 'extern '
2106    else:
2107        if ri and policy_should_be_static(struct.family):
2108            prefix = 'static '
2109        else:
2110            prefix = ''
2111
2112    suffix = ';' if terminate else ' = {'
2113
2114    max_attr = struct.attr_max_val
2115    if ri:
2116        name = ri.op.render_name
2117        if ri.op.dual_policy:
2118            name += '_' + ri.op_mode
2119    else:
2120        name = struct.render_name
2121    cw.p(f"{prefix}const struct nla_policy {name}_nl_policy[{max_attr.enum_name} + 1]{suffix}")
2122
2123
2124def print_req_policy(cw, struct, ri=None):
2125    if ri and ri.op:
2126        cw.ifdef_block(ri.op.get('config-cond', None))
2127    print_req_policy_fwd(cw, struct, ri=ri, terminate=False)
2128    for _, arg in struct.member_list():
2129        arg.attr_policy(cw)
2130    cw.p("};")
2131    cw.ifdef_block(None)
2132    cw.nl()
2133
2134
2135def kernel_can_gen_family_struct(family):
2136    return family.proto == 'genetlink'
2137
2138
2139def policy_should_be_static(family):
2140    return family.kernel_policy == 'split' or kernel_can_gen_family_struct(family)
2141
2142
2143def print_kernel_policy_ranges(family, cw):
2144    first = True
2145    for _, attr_set in family.attr_sets.items():
2146        if attr_set.subset_of:
2147            continue
2148
2149        for _, attr in attr_set.items():
2150            if not attr.request:
2151                continue
2152            if 'full-range' not in attr.checks:
2153                continue
2154
2155            if first:
2156                cw.p('/* Integer value ranges */')
2157                first = False
2158
2159            sign = '' if attr.type[0] == 'u' else '_signed'
2160            suffix = 'ULL' if attr.type[0] == 'u' else 'LL'
2161            cw.block_start(line=f'static const struct netlink_range_validation{sign} {c_lower(attr.enum_name)}_range =')
2162            members = []
2163            if 'min' in attr.checks:
2164                members.append(('min', str(attr.get_limit('min')) + suffix))
2165            if 'max' in attr.checks:
2166                members.append(('max', str(attr.get_limit('max')) + suffix))
2167            cw.write_struct_init(members)
2168            cw.block_end(line=';')
2169            cw.nl()
2170
2171
2172def print_kernel_op_table_fwd(family, cw, terminate):
2173    exported = not kernel_can_gen_family_struct(family)
2174
2175    if not terminate or exported:
2176        cw.p(f"/* Ops table for {family.ident_name} */")
2177
2178        pol_to_struct = {'global': 'genl_small_ops',
2179                         'per-op': 'genl_ops',
2180                         'split': 'genl_split_ops'}
2181        struct_type = pol_to_struct[family.kernel_policy]
2182
2183        if not exported:
2184            cnt = ""
2185        elif family.kernel_policy == 'split':
2186            cnt = 0
2187            for op in family.ops.values():
2188                if 'do' in op:
2189                    cnt += 1
2190                if 'dump' in op:
2191                    cnt += 1
2192        else:
2193            cnt = len(family.ops)
2194
2195        qual = 'static const' if not exported else 'const'
2196        line = f"{qual} struct {struct_type} {family.c_name}_nl_ops[{cnt}]"
2197        if terminate:
2198            cw.p(f"extern {line};")
2199        else:
2200            cw.block_start(line=line + ' =')
2201
2202    if not terminate:
2203        return
2204
2205    cw.nl()
2206    for name in family.hooks['pre']['do']['list']:
2207        cw.write_func_prot('int', c_lower(name),
2208                           ['const struct genl_split_ops *ops',
2209                            'struct sk_buff *skb', 'struct genl_info *info'], suffix=';')
2210    for name in family.hooks['post']['do']['list']:
2211        cw.write_func_prot('void', c_lower(name),
2212                           ['const struct genl_split_ops *ops',
2213                            'struct sk_buff *skb', 'struct genl_info *info'], suffix=';')
2214    for name in family.hooks['pre']['dump']['list']:
2215        cw.write_func_prot('int', c_lower(name),
2216                           ['struct netlink_callback *cb'], suffix=';')
2217    for name in family.hooks['post']['dump']['list']:
2218        cw.write_func_prot('int', c_lower(name),
2219                           ['struct netlink_callback *cb'], suffix=';')
2220
2221    cw.nl()
2222
2223    for op_name, op in family.ops.items():
2224        if op.is_async:
2225            continue
2226
2227        if 'do' in op:
2228            name = c_lower(f"{family.ident_name}-nl-{op_name}-doit")
2229            cw.write_func_prot('int', name,
2230                               ['struct sk_buff *skb', 'struct genl_info *info'], suffix=';')
2231
2232        if 'dump' in op:
2233            name = c_lower(f"{family.ident_name}-nl-{op_name}-dumpit")
2234            cw.write_func_prot('int', name,
2235                               ['struct sk_buff *skb', 'struct netlink_callback *cb'], suffix=';')
2236    cw.nl()
2237
2238
2239def print_kernel_op_table_hdr(family, cw):
2240    print_kernel_op_table_fwd(family, cw, terminate=True)
2241
2242
2243def print_kernel_op_table(family, cw):
2244    print_kernel_op_table_fwd(family, cw, terminate=False)
2245    if family.kernel_policy == 'global' or family.kernel_policy == 'per-op':
2246        for op_name, op in family.ops.items():
2247            if op.is_async:
2248                continue
2249
2250            cw.ifdef_block(op.get('config-cond', None))
2251            cw.block_start()
2252            members = [('cmd', op.enum_name)]
2253            if 'dont-validate' in op:
2254                members.append(('validate',
2255                                ' | '.join([c_upper('genl-dont-validate-' + x)
2256                                            for x in op['dont-validate']])), )
2257            for op_mode in ['do', 'dump']:
2258                if op_mode in op:
2259                    name = c_lower(f"{family.ident_name}-nl-{op_name}-{op_mode}it")
2260                    members.append((op_mode + 'it', name))
2261            if family.kernel_policy == 'per-op':
2262                struct = Struct(family, op['attribute-set'],
2263                                type_list=op['do']['request']['attributes'])
2264
2265                name = c_lower(f"{family.ident_name}-{op_name}-nl-policy")
2266                members.append(('policy', name))
2267                members.append(('maxattr', struct.attr_max_val.enum_name))
2268            if 'flags' in op:
2269                members.append(('flags', ' | '.join([c_upper('genl-' + x) for x in op['flags']])))
2270            cw.write_struct_init(members)
2271            cw.block_end(line=',')
2272    elif family.kernel_policy == 'split':
2273        cb_names = {'do':   {'pre': 'pre_doit', 'post': 'post_doit'},
2274                    'dump': {'pre': 'start', 'post': 'done'}}
2275
2276        for op_name, op in family.ops.items():
2277            for op_mode in ['do', 'dump']:
2278                if op.is_async or op_mode not in op:
2279                    continue
2280
2281                cw.ifdef_block(op.get('config-cond', None))
2282                cw.block_start()
2283                members = [('cmd', op.enum_name)]
2284                if 'dont-validate' in op:
2285                    dont_validate = []
2286                    for x in op['dont-validate']:
2287                        if op_mode == 'do' and x in ['dump', 'dump-strict']:
2288                            continue
2289                        if op_mode == "dump" and x == 'strict':
2290                            continue
2291                        dont_validate.append(x)
2292
2293                    if dont_validate:
2294                        members.append(('validate',
2295                                        ' | '.join([c_upper('genl-dont-validate-' + x)
2296                                                    for x in dont_validate])), )
2297                name = c_lower(f"{family.ident_name}-nl-{op_name}-{op_mode}it")
2298                if 'pre' in op[op_mode]:
2299                    members.append((cb_names[op_mode]['pre'], c_lower(op[op_mode]['pre'])))
2300                members.append((op_mode + 'it', name))
2301                if 'post' in op[op_mode]:
2302                    members.append((cb_names[op_mode]['post'], c_lower(op[op_mode]['post'])))
2303                if 'request' in op[op_mode]:
2304                    struct = Struct(family, op['attribute-set'],
2305                                    type_list=op[op_mode]['request']['attributes'])
2306
2307                    if op.dual_policy:
2308                        name = c_lower(f"{family.ident_name}-{op_name}-{op_mode}-nl-policy")
2309                    else:
2310                        name = c_lower(f"{family.ident_name}-{op_name}-nl-policy")
2311                    members.append(('policy', name))
2312                    members.append(('maxattr', struct.attr_max_val.enum_name))
2313                flags = (op['flags'] if 'flags' in op else []) + ['cmd-cap-' + op_mode]
2314                members.append(('flags', ' | '.join([c_upper('genl-' + x) for x in flags])))
2315                cw.write_struct_init(members)
2316                cw.block_end(line=',')
2317    cw.ifdef_block(None)
2318
2319    cw.block_end(line=';')
2320    cw.nl()
2321
2322
2323def print_kernel_mcgrp_hdr(family, cw):
2324    if not family.mcgrps['list']:
2325        return
2326
2327    cw.block_start('enum')
2328    for grp in family.mcgrps['list']:
2329        grp_id = c_upper(f"{family.ident_name}-nlgrp-{grp['name']},")
2330        cw.p(grp_id)
2331    cw.block_end(';')
2332    cw.nl()
2333
2334
2335def print_kernel_mcgrp_src(family, cw):
2336    if not family.mcgrps['list']:
2337        return
2338
2339    cw.block_start('static const struct genl_multicast_group ' + family.c_name + '_nl_mcgrps[] =')
2340    for grp in family.mcgrps['list']:
2341        name = grp['name']
2342        grp_id = c_upper(f"{family.ident_name}-nlgrp-{name}")
2343        cw.p('[' + grp_id + '] = { "' + name + '", },')
2344    cw.block_end(';')
2345    cw.nl()
2346
2347
2348def print_kernel_family_struct_hdr(family, cw):
2349    if not kernel_can_gen_family_struct(family):
2350        return
2351
2352    cw.p(f"extern struct genl_family {family.c_name}_nl_family;")
2353    cw.nl()
2354    if 'sock-priv' in family.kernel_family:
2355        cw.p(f'void {family.c_name}_nl_sock_priv_init({family.kernel_family["sock-priv"]} *priv);')
2356        cw.p(f'void {family.c_name}_nl_sock_priv_destroy({family.kernel_family["sock-priv"]} *priv);')
2357        cw.nl()
2358
2359
2360def print_kernel_family_struct_src(family, cw):
2361    if not kernel_can_gen_family_struct(family):
2362        return
2363
2364    cw.block_start(f"struct genl_family {family.ident_name}_nl_family __ro_after_init =")
2365    cw.p('.name\t\t= ' + family.fam_key + ',')
2366    cw.p('.version\t= ' + family.ver_key + ',')
2367    cw.p('.netnsok\t= true,')
2368    cw.p('.parallel_ops\t= true,')
2369    cw.p('.module\t\t= THIS_MODULE,')
2370    if family.kernel_policy == 'per-op':
2371        cw.p(f'.ops\t\t= {family.c_name}_nl_ops,')
2372        cw.p(f'.n_ops\t\t= ARRAY_SIZE({family.c_name}_nl_ops),')
2373    elif family.kernel_policy == 'split':
2374        cw.p(f'.split_ops\t= {family.c_name}_nl_ops,')
2375        cw.p(f'.n_split_ops\t= ARRAY_SIZE({family.c_name}_nl_ops),')
2376    if family.mcgrps['list']:
2377        cw.p(f'.mcgrps\t\t= {family.c_name}_nl_mcgrps,')
2378        cw.p(f'.n_mcgrps\t= ARRAY_SIZE({family.c_name}_nl_mcgrps),')
2379    if 'sock-priv' in family.kernel_family:
2380        cw.p(f'.sock_priv_size\t= sizeof({family.kernel_family["sock-priv"]}),')
2381        # Force cast here, actual helpers take pointer to the real type.
2382        cw.p(f'.sock_priv_init\t= (void *){family.c_name}_nl_sock_priv_init,')
2383        cw.p(f'.sock_priv_destroy = (void *){family.c_name}_nl_sock_priv_destroy,')
2384    cw.block_end(';')
2385
2386
2387def uapi_enum_start(family, cw, obj, ckey='', enum_name='enum-name'):
2388    start_line = 'enum'
2389    if enum_name in obj:
2390        if obj[enum_name]:
2391            start_line = 'enum ' + c_lower(obj[enum_name])
2392    elif ckey and ckey in obj:
2393        start_line = 'enum ' + family.c_name + '_' + c_lower(obj[ckey])
2394    cw.block_start(line=start_line)
2395
2396
2397def render_uapi(family, cw):
2398    hdr_prot = f"_UAPI_LINUX_{c_upper(family.uapi_header_name)}_H"
2399    cw.p('#ifndef ' + hdr_prot)
2400    cw.p('#define ' + hdr_prot)
2401    cw.nl()
2402
2403    defines = [(family.fam_key, family["name"]),
2404               (family.ver_key, family.get('version', 1))]
2405    cw.writes_defines(defines)
2406    cw.nl()
2407
2408    defines = []
2409    for const in family['definitions']:
2410        if const['type'] != 'const':
2411            cw.writes_defines(defines)
2412            defines = []
2413            cw.nl()
2414
2415        # Write kdoc for enum and flags (one day maybe also structs)
2416        if const['type'] == 'enum' or const['type'] == 'flags':
2417            enum = family.consts[const['name']]
2418
2419            if enum.has_doc():
2420                cw.p('/**')
2421                doc = ''
2422                if 'doc' in enum:
2423                    doc = ' - ' + enum['doc']
2424                cw.write_doc_line(enum.enum_name + doc)
2425                for entry in enum.entries.values():
2426                    if entry.has_doc():
2427                        doc = '@' + entry.c_name + ': ' + entry['doc']
2428                        cw.write_doc_line(doc)
2429                cw.p(' */')
2430
2431            uapi_enum_start(family, cw, const, 'name')
2432            name_pfx = const.get('name-prefix', f"{family.ident_name}-{const['name']}-")
2433            for entry in enum.entries.values():
2434                suffix = ','
2435                if entry.value_change:
2436                    suffix = f" = {entry.user_value()}" + suffix
2437                cw.p(entry.c_name + suffix)
2438
2439            if const.get('render-max', False):
2440                cw.nl()
2441                cw.p('/* private: */')
2442                if const['type'] == 'flags':
2443                    max_name = c_upper(name_pfx + 'mask')
2444                    max_val = f' = {enum.get_mask()},'
2445                    cw.p(max_name + max_val)
2446                else:
2447                    max_name = c_upper(name_pfx + 'max')
2448                    cw.p('__' + max_name + ',')
2449                    cw.p(max_name + ' = (__' + max_name + ' - 1)')
2450            cw.block_end(line=';')
2451            cw.nl()
2452        elif const['type'] == 'const':
2453            defines.append([c_upper(family.get('c-define-name',
2454                                               f"{family.ident_name}-{const['name']}")),
2455                            const['value']])
2456
2457    if defines:
2458        cw.writes_defines(defines)
2459        cw.nl()
2460
2461    max_by_define = family.get('max-by-define', False)
2462
2463    for _, attr_set in family.attr_sets.items():
2464        if attr_set.subset_of:
2465            continue
2466
2467        max_value = f"({attr_set.cnt_name} - 1)"
2468
2469        val = 0
2470        uapi_enum_start(family, cw, attr_set.yaml, 'enum-name')
2471        for _, attr in attr_set.items():
2472            suffix = ','
2473            if attr.value != val:
2474                suffix = f" = {attr.value},"
2475                val = attr.value
2476            val += 1
2477            cw.p(attr.enum_name + suffix)
2478        cw.nl()
2479        cw.p(attr_set.cnt_name + ('' if max_by_define else ','))
2480        if not max_by_define:
2481            cw.p(f"{attr_set.max_name} = {max_value}")
2482        cw.block_end(line=';')
2483        if max_by_define:
2484            cw.p(f"#define {attr_set.max_name} {max_value}")
2485        cw.nl()
2486
2487    # Commands
2488    separate_ntf = 'async-prefix' in family['operations']
2489
2490    max_name = c_upper(family.get('cmd-max-name', f"{family.op_prefix}MAX"))
2491    cnt_name = c_upper(family.get('cmd-cnt-name', f"__{family.op_prefix}MAX"))
2492    max_value = f"({cnt_name} - 1)"
2493
2494    uapi_enum_start(family, cw, family['operations'], 'enum-name')
2495    val = 0
2496    for op in family.msgs.values():
2497        if separate_ntf and ('notify' in op or 'event' in op):
2498            continue
2499
2500        suffix = ','
2501        if op.value != val:
2502            suffix = f" = {op.value},"
2503            val = op.value
2504        cw.p(op.enum_name + suffix)
2505        val += 1
2506    cw.nl()
2507    cw.p(cnt_name + ('' if max_by_define else ','))
2508    if not max_by_define:
2509        cw.p(f"{max_name} = {max_value}")
2510    cw.block_end(line=';')
2511    if max_by_define:
2512        cw.p(f"#define {max_name} {max_value}")
2513    cw.nl()
2514
2515    if separate_ntf:
2516        uapi_enum_start(family, cw, family['operations'], enum_name='async-enum')
2517        for op in family.msgs.values():
2518            if separate_ntf and not ('notify' in op or 'event' in op):
2519                continue
2520
2521            suffix = ','
2522            if 'value' in op:
2523                suffix = f" = {op['value']},"
2524            cw.p(op.enum_name + suffix)
2525        cw.block_end(line=';')
2526        cw.nl()
2527
2528    # Multicast
2529    defines = []
2530    for grp in family.mcgrps['list']:
2531        name = grp['name']
2532        defines.append([c_upper(grp.get('c-define-name', f"{family.ident_name}-mcgrp-{name}")),
2533                        f'{name}'])
2534    cw.nl()
2535    if defines:
2536        cw.writes_defines(defines)
2537        cw.nl()
2538
2539    cw.p(f'#endif /* {hdr_prot} */')
2540
2541
2542def _render_user_ntf_entry(ri, op):
2543    ri.cw.block_start(line=f"[{op.enum_name}] = ")
2544    ri.cw.p(f".alloc_sz\t= sizeof({type_name(ri, 'event')}),")
2545    ri.cw.p(f".cb\t\t= {op_prefix(ri, 'reply', deref=True)}_parse,")
2546    ri.cw.p(f".policy\t\t= &{ri.struct['reply'].render_name}_nest,")
2547    ri.cw.p(f".free\t\t= (void *){op_prefix(ri, 'notify')}_free,")
2548    ri.cw.block_end(line=',')
2549
2550
2551def render_user_family(family, cw, prototype):
2552    symbol = f'const struct ynl_family ynl_{family.c_name}_family'
2553    if prototype:
2554        cw.p(f'extern {symbol};')
2555        return
2556
2557    if family.ntfs:
2558        cw.block_start(line=f"static const struct ynl_ntf_info {family['name']}_ntf_info[] = ")
2559        for ntf_op_name, ntf_op in family.ntfs.items():
2560            if 'notify' in ntf_op:
2561                op = family.ops[ntf_op['notify']]
2562                ri = RenderInfo(cw, family, "user", op, "notify")
2563            elif 'event' in ntf_op:
2564                ri = RenderInfo(cw, family, "user", ntf_op, "event")
2565            else:
2566                raise Exception('Invalid notification ' + ntf_op_name)
2567            _render_user_ntf_entry(ri, ntf_op)
2568        for op_name, op in family.ops.items():
2569            if 'event' not in op:
2570                continue
2571            ri = RenderInfo(cw, family, "user", op, "event")
2572            _render_user_ntf_entry(ri, op)
2573        cw.block_end(line=";")
2574        cw.nl()
2575
2576    cw.block_start(f'{symbol} = ')
2577    cw.p(f'.name\t\t= "{family.c_name}",')
2578    if family.fixed_header:
2579        cw.p(f'.hdr_len\t= sizeof(struct genlmsghdr) + sizeof(struct {c_lower(family.fixed_header)}),')
2580    else:
2581        cw.p('.hdr_len\t= sizeof(struct genlmsghdr),')
2582    if family.ntfs:
2583        cw.p(f".ntf_info\t= {family['name']}_ntf_info,")
2584        cw.p(f".ntf_info_size\t= YNL_ARRAY_SIZE({family['name']}_ntf_info),")
2585    cw.block_end(line=';')
2586
2587
2588def family_contains_bitfield32(family):
2589    for _, attr_set in family.attr_sets.items():
2590        if attr_set.subset_of:
2591            continue
2592        for _, attr in attr_set.items():
2593            if attr.type == "bitfield32":
2594                return True
2595    return False
2596
2597
2598def find_kernel_root(full_path):
2599    sub_path = ''
2600    while True:
2601        sub_path = os.path.join(os.path.basename(full_path), sub_path)
2602        full_path = os.path.dirname(full_path)
2603        maintainers = os.path.join(full_path, "MAINTAINERS")
2604        if os.path.exists(maintainers):
2605            return full_path, sub_path[:-1]
2606
2607
2608def main():
2609    parser = argparse.ArgumentParser(description='Netlink simple parsing generator')
2610    parser.add_argument('--mode', dest='mode', type=str, required=True)
2611    parser.add_argument('--spec', dest='spec', type=str, required=True)
2612    parser.add_argument('--header', dest='header', action='store_true', default=None)
2613    parser.add_argument('--source', dest='header', action='store_false')
2614    parser.add_argument('--user-header', nargs='+', default=[])
2615    parser.add_argument('--cmp-out', action='store_true', default=None,
2616                        help='Do not overwrite the output file if the new output is identical to the old')
2617    parser.add_argument('--exclude-op', action='append', default=[])
2618    parser.add_argument('-o', dest='out_file', type=str, default=None)
2619    args = parser.parse_args()
2620
2621    if args.header is None:
2622        parser.error("--header or --source is required")
2623
2624    exclude_ops = [re.compile(expr) for expr in args.exclude_op]
2625
2626    try:
2627        parsed = Family(args.spec, exclude_ops)
2628        if parsed.license != '((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)':
2629            print('Spec license:', parsed.license)
2630            print('License must be: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)')
2631            os.sys.exit(1)
2632    except yaml.YAMLError as exc:
2633        print(exc)
2634        os.sys.exit(1)
2635        return
2636
2637    supported_models = ['unified']
2638    if args.mode in ['user', 'kernel']:
2639        supported_models += ['directional']
2640    if parsed.msg_id_model not in supported_models:
2641        print(f'Message enum-model {parsed.msg_id_model} not supported for {args.mode} generation')
2642        os.sys.exit(1)
2643
2644    cw = CodeWriter(BaseNlLib(), args.out_file, overwrite=(not args.cmp_out))
2645
2646    _, spec_kernel = find_kernel_root(args.spec)
2647    if args.mode == 'uapi' or args.header:
2648        cw.p(f'/* SPDX-License-Identifier: {parsed.license} */')
2649    else:
2650        cw.p(f'// SPDX-License-Identifier: {parsed.license}')
2651    cw.p("/* Do not edit directly, auto-generated from: */")
2652    cw.p(f"/*\t{spec_kernel} */")
2653    cw.p(f"/* YNL-GEN {args.mode} {'header' if args.header else 'source'} */")
2654    if args.exclude_op or args.user_header:
2655        line = ''
2656        line += ' --user-header '.join([''] + args.user_header)
2657        line += ' --exclude-op '.join([''] + args.exclude_op)
2658        cw.p(f'/* YNL-ARG{line} */')
2659    cw.nl()
2660
2661    if args.mode == 'uapi':
2662        render_uapi(parsed, cw)
2663        return
2664
2665    hdr_prot = f"_LINUX_{parsed.c_name.upper()}_GEN_H"
2666    if args.header:
2667        cw.p('#ifndef ' + hdr_prot)
2668        cw.p('#define ' + hdr_prot)
2669        cw.nl()
2670
2671    hdr_file=os.path.basename(args.out_file[:-2]) + ".h"
2672
2673    if args.mode == 'kernel':
2674        cw.p('#include <net/netlink.h>')
2675        cw.p('#include <net/genetlink.h>')
2676        cw.nl()
2677        if not args.header:
2678            if args.out_file:
2679                cw.p(f'#include "{hdr_file}"')
2680            cw.nl()
2681        headers = ['uapi/' + parsed.uapi_header]
2682        headers += parsed.kernel_family.get('headers', [])
2683    else:
2684        cw.p('#include <stdlib.h>')
2685        cw.p('#include <string.h>')
2686        if args.header:
2687            cw.p('#include <linux/types.h>')
2688            if family_contains_bitfield32(parsed):
2689                cw.p('#include <linux/netlink.h>')
2690        else:
2691            cw.p(f'#include "{hdr_file}"')
2692            cw.p('#include "ynl.h"')
2693        headers = [parsed.uapi_header]
2694    for definition in parsed['definitions']:
2695        if 'header' in definition:
2696            headers.append(definition['header'])
2697    for one in headers:
2698        cw.p(f"#include <{one}>")
2699    cw.nl()
2700
2701    if args.mode == "user":
2702        if not args.header:
2703            cw.p("#include <linux/genetlink.h>")
2704            cw.nl()
2705            for one in args.user_header:
2706                cw.p(f'#include "{one}"')
2707        else:
2708            cw.p('struct ynl_sock;')
2709            cw.nl()
2710            render_user_family(parsed, cw, True)
2711        cw.nl()
2712
2713    if args.mode == "kernel":
2714        if args.header:
2715            for _, struct in sorted(parsed.pure_nested_structs.items()):
2716                if struct.request:
2717                    cw.p('/* Common nested types */')
2718                    break
2719            for attr_set, struct in sorted(parsed.pure_nested_structs.items()):
2720                if struct.request:
2721                    print_req_policy_fwd(cw, struct)
2722            cw.nl()
2723
2724            if parsed.kernel_policy == 'global':
2725                cw.p(f"/* Global operation policy for {parsed.name} */")
2726
2727                struct = Struct(parsed, parsed.global_policy_set, type_list=parsed.global_policy)
2728                print_req_policy_fwd(cw, struct)
2729                cw.nl()
2730
2731            if parsed.kernel_policy in {'per-op', 'split'}:
2732                for op_name, op in parsed.ops.items():
2733                    if 'do' in op and 'event' not in op:
2734                        ri = RenderInfo(cw, parsed, args.mode, op, "do")
2735                        print_req_policy_fwd(cw, ri.struct['request'], ri=ri)
2736                        cw.nl()
2737
2738            print_kernel_op_table_hdr(parsed, cw)
2739            print_kernel_mcgrp_hdr(parsed, cw)
2740            print_kernel_family_struct_hdr(parsed, cw)
2741        else:
2742            print_kernel_policy_ranges(parsed, cw)
2743
2744            for _, struct in sorted(parsed.pure_nested_structs.items()):
2745                if struct.request:
2746                    cw.p('/* Common nested types */')
2747                    break
2748            for attr_set, struct in sorted(parsed.pure_nested_structs.items()):
2749                if struct.request:
2750                    print_req_policy(cw, struct)
2751            cw.nl()
2752
2753            if parsed.kernel_policy == 'global':
2754                cw.p(f"/* Global operation policy for {parsed.name} */")
2755
2756                struct = Struct(parsed, parsed.global_policy_set, type_list=parsed.global_policy)
2757                print_req_policy(cw, struct)
2758                cw.nl()
2759
2760            for op_name, op in parsed.ops.items():
2761                if parsed.kernel_policy in {'per-op', 'split'}:
2762                    for op_mode in ['do', 'dump']:
2763                        if op_mode in op and 'request' in op[op_mode]:
2764                            cw.p(f"/* {op.enum_name} - {op_mode} */")
2765                            ri = RenderInfo(cw, parsed, args.mode, op, op_mode)
2766                            print_req_policy(cw, ri.struct['request'], ri=ri)
2767                            cw.nl()
2768
2769            print_kernel_op_table(parsed, cw)
2770            print_kernel_mcgrp_src(parsed, cw)
2771            print_kernel_family_struct_src(parsed, cw)
2772
2773    if args.mode == "user":
2774        if args.header:
2775            cw.p('/* Enums */')
2776            put_op_name_fwd(parsed, cw)
2777
2778            for name, const in parsed.consts.items():
2779                if isinstance(const, EnumSet):
2780                    put_enum_to_str_fwd(parsed, cw, const)
2781            cw.nl()
2782
2783            cw.p('/* Common nested types */')
2784            for attr_set, struct in parsed.pure_nested_structs.items():
2785                ri = RenderInfo(cw, parsed, args.mode, "", "", attr_set)
2786                print_type_full(ri, struct)
2787
2788            for op_name, op in parsed.ops.items():
2789                cw.p(f"/* ============== {op.enum_name} ============== */")
2790
2791                if 'do' in op and 'event' not in op:
2792                    cw.p(f"/* {op.enum_name} - do */")
2793                    ri = RenderInfo(cw, parsed, args.mode, op, "do")
2794                    print_req_type(ri)
2795                    print_req_type_helpers(ri)
2796                    cw.nl()
2797                    print_rsp_type(ri)
2798                    print_rsp_type_helpers(ri)
2799                    cw.nl()
2800                    print_req_prototype(ri)
2801                    cw.nl()
2802
2803                if 'dump' in op:
2804                    cw.p(f"/* {op.enum_name} - dump */")
2805                    ri = RenderInfo(cw, parsed, args.mode, op, 'dump')
2806                    print_req_type(ri)
2807                    print_req_type_helpers(ri)
2808                    if not ri.type_consistent:
2809                        print_rsp_type(ri)
2810                    print_wrapped_type(ri)
2811                    print_dump_prototype(ri)
2812                    cw.nl()
2813
2814                if op.has_ntf:
2815                    cw.p(f"/* {op.enum_name} - notify */")
2816                    ri = RenderInfo(cw, parsed, args.mode, op, 'notify')
2817                    if not ri.type_consistent:
2818                        raise Exception(f'Only notifications with consistent types supported ({op.name})')
2819                    print_wrapped_type(ri)
2820
2821            for op_name, op in parsed.ntfs.items():
2822                if 'event' in op:
2823                    ri = RenderInfo(cw, parsed, args.mode, op, 'event')
2824                    cw.p(f"/* {op.enum_name} - event */")
2825                    print_rsp_type(ri)
2826                    cw.nl()
2827                    print_wrapped_type(ri)
2828            cw.nl()
2829        else:
2830            cw.p('/* Enums */')
2831            put_op_name(parsed, cw)
2832
2833            for name, const in parsed.consts.items():
2834                if isinstance(const, EnumSet):
2835                    put_enum_to_str(parsed, cw, const)
2836            cw.nl()
2837
2838            has_recursive_nests = False
2839            cw.p('/* Policies */')
2840            for struct in parsed.pure_nested_structs.values():
2841                if struct.recursive:
2842                    put_typol_fwd(cw, struct)
2843                    has_recursive_nests = True
2844            if has_recursive_nests:
2845                cw.nl()
2846            for name in parsed.pure_nested_structs:
2847                struct = Struct(parsed, name)
2848                put_typol(cw, struct)
2849            for name in parsed.root_sets:
2850                struct = Struct(parsed, name)
2851                put_typol(cw, struct)
2852
2853            cw.p('/* Common nested types */')
2854            if has_recursive_nests:
2855                for attr_set, struct in parsed.pure_nested_structs.items():
2856                    ri = RenderInfo(cw, parsed, args.mode, "", "", attr_set)
2857                    free_rsp_nested_prototype(ri)
2858                    if struct.request:
2859                        put_req_nested_prototype(ri, struct)
2860                    if struct.reply:
2861                        parse_rsp_nested_prototype(ri, struct)
2862                cw.nl()
2863            for attr_set, struct in parsed.pure_nested_structs.items():
2864                ri = RenderInfo(cw, parsed, args.mode, "", "", attr_set)
2865
2866                free_rsp_nested(ri, struct)
2867                if struct.request:
2868                    put_req_nested(ri, struct)
2869                if struct.reply:
2870                    parse_rsp_nested(ri, struct)
2871
2872            for op_name, op in parsed.ops.items():
2873                cw.p(f"/* ============== {op.enum_name} ============== */")
2874                if 'do' in op and 'event' not in op:
2875                    cw.p(f"/* {op.enum_name} - do */")
2876                    ri = RenderInfo(cw, parsed, args.mode, op, "do")
2877                    print_req_free(ri)
2878                    print_rsp_free(ri)
2879                    parse_rsp_msg(ri)
2880                    print_req(ri)
2881                    cw.nl()
2882
2883                if 'dump' in op:
2884                    cw.p(f"/* {op.enum_name} - dump */")
2885                    ri = RenderInfo(cw, parsed, args.mode, op, "dump")
2886                    if not ri.type_consistent:
2887                        parse_rsp_msg(ri, deref=True)
2888                    print_req_free(ri)
2889                    print_dump_type_free(ri)
2890                    print_dump(ri)
2891                    cw.nl()
2892
2893                if op.has_ntf:
2894                    cw.p(f"/* {op.enum_name} - notify */")
2895                    ri = RenderInfo(cw, parsed, args.mode, op, 'notify')
2896                    if not ri.type_consistent:
2897                        raise Exception(f'Only notifications with consistent types supported ({op.name})')
2898                    print_ntf_type_free(ri)
2899
2900            for op_name, op in parsed.ntfs.items():
2901                if 'event' in op:
2902                    cw.p(f"/* {op.enum_name} - event */")
2903
2904                    ri = RenderInfo(cw, parsed, args.mode, op, "do")
2905                    parse_rsp_msg(ri)
2906
2907                    ri = RenderInfo(cw, parsed, args.mode, op, "event")
2908                    print_ntf_type_free(ri)
2909            cw.nl()
2910            render_user_family(parsed, cw, False)
2911
2912    if args.header:
2913        cw.p(f'#endif /* {hdr_prot} */')
2914
2915
2916if __name__ == "__main__":
2917    main()
2918