Family nlctrl netlink specification

Summary

genetlink meta-family that exposes information about all genetlink families registered in the kernel (including itself).

Operations

getfamily

Get / dump genetlink families

attribute-set:

ctrl-attrs

do:

request

attributes:

[family-id, family-name]

reply

attributes:

[family-id, family-name, hdrsize, maxattr, mcast-groups, ops, version]

dump:

reply

attributes:

[family-id, family-name, hdrsize, maxattr, mcast-groups, ops, version]

getpolicy

Get / dump genetlink policies

attribute-set:

ctrl-attrs

dump:

request

attributes:

[family-name, family-id, op]

reply

attributes:

[family-id, op-policy, policy]

Definitions

op-flags

type:

flags

enum-name:

None

entries:

• admin-perm

• cmd-cap-do

• cmd-cap-dump

• cmd-cap-haspol

• uns-admin-perm

attr-type

enum-name:

netlink-attribute-type

type:

enum

entries:

• invalid

• flag

• u8

• u16

• u32

• u64

• s8

• s16

• s32

• s64

• binary

• string

• nul-string

• nested

• nested-array

• bitfield32

• sint

• uint

policy-byte-order

doc:

Byte order of an integer attribute. Zero is left unused so that it can be taken to mean host byte order.

enum-name:

netlink-policy-byte-order

type:

enum

value-start:

1

entries:

• big-endian

Attribute sets

ctrl-attrs

family-id (u16)

family-name (string)

version (u32)

hdrsize (u32)

maxattr (u32)

ops (indexed-array)

sub-type:

nest

nested-attributes:

op-attrs

mcast-groups (indexed-array)

sub-type:

nest

nested-attributes:

mcast-group-attrs

policy (nest-type-value)

type-value:

[‘policy-id’, ‘attr-id’]

nested-attributes:

policy-attrs

op-policy (nest-type-value)

type-value:

[‘op-id’]

nested-attributes:

op-policy-attrs

op (u32)

mcast-group-attrs

name (string)

id (u32)

op-attrs

id (u32)

flags (u32)

enum:

op-flags

enum-as-flags:

True

policy-attrs

type (u32)

enum:

attr-type

min-value-s (s64)

max-value-s (s64)

min-value-u (u64)

max-value-u (u64)

min-length (u32)

max-length (u32)

policy-idx (u32)

policy-maxtype (u32)

bitfield32-mask (u32)

pad (pad)

mask (u64)

byte-order (u32)

doc:

Byte order of the attribute, absent means host byte order.

enum:

policy-byte-order

op-policy-attrs

do (u32)

dump (u32)