nl-linux 0.3.0 → 0.4.1

data/generated/nl/linux/tcp_metrics.rb

@@ -3,100 +3,211 @@
 # This file is based on Documentation/netlink/specs/tcp_metrics.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
 # Management interface for TCP metrics.
-class TcpMetrics < ::Nl::Family
+class TcpMetrics < ::Nl::Genl::Family
   NAME = "tcp_metrics"
-  PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("tcp_metrics"))
+  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 [TcpMetrics]
+  # @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 [TcpMetrics] 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
+    TCP_FASTOPEN_COOKIE_MAX = 16
+  end
   module Structs
   end
   module AttributeSets
-    class TcpMetrics < ::Nl::Protocols::Genl::AttributeSet
+    class TcpMetrics < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class AddrIpv4 < Attribute
         TYPE = 1
         NAME = :"addr_ipv4"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Big::U32, check: nil)
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Big::U32, check: nil)
       end
       class AddrIpv6 < Attribute
         TYPE = 2
         NAME = :"addr_ipv6"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length 16" unless it.bytesize >= 16 })
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length 16" unless it.bytesize >= 16 })
       end
       class Age < Attribute
         TYPE = 3
         NAME = :"age"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
       end
+      # unused
       class TwTsval < Attribute
         TYPE = 4
         NAME = :"tw_tsval"
-        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
+      # unused
       class TwTsStamp < Attribute
         TYPE = 5
         NAME = :"tw_ts_stamp"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::S32, check: nil)
       end
       class Vals < Attribute
         TYPE = 6
         NAME = :"vals"
+        # @private
+        ORDER = 5
       end
       class FopenMss < Attribute
         TYPE = 7
         NAME = :"fopen_mss"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U16, check: nil)
+        # @private
+        ORDER = 6
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U16, check: nil)
       end
       class FopenSynDrops < Attribute
         TYPE = 8
         NAME = :"fopen_syn_drops"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U16, check: nil)
+        # @private
+        ORDER = 7
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U16, check: nil)
       end
       class FopenSynDropTs < Attribute
         TYPE = 9
         NAME = :"fopen_syn_drop_ts"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
+        # @private
+        ORDER = 8
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
       end
       class FopenCookie < Attribute
         TYPE = 10
         NAME = :"fopen_cookie"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length 16" unless it.bytesize >= 16 })
+        # @private
+        ORDER = 9
+        # @private
+        DATATYPE = ::Nl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length #{Constants::TCP_FASTOPEN_COOKIE_MAX}" unless it.bytesize >= Constants::TCP_FASTOPEN_COOKIE_MAX })
       end
       class SaddrIpv4 < Attribute
         TYPE = 11
         NAME = :"saddr_ipv4"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Big::U32, check: nil)
+        # @private
+        ORDER = 10
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Big::U32, check: nil)
       end
       class SaddrIpv6 < Attribute
         TYPE = 12
         NAME = :"saddr_ipv6"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length 16" unless it.bytesize >= 16 })
+        # @private
+        ORDER = 11
+        # @private
+        DATATYPE = ::Nl::DataTypes::Binary.new(check: -> { raise ArgumentError, "Value #{it.inspect} is shorter than minimum length 16" unless it.bytesize >= 16 })
       end
       class Pad < Attribute
         TYPE = 13
         NAME = :"pad"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Pad.new()
+        # @private
+        ORDER = 12
+        # @private
+        DATATYPE = ::Nl::DataTypes::Pad.new()
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"addr_ipv4" => AddrIpv4, :"addr_ipv6" => AddrIpv6, :"age" => Age, :"tw_tsval" => TwTsval, :"tw_ts_stamp" => TwTsStamp, :"vals" => Vals, :"fopen_mss" => FopenMss, :"fopen_syn_drops" => FopenSynDrops, :"fopen_syn_drop_ts" => FopenSynDropTs, :"fopen_cookie" => FopenCookie, :"saddr_ipv4" => SaddrIpv4, :"saddr_ipv6" => SaddrIpv6, :"pad" => Pad}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => AddrIpv4, 2 => AddrIpv6, 3 => Age, 4 => TwTsval, 5 => TwTsStamp, 6 => Vals, 7 => FopenMss, 8 => FopenSynDrops, 9 => FopenSynDropTs, 10 => FopenCookie, 11 => SaddrIpv4, 12 => SaddrIpv6, 13 => Pad}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AddrIpv4
+      def addr_ipv4; self[:"addr_ipv4"]&.value; end
+      # @rbs return: ::String
+      # @return [String]
+      # @see AddrIpv6
+      def addr_ipv6; self[:"addr_ipv6"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Age
+      def age; self[:"age"]&.value; end
+      # unused
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TwTsval
+      def tw_tsval; self[:"tw_tsval"]&.value; end
+      # unused
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TwTsStamp
+      def tw_ts_stamp; self[:"tw_ts_stamp"]&.value; end
+      # @rbs return: AttributeSets::Metrics
+      # @return [AttributeSets::Metrics]
+      # @see Vals
+      def vals; self[:"vals"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see FopenMss
+      def fopen_mss; self[:"fopen_mss"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see FopenSynDrops
+      def fopen_syn_drops; self[:"fopen_syn_drops"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see FopenSynDropTs
+      def fopen_syn_drop_ts; self[:"fopen_syn_drop_ts"]&.value; end
+      # @rbs return: ::String
+      # @return [String]
+      # @see FopenCookie
+      def fopen_cookie; self[:"fopen_cookie"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see SaddrIpv4
+      def saddr_ipv4; self[:"saddr_ipv4"]&.value; end
+      # @rbs return: ::String
+      # @return [String]
+      # @see SaddrIpv6
+      def saddr_ipv6; self[:"saddr_ipv6"]&.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
@@ -104,268 +215,379 @@ class TcpMetrics < ::Nl::Family
     # the TCP_METRIC_* defines in the kernel, because kernel defines
     # are off-by one (e.g. rtt is defined as enum 0, while netlink carries
     # attribute type 1).
-    class Metrics < ::Nl::Protocols::Genl::AttributeSet
+    class Metrics < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
+      # Round Trip Time (RTT), in msecs with 3 bits fractional
+      # (left-shift by 3 to get the msec value).
       class Rtt < Attribute
         TYPE = 1
         NAME = :"rtt"
-        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
+      # Round Trip Time VARiance (RTT), in msecs with 2 bits fractional
+      # (left-shift by 2 to get the msec value).
       class Rttvar < Attribute
         TYPE = 2
         NAME = :"rttvar"
-        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
+      # Slow Start THRESHold.
       class Ssthresh < Attribute
         TYPE = 3
         NAME = :"ssthresh"
-        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
+      # Congestion Window.
       class Cwnd < Attribute
         TYPE = 4
         NAME = :"cwnd"
-        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
+      # Reodering metric.
       class Reodering < Attribute
         TYPE = 5
         NAME = :"reodering"
-        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
+      # Round Trip Time (RTT), in usecs, with 3 bits fractional
+      # (left-shift by 3 to get the msec value).
       class RttUs < Attribute
         TYPE = 6
         NAME = :"rtt_us"
-        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
+      # Round Trip Time (RTT), in usecs, with 2 bits fractional
+      # (left-shift by 3 to get the msec value).
       class RttvarUs < Attribute
         TYPE = 7
         NAME = :"rttvar_us"
-        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
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"rtt" => Rtt, :"rttvar" => Rttvar, :"ssthresh" => Ssthresh, :"cwnd" => Cwnd, :"reodering" => Reodering, :"rtt_us" => RttUs, :"rttvar_us" => RttvarUs}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Rtt, 2 => Rttvar, 3 => Ssthresh, 4 => Cwnd, 5 => Reodering, 6 => RttUs, 7 => RttvarUs}) #: Hash[::Integer, Attribute]
+      # Round Trip Time (RTT), in msecs with 3 bits fractional
+      # (left-shift by 3 to get the msec value).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Rtt
+      def rtt; self[:"rtt"]&.value; end
+      # Round Trip Time VARiance (RTT), in msecs with 2 bits fractional
+      # (left-shift by 2 to get the msec value).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Rttvar
+      def rttvar; self[:"rttvar"]&.value; end
+      # Slow Start THRESHold.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ssthresh
+      def ssthresh; self[:"ssthresh"]&.value; end
+      # Congestion Window.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Cwnd
+      def cwnd; self[:"cwnd"]&.value; end
+      # Reodering metric.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Reodering
+      def reodering; self[:"reodering"]&.value; end
+      # Round Trip Time (RTT), in usecs, with 3 bits fractional
+      # (left-shift by 3 to get the msec value).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RttUs
+      def rtt_us; self[:"rtt_us"]&.value; end
+      # Round Trip Time (RTT), in usecs, with 2 bits fractional
+      # (left-shift by 3 to get the msec value).
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see RttvarUs
+      def rttvar_us; self[:"rttvar_us"]&.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
-    TcpMetrics::Vals::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(Metrics)
+    # @private
+    TcpMetrics::Vals::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::Metrics, selector_bindings: Ractor.make_shareable([]))
   end
   module Messages
     # Retrieve metrics.
-    class DoGetRequest < ::Nl::Protocols::Genl::Message
+    class DoGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::TcpMetrics
       ATTRIBUTES = Ractor.make_shareable(%i[addr_ipv4 addr_ipv6 saddr_ipv4 saddr_ipv6])
-      # Gets the value of `addr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::AddrIpv4
       def addr_ipv4; attributes[:"addr_ipv4"]&.value; end
-      # Gets the value of `addr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::AddrIpv6
       def addr_ipv6; attributes[:"addr_ipv6"]&.value; end
-      # Gets the value of `saddr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::SaddrIpv4
       def saddr_ipv4; attributes[:"saddr_ipv4"]&.value; end
-      # Gets the value of `saddr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::SaddrIpv6
       def saddr_ipv6; attributes[:"saddr_ipv6"]&.value; end
     end
     # Retrieve metrics.
-    class DoGetReply < ::Nl::Protocols::Genl::Message
+    class DoGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::TcpMetrics
       ATTRIBUTES = Ractor.make_shareable(%i[addr_ipv4 addr_ipv6 age vals fopen_mss fopen_syn_drops fopen_syn_drop_ts fopen_cookie saddr_ipv4 saddr_ipv6])
-      # Gets the value of `addr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::AddrIpv4
       def addr_ipv4; attributes[:"addr_ipv4"]&.value; end
-      # Gets the value of `addr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::AddrIpv6
       def addr_ipv6; attributes[:"addr_ipv6"]&.value; end
-      # Gets the value of `age` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::Age
       def age; attributes[:"age"]&.value; end
-      # Gets the value of `vals` attribute in the message.
-      #--
       # @rbs return: AttributeSets::Metrics
+      # @return [AttributeSets::Metrics]
+      # @see AttributeSets::TcpMetrics::Vals
       def vals; attributes[:"vals"]&.value; end
-      # Gets the value of `fopen-mss` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenMss
       def fopen_mss; attributes[:"fopen_mss"]&.value; end
-      # Gets the value of `fopen-syn-drops` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenSynDrops
       def fopen_syn_drops; attributes[:"fopen_syn_drops"]&.value; end
-      # Gets the value of `fopen-syn-drop-ts` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenSynDropTs
       def fopen_syn_drop_ts; attributes[:"fopen_syn_drop_ts"]&.value; end
-      # Gets the value of `fopen-cookie` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::FopenCookie
       def fopen_cookie; attributes[:"fopen_cookie"]&.value; end
-      # Gets the value of `saddr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::SaddrIpv4
       def saddr_ipv4; attributes[:"saddr_ipv4"]&.value; end
-      # Gets the value of `saddr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::SaddrIpv6
       def saddr_ipv6; attributes[:"saddr_ipv6"]&.value; end
     end
     # Retrieve metrics.
-    class DumpGetRequest < ::Nl::Protocols::Genl::Message
+    class DumpGetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::TcpMetrics
       ATTRIBUTES = Ractor.make_shareable(%i[])
     end
     # Retrieve metrics.
-    class DumpGetReply < ::Nl::Protocols::Genl::Message
+    class DumpGetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::TcpMetrics
       ATTRIBUTES = Ractor.make_shareable(%i[addr_ipv4 addr_ipv6 age vals fopen_mss fopen_syn_drops fopen_syn_drop_ts fopen_cookie saddr_ipv4 saddr_ipv6])
-      # Gets the value of `addr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::AddrIpv4
       def addr_ipv4; attributes[:"addr_ipv4"]&.value; end
-      # Gets the value of `addr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::AddrIpv6
       def addr_ipv6; attributes[:"addr_ipv6"]&.value; end
-      # Gets the value of `age` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::Age
       def age; attributes[:"age"]&.value; end
-      # Gets the value of `vals` attribute in the message.
-      #--
       # @rbs return: AttributeSets::Metrics
+      # @return [AttributeSets::Metrics]
+      # @see AttributeSets::TcpMetrics::Vals
       def vals; attributes[:"vals"]&.value; end
-      # Gets the value of `fopen-mss` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenMss
       def fopen_mss; attributes[:"fopen_mss"]&.value; end
-      # Gets the value of `fopen-syn-drops` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenSynDrops
       def fopen_syn_drops; attributes[:"fopen_syn_drops"]&.value; end
-      # Gets the value of `fopen-syn-drop-ts` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::FopenSynDropTs
       def fopen_syn_drop_ts; attributes[:"fopen_syn_drop_ts"]&.value; end
-      # Gets the value of `fopen-cookie` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::FopenCookie
       def fopen_cookie; attributes[:"fopen_cookie"]&.value; end
-      # Gets the value of `saddr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::SaddrIpv4
       def saddr_ipv4; attributes[:"saddr_ipv4"]&.value; end
-      # Gets the value of `saddr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::SaddrIpv6
       def saddr_ipv6; attributes[:"saddr_ipv6"]&.value; end
     end
     # Delete metrics.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoDelRequest < ::Nl::Protocols::Genl::Message
+    class DoDelRequest < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::TcpMetrics
       ATTRIBUTES = Ractor.make_shareable(%i[addr_ipv4 addr_ipv6 saddr_ipv4 saddr_ipv6])
-      # Gets the value of `addr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::AddrIpv4
       def addr_ipv4; attributes[:"addr_ipv4"]&.value; end
-      # Gets the value of `addr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::AddrIpv6
       def addr_ipv6; attributes[:"addr_ipv6"]&.value; end
-      # Gets the value of `saddr-ipv4` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::TcpMetrics::SaddrIpv4
       def saddr_ipv4; attributes[:"saddr_ipv4"]&.value; end
-      # Gets the value of `saddr-ipv6` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::TcpMetrics::SaddrIpv6
       def saddr_ipv6; attributes[:"saddr_ipv6"]&.value; end
     end
   end
   module Notifications
   end
+  # @private
   NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Retrieve metrics.
-  #--
   # @rbs (?addr_ipv4: ::Integer, ?addr_ipv6: ::String, ?saddr_ipv4: ::Integer, ?saddr_ipv6: ::String) -> Messages::DoGetReply
+  # @param [Hash] args
+  # @option args [Integer] addr_ipv4
+  # @option args [String] addr_ipv6
+  # @option args [Integer] saddr_ipv4
+  # @option args [String] saddr_ipv6
+  # @return [Messages::DoGetReply]
+  # @see Messages::DoGetRequest
   def do_get(**args)
     exchange_message(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
   end
   # Retrieve metrics.
-  #--
-  # @rbs () -> Enumerable[Messages::DumpGetReply]
+  # @rbs () -> Array[Messages::DumpGetReply]
   #   | () { (Messages::DumpGetReply) -> void } -> void
+  # @overload dump_get(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @return [Array<Messages::DumpGetReply>]
+  # @overload dump_get(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @yieldparam [Messages::DumpGetReply] reply
+  #   @return [void]
+  # @see Messages::DumpGetRequest
   def dump_get(**args, &block)
     exchange_message(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args, &block)
   end
   # Delete metrics.
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?addr_ipv4: ::Integer, ?addr_ipv6: ::String, ?saddr_ipv4: ::Integer, ?saddr_ipv6: ::String) -> void
+  # @param [Hash] args
+  # @option args [Integer] addr_ipv4
+  # @option args [String] addr_ipv6
+  # @option args [Integer] saddr_ipv4
+  # @option args [String] saddr_ipv6
+  # @return [void]
+  # @see Messages::DoDelRequest
   def do_del(**args)
     exchange_message(:"do", Messages::DoDelRequest, nil, args)
   end
   class AsyncOperations
-    # :nodoc:
+    # @private
     def initialize(&exchange)
       @exchange = exchange
     end
     # Retrieve metrics.
-    #--
     # @rbs (?addr_ipv4: ::Integer, ?addr_ipv6: ::String, ?saddr_ipv4: ::Integer, ?saddr_ipv6: ::String) -> ::Nl::Async::Future[Messages::DoGetReply]
+    # @param [Hash] args
+    # @option args [Integer] addr_ipv4
+    # @option args [String] addr_ipv6
+    # @option args [Integer] saddr_ipv4
+    # @option args [String] saddr_ipv6
+    # @return [Nl::Async::Future<Messages::DoGetReply>]
+    # @see Messages::DoGetRequest
     def do_get(**args)
       @exchange.call(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
     end
     # Retrieve metrics.
-    #--
     # @rbs () -> ::Nl::Async::Stream[Messages::DumpGetReply]
+    # @param [Hash] args
+    # @return [Nl::Async::Stream<Messages::DumpGetReply>]
+    # @see Messages::DumpGetRequest
     def dump_get(**args)
       @exchange.call(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args)
     end
     # Delete metrics.
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?addr_ipv4: ::Integer, ?addr_ipv6: ::String, ?saddr_ipv4: ::Integer, ?saddr_ipv6: ::String) -> ::Nl::Async::Future[void]
+    # @param [Hash] args
+    # @option args [Integer] addr_ipv4
+    # @option args [String] addr_ipv6
+    # @option args [Integer] saddr_ipv4
+    # @option args [String] saddr_ipv6
+    # @return [Nl::Async::Future<void>]
+    # @see Messages::DoDelRequest
     def do_del(**args)
       @exchange.call(:"do", Messages::DoDelRequest, nil, 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:)