nl-linux 0.3.0 → 0.4.1

data/generated/nl/linux/team.rb

@@ -3,15 +3,35 @@
 # This file is based on Documentation/netlink/specs/team.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
 # Network team device driver.
-class Team < ::Nl::Family
+class Team < ::Nl::Genl::Family
   NAME = "team"
-  PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("team"))
+  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 [Team]
+  # @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 [Team] 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
+    STRING_MAX_LEN = 32
+    GENL_CHANGE_EVENT_MC_GRP_NAME = "change_event"
+  end
   module Structs
   end
   module AttributeSets
@@ -29,388 +49,554 @@ class Team < ::Nl::Family
     #         [TEAM_ATTR_ITEM_PORT]
     #             [TEAM_ATTR_PORT_*], ...
     #         ...
-    class Team < ::Nl::Protocols::Genl::AttributeSet
+    class Team < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class TeamIfindex < Attribute
         TYPE = 1
         NAME = :"team_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
       class ListOption < Attribute
         TYPE = 2
         NAME = :"list_option"
+        # @private
+        ORDER = 1
       end
       class ListPort < Attribute
         TYPE = 3
         NAME = :"list_port"
+        # @private
+        ORDER = 2
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"team_ifindex" => TeamIfindex, :"list_option" => ListOption, :"list_port" => ListPort}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => TeamIfindex, 2 => ListOption, 3 => ListPort}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see TeamIfindex
+      def team_ifindex; self[:"team_ifindex"]&.value; end
+      # @rbs return: AttributeSets::ItemOption
+      # @return [AttributeSets::ItemOption]
+      # @see ListOption
+      def list_option; self[:"list_option"]&.value; end
+      # @rbs return: AttributeSets::ItemPort
+      # @return [AttributeSets::ItemPort]
+      # @see ListPort
+      def list_port; self[:"list_port"]&.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 ItemOption < ::Nl::Protocols::Genl::AttributeSet
+    class ItemOption < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class Option < Attribute
         TYPE = 1
         NAME = :"option"
+        # @private
+        ORDER = 0
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"option" => Option}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Option}) #: Hash[::Integer, Attribute]
+      # @rbs return: AttributeSets::AttrOption
+      # @return [AttributeSets::AttrOption]
+      # @see Option
+      def option; self[:"option"]&.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 AttrOption < ::Nl::Protocols::Genl::AttributeSet
+    class AttrOption < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class Name < Attribute
         TYPE = 1
         NAME = :"name"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::String.new(check: -> { raise ArgumentError, "Value #{it.inspect} is longer than maximum length 32" unless it.bytesize <= 32 })
+        # @private
+        ORDER = 0
+        # @private
+        DATATYPE = ::Nl::DataTypes::String.new(check: -> { raise ArgumentError, "Value #{it.inspect} is longer than maximum length #{Constants::STRING_MAX_LEN}" unless it.bytesize <= Constants::STRING_MAX_LEN })
       end
       class Changed < Attribute
         TYPE = 2
         NAME = :"changed"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
       class Type < Attribute
         TYPE = 3
         NAME = :"type"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U8, check: nil)
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U8, check: nil)
       end
       class Data < Attribute
         TYPE = 4
         NAME = :"data"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: nil)
+        # @private
+        ORDER = 3
+        # @private
+        DATATYPE = ::Nl::DataTypes::Binary.new(check: nil)
       end
       class Removed < Attribute
         TYPE = 5
         NAME = :"removed"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
+      # for per-port options
       class PortIfindex < Attribute
         TYPE = 6
         NAME = :"port_ifindex"
-        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
+      # for array options
       class ArrayIndex < Attribute
         TYPE = 7
         NAME = :"array_index"
-        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({:"name" => Name, :"changed" => Changed, :"type" => Type, :"data" => Data, :"removed" => Removed, :"port_ifindex" => PortIfindex, :"array_index" => ArrayIndex}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Name, 2 => Changed, 3 => Type, 4 => Data, 5 => Removed, 6 => PortIfindex, 7 => ArrayIndex}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::String
+      # @return [String]
+      # @see Name
+      def name; self[:"name"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Changed
+      def changed; self[:"changed"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Type
+      def type; self[:"type"]&.value; end
+      # @rbs return: ::String
+      # @return [String]
+      # @see Data
+      def data; self[:"data"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Removed
+      def removed; self[:"removed"]&.value; end
+      # for per-port options
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see PortIfindex
+      def port_ifindex; self[:"port_ifindex"]&.value; end
+      # for array options
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see ArrayIndex
+      def array_index; self[:"array_index"]&.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 ItemPort < ::Nl::Protocols::Genl::AttributeSet
+    class ItemPort < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       class Port < Attribute
         TYPE = 1
         NAME = :"port"
+        # @private
+        ORDER = 0
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"port" => Port}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Port}) #: Hash[::Integer, Attribute]
+      # @rbs return: AttributeSets::AttrPort
+      # @return [AttributeSets::AttrPort]
+      # @see Port
+      def port; self[:"port"]&.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 AttrPort < ::Nl::Protocols::Genl::AttributeSet
+    class AttrPort < ::Nl::AttributeSet
       # Abstract class
-      class Attribute < ::Nl::Protocols::Genl::AttributeSet::Attribute
+      class Attribute < ::Nl::AttributeSet::Attribute
       end
       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
       class Changed < Attribute
         TYPE = 2
         NAME = :"changed"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 1
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
       class Linkup < Attribute
         TYPE = 3
         NAME = :"linkup"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 2
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
       class Speed < Attribute
         TYPE = 4
         NAME = :"speed"
-        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
       class Duplex < Attribute
         TYPE = 5
         NAME = :"duplex"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U8, check: nil)
+        # @private
+        ORDER = 4
+        # @private
+        DATATYPE = ::Nl::DataTypes::Scalar.new(::Nl::Endian::Host::U8, check: nil)
       end
       class Removed < Attribute
         TYPE = 6
         NAME = :"removed"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Flag.new
+        # @private
+        ORDER = 5
+        # @private
+        DATATYPE = ::Nl::DataTypes::Flag.new
       end
-      # :nodoc:
+      # @private
       BY_NAME = Ractor.make_shareable({:"ifindex" => Ifindex, :"changed" => Changed, :"linkup" => Linkup, :"speed" => Speed, :"duplex" => Duplex, :"removed" => Removed}) #: Hash[::Symbol, Attribute]
-      # :nodoc:
+      # @private
       BY_TYPE = Ractor.make_shareable({1 => Ifindex, 2 => Changed, 3 => Linkup, 4 => Speed, 5 => Duplex, 6 => Removed}) #: Hash[::Integer, Attribute]
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Ifindex
+      def ifindex; self[:"ifindex"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Changed
+      def changed; self[:"changed"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Linkup
+      def linkup; self[:"linkup"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Speed
+      def speed; self[:"speed"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Duplex
+      def duplex; self[:"duplex"]&.value; end
+      # @rbs return: ::Integer
+      # @return [Integer]
+      # @see Removed
+      def removed; self[:"removed"]&.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
-    Team::ListOption::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(ItemOption)
-    Team::ListPort::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(ItemPort)
-    ItemOption::Option::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(AttrOption)
-    ItemPort::Port::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(AttrPort)
+    # @private
+    Team::ListOption::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::ItemOption, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    Team::ListPort::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::ItemPort, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    ItemOption::Option::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::AttrOption, selector_bindings: Ractor.make_shareable([]))
+    # @private
+    ItemPort::Port::DATATYPE = ::Nl::DataTypes::NestedAttributes.new(AttributeSets::AttrPort, selector_bindings: Ractor.make_shareable([]))
   end
   module Messages
     # No operation
-    class DoNoopRequest < ::Nl::Protocols::Genl::Message
+    class DoNoopRequest < ::Nl::Genl::Message
       TYPE = 0
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[])
     end
     # No operation
-    class DoNoopReply < ::Nl::Protocols::Genl::Message
+    class DoNoopReply < ::Nl::Genl::Message
       TYPE = 0
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
     end
     # Set team options
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoOptionsSetRequest < ::Nl::Protocols::Genl::Message
+    class DoOptionsSetRequest < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex list_option])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
-      # Gets the value of `list-option` attribute in the message.
-      #--
       # @rbs return: AttributeSets::ItemOption
+      # @return [AttributeSets::ItemOption]
+      # @see AttributeSets::Team::ListOption
       def list_option; attributes[:"list_option"]&.value; end
     end
     # Set team options
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoOptionsSetReply < ::Nl::Protocols::Genl::Message
+    class DoOptionsSetReply < ::Nl::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex list_option])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
-      # Gets the value of `list-option` attribute in the message.
-      #--
       # @rbs return: AttributeSets::ItemOption
+      # @return [AttributeSets::ItemOption]
+      # @see AttributeSets::Team::ListOption
       def list_option; attributes[:"list_option"]&.value; end
     end
     # Get team options info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoOptionsGetRequest < ::Nl::Protocols::Genl::Message
+    class DoOptionsGetRequest < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
     end
     # Get team options info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoOptionsGetReply < ::Nl::Protocols::Genl::Message
+    class DoOptionsGetReply < ::Nl::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex list_option])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
-      # Gets the value of `list-option` attribute in the message.
-      #--
       # @rbs return: AttributeSets::ItemOption
+      # @return [AttributeSets::ItemOption]
+      # @see AttributeSets::Team::ListOption
       def list_option; attributes[:"list_option"]&.value; end
     end
     # Get team ports info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoPortListGetRequest < ::Nl::Protocols::Genl::Message
+    class DoPortListGetRequest < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
     end
     # Get team ports info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    class DoPortListGetReply < ::Nl::Protocols::Genl::Message
+    class DoPortListGetReply < ::Nl::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
       ATTRIBUTE_SET = AttributeSets::Team
       ATTRIBUTES = Ractor.make_shareable(%i[team_ifindex list_port])
-      # Gets the value of `team-ifindex` attribute in the message.
-      #--
       # @rbs return: ::Integer
+      # @return [Integer]
+      # @see AttributeSets::Team::TeamIfindex
       def team_ifindex; attributes[:"team_ifindex"]&.value; end
-      # Gets the value of `list-port` attribute in the message.
-      #--
       # @rbs return: AttributeSets::ItemPort
+      # @return [AttributeSets::ItemPort]
+      # @see AttributeSets::Team::ListPort
       def list_port; attributes[:"list_port"]&.value; end
     end
   end
   module Notifications
   end
+  # @private
   NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # No operation
-  #--
   # @rbs () -> Messages::DoNoopReply
+  # @param [Hash] args
+  # @return [Messages::DoNoopReply]
+  # @see Messages::DoNoopRequest
   def do_noop(**args)
     exchange_message(:"do", Messages::DoNoopRequest, Messages::DoNoopReply, args)
   end
   # Set team options
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
-  # @rbs (?team_ifindex: ::Integer, ?list_option: AttributeSets::ItemOption) -> Messages::DoOptionsSetReply
+  # @rbs (?team_ifindex: ::Integer, ?list_option: (AttributeSets::ItemOption | ::Hash[::Symbol, untyped])) -> Messages::DoOptionsSetReply
+  # @param [Hash] args
+  # @option args [Integer] team_ifindex
+  # @option args [AttributeSets::ItemOption, Hash<Symbol, Object>] list_option
+  # @return [Messages::DoOptionsSetReply]
+  # @see Messages::DoOptionsSetRequest
   def do_options_set(**args)
     exchange_message(:"do", Messages::DoOptionsSetRequest, Messages::DoOptionsSetReply, args)
   end
   # Get team options info
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?team_ifindex: ::Integer) -> Messages::DoOptionsGetReply
+  # @param [Hash] args
+  # @option args [Integer] team_ifindex
+  # @return [Messages::DoOptionsGetReply]
+  # @see Messages::DoOptionsGetRequest
   def do_options_get(**args)
     exchange_message(:"do", Messages::DoOptionsGetRequest, Messages::DoOptionsGetReply, args)
   end
   # Get team ports info
   # 
   # Requires CAP_NET_ADMIN in the initial user namespace.
-  #--
   # @rbs (?team_ifindex: ::Integer) -> Messages::DoPortListGetReply
+  # @param [Hash] args
+  # @option args [Integer] team_ifindex
+  # @return [Messages::DoPortListGetReply]
+  # @see Messages::DoPortListGetRequest
   def do_port_list_get(**args)
     exchange_message(:"do", Messages::DoPortListGetRequest, Messages::DoPortListGetReply, args)
   end
   class AsyncOperations
-    # :nodoc:
+    # @private
     def initialize(&exchange)
       @exchange = exchange
     end
     # No operation
-    #--
     # @rbs () -> ::Nl::Async::Future[Messages::DoNoopReply]
+    # @param [Hash] args
+    # @return [Nl::Async::Future<Messages::DoNoopReply>]
+    # @see Messages::DoNoopRequest
     def do_noop(**args)
       @exchange.call(:"do", Messages::DoNoopRequest, Messages::DoNoopReply, args)
     end
     # Set team options
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
-    # @rbs (?team_ifindex: ::Integer, ?list_option: AttributeSets::ItemOption) -> ::Nl::Async::Future[Messages::DoOptionsSetReply]
+    # @rbs (?team_ifindex: ::Integer, ?list_option: (AttributeSets::ItemOption | ::Hash[::Symbol, untyped])) -> ::Nl::Async::Future[Messages::DoOptionsSetReply]
+    # @param [Hash] args
+    # @option args [Integer] team_ifindex
+    # @option args [AttributeSets::ItemOption, Hash<Symbol, Object>] list_option
+    # @return [Nl::Async::Future<Messages::DoOptionsSetReply>]
+    # @see Messages::DoOptionsSetRequest
     def do_options_set(**args)
       @exchange.call(:"do", Messages::DoOptionsSetRequest, Messages::DoOptionsSetReply, args)
     end
     # Get team options info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?team_ifindex: ::Integer) -> ::Nl::Async::Future[Messages::DoOptionsGetReply]
+    # @param [Hash] args
+    # @option args [Integer] team_ifindex
+    # @return [Nl::Async::Future<Messages::DoOptionsGetReply>]
+    # @see Messages::DoOptionsGetRequest
     def do_options_get(**args)
       @exchange.call(:"do", Messages::DoOptionsGetRequest, Messages::DoOptionsGetReply, args)
     end
     # Get team ports info
     # 
     # Requires CAP_NET_ADMIN in the initial user namespace.
-    #--
     # @rbs (?team_ifindex: ::Integer) -> ::Nl::Async::Future[Messages::DoPortListGetReply]
+    # @param [Hash] args
+    # @option args [Integer] team_ifindex
+    # @return [Nl::Async::Future<Messages::DoPortListGetReply>]
+    # @see Messages::DoPortListGetRequest
     def do_port_list_get(**args)
       @exchange.call(:"do", Messages::DoPortListGetRequest, Messages::DoPortListGetReply, 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:)