nl-linux 0.2.4 → 0.3.0

data/generated/nl/linux/drm_ras.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/drm_ras.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
 # rbs_inline: enabled
@@ -9,6 +11,7 @@ module Nl; module Linux
 class DrmRas < ::Nl::Family
   NAME = "drm-ras"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("drm-ras"))
+  MCAST_GROUPS = Ractor.make_shareable({}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
   end
   module AttributeSets
@@ -97,6 +100,17 @@ class DrmRas < ::Nl::Family
   end
   module Messages
     # Retrieve the full list of currently registered DRM RAS nodes. Each node includes its dynamically assigned ID, name, and type. **Important:** User space must call this operation first to obtain the node IDs. These IDs are required for all subsequent operations on nodes, such as querying error counters.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    class DumpListNodesRequest < ::Nl::Protocols::Genl::Message
+      TYPE = 1
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::NodeAttrs
+      ATTRIBUTES = Ractor.make_shareable(%i[])
+    end
+    # Retrieve the full list of currently registered DRM RAS nodes. Each node includes its dynamically assigned ID, name, and type. **Important:** User space must call this operation first to obtain the node IDs. These IDs are required for all subsequent operations on nodes, such as querying error counters.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DumpListNodesReply < ::Nl::Protocols::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
@@ -120,6 +134,8 @@ class DrmRas < ::Nl::Family
       def node_type; attributes[:"node_type"]&.value; end
     end
     # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoGetErrorCounterRequest < ::Nl::Protocols::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
@@ -135,6 +151,8 @@ class DrmRas < ::Nl::Family
       def error_id; attributes[:"error_id"]&.value; end
     end
     # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoGetErrorCounterReply < ::Nl::Protocols::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
@@ -154,6 +172,8 @@ class DrmRas < ::Nl::Family
       def error_value; attributes[:"error_value"]&.value; end
     end
     # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DumpGetErrorCounterRequest < ::Nl::Protocols::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
@@ -165,6 +185,8 @@ class DrmRas < ::Nl::Family
       def node_id; attributes[:"node_id"]&.value; end
     end
     # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DumpGetErrorCounterReply < ::Nl::Protocols::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
@@ -184,6 +206,8 @@ class DrmRas < ::Nl::Family
       def error_value; attributes[:"error_value"]&.value; end
     end
     # Clear error counter for a given node. The request includes the error-id and node-id of the counter to be cleared.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoClearErrorCounterRequest < ::Nl::Protocols::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
@@ -199,13 +223,29 @@ class DrmRas < ::Nl::Family
       def error_id; attributes[:"error_id"]&.value; end
     end
   end
+  module Notifications
+  end
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
+  # Retrieve the full list of currently registered DRM RAS nodes. Each node includes its dynamically assigned ID, name, and type. **Important:** User space must call this operation first to obtain the node IDs. These IDs are required for all subsequent operations on nodes, such as querying error counters.
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
+  #--
+  # @rbs () -> Enumerable[Messages::DumpListNodesReply]
+  #   | () { (Messages::DumpListNodesReply) -> void } -> void
+  def dump_list_nodes(**args, &block)
+    exchange_message(:"dump", Messages::DumpListNodesRequest, Messages::DumpListNodesReply, args, &block)
+  end
   # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?node_id: ::Integer, ?error_id: ::Integer) -> Messages::DoGetErrorCounterReply
   def do_get_error_counter(**args)
     exchange_message(:"do", Messages::DoGetErrorCounterRequest, Messages::DoGetErrorCounterReply, args)
   end
   # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?node_id: ::Integer) -> Enumerable[Messages::DumpGetErrorCounterReply]
   #   | (?node_id: ::Integer) { (Messages::DumpGetErrorCounterReply) -> void } -> void
@@ -213,10 +253,57 @@ class DrmRas < ::Nl::Family
     exchange_message(:"dump", Messages::DumpGetErrorCounterRequest, Messages::DumpGetErrorCounterReply, args, &block)
   end
   # Clear error counter for a given node. The request includes the error-id and node-id of the counter to be cleared.
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?node_id: ::Integer, ?error_id: ::Integer) -> void
   def do_clear_error_counter(**args)
     exchange_message(:"do", Messages::DoClearErrorCounterRequest, nil, args)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Retrieve the full list of currently registered DRM RAS nodes. Each node includes its dynamically assigned ID, name, and type. **Important:** User space must call this operation first to obtain the node IDs. These IDs are required for all subsequent operations on nodes, such as querying error counters.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs () -> ::Nl::Async::Stream[Messages::DumpListNodesReply]
+    def dump_list_nodes(**args)
+      @exchange.call(:"dump", Messages::DumpListNodesRequest, Messages::DumpListNodesReply, args)
+    end
+    # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?node_id: ::Integer, ?error_id: ::Integer) -> ::Nl::Async::Future[Messages::DoGetErrorCounterReply]
+    def do_get_error_counter(**args)
+      @exchange.call(:"do", Messages::DoGetErrorCounterRequest, Messages::DoGetErrorCounterReply, args)
+    end
+    # Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?node_id: ::Integer) -> ::Nl::Async::Stream[Messages::DumpGetErrorCounterReply]
+    def dump_get_error_counter(**args)
+      @exchange.call(:"dump", Messages::DumpGetErrorCounterRequest, Messages::DumpGetErrorCounterReply, args)
+    end
+    # Clear error counter for a given node. The request includes the error-id and node-id of the counter to be cleared.
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?node_id: ::Integer, ?error_id: ::Integer) -> ::Nl::Async::Future[void]
+    def do_clear_error_counter(**args)
+      @exchange.call(:"do", Messages::DoClearErrorCounterRequest, nil, 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