.. LINENO 2

.. SPDX-License-Identifier: GPL-2.0
.. NOTE: This document was auto-generated.


.. _netlink-nlctrl:


=======================================
Family ``nlctrl`` netlink specification
=======================================


.. contents:: :depth: 3


-------
Summary
-------


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


----------
Operations
----------


.. LINENO 171

.. _nlctrl-operation-getfamily:

getfamily
=========
Get / dump genetlink families

:attribute-set: :ref:`nlctrl-attribute-set-ctrl-attrs`
:do:
.. LINENO 175

    **request**
        :attributes: [``family-name``]

    **reply**
        :attributes: [``family-id``, ``family-name``, ``hdrsize``, ``maxattr``, ``mcast-groups``, ``ops``, ``version``]

:dump:
.. LINENO 190

    **reply**
        :attributes: [``family-id``, ``family-name``, ``hdrsize``, ``maxattr``, ``mcast-groups``, ``ops``, ``version``]



.. LINENO 192

.. _nlctrl-operation-getpolicy:

getpolicy
=========
Get / dump genetlink policies

:attribute-set: :ref:`nlctrl-attribute-set-ctrl-attrs`
:dump:
.. LINENO 196

    **request**
        :attributes: [``family-name``, ``family-id``, ``op``]

    **reply**
        :attributes: [``family-id``, ``op-policy``, ``policy``]




-----------
Definitions
-----------


.. LINENO 12

.. _nlctrl-definition-op-flags:

op-flags
========
:type: flags
:enum-name: None


:entries:
    - ``admin-perm``
    - ``cmd-cap-do``
    - ``cmd-cap-dump``
    - ``cmd-cap-haspol``
    - ``uns-admin-perm``


.. LINENO 22

.. _nlctrl-definition-attr-type:

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``



--------------
Attribute sets
--------------


.. _nlctrl-attribute-set-ctrl-attrs:

ctrl-attrs
==========
.. LINENO 51

family-id (``u16``)
~~~~~~~~~~~~~~~~~~~


.. LINENO 54

family-name (``string``)
~~~~~~~~~~~~~~~~~~~~~~~~


.. LINENO 57

version (``u32``)
~~~~~~~~~~~~~~~~~


.. LINENO 60

hdrsize (``u32``)
~~~~~~~~~~~~~~~~~


.. LINENO 63

maxattr (``u32``)
~~~~~~~~~~~~~~~~~


.. LINENO 66

ops (``indexed-array``)
~~~~~~~~~~~~~~~~~~~~~~~
:sub-type: nest
:nested-attributes: :ref:`nlctrl-attribute-set-op-attrs`


.. LINENO 71

mcast-groups (``indexed-array``)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:sub-type: nest
:nested-attributes: :ref:`nlctrl-attribute-set-mcast-group-attrs`


.. LINENO 76

policy (``nest-type-value``)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:type-value: ['policy-id', 'attr-id']
:nested-attributes: :ref:`nlctrl-attribute-set-policy-attrs`


.. LINENO 81

op-policy (``nest-type-value``)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:type-value: ['op-id']
:nested-attributes: :ref:`nlctrl-attribute-set-op-policy-attrs`


.. LINENO 86

op (``u32``)
~~~~~~~~~~~~


.. _nlctrl-attribute-set-mcast-group-attrs:

mcast-group-attrs
=================
.. LINENO 94

name (``string``)
~~~~~~~~~~~~~~~~~


.. LINENO 97

id (``u32``)
~~~~~~~~~~~~


.. _nlctrl-attribute-set-op-attrs:

op-attrs
========
.. LINENO 105

id (``u32``)
~~~~~~~~~~~~


.. LINENO 108

flags (``u32``)
~~~~~~~~~~~~~~~
:enum: :ref:`nlctrl-definition-op-flags`
:enum-as-flags: True


.. _nlctrl-attribute-set-policy-attrs:

policy-attrs
============
.. LINENO 118

type (``u32``)
~~~~~~~~~~~~~~
:enum: :ref:`nlctrl-definition-attr-type`


.. LINENO 122

min-value-s (``s64``)
~~~~~~~~~~~~~~~~~~~~~


.. LINENO 125

max-value-s (``s64``)
~~~~~~~~~~~~~~~~~~~~~


.. LINENO 128

min-value-u (``u64``)
~~~~~~~~~~~~~~~~~~~~~


.. LINENO 131

max-value-u (``u64``)
~~~~~~~~~~~~~~~~~~~~~


.. LINENO 134

min-length (``u32``)
~~~~~~~~~~~~~~~~~~~~


.. LINENO 137

max-length (``u32``)
~~~~~~~~~~~~~~~~~~~~


.. LINENO 140

policy-idx (``u32``)
~~~~~~~~~~~~~~~~~~~~


.. LINENO 143

policy-maxtype (``u32``)
~~~~~~~~~~~~~~~~~~~~~~~~


.. LINENO 146

bitfield32-mask (``u32``)
~~~~~~~~~~~~~~~~~~~~~~~~~


.. LINENO 149

mask (``u64``)
~~~~~~~~~~~~~~


.. LINENO 152

pad (``pad``)
~~~~~~~~~~~~~


.. _nlctrl-attribute-set-op-policy-attrs:

op-policy-attrs
===============
.. LINENO 160

do (``u32``)
~~~~~~~~~~~~


.. LINENO 163

dump (``u32``)
~~~~~~~~~~~~~~