nl-linux 0.2.4 → 0.3.0

data/generated/nl/linux/nl80211.rb

@@ -1,4 +1,6 @@
 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
+#
+# This file is based on Documentation/netlink/specs/nl80211.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
 # rbs_inline: enabled
@@ -9,6 +11,7 @@ module Nl; module Linux
 class Nl80211 < ::Nl::Family
   NAME = "nl80211"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("nl80211"))
+  MCAST_GROUPS = Ractor.make_shareable({:"config" => ::Nl::McastGroup.new("config", nil), :"scan" => ::Nl::McastGroup.new("scan", nil), :"regulatory" => ::Nl::McastGroup.new("regulatory", nil), :"mlme" => ::Nl::McastGroup.new("mlme", nil), :"vendor" => ::Nl::McastGroup.new("vendor", nil), :"nan" => ::Nl::McastGroup.new("nan", nil), :"testmode" => ::Nl::McastGroup.new("testmode", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
     StaFlagUpdate = Struct.new(
       :"mask", #: ::Integer
@@ -2781,7 +2784,7 @@ class Nl80211 < ::Nl::Family
       def wiphy_name; attributes[:"wiphy_name"]&.value; end
       # Gets the value of `mac` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def mac; attributes[:"mac"]&.value; end
       # Gets the value of `wiphy-bands` attribute in the message.
       #--
@@ -2801,7 +2804,7 @@ class Nl80211 < ::Nl::Family
       def generation; attributes[:"generation"]&.value; end
       # Gets the value of `supported-commands` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[::Integer]
       def supported_commands; attributes[:"supported_commands"]&.value; end
       # Gets the value of `max-scan-ie-len` attribute in the message.
       #--
@@ -2809,7 +2812,7 @@ class Nl80211 < ::Nl::Family
       def max_scan_ie_len; attributes[:"max_scan_ie_len"]&.value; end
       # Gets the value of `cipher-suites` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def cipher_suites; attributes[:"cipher_suites"]&.value; end
       # Gets the value of `wiphy-retry-short` attribute in the message.
       #--
@@ -2877,7 +2880,7 @@ class Nl80211 < ::Nl::Family
       def wowlan_triggers_supported; attributes[:"wowlan_triggers_supported"]&.value; end
       # Gets the value of `interface-combinations` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::IfCombinationAttributes]
       def interface_combinations; attributes[:"interface_combinations"]&.value; end
       # Gets the value of `software-iftypes` attribute in the message.
       #--
@@ -2913,19 +2916,19 @@ class Nl80211 < ::Nl::Family
       def feature_flags; attributes[:"feature_flags"]&.value; end
       # Gets the value of `ht-capability-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ht_capability_mask; attributes[:"ht_capability_mask"]&.value; end
       # Gets the value of `ext-capa` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_capa; attributes[:"ext_capa"]&.value; end
       # Gets the value of `ext-capa-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_capa_mask; attributes[:"ext_capa_mask"]&.value; end
       # Gets the value of `vht-capability-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def vht_capability_mask; attributes[:"vht_capability_mask"]&.value; end
       # Gets the value of `max-csa-counters` attribute in the message.
       #--
@@ -2933,7 +2936,7 @@ class Nl80211 < ::Nl::Family
       def max_csa_counters; attributes[:"max_csa_counters"]&.value; end
       # Gets the value of `ext-features` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_features; attributes[:"ext_features"]&.value; end
       # Gets the value of `max-num-sched-scan-plans` attribute in the message.
       #--
@@ -2977,7 +2980,7 @@ class Nl80211 < ::Nl::Family
       def sar_spec; attributes[:"sar_spec"]&.value; end
       # Gets the value of `max-num-akm-suites` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def max_num_akm_suites; attributes[:"max_num_akm_suites"]&.value; end
     end
     # Get information about a wiphy or dump a list of all wiphys. Requests to
@@ -3023,7 +3026,7 @@ class Nl80211 < ::Nl::Family
       def wiphy_name; attributes[:"wiphy_name"]&.value; end
       # Gets the value of `mac` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def mac; attributes[:"mac"]&.value; end
       # Gets the value of `wiphy-bands` attribute in the message.
       #--
@@ -3043,7 +3046,7 @@ class Nl80211 < ::Nl::Family
       def generation; attributes[:"generation"]&.value; end
       # Gets the value of `supported-commands` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[::Integer]
       def supported_commands; attributes[:"supported_commands"]&.value; end
       # Gets the value of `max-scan-ie-len` attribute in the message.
       #--
@@ -3051,7 +3054,7 @@ class Nl80211 < ::Nl::Family
       def max_scan_ie_len; attributes[:"max_scan_ie_len"]&.value; end
       # Gets the value of `cipher-suites` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def cipher_suites; attributes[:"cipher_suites"]&.value; end
       # Gets the value of `wiphy-retry-short` attribute in the message.
       #--
@@ -3119,7 +3122,7 @@ class Nl80211 < ::Nl::Family
       def wowlan_triggers_supported; attributes[:"wowlan_triggers_supported"]&.value; end
       # Gets the value of `interface-combinations` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::IfCombinationAttributes]
       def interface_combinations; attributes[:"interface_combinations"]&.value; end
       # Gets the value of `software-iftypes` attribute in the message.
       #--
@@ -3155,19 +3158,19 @@ class Nl80211 < ::Nl::Family
       def feature_flags; attributes[:"feature_flags"]&.value; end
       # Gets the value of `ht-capability-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ht_capability_mask; attributes[:"ht_capability_mask"]&.value; end
       # Gets the value of `ext-capa` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_capa; attributes[:"ext_capa"]&.value; end
       # Gets the value of `ext-capa-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_capa_mask; attributes[:"ext_capa_mask"]&.value; end
       # Gets the value of `vht-capability-mask` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def vht_capability_mask; attributes[:"vht_capability_mask"]&.value; end
       # Gets the value of `max-csa-counters` attribute in the message.
       #--
@@ -3175,7 +3178,7 @@ class Nl80211 < ::Nl::Family
       def max_csa_counters; attributes[:"max_csa_counters"]&.value; end
       # Gets the value of `ext-features` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def ext_features; attributes[:"ext_features"]&.value; end
       # Gets the value of `max-num-sched-scan-plans` attribute in the message.
       #--
@@ -3219,7 +3222,7 @@ class Nl80211 < ::Nl::Family
       def sar_spec; attributes[:"sar_spec"]&.value; end
       # Gets the value of `max-num-akm-suites` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def max_num_akm_suites; attributes[:"max_num_akm_suites"]&.value; end
     end
     # Get information about an interface or dump a list of all interfaces
@@ -3257,7 +3260,7 @@ class Nl80211 < ::Nl::Family
       def iftype; attributes[:"iftype"]&.value; end
       # Gets the value of `mac` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def mac; attributes[:"mac"]&.value; end
       # Gets the value of `generation` attribute in the message.
       #--
@@ -3311,7 +3314,7 @@ class Nl80211 < ::Nl::Family
       def iftype; attributes[:"iftype"]&.value; end
       # Gets the value of `mac` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def mac; attributes[:"mac"]&.value; end
       # Gets the value of `generation` attribute in the message.
       #--
@@ -3353,6 +3356,9 @@ class Nl80211 < ::Nl::Family
       def protocol_features; attributes[:"protocol_features"]&.value; end
     end
   end
+  module Notifications
+  end
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Get information about a wiphy or dump a list of all wiphys. Requests to
   # dump get-wiphy should unconditionally include the split-wiphy-dump flag
   # in the request.
@@ -3389,5 +3395,58 @@ class Nl80211 < ::Nl::Family
   def do_get_protocol_features(**args)
     exchange_message(:"do", Messages::DoGetProtocolFeaturesRequest, Messages::DoGetProtocolFeaturesReply, args)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Get information about a wiphy or dump a list of all wiphys. Requests to
+    # dump get-wiphy should unconditionally include the split-wiphy-dump flag
+    # in the request.
+    #--
+    # @rbs (?wiphy: ::Integer, ?ifindex: ::Integer, ?wdev: ::Integer) -> ::Nl::Async::Future[Messages::DoGetWiphyReply]
+    def do_get_wiphy(**args)
+      @exchange.call(:"do", Messages::DoGetWiphyRequest, Messages::DoGetWiphyReply, args)
+    end
+    # Get information about a wiphy or dump a list of all wiphys. Requests to
+    # dump get-wiphy should unconditionally include the split-wiphy-dump flag
+    # in the request.
+    #--
+    # @rbs (?wiphy: ::Integer, ?ifindex: ::Integer, ?wdev: ::Integer, ?split_wiphy_dump: ::Integer) -> ::Nl::Async::Stream[Messages::DumpGetWiphyReply]
+    def dump_get_wiphy(**args)
+      @exchange.call(:"dump", Messages::DumpGetWiphyRequest, Messages::DumpGetWiphyReply, args)
+    end
+    # Get information about an interface or dump a list of all interfaces
+    #--
+    # @rbs (?ifname: ::String) -> ::Nl::Async::Future[Messages::DoGetInterfaceReply]
+    def do_get_interface(**args)
+      @exchange.call(:"do", Messages::DoGetInterfaceRequest, Messages::DoGetInterfaceReply, args)
+    end
+    # Get information about an interface or dump a list of all interfaces
+    #--
+    # @rbs (?ifname: ::String) -> ::Nl::Async::Stream[Messages::DumpGetInterfaceReply]
+    def dump_get_interface(**args)
+      @exchange.call(:"dump", Messages::DumpGetInterfaceRequest, Messages::DumpGetInterfaceReply, args)
+    end
+    # Get information about supported protocol features
+    #--
+    # @rbs (?protocol_features: ::Integer) -> ::Nl::Async::Future[Messages::DoGetProtocolFeaturesReply]
+    def do_get_protocol_features(**args)
+      @exchange.call(:"do", Messages::DoGetProtocolFeaturesRequest, Messages::DoGetProtocolFeaturesReply, args)
+    end
+  end
+  # Returns the asynchronous operation facade for this family.
+  #--
+  # @rbs (?stream_capacity: ::Integer?) -> 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 (*(:config | :scan | :regulatory | :mlme | :vendor | :nan | :testmode) groups) -> self
+  def subscribe(*groups) = super
+  #--
+  # @rbs (*(:config | :scan | :regulatory | :mlme | :vendor | :nan | :testmode) groups) -> self
+  def unsubscribe(*groups) = super
 end
 end; end

data/generated/nl/linux/nlctrl.rb

@@ -1,4 +1,6 @@
 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
+#
+# This file is based on Documentation/netlink/specs/nlctrl.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
 # rbs_inline: enabled
@@ -10,6 +12,7 @@ module Nl; module Linux
 class Nlctrl < ::Nl::Family
   NAME = "nlctrl"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("nlctrl"))
+  MCAST_GROUPS = Ractor.make_shareable({}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
   end
   module AttributeSets
@@ -256,8 +259,8 @@ class Nlctrl < ::Nl::Family
     end
     CtrlAttrs::Ops::DATATYPE = ::Nl::Protocols::Genl::DataTypes::IndexedArray.new(::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(OpAttrs))
     CtrlAttrs::McastGroups::DATATYPE = ::Nl::Protocols::Genl::DataTypes::IndexedArray.new(::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(McastGroupAttrs))
-    CtrlAttrs::Policy::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(PolicyAttrs)
-    CtrlAttrs::OpPolicy::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestedAttributes.new(OpPolicyAttrs)
+    CtrlAttrs::Policy::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestTypeValue.new(PolicyAttrs, 2)
+    CtrlAttrs::OpPolicy::DATATYPE = ::Nl::Protocols::Genl::DataTypes::NestTypeValue.new(OpPolicyAttrs, 1)
   end
   module Messages
     # Get / dump genetlink families
@@ -299,14 +302,21 @@ class Nlctrl < ::Nl::Family
       def maxattr; attributes[:"maxattr"]&.value; end
       # Gets the value of `ops` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::OpAttrs]
       def ops; attributes[:"ops"]&.value; end
       # Gets the value of `mcast-groups` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::McastGroupAttrs]
       def mcast_groups; attributes[:"mcast_groups"]&.value; end
     end
     # Get / dump genetlink families
+    class DumpGetfamilyRequest < ::Nl::Protocols::Genl::Message
+      TYPE = 3
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::CtrlAttrs
+      ATTRIBUTES = Ractor.make_shareable(%i[])
+    end
+    # Get / dump genetlink families
     class DumpGetfamilyReply < ::Nl::Protocols::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
@@ -334,11 +344,11 @@ class Nlctrl < ::Nl::Family
       def maxattr; attributes[:"maxattr"]&.value; end
       # Gets the value of `ops` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::OpAttrs]
       def ops; attributes[:"ops"]&.value; end
       # Gets the value of `mcast-groups` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::Array[AttributeSets::McastGroupAttrs]
       def mcast_groups; attributes[:"mcast_groups"]&.value; end
     end
     # Get / dump genetlink policies
@@ -372,20 +382,30 @@ class Nlctrl < ::Nl::Family
       def family_id; attributes[:"family_id"]&.value; end
       # Gets the value of `policy` attribute in the message.
       #--
-      # @rbs return: AttributeSets::PolicyAttrs
+      # @rbs return: ::Hash[::Integer, ::Hash[::Integer, AttributeSets::PolicyAttrs]]
       def policy; attributes[:"policy"]&.value; end
       # Gets the value of `op-policy` attribute in the message.
       #--
-      # @rbs return: AttributeSets::OpPolicyAttrs
+      # @rbs return: ::Hash[::Integer, AttributeSets::OpPolicyAttrs]
       def op_policy; attributes[:"op_policy"]&.value; end
     end
   end
+  module Notifications
+  end
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Get / dump genetlink families
   #--
   # @rbs (?family_name: ::String) -> Messages::DoGetfamilyReply
   def do_getfamily(**args)
     exchange_message(:"do", Messages::DoGetfamilyRequest, Messages::DoGetfamilyReply, args)
   end
+  # Get / dump genetlink families
+  #--
+  # @rbs () -> Enumerable[Messages::DumpGetfamilyReply]
+  #   | () { (Messages::DumpGetfamilyReply) -> void } -> void
+  def dump_getfamily(**args, &block)
+    exchange_message(:"dump", Messages::DumpGetfamilyRequest, Messages::DumpGetfamilyReply, args, &block)
+  end
   # Get / dump genetlink policies
   #--
   # @rbs (?family_id: ::Integer, ?family_name: ::String, ?op: ::Integer) -> Enumerable[Messages::DumpGetpolicyReply]
@@ -393,5 +413,36 @@ class Nlctrl < ::Nl::Family
   def dump_getpolicy(**args, &block)
     exchange_message(:"dump", Messages::DumpGetpolicyRequest, Messages::DumpGetpolicyReply, args, &block)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Get / dump genetlink families
+    #--
+    # @rbs (?family_name: ::String) -> ::Nl::Async::Future[Messages::DoGetfamilyReply]
+    def do_getfamily(**args)
+      @exchange.call(:"do", Messages::DoGetfamilyRequest, Messages::DoGetfamilyReply, args)
+    end
+    # Get / dump genetlink families
+    #--
+    # @rbs () -> ::Nl::Async::Stream[Messages::DumpGetfamilyReply]
+    def dump_getfamily(**args)
+      @exchange.call(:"dump", Messages::DumpGetfamilyRequest, Messages::DumpGetfamilyReply, args)
+    end
+    # Get / dump genetlink policies
+    #--
+    # @rbs (?family_id: ::Integer, ?family_name: ::String, ?op: ::Integer) -> ::Nl::Async::Stream[Messages::DumpGetpolicyReply]
+    def dump_getpolicy(**args)
+      @exchange.call(:"dump", Messages::DumpGetpolicyRequest, Messages::DumpGetpolicyReply, args)
+    end
+  end
+  # Returns the asynchronous operation facade for this family.
+  #--
+  # @rbs (?stream_capacity: ::Integer?) -> AsyncOperations
+  def async(stream_capacity: nil)
+    return @async_operations ||= build_async_facade(AsyncOperations) if stream_capacity.nil?
+    build_async_facade(AsyncOperations, stream_capacity:)
+  end
 end
 end; end