nl-linux 0.2.4 → 0.4.1

data/generated/nl/linux/net_shaper.rb

@@ -1,7 +1,8 @@
 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
+#
+# This file is based on Documentation/netlink/specs/net_shaper.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
-# rbs_inline: enabled
 # This code is generated by Ynl::Generator. DO NOT EDIT.
 require 'nl'
 module Nl; module Linux
@@ -33,374 +34,750 @@ module Nl; module Linux
 # support for complex scheduling hierarchy, or for some shaping
 # parameters. The user can introspect the HW capabilities via the
 # `cap-get` operation.
-class NetShaper < ::Nl::Family
+class NetShaper < ::Nl::Genl::Family
   NAME = "net-shaper"
-  PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("net-shaper"))
+  VERSION = 1
+  # @rbs (?resolver: ^(::Nl::Genl::Client, ::String) -> ::Nl::Genl::FamilyInfo, ?executor: executor?, ?notification_capacity: ::Integer?) -> (::Nl::Family::Session & instance)
+  # @rbs | [R] (?resolver: ^(::Nl::Genl::Client, ::String) -> ::Nl::Genl::FamilyInfo, ?executor: executor?, ?notification_capacity: ::Integer?) { (instance) -> R } -> R
+  # @overload open(resolver: ::Nl::Linux::DEFAULT_RESOLVER, executor: nil, notification_capacity: DEFAULT_NOTIFICATION_CAPACITY)
+  #   @param [#call] resolver
+  #   @param [Symbol, nil] executor
+  #   @param [Integer, nil] notification_capacity
+  #   @return [NetShaper]
+  # @overload open(resolver: ::Nl::Linux::DEFAULT_RESOLVER, executor: nil, notification_capacity: DEFAULT_NOTIFICATION_CAPACITY, &block)
+  #   @param [#call] resolver
+  #   @param [Symbol, nil] executor
+  #   @param [Integer, nil] notification_capacity
+  #   @yieldparam [NetShaper] family
+  #   @return [Object] the result of the block
+  def self.open(resolver: ::Nl::Linux::DEFAULT_RESOLVER, executor: nil, notification_capacity: DEFAULT_NOTIFICATION_CAPACITY)
+    super
+  end
+  # @private
+  MCAST_GROUPS = Ractor.make_shareable({}) #: Hash[::Symbol, ::Nl::McastGroup]
+  module Constants
+    MAX_HANDLE_ID = 67108862
+  end
+  module Enums
+    # Defines the shaper `id` interpretation.
+    module Scope
+      # The scope is not specified.
+      Unspec = 0
+      # The main shaper for the given network device.
+      Netdev = 1
+      # The shaper is attached to the given device queue,
+      # the `id` represents the queue number.
+      Queue = 2
+      # The shaper allows grouping of queues or other
+      # node shapers; can be nested in either `netdev`
+      # shapers or other `node` shapers, allowing placement
+      # in any location of the scheduling tree, except
+      # leaves and root.
+      Node = 3
+    end
+    # Different metric supported by the shaper.
+    module Metric
+      # Shaper operates on a bits per second basis.
+      Bps = 0
+      # Shaper operates on a packets per second basis.
+      Pps = 1
+    end
+  end
   module Structs
   end
   module AttributeSets
-    class NetShaper < ::Nl::Protocols::Genl::AttributeSet
+    class NetShaper < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # Unique identifier for the given shaper inside the owning device.
       class Handle < Attribute
         TYPE = 1
         NAME = :"handle"
+        # @private
+        ORDER = 0
       end
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
       class Metric < Attribute
         TYPE = 2
         NAME = :"metric"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Guaranteed bandwidth for the given shaper.
       class BwMin < Attribute
         TYPE = 3
         NAME = :"bw_min"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
       class BwMax < Attribute
         TYPE = 4
         NAME = :"bw_max"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 3
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
       class Burst < Attribute
         TYPE = 5
         NAME = :"burst"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       class Priority < Attribute
         TYPE = 6
         NAME = :"priority"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       class Weight < Attribute
         TYPE = 7
         NAME = :"weight"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 6
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Interface index owning the specified shaper.
       class Ifindex < Attribute
         TYPE = 8
         NAME = :"ifindex"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 7
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Identifier for the parent of the affected shaper.
+      # Only needed for `group` operation.
       class Parent < Attribute
         TYPE = 9
         NAME = :"parent"
+        # @private
+        ORDER = 8
       end
+      # Describes a set of leaves shapers for a `group` operation.
       class Leaves < Attribute
         TYPE = 10
         NAME = :"leaves"
+        # @private
+        MULTI = true
+        # @private
+        ORDER = 9
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"handle" => Handle, :"metric" => Metric, :"bw_min" => BwMin, :"bw_max" => BwMax, :"burst" => Burst, :"priority" => Priority, :"weight" => Weight, :"ifindex" => Ifindex, :"parent" => Parent, :"leaves" => Leaves}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Handle, 2 => Metric, 3 => BwMin, 4 => BwMax, 5 => Burst, 6 => Priority, 7 => Weight, 8 => Ifindex, 9 => Parent, 10 => Leaves}) #: Hash[::Integer, Attribute]
+      # Unique identifier for the given shaper inside the owning device.
+      # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see Handle
+      def handle; self[:"handle"]&.value; end
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Metric
+      def metric; self[:"metric"]&.value; end
+      # Guaranteed bandwidth for the given shaper.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see BwMin
+      def bw_min; self[:"bw_min"]&.value; end
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see BwMax
+      def bw_max; self[:"bw_max"]&.value; end
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Burst
+      def burst; self[:"burst"]&.value; end
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Priority
+      def priority; self[:"priority"]&.value; end
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Weight
+      def weight; self[:"weight"]&.value; end
+      # Interface index owning the specified shaper.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # Identifier for the parent of the affected shaper.
+      # Only needed for `group` operation.
+      # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see Parent
+      def parent; self[:"parent"]&.value; end
+      # Describes a set of leaves shapers for a `group` operation.
+      # @rbs return: ::Array[AttributeSets::LeafInfo]
+      # @return [Array<AttributeSets::LeafInfo>]
+      # @see Leaves
+      def leaves; self[:"leaves"].map(&:value); end
       class << self
         # Looks up Attribute class by name.
-        #--
         # @rbs name: Symbol
         # @rbs return: Attribute
+        # @param [Symbol] name
+        # @return [Attribute]
         def by_name(name); BY_NAME.fetch(name); end
         # Looks up Attribute class by type value.
-        #--
         # @rbs type: Integer
         # @rbs return: Attribute
+        # @param [Integer] type
+        # @return [Attribute]
         def by_type(type); BY_TYPE.fetch(type); end
       end
     end
-    class Handle < ::Nl::Protocols::Genl::AttributeSet
+    class Handle < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # Defines the shaper `id` interpretation.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
       class Scope < Attribute
         TYPE = 1
         NAME = :"scope"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Numeric identifier of a shaper. The id semantic depends on
+      # the scope. For `queue` scope it's the queue id and for `node`
+      # scope it's the node identifier.
       class Id < Attribute
         TYPE = 2
         NAME = :"id"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 67108862" unless it <= 67108862 })
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum #{Constants::MAX_HANDLE_ID}" unless it <= Constants::MAX_HANDLE_ID })
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"scope" => Scope, :"id" => Id}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Scope, 2 => Id}) #: Hash[::Integer, Attribute]
+      # Defines the shaper `id` interpretation.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Scope
+      def scope; self[:"scope"]&.value; end
+      # Numeric identifier of a shaper. The id semantic depends on
+      # the scope. For `queue` scope it's the queue id and for `node`
+      # scope it's the node identifier.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Id
+      def id; self[:"id"]&.value; end
       class << self
         # Looks up Attribute class by name.
-        #--
         # @rbs name: Symbol
         # @rbs return: Attribute
+        # @param [Symbol] name
+        # @return [Attribute]
         def by_name(name); BY_NAME.fetch(name); end
         # Looks up Attribute class by type value.
-        #--
         # @rbs type: Integer
         # @rbs return: Attribute
+        # @param [Integer] type
+        # @return [Attribute]
         def by_type(type); BY_TYPE.fetch(type); end
       end
     end
-    class LeafInfo < ::Nl::Protocols::Genl::AttributeSet
+    class LeafInfo < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # Unique identifier for the given shaper inside the owning device.
       class Handle < Attribute
         TYPE = 1
         NAME = :"handle"
+        # @private
+        ORDER = 0
       end
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       class Priority < Attribute
         TYPE = 6
         NAME = :"priority"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       class Weight < Attribute
         TYPE = 7
         NAME = :"weight"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"handle" => Handle, :"priority" => Priority, :"weight" => Weight}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Handle, 6 => Priority, 7 => Weight}) #: Hash[::Integer, Attribute]
+      # Unique identifier for the given shaper inside the owning device.
+      # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see Handle
+      def handle; self[:"handle"]&.value; end
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Priority
+      def priority; self[:"priority"]&.value; end
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Weight
+      def weight; self[:"weight"]&.value; end
       class << self
         # Looks up Attribute class by name.
-        #--
         # @rbs name: Symbol
         # @rbs return: Attribute
+        # @param [Symbol] name
+        # @return [Attribute]
         def by_name(name); BY_NAME.fetch(name); end
         # Looks up Attribute class by type value.
-        #--
         # @rbs type: Integer
         # @rbs return: Attribute
+        # @param [Integer] type
+        # @return [Attribute]
         def by_type(type); BY_TYPE.fetch(type); end
       end
     end
-    class Caps < ::Nl::Protocols::Genl::AttributeSet
+    class Caps < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # Interface index queried for shapers capabilities.
       class Ifindex < Attribute
         TYPE = 1
         NAME = :"ifindex"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # The scope to which the queried capabilities apply.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
       class Scope < Attribute
         TYPE = 2
         NAME = :"scope"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # The device accepts 'bps' metric for bw-min, bw-max and burst.
       class SupportMetricBps < Attribute
         TYPE = 3
         NAME = :"support_metric_bps"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device accepts 'pps' metric for bw-min, bw-max and burst.
       class SupportMetricPps < Attribute
         TYPE = 4
         NAME = :"support_metric_pps"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 3
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports nesting shaper belonging to this scope
+      # below 'node' scoped shapers. Only 'queue' and 'node'
+      # scope can have flag 'support-nesting'.
       class SupportNesting < Attribute
         TYPE = 5
         NAME = :"support_nesting"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports a minimum guaranteed B/W.
       class SupportBwMin < Attribute
         TYPE = 6
         NAME = :"support_bw_min"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports maximum B/W shaping.
       class SupportBwMax < Attribute
         TYPE = 7
         NAME = :"support_bw_max"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 6
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports a maximum burst size.
       class SupportBurst < Attribute
         TYPE = 8
         NAME = :"support_burst"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 7
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports priority scheduling.
       class SupportPriority < Attribute
         TYPE = 9
         NAME = :"support_priority"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 8
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # The device supports weighted round robin scheduling.
       class SupportWeight < Attribute
         TYPE = 10
         NAME = :"support_weight"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 9
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"ifindex" => Ifindex, :"scope" => Scope, :"support_metric_bps" => SupportMetricBps, :"support_metric_pps" => SupportMetricPps, :"support_nesting" => SupportNesting, :"support_bw_min" => SupportBwMin, :"support_bw_max" => SupportBwMax, :"support_burst" => SupportBurst, :"support_priority" => SupportPriority, :"support_weight" => SupportWeight}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Ifindex, 2 => Scope, 3 => SupportMetricBps, 4 => SupportMetricPps, 5 => SupportNesting, 6 => SupportBwMin, 7 => SupportBwMax, 8 => SupportBurst, 9 => SupportPriority, 10 => SupportWeight}) #: Hash[::Integer, Attribute]
+      # Interface index queried for shapers capabilities.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # The scope to which the queried capabilities apply.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Scope
+      def scope; self[:"scope"]&.value; end
+      # The device accepts 'bps' metric for bw-min, bw-max and burst.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportMetricBps
+      def support_metric_bps; self[:"support_metric_bps"]&.value; end
+      # The device accepts 'pps' metric for bw-min, bw-max and burst.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportMetricPps
+      def support_metric_pps; self[:"support_metric_pps"]&.value; end
+      # The device supports nesting shaper belonging to this scope
+      # below 'node' scoped shapers. Only 'queue' and 'node'
+      # scope can have flag 'support-nesting'.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportNesting
+      def support_nesting; self[:"support_nesting"]&.value; end
+      # The device supports a minimum guaranteed B/W.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportBwMin
+      def support_bw_min; self[:"support_bw_min"]&.value; end
+      # The device supports maximum B/W shaping.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportBwMax
+      def support_bw_max; self[:"support_bw_max"]&.value; end
+      # The device supports a maximum burst size.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportBurst
+      def support_burst; self[:"support_burst"]&.value; end
+      # The device supports priority scheduling.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportPriority
+      def support_priority; self[:"support_priority"]&.value; end
+      # The device supports weighted round robin scheduling.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SupportWeight
+      def support_weight; self[:"support_weight"]&.value; end
       class << self
         # Looks up Attribute class by name.
-        #--
         # @rbs name: Symbol
         # @rbs return: Attribute
+        # @param [Symbol] name
+        # @return [Attribute]
         def by_name(name); BY_NAME.fetch(name); end
         # Looks up Attribute class by type value.
-        #--
         # @rbs type: Integer
         # @rbs return: Attribute
+        # @param [Integer] type
+        # @return [Attribute]
         def by_type(type); BY_TYPE.fetch(type); end
       end
     end
-    NetShaper::Handle::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Handle)
-    NetShaper::Parent::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Handle)
-    NetShaper::Leaves::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(LeafInfo)
-    LeafInfo::Handle::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Handle)
+    # @private
+    NetShaper::Handle::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Handle, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    NetShaper::Parent::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Handle, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    NetShaper::Leaves::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::LeafInfo, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    LeafInfo::Handle::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Handle, selector_bindings: Ractor.make_shareable([]))
   end
   module Messages
     # Get information about a shaper for a given device.
-    class DoGetRequest < ::Nl::Protocols::Genl::Message
+    class DoGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle ifindex])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Get information about a shaper for a given device.
-    class DoGetReply < ::Nl::Protocols::Genl::Message
+    class DoGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle metric bw_min bw_max burst priority weight ifindex parent])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `metric` attribute in the message.
-      #--
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Metric
       def metric; attributes[:"metric"]&.value; end
-      # Gets the value of `bw-min` attribute in the message.
-      #--
+      # Guaranteed bandwidth for the given shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMin
       def bw_min; attributes[:"bw_min"]&.value; end
-      # Gets the value of `bw-max` attribute in the message.
-      #--
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMax
       def bw_max; attributes[:"bw_max"]&.value; end
-      # Gets the value of `burst` attribute in the message.
-      #--
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Burst
       def burst; attributes[:"burst"]&.value; end
-      # Gets the value of `priority` attribute in the message.
-      #--
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Priority
       def priority; attributes[:"priority"]&.value; end
-      # Gets the value of `weight` attribute in the message.
-      #--
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Weight
       def weight; attributes[:"weight"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `parent` attribute in the message.
-      #--
+      # Identifier for the parent of the affected shaper.
+      # Only needed for `group` operation.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Parent
       def parent; attributes[:"parent"]&.value; end
     end
     # Get information about a shaper for a given device.
-    class DumpGetRequest < ::Nl::Protocols::Genl::Message
+    class DumpGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[ifindex])
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Get information about a shaper for a given device.
-    class DumpGetReply < ::Nl::Protocols::Genl::Message
+    class DumpGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle metric bw_min bw_max burst priority weight ifindex parent])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `metric` attribute in the message.
-      #--
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Metric
       def metric; attributes[:"metric"]&.value; end
-      # Gets the value of `bw-min` attribute in the message.
-      #--
+      # Guaranteed bandwidth for the given shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMin
       def bw_min; attributes[:"bw_min"]&.value; end
-      # Gets the value of `bw-max` attribute in the message.
-      #--
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMax
       def bw_max; attributes[:"bw_max"]&.value; end
-      # Gets the value of `burst` attribute in the message.
-      #--
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Burst
       def burst; attributes[:"burst"]&.value; end
-      # Gets the value of `priority` attribute in the message.
-      #--
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Priority
       def priority; attributes[:"priority"]&.value; end
-      # Gets the value of `weight` attribute in the message.
-      #--
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Weight
       def weight; attributes[:"weight"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `parent` attribute in the message.
-      #--
+      # Identifier for the parent of the affected shaper.
+      # Only needed for `group` operation.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Parent
       def parent; attributes[:"parent"]&.value; end
     end
     # Create or update the specified shaper.
     # The set operation can't be used to create a `node` scope shaper,
     # use the `group` operation instead.
-    class DoSetRequest < ::Nl::Protocols::Genl::Message
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    class DoSetRequest < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle metric bw_min bw_max burst priority weight ifindex])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `metric` attribute in the message.
-      #--
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Metric
       def metric; attributes[:"metric"]&.value; end
-      # Gets the value of `bw-min` attribute in the message.
-      #--
+      # Guaranteed bandwidth for the given shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMin
       def bw_min; attributes[:"bw_min"]&.value; end
-      # Gets the value of `bw-max` attribute in the message.
-      #--
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMax
       def bw_max; attributes[:"bw_max"]&.value; end
-      # Gets the value of `burst` attribute in the message.
-      #--
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Burst
       def burst; attributes[:"burst"]&.value; end
-      # Gets the value of `priority` attribute in the message.
-      #--
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Priority
       def priority; attributes[:"priority"]&.value; end
-      # Gets the value of `weight` attribute in the message.
-      #--
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Weight
       def weight; attributes[:"weight"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Clear (remove) the specified shaper. When deleting
@@ -414,18 +791,23 @@ class NetShaper < ::Nl::Family
     # queue/device can still send traffic: it has an implicit
     # node with infinite bandwidth. The queue's implicit node
     # feeds an implicit RR node at the root of the hierarchy.
-    class DoDeleteRequest < ::Nl::Protocols::Genl::Message
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    class DoDeleteRequest < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle ifindex])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Create or update a scheduling group, attaching the specified
@@ -447,51 +829,72 @@ class NetShaper < ::Nl::Family
     # the device shaping configuration, otherwise the `node` shaper
     # full identifier, comprising `binding` and `handle`, is provided
     # as the reply.
-    class DoGroupRequest < ::Nl::Protocols::Genl::Message
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    class DoGroupRequest < ::Nl::Genl::Message
       TYPE = 4
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle metric bw_min bw_max burst priority weight ifindex parent leaves])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `metric` attribute in the message.
-      #--
+      # Metric used by the given shaper for bw-min, bw-max and burst.
+      # 
+      # Known enum values are defined in {Enums::Metric}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Metric
       def metric; attributes[:"metric"]&.value; end
-      # Gets the value of `bw-min` attribute in the message.
-      #--
+      # Guaranteed bandwidth for the given shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMin
       def bw_min; attributes[:"bw_min"]&.value; end
-      # Gets the value of `bw-max` attribute in the message.
-      #--
+      # Maximum bandwidth for the given shaper or 0 when unlimited.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::BwMax
       def bw_max; attributes[:"bw_max"]&.value; end
-      # Gets the value of `burst` attribute in the message.
-      #--
+      # Maximum burst-size for shaping. Should not be interpreted
+      # as a quantum.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Burst
       def burst; attributes[:"burst"]&.value; end
-      # Gets the value of `priority` attribute in the message.
-      #--
+      # Scheduling priority for the given shaper. The priority
+      # scheduling is applied to sibling shapers.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Priority
       def priority; attributes[:"priority"]&.value; end
-      # Gets the value of `weight` attribute in the message.
-      #--
+      # Relative weight for round robin scheduling of the
+      # given shaper.
+      # The scheduling is applied to all sibling shapers
+      # with the same priority.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Weight
       def weight; attributes[:"weight"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `parent` attribute in the message.
-      #--
+      # Identifier for the parent of the affected shaper.
+      # Only needed for `group` operation.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Parent
       def parent; attributes[:"parent"]&.value; end
-      # Gets the value of `leaves` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::LeafInfo
-      def leaves; attributes[:"leaves"]&.value; end
+      # Describes a set of leaves shapers for a `group` operation.
+      # @rbs return: ::Array[AttributeSets::LeafInfo]
+      # @return [Array<AttributeSets::LeafInfo>]
+      # @see AttributeSets::NetShaper::Leaves
+      def leaves; attributes[:"leaves"].map(&:value); end
     end
     # Create or update a scheduling group, attaching the specified
     # `leaves` shapers under the specified node identified by `handle.`
@@ -512,163 +915,240 @@ class NetShaper < ::Nl::Family
     # the device shaping configuration, otherwise the `node` shaper
     # full identifier, comprising `binding` and `handle`, is provided
     # as the reply.
-    class DoGroupReply < ::Nl::Protocols::Genl::Message
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    class DoGroupReply < ::Nl::Genl::Message
       TYPE = 4
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::NetShaper
       ATTRIBUTES = Ractor.make_shareable(%i[handle ifindex])
-      # Gets the value of `handle` attribute in the message.
-      #--
+      # Unique identifier for the given shaper inside the owning device.
       # @rbs return: AttributeSets::Handle
+      # @return [AttributeSets::Handle]
+      # @see AttributeSets::NetShaper::Handle
       def handle; attributes[:"handle"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index owning the specified shaper.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::NetShaper::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Get the shaper capabilities supported by the given device
     # for the specified scope.
-    class DoCapGetRequest < ::Nl::Protocols::Genl::Message
+    class DoCapGetRequest < ::Nl::Genl::Message
       TYPE = 5
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Caps
       ATTRIBUTES = Ractor.make_shareable(%i[ifindex scope])
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index queried for shapers capabilities.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `scope` attribute in the message.
-      #--
+      # The scope to which the queried capabilities apply.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Scope
       def scope; attributes[:"scope"]&.value; end
     end
     # Get the shaper capabilities supported by the given device
     # for the specified scope.
-    class DoCapGetReply < ::Nl::Protocols::Genl::Message
+    class DoCapGetReply < ::Nl::Genl::Message
       TYPE = 5
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Caps
       ATTRIBUTES = Ractor.make_shareable(%i[ifindex scope support_metric_bps support_metric_pps support_nesting support_bw_min support_bw_max support_burst support_priority support_weight])
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index queried for shapers capabilities.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `scope` attribute in the message.
-      #--
+      # The scope to which the queried capabilities apply.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Scope
       def scope; attributes[:"scope"]&.value; end
-      # Gets the value of `support-metric-bps` attribute in the message.
-      #--
+      # The device accepts 'bps' metric for bw-min, bw-max and burst.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportMetricBps
       def support_metric_bps; attributes[:"support_metric_bps"]&.value; end
-      # Gets the value of `support-metric-pps` attribute in the message.
-      #--
+      # The device accepts 'pps' metric for bw-min, bw-max and burst.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportMetricPps
       def support_metric_pps; attributes[:"support_metric_pps"]&.value; end
-      # Gets the value of `support-nesting` attribute in the message.
-      #--
+      # The device supports nesting shaper belonging to this scope
+      # below 'node' scoped shapers. Only 'queue' and 'node'
+      # scope can have flag 'support-nesting'.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportNesting
       def support_nesting; attributes[:"support_nesting"]&.value; end
-      # Gets the value of `support-bw-min` attribute in the message.
-      #--
+      # The device supports a minimum guaranteed B/W.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBwMin
       def support_bw_min; attributes[:"support_bw_min"]&.value; end
-      # Gets the value of `support-bw-max` attribute in the message.
-      #--
+      # The device supports maximum B/W shaping.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBwMax
       def support_bw_max; attributes[:"support_bw_max"]&.value; end
-      # Gets the value of `support-burst` attribute in the message.
-      #--
+      # The device supports a maximum burst size.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBurst
       def support_burst; attributes[:"support_burst"]&.value; end
-      # Gets the value of `support-priority` attribute in the message.
-      #--
+      # The device supports priority scheduling.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportPriority
       def support_priority; attributes[:"support_priority"]&.value; end
-      # Gets the value of `support-weight` attribute in the message.
-      #--
+      # The device supports weighted round robin scheduling.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportWeight
       def support_weight; attributes[:"support_weight"]&.value; end
     end
     # Get the shaper capabilities supported by the given device
     # for the specified scope.
-    class DumpCapGetRequest < ::Nl::Protocols::Genl::Message
+    class DumpCapGetRequest < ::Nl::Genl::Message
       TYPE = 5
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Caps
       ATTRIBUTES = Ractor.make_shareable(%i[ifindex])
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index queried for shapers capabilities.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Get the shaper capabilities supported by the given device
     # for the specified scope.
-    class DumpCapGetReply < ::Nl::Protocols::Genl::Message
+    class DumpCapGetReply < ::Nl::Genl::Message
       TYPE = 5
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Caps
       ATTRIBUTES = Ractor.make_shareable(%i[ifindex scope support_metric_bps support_metric_pps support_nesting support_bw_min support_bw_max support_burst support_priority support_weight])
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # Interface index queried for shapers capabilities.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `scope` attribute in the message.
-      #--
+      # The scope to which the queried capabilities apply.
+      # 
+      # Known enum values are defined in {Enums::Scope}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::Scope
       def scope; attributes[:"scope"]&.value; end
-      # Gets the value of `support-metric-bps` attribute in the message.
-      #--
+      # The device accepts 'bps' metric for bw-min, bw-max and burst.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportMetricBps
       def support_metric_bps; attributes[:"support_metric_bps"]&.value; end
-      # Gets the value of `support-metric-pps` attribute in the message.
-      #--
+      # The device accepts 'pps' metric for bw-min, bw-max and burst.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportMetricPps
       def support_metric_pps; attributes[:"support_metric_pps"]&.value; end
-      # Gets the value of `support-nesting` attribute in the message.
-      #--
+      # The device supports nesting shaper belonging to this scope
+      # below 'node' scoped shapers. Only 'queue' and 'node'
+      # scope can have flag 'support-nesting'.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportNesting
       def support_nesting; attributes[:"support_nesting"]&.value; end
-      # Gets the value of `support-bw-min` attribute in the message.
-      #--
+      # The device supports a minimum guaranteed B/W.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBwMin
       def support_bw_min; attributes[:"support_bw_min"]&.value; end
-      # Gets the value of `support-bw-max` attribute in the message.
-      #--
+      # The device supports maximum B/W shaping.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBwMax
       def support_bw_max; attributes[:"support_bw_max"]&.value; end
-      # Gets the value of `support-burst` attribute in the message.
-      #--
+      # The device supports a maximum burst size.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportBurst
       def support_burst; attributes[:"support_burst"]&.value; end
-      # Gets the value of `support-priority` attribute in the message.
-      #--
+      # The device supports priority scheduling.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportPriority
       def support_priority; attributes[:"support_priority"]&.value; end
-      # Gets the value of `support-weight` attribute in the message.
-      #--
+      # The device supports weighted round robin scheduling.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Caps::SupportWeight
       def support_weight; attributes[:"support_weight"]&.value; end
     end
   end
+  module Notifications
+  end
+  # @private
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Get information about a shaper for a given device.
-  #--
-  # @rbs (?handle: AttributeSets::Handle, ?ifindex: ::Integer) -> Messages::DoGetReply
+  # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?ifindex: ::Integer) -> Messages::DoGetReply
+  # @param [Hash] args
+  # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+  # @option args [Integer] ifindex Interface index owning the specified shaper.
+  # @return [Messages::DoGetReply]
+  # @see Messages::DoGetRequest
   def do_get(**args)
     exchange_message(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
   end
   # Get information about a shaper for a given device.
-  #--
-  # @rbs (?ifindex: ::Integer) -> Enumerable[Messages::DumpGetReply]
+  # @rbs (?ifindex: ::Integer) -> Array[Messages::DumpGetReply]
   #   | (?ifindex: ::Integer) { (Messages::DumpGetReply) -> void } -> void
+  # @overload dump_get(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] ifindex Interface index owning the specified shaper.
+  #   @return [Array<Messages::DumpGetReply>]
+  # @overload dump_get(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] ifindex Interface index owning the specified shaper.
+  #   @yieldparam [Messages::DumpGetReply] reply
+  #   @return [void]
+  # @see Messages::DumpGetRequest
   def dump_get(**args, &block)
     exchange_message(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args, &block)
   end
   # Create or update the specified shaper.
   # The set operation can't be used to create a `node` scope shaper,
   # use the `group` operation instead.
-  #--
-  # @rbs (?handle: AttributeSets::Handle, ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer) -> void
+  # 
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
+  # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer) -> void
+  # @param [Hash] args
+  # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+  # @option args [Integer] metric Metric used by the given shaper for bw-min, bw-max and burst.
+  #   
+  #   Known enum values are defined in {Enums::Metric}.
+  # @option args [Integer] bw_min Guaranteed bandwidth for the given shaper.
+  # @option args [Integer] bw_max Maximum bandwidth for the given shaper or 0 when unlimited.
+  # @option args [Integer] burst Maximum burst-size for shaping. Should not be interpreted
+  #   as a quantum.
+  # @option args [Integer] priority Scheduling priority for the given shaper. The priority
+  #   scheduling is applied to sibling shapers.
+  # @option args [Integer] weight Relative weight for round robin scheduling of the
+  #   given shaper.
+  #   The scheduling is applied to all sibling shapers
+  #   with the same priority.
+  # @option args [Integer] ifindex Interface index owning the specified shaper.
+  # @return [void]
+  # @see Messages::DoSetRequest
   def do_set(**args)
     exchange_message(:"do", Messages::DoSetRequest, nil, args)
   end
@@ -683,8 +1163,15 @@ class NetShaper < ::Nl::Family
   # queue/device can still send traffic: it has an implicit
   # node with infinite bandwidth. The queue's implicit node
   # feeds an implicit RR node at the root of the hierarchy.
-  #--
-  # @rbs (?handle: AttributeSets::Handle, ?ifindex: ::Integer) -> void
+  # 
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
+  # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?ifindex: ::Integer) -> void
+  # @param [Hash] args
+  # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+  # @option args [Integer] ifindex Interface index owning the specified shaper.
+  # @return [void]
+  # @see Messages::DoDeleteRequest
   def do_delete(**args)
     exchange_message(:"do", Messages::DoDeleteRequest, nil, args)
   end
@@ -707,25 +1194,219 @@ class NetShaper < ::Nl::Family
   # the device shaping configuration, otherwise the `node` shaper
   # full identifier, comprising `binding` and `handle`, is provided
   # as the reply.
-  #--
-  # @rbs (?handle: AttributeSets::Handle, ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer, ?parent: AttributeSets::Handle, ?leaves: AttributeSets::LeafInfo) -> Messages::DoGroupReply
+  # 
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
+  # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer, ?parent: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?leaves: ::Array[(AttributeSets::LeafInfo | ::Hash[::Symbol, untyped])]) -> Messages::DoGroupReply
+  # @param [Hash] args
+  # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+  # @option args [Integer] metric Metric used by the given shaper for bw-min, bw-max and burst.
+  #   
+  #   Known enum values are defined in {Enums::Metric}.
+  # @option args [Integer] bw_min Guaranteed bandwidth for the given shaper.
+  # @option args [Integer] bw_max Maximum bandwidth for the given shaper or 0 when unlimited.
+  # @option args [Integer] burst Maximum burst-size for shaping. Should not be interpreted
+  #   as a quantum.
+  # @option args [Integer] priority Scheduling priority for the given shaper. The priority
+  #   scheduling is applied to sibling shapers.
+  # @option args [Integer] weight Relative weight for round robin scheduling of the
+  #   given shaper.
+  #   The scheduling is applied to all sibling shapers
+  #   with the same priority.
+  # @option args [Integer] ifindex Interface index owning the specified shaper.
+  # @option args [AttributeSets::Handle, Hash<Symbol, Object>] parent Identifier for the parent of the affected shaper.
+  #   Only needed for `group` operation.
+  # @option args [Array<AttributeSets::LeafInfo, Hash<Symbol, Object>>] leaves Describes a set of leaves shapers for a `group` operation.
+  # @return [Messages::DoGroupReply]
+  # @see Messages::DoGroupRequest
   def do_group(**args)
     exchange_message(:"do", Messages::DoGroupRequest, Messages::DoGroupReply, args)
   end
   # Get the shaper capabilities supported by the given device
   # for the specified scope.
-  #--
   # @rbs (?ifindex: ::Integer, ?scope: ::Integer) -> Messages::DoCapGetReply
+  # @param [Hash] args
+  # @option args [Integer] ifindex Interface index queried for shapers capabilities.
+  # @option args [Integer] scope The scope to which the queried capabilities apply.
+  #   
+  #   Known enum values are defined in {Enums::Scope}.
+  # @return [Messages::DoCapGetReply]
+  # @see Messages::DoCapGetRequest
   def do_cap_get(**args)
     exchange_message(:"do", Messages::DoCapGetRequest, Messages::DoCapGetReply, args)
   end
   # Get the shaper capabilities supported by the given device
   # for the specified scope.
-  #--
-  # @rbs (?ifindex: ::Integer) -> Enumerable[Messages::DumpCapGetReply]
+  # @rbs (?ifindex: ::Integer) -> Array[Messages::DumpCapGetReply]
   #   | (?ifindex: ::Integer) { (Messages::DumpCapGetReply) -> void } -> void
+  # @overload dump_cap_get(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] ifindex Interface index queried for shapers capabilities.
+  #   @return [Array<Messages::DumpCapGetReply>]
+  # @overload dump_cap_get(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] ifindex Interface index queried for shapers capabilities.
+  #   @yieldparam [Messages::DumpCapGetReply] reply
+  #   @return [void]
+  # @see Messages::DumpCapGetRequest
   def dump_cap_get(**args, &block)
     exchange_message(:"dump", Messages::DumpCapGetRequest, Messages::DumpCapGetReply, args, &block)
   end
+  class AsyncOperations
+    # @private
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Get information about a shaper for a given device.
+    # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?ifindex: ::Integer) -> ::Nl::Async::Future[Messages::DoGetReply]
+    # @param [Hash] args
+    # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+    # @option args [Integer] ifindex Interface index owning the specified shaper.
+    # @return [Nl::Async::Future<Messages::DoGetReply>]
+    # @see Messages::DoGetRequest
+    def do_get(**args)
+      @exchange.call(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
+    end
+    # Get information about a shaper for a given device.
+    # @rbs (?ifindex: ::Integer) -> ::Nl::Async::Stream[Messages::DumpGetReply]
+    # @param [Hash] args
+    # @option args [Integer] ifindex Interface index owning the specified shaper.
+    # @return [Nl::Async::Stream<Messages::DumpGetReply>]
+    # @see Messages::DumpGetRequest
+    def dump_get(**args)
+      @exchange.call(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args)
+    end
+    # Create or update the specified shaper.
+    # The set operation can't be used to create a `node` scope shaper,
+    # use the `group` operation instead.
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer) -> ::Nl::Async::Future[void]
+    # @param [Hash] args
+    # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+    # @option args [Integer] metric Metric used by the given shaper for bw-min, bw-max and burst.
+    #   
+    #   Known enum values are defined in {Enums::Metric}.
+    # @option args [Integer] bw_min Guaranteed bandwidth for the given shaper.
+    # @option args [Integer] bw_max Maximum bandwidth for the given shaper or 0 when unlimited.
+    # @option args [Integer] burst Maximum burst-size for shaping. Should not be interpreted
+    #   as a quantum.
+    # @option args [Integer] priority Scheduling priority for the given shaper. The priority
+    #   scheduling is applied to sibling shapers.
+    # @option args [Integer] weight Relative weight for round robin scheduling of the
+    #   given shaper.
+    #   The scheduling is applied to all sibling shapers
+    #   with the same priority.
+    # @option args [Integer] ifindex Interface index owning the specified shaper.
+    # @return [Nl::Async::Future<void>]
+    # @see Messages::DoSetRequest
+    def do_set(**args)
+      @exchange.call(:"do", Messages::DoSetRequest, nil, args)
+    end
+    # Clear (remove) the specified shaper. When deleting
+    # a `node` shaper, reattach all the node's leaves to the
+    # deleted node's parent.
+    # If, after the removal, the parent shaper has no more
+    # leaves and the parent shaper scope is `node`, the parent
+    # node is deleted, recursively.
+    # When deleting a `queue` shaper or a `netdev` shaper,
+    # the shaper disappears from the hierarchy, but the
+    # queue/device can still send traffic: it has an implicit
+    # node with infinite bandwidth. The queue's implicit node
+    # feeds an implicit RR node at the root of the hierarchy.
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?ifindex: ::Integer) -> ::Nl::Async::Future[void]
+    # @param [Hash] args
+    # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+    # @option args [Integer] ifindex Interface index owning the specified shaper.
+    # @return [Nl::Async::Future<void>]
+    # @see Messages::DoDeleteRequest
+    def do_delete(**args)
+      @exchange.call(:"do", Messages::DoDeleteRequest, nil, args)
+    end
+    # Create or update a scheduling group, attaching the specified
+    # `leaves` shapers under the specified node identified by `handle.`
+    # The `leaves` shapers scope must be `queue` and the node shaper
+    # scope must be either `node` or `netdev.`
+    # When the node shaper has `node` scope, if the `handle` `id` is not
+    # specified, a new shaper of such scope is created, otherwise the
+    # specified node must already exist.
+    # When updating an existing node shaper, the specified `leaves` are
+    # added to the existing node; such node will also retain any preexisting
+    # leave.
+    # The `parent` handle for a new node shaper defaults to the parent
+    # of all the leaves, provided all the leaves share the same parent.
+    # Otherwise `parent` handle must be specified.
+    # The user can optionally provide shaping attributes for the node
+    # shaper.
+    # The operation is atomic, on failure no change is applied to
+    # the device shaping configuration, otherwise the `node` shaper
+    # full identifier, comprising `binding` and `handle`, is provided
+    # as the reply.
+    # 
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    # @rbs (?handle: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?metric: ::Integer, ?bw_min: ::Integer, ?bw_max: ::Integer, ?burst: ::Integer, ?priority: ::Integer, ?weight: ::Integer, ?ifindex: ::Integer, ?parent: (AttributeSets::Handle | ::Hash[::Symbol, untyped]), ?leaves: ::Array[(AttributeSets::LeafInfo | ::Hash[::Symbol, untyped])]) -> ::Nl::Async::Future[Messages::DoGroupReply]
+    # @param [Hash] args
+    # @option args [AttributeSets::Handle, Hash<Symbol, Object>] handle Unique identifier for the given shaper inside the owning device.
+    # @option args [Integer] metric Metric used by the given shaper for bw-min, bw-max and burst.
+    #   
+    #   Known enum values are defined in {Enums::Metric}.
+    # @option args [Integer] bw_min Guaranteed bandwidth for the given shaper.
+    # @option args [Integer] bw_max Maximum bandwidth for the given shaper or 0 when unlimited.
+    # @option args [Integer] burst Maximum burst-size for shaping. Should not be interpreted
+    #   as a quantum.
+    # @option args [Integer] priority Scheduling priority for the given shaper. The priority
+    #   scheduling is applied to sibling shapers.
+    # @option args [Integer] weight Relative weight for round robin scheduling of the
+    #   given shaper.
+    #   The scheduling is applied to all sibling shapers
+    #   with the same priority.
+    # @option args [Integer] ifindex Interface index owning the specified shaper.
+    # @option args [AttributeSets::Handle, Hash<Symbol, Object>] parent Identifier for the parent of the affected shaper.
+    #   Only needed for `group` operation.
+    # @option args [Array<AttributeSets::LeafInfo, Hash<Symbol, Object>>] leaves Describes a set of leaves shapers for a `group` operation.
+    # @return [Nl::Async::Future<Messages::DoGroupReply>]
+    # @see Messages::DoGroupRequest
+    def do_group(**args)
+      @exchange.call(:"do", Messages::DoGroupRequest, Messages::DoGroupReply, args)
+    end
+    # Get the shaper capabilities supported by the given device
+    # for the specified scope.
+    # @rbs (?ifindex: ::Integer, ?scope: ::Integer) -> ::Nl::Async::Future[Messages::DoCapGetReply]
+    # @param [Hash] args
+    # @option args [Integer] ifindex Interface index queried for shapers capabilities.
+    # @option args [Integer] scope The scope to which the queried capabilities apply.
+    #   
+    #   Known enum values are defined in {Enums::Scope}.
+    # @return [Nl::Async::Future<Messages::DoCapGetReply>]
+    # @see Messages::DoCapGetRequest
+    def do_cap_get(**args)
+      @exchange.call(:"do", Messages::DoCapGetRequest, Messages::DoCapGetReply, args)
+    end
+    # Get the shaper capabilities supported by the given device
+    # for the specified scope.
+    # @rbs (?ifindex: ::Integer) -> ::Nl::Async::Stream[Messages::DumpCapGetReply]
+    # @param [Hash] args
+    # @option args [Integer] ifindex Interface index queried for shapers capabilities.
+    # @return [Nl::Async::Stream<Messages::DumpCapGetReply>]
+    # @see Messages::DumpCapGetRequest
+    def dump_cap_get(**args)
+      @exchange.call(:"dump", Messages::DumpCapGetRequest, Messages::DumpCapGetReply, args)
+    end
+  end
+  # Returns the asynchronous operation facade for this family.
+  # @rbs (?stream_capacity: ::Integer?) -> AsyncOperations
+  # @param [::Integer, nil] stream_capacity
+  # @return [AsyncOperations]
+  def async(stream_capacity: nil)
+    return @async_operations ||= build_async_facade(AsyncOperations) if stream_capacity.nil?
+    build_async_facade(AsyncOperations, stream_capacity:)
+  end
 end
 end; end