nl-linux 0.2.4 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1bea36721f23b526f593ceee10b7fbe2c420e511a3574e49134982af1d354ee2
-  data.tar.gz: 07b51dcce909e7df313cd4bbef6eeaa8d1bbae82ed36258d75dc0f4bbd9f845d
+  metadata.gz: bed490a59c8ebdc1b573ff996f21f9ae4acaa976c62de168cd7de56f9f511988
+  data.tar.gz: 8b03bb15adf2e682ec3735fcd2d8a6f23a9c4bb45d4203bb2d66410db2cdd11d
 SHA512:
-  metadata.gz: a3155f82614682291afe91ebe8d59858888fd25c7a12ce45d19b323a06463f78e301194303a4b378ca80b17d4c9f22fbc4a9388823b9066470afb8bc101c150a
-  data.tar.gz: aef40e37d4591c13f65cdb02ab7bb9963dda593be5a726981bd267b48170e312257d1e2ab02a1806089cf77ec6b522840ee77caff660e44b2b10d3b77e5f2a53
+  metadata.gz: a60acb7de13c1b9bc3e56a0f3da1433e7747a9071e67df099dd7375d5a0d030bb8b5099ea250f2e7e9263039828a28fc42270ec867b1c3df0d18969e57ac81bd
+  data.tar.gz: bf8ed664a1561663de0321703e9a89251ef794f360415d17762f5cb9d1357b48e757f23be782038b0922389e16b8bd69453c795c2ef2c786ee6d10b7ca4b214e

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## v0.3.0 (2026-09-01)
+
 ## v0.2.4 (2026-08-22)
 
 - Update kernel YNL specification from Linux 7.2.

data/Rakefile

@@ -1,5 +1,8 @@
 require 'rspec/core/rake_task'
 
+NLSPEC_PATH = 'Documentation/netlink/specs'
+NLSPEC_VERSION = File.read('NLSPEC_VERSION').chomp
+
 RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
@@ -20,13 +23,20 @@ end
 specs.each do |spec, h|
   h => {source:, target:}
   task :generate => target
-  task target => [source, 'generated/nl/linux'] do
+  task target => [source, 'generated/nl/linux', 'NLSPEC_VERSION', 'Rakefile'] do
     require 'ynl'
     File.open(source, 'r') do |src|
-      front = src.readlines.take_while {|l| !l.start_with?('---') }.grep(/\A\#/).join
+      comments = src.readlines.take_while {|l| !l.start_with?('---') }.grep(/\A\#/)
 
       File.open(target, 'w') do |out|
-        out << front
+        out << comments.shift
+        out << "#\n"
+        out << "# This file is based on #{NLSPEC_PATH}/#{spec} from Linux v#{NLSPEC_VERSION}.\n"
+        unless comments.empty?
+          out << "#\n"
+          out << "# Original YNL comment:\n"
+          out << comments.join
+        end
         out << "#--\n"
         out << Ynl::Generator::PRELUDE
         out << "module Nl; module Linux\n"

data/generated/nl/linux/binder.rb

@@ -1,5 +1,9 @@
 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
 #
+# This file is based on Documentation/netlink/specs/binder.yaml from Linux v7.2.
+#
+# Original YNL comment:
+#
 # Copyright 2025 Google LLC
 #
 #--
@@ -12,6 +16,7 @@ module Nl; module Linux
 class Binder < ::Nl::Family
   NAME = "binder"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("binder"))
+  MCAST_GROUPS = Ractor.make_shareable({:"report" => ::Nl::McastGroup.new("report", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
   end
   module AttributeSets
@@ -92,5 +97,80 @@ class Binder < ::Nl::Family
   end
   module Messages
   end
+  module Notifications
+    # A multicast event sent to userspace subscribers to notify them about
+    # binder transaction failures. The generated report provides the full
+    # details of the specific transaction that failed. The intention is for
+    # programs to monitor these events and react to the failures as needed.
+    # 
+    # 
+    # Multicast group: `report`.
+    class Report < ::Nl::Protocols::Genl::Message
+      TYPE = 1
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::Report
+      ATTRIBUTES = Ractor.make_shareable(%i[error context from_pid from_tid to_pid to_tid is_reply flags code data_size])
+      # Gets the value of `error` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def error; attributes[:"error"]&.value; end
+      # Gets the value of `context` attribute in the message.
+      #--
+      # @rbs return: ::String
+      def context; attributes[:"context"]&.value; end
+      # Gets the value of `from-pid` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def from_pid; attributes[:"from_pid"]&.value; end
+      # Gets the value of `from-tid` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def from_tid; attributes[:"from_tid"]&.value; end
+      # Gets the value of `to-pid` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def to_pid; attributes[:"to_pid"]&.value; end
+      # Gets the value of `to-tid` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def to_tid; attributes[:"to_tid"]&.value; end
+      # Gets the value of `is-reply` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def is_reply; attributes[:"is_reply"]&.value; end
+      # Gets the value of `flags` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def flags; attributes[:"flags"]&.value; end
+      # Gets the value of `code` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def code; attributes[:"code"]&.value; end
+      # Gets the value of `data-size` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def data_size; attributes[:"data_size"]&.value; end
+    end
+  end
+  NOTIFICATIONS = Ractor.make_shareable({1 => Notifications::Report}) #: Hash[::Integer, ::Class]
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    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 (*(:report) groups) -> self
+  def subscribe(*groups) = super
+  #--
+  # @rbs (*(:report) groups) -> self
+  def unsubscribe(*groups) = super
 end
 end; end

data/generated/nl/linux/conntrack.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/conntrack.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
 # rbs_inline: enabled
@@ -9,6 +11,7 @@ module Nl; module Linux
 class Conntrack < ::Nl::Family
   NAME = "conntrack"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Raw.new("conntrack", 12))
+  MCAST_GROUPS = Ractor.make_shareable({}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
     Nfgenmsg = Struct.new(
       :"nfgen_family", #: ::Integer
@@ -983,7 +986,7 @@ class Conntrack < ::Nl::Family
       def secctx; attributes[:"secctx"]&.value; end
       # Gets the value of `labels` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def labels; attributes[:"labels"]&.value; end
       # Gets the value of `synproxy` attribute in the message.
       #--
@@ -1117,7 +1120,7 @@ class Conntrack < ::Nl::Family
       def secctx; attributes[:"secctx"]&.value; end
       # Gets the value of `labels` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def labels; attributes[:"labels"]&.value; end
       # Gets the value of `synproxy` attribute in the message.
       #--
@@ -1203,6 +1206,9 @@ class Conntrack < ::Nl::Family
       def chain_toolong; attributes[:"chain_toolong"]&.value; end
     end
   end
+  module Notifications
+  end
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # get / dump entries
   #--
   # @rbs (?nfgen_family: ::Integer, ?version: ::Integer, ?res_id: ::Integer, ?tuple_orig: AttributeSets::TupleAttrs, ?tuple_reply: AttributeSets::TupleAttrs, ?zone: ::Integer) -> Messages::DoGetReply
@@ -1223,5 +1229,36 @@ class Conntrack < ::Nl::Family
   def dump_get_stats(**args, &block)
     exchange_message(:"dump", Messages::DumpGetStatsRequest, Messages::DumpGetStatsReply, args, &block)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # get / dump entries
+    #--
+    # @rbs (?nfgen_family: ::Integer, ?version: ::Integer, ?res_id: ::Integer, ?tuple_orig: AttributeSets::TupleAttrs, ?tuple_reply: AttributeSets::TupleAttrs, ?zone: ::Integer) -> ::Nl::Async::Future[Messages::DoGetReply]
+    def do_get(**args)
+      @exchange.call(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
+    end
+    # get / dump entries
+    #--
+    # @rbs (?nfgen_family: ::Integer, ?version: ::Integer, ?res_id: ::Integer, ?status: ::Integer, ?mark: ::Integer, ?zone: ::Integer, ?filter: AttributeSets::TupleAttrs) -> ::Nl::Async::Stream[Messages::DumpGetReply]
+    def dump_get(**args)
+      @exchange.call(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args)
+    end
+    # dump pcpu conntrack stats
+    #--
+    # @rbs (?nfgen_family: ::Integer, ?version: ::Integer, ?res_id: ::Integer) -> ::Nl::Async::Stream[Messages::DumpGetStatsReply]
+    def dump_get_stats(**args)
+      @exchange.call(:"dump", Messages::DumpGetStatsRequest, Messages::DumpGetStatsReply, 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

data/generated/nl/linux/dev_energymodel.rb

@@ -1,5 +1,9 @@
 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
 #
+# This file is based on Documentation/netlink/specs/dev-energymodel.yaml from Linux v7.2.
+#
+# Original YNL comment:
+#
 # Copyright (c) 2025 Valve Corporation.
 #
 #--
@@ -12,6 +16,7 @@ module Nl; module Linux
 class DevEnergymodel < ::Nl::Family
   NAME = "dev-energymodel"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("dev-energymodel"))
+  MCAST_GROUPS = Ractor.make_shareable({:"event" => ::Nl::McastGroup.new("event", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
   end
   module AttributeSets
@@ -174,6 +179,13 @@ class DevEnergymodel < ::Nl::Family
       def cpus; attributes[:"cpus"]&.value; end
     end
     # Get the list of information for all performance domains.
+    class DumpGetPerfDomainsRequest < ::Nl::Protocols::Genl::Message
+      TYPE = 1
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::PerfDomain
+      ATTRIBUTES = Ractor.make_shareable(%i[])
+    end
+    # Get the list of information for all performance domains.
     class DumpGetPerfDomainsReply < ::Nl::Protocols::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
@@ -219,17 +231,111 @@ class DevEnergymodel < ::Nl::Family
       def perf_state; attributes[:"perf_state"]&.value; end
     end
   end
+  module Notifications
+    # A performance domain is created.
+    # 
+    # Multicast group: `event`.
+    class PerfDomainCreated < ::Nl::Protocols::Genl::Message
+      TYPE = 3
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::PerfTable
+      ATTRIBUTES = Ractor.make_shareable(%i[perf_domain_id perf_state])
+      # Gets the value of `perf-domain-id` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def perf_domain_id; attributes[:"perf_domain_id"]&.value; end
+      # Gets the value of `perf-state` attribute in the message.
+      #--
+      # @rbs return: AttributeSets::PerfState
+      def perf_state; attributes[:"perf_state"]&.value; end
+    end
+    # A performance domain is updated.
+    # 
+    # Multicast group: `event`.
+    class PerfDomainUpdated < ::Nl::Protocols::Genl::Message
+      TYPE = 4
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::PerfTable
+      ATTRIBUTES = Ractor.make_shareable(%i[perf_domain_id perf_state])
+      # Gets the value of `perf-domain-id` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def perf_domain_id; attributes[:"perf_domain_id"]&.value; end
+      # Gets the value of `perf-state` attribute in the message.
+      #--
+      # @rbs return: AttributeSets::PerfState
+      def perf_state; attributes[:"perf_state"]&.value; end
+    end
+    # A performance domain is deleted.
+    # 
+    # Multicast group: `event`.
+    class PerfDomainDeleted < ::Nl::Protocols::Genl::Message
+      TYPE = 5
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::PerfTable
+      ATTRIBUTES = Ractor.make_shareable(%i[perf_domain_id])
+      # Gets the value of `perf-domain-id` attribute in the message.
+      #--
+      # @rbs return: ::Integer
+      def perf_domain_id; attributes[:"perf_domain_id"]&.value; end
+    end
+  end
+  NOTIFICATIONS = Ractor.make_shareable({3 => Notifications::PerfDomainCreated, 4 => Notifications::PerfDomainUpdated, 5 => Notifications::PerfDomainDeleted}) #: Hash[::Integer, ::Class]
   # Get the list of information for all performance domains.
   #--
   # @rbs (?perf_domain_id: ::Integer) -> Messages::DoGetPerfDomainsReply
   def do_get_perf_domains(**args)
     exchange_message(:"do", Messages::DoGetPerfDomainsRequest, Messages::DoGetPerfDomainsReply, args)
   end
+  # Get the list of information for all performance domains.
+  #--
+  # @rbs () -> Enumerable[Messages::DumpGetPerfDomainsReply]
+  #   | () { (Messages::DumpGetPerfDomainsReply) -> void } -> void
+  def dump_get_perf_domains(**args, &block)
+    exchange_message(:"dump", Messages::DumpGetPerfDomainsRequest, Messages::DumpGetPerfDomainsReply, args, &block)
+  end
   # Get the energy model table of a performance domain.
   #--
   # @rbs (?perf_domain_id: ::Integer) -> Messages::DoGetPerfTableReply
   def do_get_perf_table(**args)
     exchange_message(:"do", Messages::DoGetPerfTableRequest, Messages::DoGetPerfTableReply, args)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Get the list of information for all performance domains.
+    #--
+    # @rbs (?perf_domain_id: ::Integer) -> ::Nl::Async::Future[Messages::DoGetPerfDomainsReply]
+    def do_get_perf_domains(**args)
+      @exchange.call(:"do", Messages::DoGetPerfDomainsRequest, Messages::DoGetPerfDomainsReply, args)
+    end
+    # Get the list of information for all performance domains.
+    #--
+    # @rbs () -> ::Nl::Async::Stream[Messages::DumpGetPerfDomainsReply]
+    def dump_get_perf_domains(**args)
+      @exchange.call(:"dump", Messages::DumpGetPerfDomainsRequest, Messages::DumpGetPerfDomainsReply, args)
+    end
+    # Get the energy model table of a performance domain.
+    #--
+    # @rbs (?perf_domain_id: ::Integer) -> ::Nl::Async::Future[Messages::DoGetPerfTableReply]
+    def do_get_perf_table(**args)
+      @exchange.call(:"do", Messages::DoGetPerfTableRequest, Messages::DoGetPerfTableReply, 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 (*(:event) groups) -> self
+  def subscribe(*groups) = super
+  #--
+  # @rbs (*(:event) groups) -> self
+  def unsubscribe(*groups) = super
 end
 end; end