nl-linux 0.3.0 → 0.4.1

data/generated/nl/linux/psp.rb

@@ -3,361 +3,739 @@
 # This file is based on Documentation/netlink/specs/psp.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
 # PSP Security Protocol Generic Netlink family.
-class Psp < ::Nl::Family
+class Psp < ::Nl::Genl::Family
   NAME = "psp"
-  PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("psp"))
+  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 [Psp]
+  # @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 [Psp] 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({:"mgmt" => ::Nl::McastGroup.new("mgmt", nil), :"use" => ::Nl::McastGroup.new("use", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
+  module Enums
+    module Version
+      Hdr0AesGcm128 = 0
+      Hdr0AesGcm256 = 1
+      Hdr0AesGmac128 = 2
+      Hdr0AesGmac256 = 3
+    end
+  end
+  module Flags
+    module Version
+      Hdr0AesGcm128 = 1
+      Hdr0AesGcm256 = 2
+      Hdr0AesGmac128 = 4
+      Hdr0AesGmac256 = 8
+    end
+  end
   module Structs
   end
   module AttributeSets
-    class AssocDevInfo < ::Nl::Protocols::Genl::AttributeSet
+    class AssocDevInfo < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # ifindex of an associated network device.
       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
+      # Network namespace ID of the associated device.
       class Nsid < Attribute
         TYPE = 2
         NAME = :"nsid"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"ifindex" => Ifindex, :"nsid" => Nsid}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Ifindex, 2 => Nsid}) #: Hash[::Integer, Attribute]
+      # ifindex of an associated network device.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # Network namespace ID of the associated device.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Nsid
+      def nsid; self[:"nsid"]&.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 Dev < ::Nl::Protocols::Genl::AttributeSet
+    class Dev < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # PSP device ID.
       class Id < Attribute
         TYPE = 1
         NAME = :"id"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
       end
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       class Ifindex < Attribute
         TYPE = 2
         NAME = :"ifindex"
-        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
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       class PspVersionsCap < Attribute
         TYPE = 3
         NAME = :"psp_versions_cap"
-        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
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       class PspVersionsEna < Attribute
         TYPE = 4
         NAME = :"psp_versions_ena"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 3
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
+      # List of associated virtual devices.
       class AssocList < Attribute
         TYPE = 5
         NAME = :"assoc_list"
+        # @private
+        MULTI = true
+        # @private
+        ORDER = 4
       end
+      # Network namespace ID for the device to associate/disassociate.
+      # Optional for dev-assoc and dev-disassoc; if not present, the
+      # device is looked up in the caller's network namespace.
       class Nsid < Attribute
         TYPE = 6
         NAME = :"nsid"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
       end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
       class ByAssociation < Attribute
         TYPE = 7
         NAME = :"by_association"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 6
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"id" => Id, :"ifindex" => Ifindex, :"psp_versions_cap" => PspVersionsCap, :"psp_versions_ena" => PspVersionsEna, :"assoc_list" => AssocList, :"nsid" => Nsid, :"by_association" => ByAssociation}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Id, 2 => Ifindex, 3 => PspVersionsCap, 4 => PspVersionsEna, 5 => AssocList, 6 => Nsid, 7 => ByAssociation}) #: Hash[::Integer, Attribute]
+      # PSP device ID.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Id
+      def id; self[:"id"]&.value; end
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see PspVersionsCap
+      def psp_versions_cap; self[:"psp_versions_cap"]&.value; end
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see PspVersionsEna
+      def psp_versions_ena; self[:"psp_versions_ena"]&.value; end
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AssocList
+      def assoc_list; self[:"assoc_list"].map(&:value); end
+      # Network namespace ID for the device to associate/disassociate.
+      # Optional for dev-assoc and dev-disassoc; if not present, the
+      # device is looked up in the caller's network namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Nsid
+      def nsid; self[:"nsid"]&.value; end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see ByAssociation
+      def by_association; self[:"by_association"]&.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 Assoc < ::Nl::Protocols::Genl::AttributeSet
+    class Assoc < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # PSP device ID.
       class DevId < Attribute
         TYPE = 1
         NAME = :"dev_id"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
       end
+      # PSP versions (AEAD and protocol version) used by this association,
+      # dictates the size of the key.
+      # 
+      # 
+      # Known enum values are defined in {Enums::Version}.
       class Version < Attribute
         TYPE = 2
         NAME = :"version"
-        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
       class RxKey < Attribute
         TYPE = 3
         NAME = :"rx_key"
+        # @private
+        ORDER = 2
       end
       class TxKey < Attribute
         TYPE = 4
         NAME = :"tx_key"
+        # @private
+        ORDER = 3
       end
+      # Sockets which should be bound to the association immediately.
       class SockFd < Attribute
         TYPE = 5
         NAME = :"sock_fd"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"dev_id" => DevId, :"version" => Version, :"rx_key" => RxKey, :"tx_key" => TxKey, :"sock_fd" => SockFd}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => DevId, 2 => Version, 3 => RxKey, 4 => TxKey, 5 => SockFd}) #: Hash[::Integer, Attribute]
+      # PSP device ID.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see DevId
+      def dev_id; self[:"dev_id"]&.value; end
+      # PSP versions (AEAD and protocol version) used by this association,
+      # dictates the size of the key.
+      # 
+      # 
+      # Known enum values are defined in {Enums::Version}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Version
+      def version; self[:"version"]&.value; end
+      # @rbs return: AttributeSets::Keys
+      # @return [AttributeSets::Keys]
+      # @see RxKey
+      def rx_key; self[:"rx_key"]&.value; end
+      # @rbs return: AttributeSets::Keys
+      # @return [AttributeSets::Keys]
+      # @see TxKey
+      def tx_key; self[:"tx_key"]&.value; end
+      # Sockets which should be bound to the association immediately.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SockFd
+      def sock_fd; self[:"sock_fd"]&.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 Keys < ::Nl::Protocols::Genl::AttributeSet
+    class Keys < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class Key < Attribute
         TYPE = 1
         NAME = :"key"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: nil)
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Binary.new(check: nil)
       end
+      # Security Parameters Index (SPI) of the association.
       class Spi < Attribute
         TYPE = 2
         NAME = :"spi"
-        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
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"key" => Key, :"spi" => Spi}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Key, 2 => Spi}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::String
+      # @return [String]
+      # @see Key
+      def key; self[:"key"]&.value; end
+      # Security Parameters Index (SPI) of the association.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Spi
+      def spi; self[:"spi"]&.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 Stats < ::Nl::Protocols::Genl::AttributeSet
+    class Stats < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # PSP device ID.
       class DevId < Attribute
         TYPE = 1
         NAME = :"dev_id"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is less than minimum 1" unless it >= 1 })
       end
+      # Number of key rotations during the lifetime of the device.
+      # Kernel statistic.
       class KeyRotations < Attribute
         TYPE = 2
         NAME = :"key_rotations"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of times a socket's Rx got shut down due to using
+      # a key which went stale (fully rotated out).
+      # Kernel statistic.
       class StaleEvents < Attribute
         TYPE = 3
         NAME = :"stale_events"
-        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
+      # Number of successfully processed and authenticated PSP packets.
+      # Device statistic (from the PSP spec).
       class RxPackets < Attribute
         TYPE = 4
         NAME = :"rx_packets"
-        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
+      # Number of successfully authenticated PSP bytes received, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
       class RxBytes < Attribute
         TYPE = 5
         NAME = :"rx_bytes"
-        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
+      # Number of received PSP packets with unsuccessful authentication.
+      # Device statistic (from the PSP spec).
       class RxAuthFail < Attribute
         TYPE = 6
         NAME = :"rx_auth_fail"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of received PSP packets with length/framing errors.
+      # Device statistic (from the PSP spec).
       class RxError < Attribute
         TYPE = 7
         NAME = :"rx_error"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 6
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of received PSP packets with miscellaneous errors
+      # (invalid master key indicated by SPI, unsupported version, etc.)
+      # Device statistic (from the PSP spec).
       class RxBad < Attribute
         TYPE = 8
         NAME = :"rx_bad"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 7
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of successfully processed PSP packets for transmission.
+      # Device statistic (from the PSP spec).
       class TxPackets < Attribute
         TYPE = 9
         NAME = :"tx_packets"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 8
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of successfully processed PSP bytes for transmit, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
       class TxBytes < Attribute
         TYPE = 10
         NAME = :"tx_bytes"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 9
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
+      # Number of PSP packets for transmission with errors.
+      # Device statistic (from the PSP spec).
       class TxError < Attribute
         TYPE = 11
         NAME = :"tx_error"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
+        # @private
+        ORDER = 10
+        # @private
+        DATATYPE = ::Nl::DataTypes::VariableInteger.new(::Nl::Endian::Host, signed: false, check: nil)
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"dev_id" => DevId, :"key_rotations" => KeyRotations, :"stale_events" => StaleEvents, :"rx_packets" => RxPackets, :"rx_bytes" => RxBytes, :"rx_auth_fail" => RxAuthFail, :"rx_error" => RxError, :"rx_bad" => RxBad, :"tx_packets" => TxPackets, :"tx_bytes" => TxBytes, :"tx_error" => TxError}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => DevId, 2 => KeyRotations, 3 => StaleEvents, 4 => RxPackets, 5 => RxBytes, 6 => RxAuthFail, 7 => RxError, 8 => RxBad, 9 => TxPackets, 10 => TxBytes, 11 => TxError}) #: Hash[::Integer, Attribute]
+      # PSP device ID.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see DevId
+      def dev_id; self[:"dev_id"]&.value; end
+      # Number of key rotations during the lifetime of the device.
+      # Kernel statistic.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see KeyRotations
+      def key_rotations; self[:"key_rotations"]&.value; end
+      # Number of times a socket's Rx got shut down due to using
+      # a key which went stale (fully rotated out).
+      # Kernel statistic.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see StaleEvents
+      def stale_events; self[:"stale_events"]&.value; end
+      # Number of successfully processed and authenticated PSP packets.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RxPackets
+      def rx_packets; self[:"rx_packets"]&.value; end
+      # Number of successfully authenticated PSP bytes received, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RxBytes
+      def rx_bytes; self[:"rx_bytes"]&.value; end
+      # Number of received PSP packets with unsuccessful authentication.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RxAuthFail
+      def rx_auth_fail; self[:"rx_auth_fail"]&.value; end
+      # Number of received PSP packets with length/framing errors.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RxError
+      def rx_error; self[:"rx_error"]&.value; end
+      # Number of received PSP packets with miscellaneous errors
+      # (invalid master key indicated by SPI, unsupported version, etc.)
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RxBad
+      def rx_bad; self[:"rx_bad"]&.value; end
+      # Number of successfully processed PSP packets for transmission.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TxPackets
+      def tx_packets; self[:"tx_packets"]&.value; end
+      # Number of successfully processed PSP bytes for transmit, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TxBytes
+      def tx_bytes; self[:"tx_bytes"]&.value; end
+      # Number of PSP packets for transmission with errors.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TxError
+      def tx_error; self[:"tx_error"]&.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
-    Dev::AssocList::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(AssocDevInfo)
-    Assoc::RxKey::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Keys)
-    Assoc::TxKey::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Keys)
+    # @private
+    Dev::AssocList::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::AssocDevInfo, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    Assoc::RxKey::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Keys, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    Assoc::TxKey::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Keys, selector_bindings: Ractor.make_shareable([]))
   end
   module Messages
     # Get / dump information about PSP capable devices on the system.
-    class DoDevGetRequest < ::Nl::Protocols::Genl::Message
+    class DoDevGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
     end
     # Get / dump information about PSP capable devices on the system.
-    class DoDevGetReply < ::Nl::Protocols::Genl::Message
+    class DoDevGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex psp_versions_cap psp_versions_ena assoc_list by_association])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `psp-versions-cap` attribute in the message.
-      #--
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsCap
       def psp_versions_cap; attributes[:"psp_versions_cap"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
-      # Gets the value of `assoc-list` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::AssocDevInfo
-      def assoc_list; attributes[:"assoc_list"]&.value; end
-      # Gets the value of `by-association` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AttributeSets::Dev::AssocList
+      def assoc_list; attributes[:"assoc_list"].map(&:value); end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::ByAssociation
       def by_association; attributes[:"by_association"]&.value; end
     end
     # Get / dump information about PSP capable devices on the system.
-    class DumpDevGetRequest < ::Nl::Protocols::Genl::Message
+    class DumpDevGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[])
     end
     # Get / dump information about PSP capable devices on the system.
-    class DumpDevGetReply < ::Nl::Protocols::Genl::Message
+    class DumpDevGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex psp_versions_cap psp_versions_ena assoc_list by_association])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `psp-versions-cap` attribute in the message.
-      #--
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsCap
       def psp_versions_cap; attributes[:"psp_versions_cap"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
-      # Gets the value of `assoc-list` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::AssocDevInfo
-      def assoc_list; attributes[:"assoc_list"]&.value; end
-      # Gets the value of `by-association` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AttributeSets::Dev::AssocList
+      def assoc_list; attributes[:"assoc_list"].map(&:value); end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::ByAssociation
       def by_association; attributes[:"by_association"]&.value; end
     end
     # Set the configuration of a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevSetRequest < ::Nl::Protocols::Genl::Message
+    class DoDevSetRequest < ::Nl::Genl::Message
       TYPE = 4
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id psp_versions_ena])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
     end
     # Set the configuration of a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevSetReply < ::Nl::Protocols::Genl::Message
+    class DoDevSetReply < ::Nl::Genl::Message
       TYPE = 4
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
@@ -366,238 +744,320 @@ class Psp < ::Nl::Family
     # Rotate the device key.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoKeyRotateRequest < ::Nl::Protocols::Genl::Message
+    class DoKeyRotateRequest < ::Nl::Genl::Message
       TYPE = 6
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
     end
     # Rotate the device key.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoKeyRotateReply < ::Nl::Protocols::Genl::Message
+    class DoKeyRotateReply < ::Nl::Genl::Message
       TYPE = 6
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
     end
     # Allocate a new Rx key + SPI pair, associate it with a socket.
-    class DoRxAssocRequest < ::Nl::Protocols::Genl::Message
+    class DoRxAssocRequest < ::Nl::Genl::Message
       TYPE = 8
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Assoc
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id version sock_fd])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
-      # Gets the value of `version` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # PSP versions (AEAD and protocol version) used by this association,
+      # dictates the size of the key.
+      # 
+      # 
+      # Known enum values are defined in {Enums::Version}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::Version
       def version; attributes[:"version"]&.value; end
-      # Gets the value of `sock-fd` attribute in the message.
-      #--
+      # Sockets which should be bound to the association immediately.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::SockFd
       def sock_fd; attributes[:"sock_fd"]&.value; end
     end
     # Allocate a new Rx key + SPI pair, associate it with a socket.
-    class DoRxAssocReply < ::Nl::Protocols::Genl::Message
+    class DoRxAssocReply < ::Nl::Genl::Message
       TYPE = 8
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Assoc
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id rx_key])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
-      # Gets the value of `rx-key` attribute in the message.
-      #--
       # @rbs return: AttributeSets::Keys
+      # @return [AttributeSets::Keys]
+      # @see AttributeSets::Assoc::RxKey
       def rx_key; attributes[:"rx_key"]&.value; end
     end
     # Add a PSP Tx association.
-    class DoTxAssocRequest < ::Nl::Protocols::Genl::Message
+    class DoTxAssocRequest < ::Nl::Genl::Message
       TYPE = 9
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Assoc
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id version tx_key sock_fd])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
-      # Gets the value of `version` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # PSP versions (AEAD and protocol version) used by this association,
+      # dictates the size of the key.
+      # 
+      # 
+      # Known enum values are defined in {Enums::Version}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::Version
       def version; attributes[:"version"]&.value; end
-      # Gets the value of `tx-key` attribute in the message.
-      #--
       # @rbs return: AttributeSets::Keys
+      # @return [AttributeSets::Keys]
+      # @see AttributeSets::Assoc::TxKey
       def tx_key; attributes[:"tx_key"]&.value; end
-      # Gets the value of `sock-fd` attribute in the message.
-      #--
+      # Sockets which should be bound to the association immediately.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Assoc::SockFd
       def sock_fd; attributes[:"sock_fd"]&.value; end
     end
     # Add a PSP Tx association.
-    class DoTxAssocReply < ::Nl::Protocols::Genl::Message
+    class DoTxAssocReply < ::Nl::Genl::Message
       TYPE = 9
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Assoc
       ATTRIBUTES = Ractor.make_shareable(%i[])
     end
     # Get device statistics.
-    class DoGetStatsRequest < ::Nl::Protocols::Genl::Message
+    class DoGetStatsRequest < ::Nl::Genl::Message
       TYPE = 10
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Stats
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
     end
     # Get device statistics.
-    class DoGetStatsReply < ::Nl::Protocols::Genl::Message
+    class DoGetStatsReply < ::Nl::Genl::Message
       TYPE = 10
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Stats
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id key_rotations stale_events rx_packets rx_bytes rx_auth_fail rx_error rx_bad tx_packets tx_bytes tx_error])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
-      # Gets the value of `key-rotations` attribute in the message.
-      #--
+      # Number of key rotations during the lifetime of the device.
+      # Kernel statistic.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::KeyRotations
       def key_rotations; attributes[:"key_rotations"]&.value; end
-      # Gets the value of `stale-events` attribute in the message.
-      #--
+      # Number of times a socket's Rx got shut down due to using
+      # a key which went stale (fully rotated out).
+      # Kernel statistic.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::StaleEvents
       def stale_events; attributes[:"stale_events"]&.value; end
-      # Gets the value of `rx-packets` attribute in the message.
-      #--
+      # Number of successfully processed and authenticated PSP packets.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxPackets
       def rx_packets; attributes[:"rx_packets"]&.value; end
-      # Gets the value of `rx-bytes` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # Number of successfully authenticated PSP bytes received, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxBytes
       def rx_bytes; attributes[:"rx_bytes"]&.value; end
-      # Gets the value of `rx-auth-fail` attribute in the message.
-      #--
+      # Number of received PSP packets with unsuccessful authentication.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxAuthFail
       def rx_auth_fail; attributes[:"rx_auth_fail"]&.value; end
-      # Gets the value of `rx-error` attribute in the message.
-      #--
+      # Number of received PSP packets with length/framing errors.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxError
       def rx_error; attributes[:"rx_error"]&.value; end
-      # Gets the value of `rx-bad` attribute in the message.
-      #--
+      # Number of received PSP packets with miscellaneous errors
+      # (invalid master key indicated by SPI, unsupported version, etc.)
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxBad
       def rx_bad; attributes[:"rx_bad"]&.value; end
-      # Gets the value of `tx-packets` attribute in the message.
-      #--
+      # Number of successfully processed PSP packets for transmission.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxPackets
       def tx_packets; attributes[:"tx_packets"]&.value; end
-      # Gets the value of `tx-bytes` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # Number of successfully processed PSP bytes for transmit, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxBytes
       def tx_bytes; attributes[:"tx_bytes"]&.value; end
-      # Gets the value of `tx-error` attribute in the message.
-      #--
+      # Number of PSP packets for transmission with errors.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxError
       def tx_error; attributes[:"tx_error"]&.value; end
     end
     # Get device statistics.
-    class DumpGetStatsRequest < ::Nl::Protocols::Genl::Message
+    class DumpGetStatsRequest < ::Nl::Genl::Message
       TYPE = 10
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Stats
       ATTRIBUTES = Ractor.make_shareable(%i[])
     end
     # Get device statistics.
-    class DumpGetStatsReply < ::Nl::Protocols::Genl::Message
+    class DumpGetStatsReply < ::Nl::Genl::Message
       TYPE = 10
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Stats
       ATTRIBUTES = Ractor.make_shareable(%i[dev_id key_rotations stale_events rx_packets rx_bytes rx_auth_fail rx_error rx_bad tx_packets tx_bytes tx_error])
-      # Gets the value of `dev-id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::DevId
       def dev_id; attributes[:"dev_id"]&.value; end
-      # Gets the value of `key-rotations` attribute in the message.
-      #--
+      # Number of key rotations during the lifetime of the device.
+      # Kernel statistic.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::KeyRotations
       def key_rotations; attributes[:"key_rotations"]&.value; end
-      # Gets the value of `stale-events` attribute in the message.
-      #--
+      # Number of times a socket's Rx got shut down due to using
+      # a key which went stale (fully rotated out).
+      # Kernel statistic.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::StaleEvents
       def stale_events; attributes[:"stale_events"]&.value; end
-      # Gets the value of `rx-packets` attribute in the message.
-      #--
+      # Number of successfully processed and authenticated PSP packets.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxPackets
       def rx_packets; attributes[:"rx_packets"]&.value; end
-      # Gets the value of `rx-bytes` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # Number of successfully authenticated PSP bytes received, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxBytes
       def rx_bytes; attributes[:"rx_bytes"]&.value; end
-      # Gets the value of `rx-auth-fail` attribute in the message.
-      #--
+      # Number of received PSP packets with unsuccessful authentication.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxAuthFail
       def rx_auth_fail; attributes[:"rx_auth_fail"]&.value; end
-      # Gets the value of `rx-error` attribute in the message.
-      #--
+      # Number of received PSP packets with length/framing errors.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxError
       def rx_error; attributes[:"rx_error"]&.value; end
-      # Gets the value of `rx-bad` attribute in the message.
-      #--
+      # Number of received PSP packets with miscellaneous errors
+      # (invalid master key indicated by SPI, unsupported version, etc.)
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::RxBad
       def rx_bad; attributes[:"rx_bad"]&.value; end
-      # Gets the value of `tx-packets` attribute in the message.
-      #--
+      # Number of successfully processed PSP packets for transmission.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxPackets
       def tx_packets; attributes[:"tx_packets"]&.value; end
-      # Gets the value of `tx-bytes` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # Number of successfully processed PSP bytes for transmit, counting from
+      # the first byte after the IV through the last byte of payload.
+      # The fixed initial portion of the PSP header (16 bytes)
+      # and the PSP trailer/ICV (16 bytes) are not included in this count.
+      # Device statistic (from the PSP spec).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxBytes
       def tx_bytes; attributes[:"tx_bytes"]&.value; end
-      # Gets the value of `tx-error` attribute in the message.
-      #--
+      # Number of PSP packets for transmission with errors.
+      # Device statistic (from the PSP spec).
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Stats::TxError
       def tx_error; attributes[:"tx_error"]&.value; end
     end
     # Associate a network device with a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevAssocRequest < ::Nl::Protocols::Genl::Message
+    class DoDevAssocRequest < ::Nl::Genl::Message
       TYPE = 11
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex nsid])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `nsid` attribute in the message.
-      #--
+      # Network namespace ID for the device to associate/disassociate.
+      # Optional for dev-assoc and dev-disassoc; if not present, the
+      # device is looked up in the caller's network namespace.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Nsid
       def nsid; attributes[:"nsid"]&.value; end
     end
     # Associate a network device with a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevAssocReply < ::Nl::Protocols::Genl::Message
+    class DoDevAssocReply < ::Nl::Genl::Message
       TYPE = 11
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
@@ -606,28 +1066,34 @@ class Psp < ::Nl::Family
     # Disassociate a network device from a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevDisassocRequest < ::Nl::Protocols::Genl::Message
+    class DoDevDisassocRequest < ::Nl::Genl::Message
       TYPE = 12
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex nsid])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `nsid` attribute in the message.
-      #--
+      # Network namespace ID for the device to associate/disassociate.
+      # Optional for dev-assoc and dev-disassoc; if not present, the
+      # device is looked up in the caller's network namespace.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Nsid
       def nsid; attributes[:"nsid"]&.value; end
     end
     # Disassociate a network device from a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDevDisassocReply < ::Nl::Protocols::Genl::Message
+    class DoDevDisassocReply < ::Nl::Genl::Message
       TYPE = 12
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
@@ -638,273 +1104,442 @@ class Psp < ::Nl::Family
     # Notification about device appearing.
     # 
     # Multicast group: `mgmt`.
-    class DevAddNtf < ::Nl::Protocols::Genl::Message
+    class DevAddNtf < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex psp_versions_cap psp_versions_ena assoc_list by_association])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `psp-versions-cap` attribute in the message.
-      #--
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsCap
       def psp_versions_cap; attributes[:"psp_versions_cap"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
-      # Gets the value of `assoc-list` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::AssocDevInfo
-      def assoc_list; attributes[:"assoc_list"]&.value; end
-      # Gets the value of `by-association` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AttributeSets::Dev::AssocList
+      def assoc_list; attributes[:"assoc_list"].map(&:value); end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::ByAssociation
       def by_association; attributes[:"by_association"]&.value; end
     end
     # Notification about device disappearing.
     # 
     # Multicast group: `mgmt`.
-    class DevDelNtf < ::Nl::Protocols::Genl::Message
+    class DevDelNtf < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex psp_versions_cap psp_versions_ena assoc_list by_association])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `psp-versions-cap` attribute in the message.
-      #--
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsCap
       def psp_versions_cap; attributes[:"psp_versions_cap"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
-      # Gets the value of `assoc-list` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::AssocDevInfo
-      def assoc_list; attributes[:"assoc_list"]&.value; end
-      # Gets the value of `by-association` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AttributeSets::Dev::AssocList
+      def assoc_list; attributes[:"assoc_list"].map(&:value); end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::ByAssociation
       def by_association; attributes[:"by_association"]&.value; end
     end
     # Notification about device configuration being changed.
     # 
     # Multicast group: `mgmt`.
-    class DevChangeNtf < ::Nl::Protocols::Genl::Message
+    class DevChangeNtf < ::Nl::Genl::Message
       TYPE = 5
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id ifindex psp_versions_cap psp_versions_ena assoc_list by_association])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
+      # ifindex of the main netdevice linked to the PSP device,
+      # or the ifindex to associate with the PSP device.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `psp-versions-cap` attribute in the message.
-      #--
+      # Bitmask of PSP versions supported by the device.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsCap
       def psp_versions_cap; attributes[:"psp_versions_cap"]&.value; end
-      # Gets the value of `psp-versions-ena` attribute in the message.
-      #--
+      # Bitmask of currently enabled (accepted on Rx) PSP versions.
+      # 
+      # Known flags are defined in {Flags::Version}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::PspVersionsEna
       def psp_versions_ena; attributes[:"psp_versions_ena"]&.value; end
-      # Gets the value of `assoc-list` attribute in the message.
-      #--
-      # @rbs return: AttributeSets::AssocDevInfo
-      def assoc_list; attributes[:"assoc_list"]&.value; end
-      # Gets the value of `by-association` attribute in the message.
-      #--
-      # @rbs return: ::Integer
+      # List of associated virtual devices.
+      # @rbs return: ::Array[AttributeSets::AssocDevInfo]
+      # @return [Array<AttributeSets::AssocDevInfo>]
+      # @see AttributeSets::Dev::AssocList
+      def assoc_list; attributes[:"assoc_list"].map(&:value); end
+      # Flag indicating the PSP device is an associated device from a
+      # different network namespace.
+      # Present when in associated namespace, absent when in primary/host
+      # namespace.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::ByAssociation
       def by_association; attributes[:"by_association"]&.value; end
     end
     # Notification about device key getting rotated.
     # 
     # Multicast group: `use`.
-    class KeyRotateNtf < ::Nl::Protocols::Genl::Message
+    class KeyRotateNtf < ::Nl::Genl::Message
       TYPE = 7
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Dev
       ATTRIBUTES = Ractor.make_shareable(%i[id])
-      # Gets the value of `id` attribute in the message.
-      #--
+      # PSP device ID.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Dev::Id
       def id; attributes[:"id"]&.value; end
     end
   end
+  # @private
   NOTIFICATIONS = Ractor.make_shareable({2 => Notifications::DevAddNtf, 3 => Notifications::DevDelNtf, 5 => Notifications::DevChangeNtf, 7 => Notifications::KeyRotateNtf}) #: Hash[::Integer, ::Class]
   # Get / dump information about PSP capable devices on the system.
-  #--
   # @rbs (?id: ::Integer) -> Messages::DoDevGetReply
+  # @param [Hash] args
+  # @option args [Integer] id PSP device ID.
+  # @return [Messages::DoDevGetReply]
+  # @see Messages::DoDevGetRequest
   def do_dev_get(**args)
     exchange_message(:"do", Messages::DoDevGetRequest, Messages::DoDevGetReply, args)
   end
   # Get / dump information about PSP capable devices on the system.
-  #--
-  # @rbs () -> Enumerable[Messages::DumpDevGetReply]
+  # @rbs () -> Array[Messages::DumpDevGetReply]
   #   | () { (Messages::DumpDevGetReply) -> void } -> void
+  # @overload dump_dev_get(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @return [Array<Messages::DumpDevGetReply>]
+  # @overload dump_dev_get(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @yieldparam [Messages::DumpDevGetReply] reply
+  #   @return [void]
+  # @see Messages::DumpDevGetRequest
   def dump_dev_get(**args, &block)
     exchange_message(:"dump", Messages::DumpDevGetRequest, Messages::DumpDevGetReply, args, &block)
   end
   # Set the configuration of a PSP device.
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?id: ::Integer, ?psp_versions_ena: ::Integer) -> Messages::DoDevSetReply
+  # @param [Hash] args
+  # @option args [Integer] id PSP device ID.
+  # @option args [Integer] psp_versions_ena Bitmask of currently enabled (accepted on Rx) PSP versions.
+  #   
+  #   Known flags are defined in {Flags::Version}.
+  # @return [Messages::DoDevSetReply]
+  # @see Messages::DoDevSetRequest
   def do_dev_set(**args)
     exchange_message(:"do", Messages::DoDevSetRequest, Messages::DoDevSetReply, args)
   end
   # Rotate the device key.
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?id: ::Integer) -> Messages::DoKeyRotateReply
+  # @param [Hash] args
+  # @option args [Integer] id PSP device ID.
+  # @return [Messages::DoKeyRotateReply]
+  # @see Messages::DoKeyRotateRequest
   def do_key_rotate(**args)
     exchange_message(:"do", Messages::DoKeyRotateRequest, Messages::DoKeyRotateReply, args)
   end
   # Allocate a new Rx key + SPI pair, associate it with a socket.
-  #--
   # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?sock_fd: ::Integer) -> Messages::DoRxAssocReply
+  # @param [Hash] args
+  # @option args [Integer] dev_id PSP device ID.
+  # @option args [Integer] version PSP versions (AEAD and protocol version) used by this association,
+  #   dictates the size of the key.
+  #   
+  #   
+  #   Known enum values are defined in {Enums::Version}.
+  # @option args [Integer] sock_fd Sockets which should be bound to the association immediately.
+  # @return [Messages::DoRxAssocReply]
+  # @see Messages::DoRxAssocRequest
   def do_rx_assoc(**args)
     exchange_message(:"do", Messages::DoRxAssocRequest, Messages::DoRxAssocReply, args)
   end
   # Add a PSP Tx association.
-  #--
-  # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?tx_key: AttributeSets::Keys, ?sock_fd: ::Integer) -> Messages::DoTxAssocReply
+  # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?tx_key: (AttributeSets::Keys | ::Hash[::Symbol, untyped]), ?sock_fd: ::Integer) -> Messages::DoTxAssocReply
+  # @param [Hash] args
+  # @option args [Integer] dev_id PSP device ID.
+  # @option args [Integer] version PSP versions (AEAD and protocol version) used by this association,
+  #   dictates the size of the key.
+  #   
+  #   
+  #   Known enum values are defined in {Enums::Version}.
+  # @option args [AttributeSets::Keys, Hash<Symbol, Object>] tx_key
+  # @option args [Integer] sock_fd Sockets which should be bound to the association immediately.
+  # @return [Messages::DoTxAssocReply]
+  # @see Messages::DoTxAssocRequest
   def do_tx_assoc(**args)
     exchange_message(:"do", Messages::DoTxAssocRequest, Messages::DoTxAssocReply, args)
   end
   # Get device statistics.
-  #--
   # @rbs (?dev_id: ::Integer) -> Messages::DoGetStatsReply
+  # @param [Hash] args
+  # @option args [Integer] dev_id PSP device ID.
+  # @return [Messages::DoGetStatsReply]
+  # @see Messages::DoGetStatsRequest
   def do_get_stats(**args)
     exchange_message(:"do", Messages::DoGetStatsRequest, Messages::DoGetStatsReply, args)
   end
   # Get device statistics.
-  #--
-  # @rbs () -> Enumerable[Messages::DumpGetStatsReply]
+  # @rbs () -> Array[Messages::DumpGetStatsReply]
   #   | () { (Messages::DumpGetStatsReply) -> void } -> void
+  # @overload dump_get_stats(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @return [Array<Messages::DumpGetStatsReply>]
+  # @overload dump_get_stats(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @yieldparam [Messages::DumpGetStatsReply] reply
+  #   @return [void]
+  # @see Messages::DumpGetStatsRequest
   def dump_get_stats(**args, &block)
     exchange_message(:"dump", Messages::DumpGetStatsRequest, Messages::DumpGetStatsReply, args, &block)
   end
   # Associate a network device with a PSP device.
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?id: ::Integer, ?ifindex: ::Integer, ?nsid: ::Integer) -> Messages::DoDevAssocReply
+  # @param [Hash] args
+  # @option args [Integer] id PSP device ID.
+  # @option args [Integer] ifindex ifindex of the main netdevice linked to the PSP device,
+  #   or the ifindex to associate with the PSP device.
+  # @option args [Integer] nsid Network namespace ID for the device to associate/disassociate.
+  #   Optional for dev-assoc and dev-disassoc; if not present, the
+  #   device is looked up in the caller's network namespace.
+  # @return [Messages::DoDevAssocReply]
+  # @see Messages::DoDevAssocRequest
   def do_dev_assoc(**args)
     exchange_message(:"do", Messages::DoDevAssocRequest, Messages::DoDevAssocReply, args)
   end
   # Disassociate a network device from a PSP device.
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?id: ::Integer, ?ifindex: ::Integer, ?nsid: ::Integer) -> Messages::DoDevDisassocReply
+  # @param [Hash] args
+  # @option args [Integer] id PSP device ID.
+  # @option args [Integer] ifindex ifindex of the main netdevice linked to the PSP device,
+  #   or the ifindex to associate with the PSP device.
+  # @option args [Integer] nsid Network namespace ID for the device to associate/disassociate.
+  #   Optional for dev-assoc and dev-disassoc; if not present, the
+  #   device is looked up in the caller's network namespace.
+  # @return [Messages::DoDevDisassocReply]
+  # @see Messages::DoDevDisassocRequest
   def do_dev_disassoc(**args)
     exchange_message(:"do", Messages::DoDevDisassocRequest, Messages::DoDevDisassocReply, args)
   end
   class AsyncOperations
-    # :nodoc:
+    # @private
     def initialize(&exchange)
       @exchange = exchange
     end
     # Get / dump information about PSP capable devices on the system.
-    #--
     # @rbs (?id: ::Integer) -> ::Nl::Async::Future[Messages::DoDevGetReply]
+    # @param [Hash] args
+    # @option args [Integer] id PSP device ID.
+    # @return [Nl::Async::Future<Messages::DoDevGetReply>]
+    # @see Messages::DoDevGetRequest
     def do_dev_get(**args)
       @exchange.call(:"do", Messages::DoDevGetRequest, Messages::DoDevGetReply, args)
     end
     # Get / dump information about PSP capable devices on the system.
-    #--
     # @rbs () -> ::Nl::Async::Stream[Messages::DumpDevGetReply]
+    # @param [Hash] args
+    # @return [Nl::Async::Stream<Messages::DumpDevGetReply>]
+    # @see Messages::DumpDevGetRequest
     def dump_dev_get(**args)
       @exchange.call(:"dump", Messages::DumpDevGetRequest, Messages::DumpDevGetReply, args)
     end
     # Set the configuration of a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?id: ::Integer, ?psp_versions_ena: ::Integer) -> ::Nl::Async::Future[Messages::DoDevSetReply]
+    # @param [Hash] args
+    # @option args [Integer] id PSP device ID.
+    # @option args [Integer] psp_versions_ena Bitmask of currently enabled (accepted on Rx) PSP versions.
+    #   
+    #   Known flags are defined in {Flags::Version}.
+    # @return [Nl::Async::Future<Messages::DoDevSetReply>]
+    # @see Messages::DoDevSetRequest
     def do_dev_set(**args)
       @exchange.call(:"do", Messages::DoDevSetRequest, Messages::DoDevSetReply, args)
     end
     # Rotate the device key.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?id: ::Integer) -> ::Nl::Async::Future[Messages::DoKeyRotateReply]
+    # @param [Hash] args
+    # @option args [Integer] id PSP device ID.
+    # @return [Nl::Async::Future<Messages::DoKeyRotateReply>]
+    # @see Messages::DoKeyRotateRequest
     def do_key_rotate(**args)
       @exchange.call(:"do", Messages::DoKeyRotateRequest, Messages::DoKeyRotateReply, args)
     end
     # Allocate a new Rx key + SPI pair, associate it with a socket.
-    #--
     # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?sock_fd: ::Integer) -> ::Nl::Async::Future[Messages::DoRxAssocReply]
+    # @param [Hash] args
+    # @option args [Integer] dev_id PSP device ID.
+    # @option args [Integer] version PSP versions (AEAD and protocol version) used by this association,
+    #   dictates the size of the key.
+    #   
+    #   
+    #   Known enum values are defined in {Enums::Version}.
+    # @option args [Integer] sock_fd Sockets which should be bound to the association immediately.
+    # @return [Nl::Async::Future<Messages::DoRxAssocReply>]
+    # @see Messages::DoRxAssocRequest
     def do_rx_assoc(**args)
       @exchange.call(:"do", Messages::DoRxAssocRequest, Messages::DoRxAssocReply, args)
     end
     # Add a PSP Tx association.
-    #--
-    # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?tx_key: AttributeSets::Keys, ?sock_fd: ::Integer) -> ::Nl::Async::Future[Messages::DoTxAssocReply]
+    # @rbs (?dev_id: ::Integer, ?version: ::Integer, ?tx_key: (AttributeSets::Keys | ::Hash[::Symbol, untyped]), ?sock_fd: ::Integer) -> ::Nl::Async::Future[Messages::DoTxAssocReply]
+    # @param [Hash] args
+    # @option args [Integer] dev_id PSP device ID.
+    # @option args [Integer] version PSP versions (AEAD and protocol version) used by this association,
+    #   dictates the size of the key.
+    #   
+    #   
+    #   Known enum values are defined in {Enums::Version}.
+    # @option args [AttributeSets::Keys, Hash<Symbol, Object>] tx_key
+    # @option args [Integer] sock_fd Sockets which should be bound to the association immediately.
+    # @return [Nl::Async::Future<Messages::DoTxAssocReply>]
+    # @see Messages::DoTxAssocRequest
     def do_tx_assoc(**args)
       @exchange.call(:"do", Messages::DoTxAssocRequest, Messages::DoTxAssocReply, args)
     end
     # Get device statistics.
-    #--
     # @rbs (?dev_id: ::Integer) -> ::Nl::Async::Future[Messages::DoGetStatsReply]
+    # @param [Hash] args
+    # @option args [Integer] dev_id PSP device ID.
+    # @return [Nl::Async::Future<Messages::DoGetStatsReply>]
+    # @see Messages::DoGetStatsRequest
     def do_get_stats(**args)
       @exchange.call(:"do", Messages::DoGetStatsRequest, Messages::DoGetStatsReply, args)
     end
     # Get device statistics.
-    #--
     # @rbs () -> ::Nl::Async::Stream[Messages::DumpGetStatsReply]
+    # @param [Hash] args
+    # @return [Nl::Async::Stream<Messages::DumpGetStatsReply>]
+    # @see Messages::DumpGetStatsRequest
     def dump_get_stats(**args)
       @exchange.call(:"dump", Messages::DumpGetStatsRequest, Messages::DumpGetStatsReply, args)
     end
     # Associate a network device with a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?id: ::Integer, ?ifindex: ::Integer, ?nsid: ::Integer) -> ::Nl::Async::Future[Messages::DoDevAssocReply]
+    # @param [Hash] args
+    # @option args [Integer] id PSP device ID.
+    # @option args [Integer] ifindex ifindex of the main netdevice linked to the PSP device,
+    #   or the ifindex to associate with the PSP device.
+    # @option args [Integer] nsid Network namespace ID for the device to associate/disassociate.
+    #   Optional for dev-assoc and dev-disassoc; if not present, the
+    #   device is looked up in the caller's network namespace.
+    # @return [Nl::Async::Future<Messages::DoDevAssocReply>]
+    # @see Messages::DoDevAssocRequest
     def do_dev_assoc(**args)
       @exchange.call(:"do", Messages::DoDevAssocRequest, Messages::DoDevAssocReply, args)
     end
     # Disassociate a network device from a PSP device.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?id: ::Integer, ?ifindex: ::Integer, ?nsid: ::Integer) -> ::Nl::Async::Future[Messages::DoDevDisassocReply]
+    # @param [Hash] args
+    # @option args [Integer] id PSP device ID.
+    # @option args [Integer] ifindex ifindex of the main netdevice linked to the PSP device,
+    #   or the ifindex to associate with the PSP device.
+    # @option args [Integer] nsid Network namespace ID for the device to associate/disassociate.
+    #   Optional for dev-assoc and dev-disassoc; if not present, the
+    #   device is looked up in the caller's network namespace.
+    # @return [Nl::Async::Future<Messages::DoDevDisassocReply>]
+    # @see Messages::DoDevDisassocRequest
     def do_dev_disassoc(**args)
       @exchange.call(:"do", Messages::DoDevDisassocRequest, Messages::DoDevDisassocReply, 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
-  #--
   # @rbs (*(:mgmt | :use) groups) -> self
+  # @param [Array<:mgmt, :use>] groups
+  # @return [self]
   def subscribe(*groups) = super
-  #--
   # @rbs (*(:mgmt | :use) groups) -> self
+  # @param [Array<:mgmt, :use>] groups
+  # @return [self]
   def unsubscribe(*groups) = super
 end
 end; end