nl-linux 0.3.0 → 0.4.1

data/generated/nl/linux/ovs_vport.rb

@@ -3,33 +3,63 @@
 # This file is based on Documentation/netlink/specs/ovs_vport.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
 # OVS vport configuration over generic netlink.
-class OvsVport < ::Nl::Family
+class OvsVport < ::Nl::Genl::Family
   NAME = "ovs_vport"
-  PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("ovs_vport"))
+  VERSION = 2
+  # @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 [OvsVport]
+  # @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 [OvsVport] 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({:"ovs_vport" => ::Nl::McastGroup.new("ovs_vport", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
+  module Enums
+    module VportType
+      Unspec = 0
+      Netdev = 1
+      Internal = 2
+      Gre = 3
+      Vxlan = 4
+      Geneve = 5
+    end
+  end
   module Structs
     OvsHeader = Struct.new(
       :"dp_ifindex", #: ::Integer
     )
     class OvsHeader
-      # :nodoc:
-      MEMBERS = Ractor.make_shareable({dp_ifindex: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)}) #: Hash[::Symbol, ::Nl::_DataType]
+      # @!attribute [rw] dp_ifindex
+      #   @return [Integer]
+      # @private
+      MEMBERS = Ractor.make_shareable({dp_ifindex: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)}) #: Hash[::Symbol, ::Nl::_DataType]
       # Decodes the struct.
-      #--
       # @rbs decoder: ::Nl::Decoder
       # @rbs return: instance
+      # @param [Nl::Decoder] decoder
+      # @return [self]
       def self.decode(decoder)
         self.new(*MEMBERS.map {|name, datatype| datatype.decode(decoder) })
       end
       # Encodes the struct.
-      #--
       # @rbs encoder: ::Nl::Encoder
       # @rbs return: void
+      # @param [Nl::Encoder] encoder
+      # @return [void]
       def encode(encoder)
         MEMBERS.each {|name, datatype| datatype.encode(encoder, self.public_send(name)) }
       end
@@ -45,396 +75,568 @@ class OvsVport < ::Nl::Family
       :"tx_dropped", #: ::Integer
     )
     class OvsVportStats
-      # :nodoc:
-      MEMBERS = Ractor.make_shareable({rx_packets: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_packets: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_bytes: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_bytes: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_errors: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_errors: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_dropped: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_dropped: ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)}) #: Hash[::Symbol, ::Nl::_DataType]
+      # @!attribute [rw] rx_packets
+      #   @return [Integer]
+      # @!attribute [rw] tx_packets
+      #   @return [Integer]
+      # @!attribute [rw] rx_bytes
+      #   @return [Integer]
+      # @!attribute [rw] tx_bytes
+      #   @return [Integer]
+      # @!attribute [rw] rx_errors
+      #   @return [Integer]
+      # @!attribute [rw] tx_errors
+      #   @return [Integer]
+      # @!attribute [rw] rx_dropped
+      #   @return [Integer]
+      # @!attribute [rw] tx_dropped
+      #   @return [Integer]
+      # @private
+      MEMBERS = Ractor.make_shareable({rx_packets: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_packets: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_bytes: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_bytes: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_errors: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_errors: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), rx_dropped: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil), tx_dropped: ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)}) #: Hash[::Symbol, ::Nl::_DataType]
       # Decodes the struct.
-      #--
       # @rbs decoder: ::Nl::Decoder
       # @rbs return: instance
+      # @param [Nl::Decoder] decoder
+      # @return [self]
       def self.decode(decoder)
         self.new(*MEMBERS.map {|name, datatype| datatype.decode(decoder) })
       end
       # Encodes the struct.
-      #--
       # @rbs encoder: ::Nl::Encoder
       # @rbs return: void
+      # @param [Nl::Encoder] encoder
+      # @return [void]
       def encode(encoder)
         MEMBERS.each {|name, datatype| datatype.encode(encoder, self.public_send(name)) }
       end
     end
   end
   module AttributeSets
-    class VportOptions < ::Nl::Protocols::Genl::AttributeSet
+    class VportOptions < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class DstPort < Attribute
         TYPE = 1
         NAME = :"dst_port"
-        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
       class Extension < Attribute
         TYPE = 2
         NAME = :"extension"
-        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({:"dst_port" => DstPort, :"extension" => Extension}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => DstPort, 2 => Extension}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see DstPort
+      def dst_port; self[:"dst_port"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Extension
+      def extension; self[:"extension"]&.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 UpcallStats < ::Nl::Protocols::Genl::AttributeSet
+    class UpcallStats < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class Success < Attribute
         TYPE = 0
         NAME = :"success"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
       end
       class Fail < Attribute
         TYPE = 1
         NAME = :"fail"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U64, check: nil)
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"success" => Success, :"fail" => Fail}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({0 => Success, 1 => Fail}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Success
+      def success; self[:"success"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Fail
+      def fail; self[:"fail"]&.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 Vport < ::Nl::Protocols::Genl::AttributeSet
+    class Vport < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class PortNo < Attribute
         TYPE = 1
         NAME = :"port_no"
-        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
+      # Known enum values are defined in {Enums::VportType}.
       class Type < Attribute
         TYPE = 2
         NAME = :"type"
-        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 Name < Attribute
         TYPE = 3
         NAME = :"name"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::String.new(check: nil)
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::String.new(check: nil)
       end
       class Options < Attribute
         TYPE = 4
         NAME = :"options"
+        # @private
+        ORDER = 3
       end
       class UpcallPid < Attribute
         TYPE = 5
         NAME = :"upcall_pid"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: nil)
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::PackedArray.new(::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil), check: nil)
       end
       class Stats < Attribute
         TYPE = 6
         NAME = :"stats"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: nil)
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::Struct.new(Structs::OvsVportStats, check: nil, consume_remaining: true)
       end
       class Ifindex < Attribute
         TYPE = 8
         NAME = :"ifindex"
-        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
       class Netnsid < Attribute
         TYPE = 9
         NAME = :"netnsid"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        # @private
+        ORDER = 7
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
       class UpcallStats < Attribute
         TYPE = 10
         NAME = :"upcall_stats"
+        # @private
+        ORDER = 8
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"port_no" => PortNo, :"type" => Type, :"name" => Name, :"options" => Options, :"upcall_pid" => UpcallPid, :"stats" => Stats, :"ifindex" => Ifindex, :"netnsid" => Netnsid, :"upcall_stats" => UpcallStats}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => PortNo, 2 => Type, 3 => Name, 4 => Options, 5 => UpcallPid, 6 => Stats, 8 => Ifindex, 9 => Netnsid, 10 => UpcallStats}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see PortNo
+      def port_no; self[:"port_no"]&.value; end
+      # Known enum values are defined in {Enums::VportType}.
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Type
+      def type; self[:"type"]&.value; end
+      # @rbs return: ::String
+      # @return [String]
+      # @see Name
+      def name; self[:"name"]&.value; end
+      # @rbs return: AttributeSets::VportOptions
+      # @return [AttributeSets::VportOptions]
+      # @see Options
+      def options; self[:"options"]&.value; end
+      # @rbs return: ::Array[::Integer]
+      # @return [Array<Integer>]
+      # @see UpcallPid
+      def upcall_pid; self[:"upcall_pid"]&.value; end
+      # @rbs return: Structs::OvsVportStats
+      # @return [Structs::OvsVportStats]
+      # @see Stats
+      def stats; self[:"stats"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Netnsid
+      def netnsid; self[:"netnsid"]&.value; end
+      # @rbs return: AttributeSets::UpcallStats
+      # @return [AttributeSets::UpcallStats]
+      # @see UpcallStats
+      def upcall_stats; self[:"upcall_stats"]&.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
-    Vport::Options::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(VportOptions)
-    Vport::UpcallStats::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(UpcallStats)
+    # @private
+    Vport::Options::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::VportOptions, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    Vport::UpcallStats::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::UpcallStats, selector_bindings: Ractor.make_shareable([]))
   end
   module Messages
     # Create a new OVS vport
-    class DoNewRequest < ::Nl::Protocols::Genl::Message
+    class DoNewRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[type name options upcall_pid ifindex])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `type` attribute in the message.
-      #--
+      # Known enum values are defined in {Enums::VportType}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Type
       def type; attributes[:"type"]&.value; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
-      # Gets the value of `options` attribute in the message.
-      #--
       # @rbs return: AttributeSets::VportOptions
+      # @return [AttributeSets::VportOptions]
+      # @see AttributeSets::Vport::Options
       def options; attributes[:"options"]&.value; end
-      # Gets the value of `upcall-pid` attribute in the message.
-      #--
-      # @rbs return: ::String
+      # @rbs return: ::Array[::Integer]
+      # @return [Array<Integer>]
+      # @see AttributeSets::Vport::UpcallPid
       def upcall_pid; attributes[:"upcall_pid"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Delete existing OVS vport from a data path
-    class DoDelRequest < ::Nl::Protocols::Genl::Message
+    class DoDelRequest < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[port_no type name])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `port-no` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::PortNo
       def port_no; attributes[:"port_no"]&.value; end
-      # Gets the value of `type` attribute in the message.
-      #--
+      # Known enum values are defined in {Enums::VportType}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Type
       def type; attributes[:"type"]&.value; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
     end
     # Get / dump OVS vport configuration and state
-    class DoGetRequest < ::Nl::Protocols::Genl::Message
+    class DoGetRequest < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[name])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
     end
     # Get / dump OVS vport configuration and state
-    class DoGetReply < ::Nl::Protocols::Genl::Message
+    class DoGetReply < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[port_no type name upcall_pid stats ifindex netnsid upcall_stats])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `port-no` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::PortNo
       def port_no; attributes[:"port_no"]&.value; end
-      # Gets the value of `type` attribute in the message.
-      #--
+      # Known enum values are defined in {Enums::VportType}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Type
       def type; attributes[:"type"]&.value; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
-      # Gets the value of `upcall-pid` attribute in the message.
-      #--
-      # @rbs return: ::String
+      # @rbs return: ::Array[::Integer]
+      # @return [Array<Integer>]
+      # @see AttributeSets::Vport::UpcallPid
       def upcall_pid; attributes[:"upcall_pid"]&.value; end
-      # Gets the value of `stats` attribute in the message.
-      #--
-      # @rbs return: ::String
+      # @rbs return: Structs::OvsVportStats
+      # @return [Structs::OvsVportStats]
+      # @see AttributeSets::Vport::Stats
       def stats; attributes[:"stats"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `netnsid` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Netnsid
       def netnsid; attributes[:"netnsid"]&.value; end
-      # Gets the value of `upcall-stats` attribute in the message.
-      #--
       # @rbs return: AttributeSets::UpcallStats
+      # @return [AttributeSets::UpcallStats]
+      # @see AttributeSets::Vport::UpcallStats
       def upcall_stats; attributes[:"upcall_stats"]&.value; end
     end
     # Get / dump OVS vport configuration and state
-    class DumpGetRequest < ::Nl::Protocols::Genl::Message
+    class DumpGetRequest < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[name])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
     end
     # Get / dump OVS vport configuration and state
-    class DumpGetReply < ::Nl::Protocols::Genl::Message
+    class DumpGetReply < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = Structs::OvsHeader
       ATTRIBUTE_SET = AttributeSets::Vport
       ATTRIBUTES = Ractor.make_shareable(%i[port_no type name upcall_pid stats ifindex netnsid upcall_stats])
-      # Gets the value of `dp-ifindex` field in the message's fixed header.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
       def dp_ifindex; fixed_header.dp_ifindex; end
-      # Gets the value of `port-no` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::PortNo
       def port_no; attributes[:"port_no"]&.value; end
-      # Gets the value of `type` attribute in the message.
-      #--
+      # Known enum values are defined in {Enums::VportType}.
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Type
       def type; attributes[:"type"]&.value; end
-      # Gets the value of `name` attribute in the message.
-      #--
       # @rbs return: ::String
+      # @return [String]
+      # @see AttributeSets::Vport::Name
       def name; attributes[:"name"]&.value; end
-      # Gets the value of `upcall-pid` attribute in the message.
-      #--
-      # @rbs return: ::String
+      # @rbs return: ::Array[::Integer]
+      # @return [Array<Integer>]
+      # @see AttributeSets::Vport::UpcallPid
       def upcall_pid; attributes[:"upcall_pid"]&.value; end
-      # Gets the value of `stats` attribute in the message.
-      #--
-      # @rbs return: ::String
+      # @rbs return: Structs::OvsVportStats
+      # @return [Structs::OvsVportStats]
+      # @see AttributeSets::Vport::Stats
       def stats; attributes[:"stats"]&.value; end
-      # Gets the value of `ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Ifindex
       def ifindex; attributes[:"ifindex"]&.value; end
-      # Gets the value of `netnsid` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Vport::Netnsid
       def netnsid; attributes[:"netnsid"]&.value; end
-      # Gets the value of `upcall-stats` attribute in the message.
-      #--
       # @rbs return: AttributeSets::UpcallStats
+      # @return [AttributeSets::UpcallStats]
+      # @see AttributeSets::Vport::UpcallStats
       def upcall_stats; attributes[:"upcall_stats"]&.value; end
     end
   end
   module Notifications
   end
+  # @private
   NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Create a new OVS vport
-  #--
-  # @rbs (?dp_ifindex: ::Integer, ?type: ::Integer, ?name: ::String, ?options: AttributeSets::VportOptions, ?upcall_pid: ::String, ?ifindex: ::Integer) -> void
+  # @rbs (?dp_ifindex: ::Integer, ?type: ::Integer, ?name: ::String, ?options: (AttributeSets::VportOptions | ::Hash[::Symbol, untyped]), ?upcall_pid: ::Array[::Integer], ?ifindex: ::Integer) -> void
+  # @param [Hash] args
+  # @option args [Integer] dp_ifindex
+  # @option args [Integer] type Known enum values are defined in {Enums::VportType}.
+  # @option args [String] name
+  # @option args [AttributeSets::VportOptions, Hash<Symbol, Object>] options
+  # @option args [Array<Integer>] upcall_pid
+  # @option args [Integer] ifindex
+  # @return [void]
+  # @see Messages::DoNewRequest
   def do_new(**args)
     exchange_message(:"do", Messages::DoNewRequest, nil, args)
   end
   # Delete existing OVS vport from a data path
-  #--
   # @rbs (?dp_ifindex: ::Integer, ?port_no: ::Integer, ?type: ::Integer, ?name: ::String) -> void
+  # @param [Hash] args
+  # @option args [Integer] dp_ifindex
+  # @option args [Integer] port_no
+  # @option args [Integer] type Known enum values are defined in {Enums::VportType}.
+  # @option args [String] name
+  # @return [void]
+  # @see Messages::DoDelRequest
   def do_del(**args)
     exchange_message(:"do", Messages::DoDelRequest, nil, args)
   end
   # Get / dump OVS vport configuration and state
-  #--
   # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> Messages::DoGetReply
+  # @param [Hash] args
+  # @option args [Integer] dp_ifindex
+  # @option args [String] name
+  # @return [Messages::DoGetReply]
+  # @see Messages::DoGetRequest
   def do_get(**args)
     exchange_message(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
   end
   # Get / dump OVS vport configuration and state
-  #--
-  # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> Enumerable[Messages::DumpGetReply]
+  # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> Array[Messages::DumpGetReply]
   #   | (?dp_ifindex: ::Integer, ?name: ::String) { (Messages::DumpGetReply) -> void } -> void
+  # @overload dump_get(**args)
+  #   Returns an array when no block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] dp_ifindex
+  #   @option args [String] name
+  #   @return [Array<Messages::DumpGetReply>]
+  # @overload dump_get(**args, &block)
+  #   Yields each reply when a block is given.
+  #   @param [Hash] args
+  #   @option args [Integer] dp_ifindex
+  #   @option args [String] name
+  #   @yieldparam [Messages::DumpGetReply] reply
+  #   @return [void]
+  # @see Messages::DumpGetRequest
   def dump_get(**args, &block)
     exchange_message(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args, &block)
   end
   class AsyncOperations
-    # :nodoc:
+    # @private
     def initialize(&exchange)
       @exchange = exchange
     end
     # Create a new OVS vport
-    #--
-    # @rbs (?dp_ifindex: ::Integer, ?type: ::Integer, ?name: ::String, ?options: AttributeSets::VportOptions, ?upcall_pid: ::String, ?ifindex: ::Integer) -> ::Nl::Async::Future[void]
+    # @rbs (?dp_ifindex: ::Integer, ?type: ::Integer, ?name: ::String, ?options: (AttributeSets::VportOptions | ::Hash[::Symbol, untyped]), ?upcall_pid: ::Array[::Integer], ?ifindex: ::Integer) -> ::Nl::Async::Future[void]
+    # @param [Hash] args
+    # @option args [Integer] dp_ifindex
+    # @option args [Integer] type Known enum values are defined in {Enums::VportType}.
+    # @option args [String] name
+    # @option args [AttributeSets::VportOptions, Hash<Symbol, Object>] options
+    # @option args [Array<Integer>] upcall_pid
+    # @option args [Integer] ifindex
+    # @return [Nl::Async::Future<void>]
+    # @see Messages::DoNewRequest
     def do_new(**args)
       @exchange.call(:"do", Messages::DoNewRequest, nil, args)
     end
     # Delete existing OVS vport from a data path
-    #--
     # @rbs (?dp_ifindex: ::Integer, ?port_no: ::Integer, ?type: ::Integer, ?name: ::String) -> ::Nl::Async::Future[void]
+    # @param [Hash] args
+    # @option args [Integer] dp_ifindex
+    # @option args [Integer] port_no
+    # @option args [Integer] type Known enum values are defined in {Enums::VportType}.
+    # @option args [String] name
+    # @return [Nl::Async::Future<void>]
+    # @see Messages::DoDelRequest
     def do_del(**args)
       @exchange.call(:"do", Messages::DoDelRequest, nil, args)
     end
     # Get / dump OVS vport configuration and state
-    #--
     # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> ::Nl::Async::Future[Messages::DoGetReply]
+    # @param [Hash] args
+    # @option args [Integer] dp_ifindex
+    # @option args [String] name
+    # @return [Nl::Async::Future<Messages::DoGetReply>]
+    # @see Messages::DoGetRequest
     def do_get(**args)
       @exchange.call(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
     end
     # Get / dump OVS vport configuration and state
-    #--
     # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> ::Nl::Async::Stream[Messages::DumpGetReply]
+    # @param [Hash] args
+    # @option args [Integer] dp_ifindex
+    # @option args [String] name
+    # @return [Nl::Async::Stream<Messages::DumpGetReply>]
+    # @see Messages::DumpGetRequest
     def dump_get(**args)
       @exchange.call(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, 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 (*(:ovs_vport) groups) -> self
+  # @param [Array<:ovs_vport>] groups
+  # @return [self]
   def subscribe(*groups) = super
-  #--
   # @rbs (*(:ovs_vport) groups) -> self
+  # @param [Array<:ovs_vport>] groups
+  # @return [self]
   def unsubscribe(*groups) = super
 end
 end; end