nl-linux 0.2.3 → 0.3.0

data/generated/nl/linux/ovpn.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/ovpn.yaml from Linux v7.2.
+#
+# Original YNL comment:
+#
 # Author: Antonio Quartulli <antonio@openvpn.net>
 #
 # Copyright (c) 2024-2025, OpenVPN Inc.
@@ -14,6 +18,7 @@ module Nl; module Linux
 class Ovpn < ::Nl::Family
   NAME = "ovpn"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("ovpn"))
+  MCAST_GROUPS = Ractor.make_shareable({:"peers" => ::Nl::McastGroup.new("peers", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
   end
   module AttributeSets
@@ -84,12 +89,12 @@ class Ovpn < ::Nl::Family
       class KeepaliveInterval < Attribute
         TYPE = 13
         NAME = :"keepalive_interval"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
       end
       class KeepaliveTimeout < Attribute
         TYPE = 14
         NAME = :"keepalive_timeout"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
       end
       class DelReason < Attribute
         TYPE = 15
@@ -136,10 +141,15 @@ class Ovpn < ::Nl::Family
         NAME = :"link_tx_packets"
         DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::UINT, check: nil)
       end
+      class TxId < Attribute
+        TYPE = 24
+        NAME = :"tx_id"
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 16777215" unless it <= 16777215 })
+      end
       # :nodoc:
-      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"socket" => Socket, :"socket_netnsid" => SocketNetnsid, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"local_port" => LocalPort, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout, :"del_reason" => DelReason, :"vpn_rx_bytes" => VpnRxBytes, :"vpn_tx_bytes" => VpnTxBytes, :"vpn_rx_packets" => VpnRxPackets, :"vpn_tx_packets" => VpnTxPackets, :"link_rx_bytes" => LinkRxBytes, :"link_tx_bytes" => LinkTxBytes, :"link_rx_packets" => LinkRxPackets, :"link_tx_packets" => LinkTxPackets}) #: Hash[::Symbol, Attribute]
+      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"socket" => Socket, :"socket_netnsid" => SocketNetnsid, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"local_port" => LocalPort, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout, :"del_reason" => DelReason, :"vpn_rx_bytes" => VpnRxBytes, :"vpn_tx_bytes" => VpnTxBytes, :"vpn_rx_packets" => VpnRxPackets, :"vpn_tx_packets" => VpnTxPackets, :"link_rx_bytes" => LinkRxBytes, :"link_tx_bytes" => LinkTxBytes, :"link_rx_packets" => LinkRxPackets, :"link_tx_packets" => LinkTxPackets, :"tx_id" => TxId}) #: Hash[::Symbol, Attribute]
       # :nodoc:
-      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 6 => Socket, 7 => SocketNetnsid, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 12 => LocalPort, 13 => KeepaliveInterval, 14 => KeepaliveTimeout, 15 => DelReason, 16 => VpnRxBytes, 17 => VpnTxBytes, 18 => VpnRxPackets, 19 => VpnTxPackets, 20 => LinkRxBytes, 21 => LinkTxBytes, 22 => LinkRxPackets, 23 => LinkTxPackets}) #: Hash[::Integer, Attribute]
+      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 6 => Socket, 7 => SocketNetnsid, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 12 => LocalPort, 13 => KeepaliveInterval, 14 => KeepaliveTimeout, 15 => DelReason, 16 => VpnRxBytes, 17 => VpnTxBytes, 18 => VpnRxPackets, 19 => VpnTxPackets, 20 => LinkRxBytes, 21 => LinkTxBytes, 22 => LinkRxPackets, 23 => LinkTxPackets, 24 => TxId}) #: Hash[::Integer, Attribute]
       class << self
         # Looks up Attribute class by name.
         #--
@@ -210,17 +220,22 @@ class Ovpn < ::Nl::Family
       class KeepaliveInterval < Attribute
         TYPE = 13
         NAME = :"keepalive_interval"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
       end
       class KeepaliveTimeout < Attribute
         TYPE = 14
         NAME = :"keepalive_timeout"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
+      end
+      class TxId < Attribute
+        TYPE = 24
+        NAME = :"tx_id"
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 16777215" unless it <= 16777215 })
       end
       # :nodoc:
-      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"socket" => Socket, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout}) #: Hash[::Symbol, Attribute]
+      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"socket" => Socket, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout, :"tx_id" => TxId}) #: Hash[::Symbol, Attribute]
       # :nodoc:
-      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 6 => Socket, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 13 => KeepaliveInterval, 14 => KeepaliveTimeout}) #: Hash[::Integer, Attribute]
+      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 6 => Socket, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 13 => KeepaliveInterval, 14 => KeepaliveTimeout, 24 => TxId}) #: Hash[::Integer, Attribute]
       class << self
         # Looks up Attribute class by name.
         #--
@@ -286,17 +301,22 @@ class Ovpn < ::Nl::Family
       class KeepaliveInterval < Attribute
         TYPE = 13
         NAME = :"keepalive_interval"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
       end
       class KeepaliveTimeout < Attribute
         TYPE = 14
         NAME = :"keepalive_timeout"
-        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 86400" unless it <= 86400 })
+      end
+      class TxId < Attribute
+        TYPE = 24
+        NAME = :"tx_id"
+        DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: -> { raise ArgumentError, "Value #{it.inspect} is greater than maximum 16777215" unless it <= 16777215 })
       end
       # :nodoc:
-      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout}) #: Hash[::Symbol, Attribute]
+      BY_NAME = Ractor.make_shareable({:"id" => Id, :"remote_ipv4" => RemoteIpv4, :"remote_ipv6" => RemoteIpv6, :"remote_ipv6_scope_id" => RemoteIpv6ScopeId, :"remote_port" => RemotePort, :"vpn_ipv4" => VpnIpv4, :"vpn_ipv6" => VpnIpv6, :"local_ipv4" => LocalIpv4, :"local_ipv6" => LocalIpv6, :"keepalive_interval" => KeepaliveInterval, :"keepalive_timeout" => KeepaliveTimeout, :"tx_id" => TxId}) #: Hash[::Symbol, Attribute]
       # :nodoc:
-      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 13 => KeepaliveInterval, 14 => KeepaliveTimeout}) #: Hash[::Integer, Attribute]
+      BY_TYPE = Ractor.make_shareable({1 => Id, 2 => RemoteIpv4, 3 => RemoteIpv6, 4 => RemoteIpv6ScopeId, 5 => RemotePort, 8 => VpnIpv4, 9 => VpnIpv6, 10 => LocalIpv4, 11 => LocalIpv6, 13 => KeepaliveInterval, 14 => KeepaliveTimeout, 24 => TxId}) #: Hash[::Integer, Attribute]
       class << self
         # Looks up Attribute class by name.
         #--
@@ -741,6 +761,8 @@ class Ovpn < ::Nl::Family
   end
   module Messages
     # Add a remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoPeerNewRequest < ::Nl::Protocols::Genl::Message
       TYPE = 1
       FIXED_HEADER = nil
@@ -756,6 +778,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # modify a remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoPeerSetRequest < ::Nl::Protocols::Genl::Message
       TYPE = 2
       FIXED_HEADER = nil
@@ -771,6 +795,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoPeerGetRequest < ::Nl::Protocols::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
@@ -786,6 +812,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoPeerGetReply < ::Nl::Protocols::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
@@ -797,6 +825,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DumpPeerGetRequest < ::Nl::Protocols::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
@@ -808,6 +838,8 @@ class Ovpn < ::Nl::Family
       def ifindex; attributes[:"ifindex"]&.value; end
     end
     # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DumpPeerGetReply < ::Nl::Protocols::Genl::Message
       TYPE = 3
       FIXED_HEADER = nil
@@ -819,6 +851,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # Delete existing remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoPeerDelRequest < ::Nl::Protocols::Genl::Message
       TYPE = 4
       FIXED_HEADER = nil
@@ -834,6 +868,8 @@ class Ovpn < ::Nl::Family
       def peer; attributes[:"peer"]&.value; end
     end
     # Add a cipher key for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoKeyNewRequest < ::Nl::Protocols::Genl::Message
       TYPE = 6
       FIXED_HEADER = nil
@@ -849,6 +885,8 @@ class Ovpn < ::Nl::Family
       def keyconf; attributes[:"keyconf"]&.value; end
     end
     # Retrieve non-sensitive data about peer key and cipher
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoKeyGetRequest < ::Nl::Protocols::Genl::Message
       TYPE = 7
       FIXED_HEADER = nil
@@ -864,6 +902,8 @@ class Ovpn < ::Nl::Family
       def keyconf; attributes[:"keyconf"]&.value; end
     end
     # Retrieve non-sensitive data about peer key and cipher
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoKeyGetReply < ::Nl::Protocols::Genl::Message
       TYPE = 7
       FIXED_HEADER = nil
@@ -875,6 +915,8 @@ class Ovpn < ::Nl::Family
       def keyconf; attributes[:"keyconf"]&.value; end
     end
     # Swap primary and secondary session keys for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoKeySwapRequest < ::Nl::Protocols::Genl::Message
       TYPE = 8
       FIXED_HEADER = nil
@@ -890,6 +932,8 @@ class Ovpn < ::Nl::Family
       def keyconf; attributes[:"keyconf"]&.value; end
     end
     # Delete cipher key for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
     class DoKeyDelRequest < ::Nl::Protocols::Genl::Message
       TYPE = 10
       FIXED_HEADER = nil
@@ -905,25 +949,75 @@ class Ovpn < ::Nl::Family
       def keyconf; attributes[:"keyconf"]&.value; end
     end
   end
+  module Notifications
+    # Notification about a peer being deleted
+    # 
+    # Multicast group: `peers`.
+    class PeerDelNtf < ::Nl::Protocols::Genl::Message
+      TYPE = 5
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::Ovpn
+      ATTRIBUTES = Ractor.make_shareable(%i[peer])
+      # Gets the value of `peer` attribute in the message.
+      #--
+      # @rbs return: AttributeSets::Peer
+      def peer; attributes[:"peer"]&.value; end
+    end
+    # Notification about key having exhausted its IV space and requiring renegotiation
+    # 
+    # Multicast group: `peers`.
+    class KeySwapNtf < ::Nl::Protocols::Genl::Message
+      TYPE = 9
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::OvpnKeyconfGet
+      ATTRIBUTES = Ractor.make_shareable(%i[keyconf])
+      # Gets the value of `keyconf` attribute in the message.
+      #--
+      # @rbs return: AttributeSets::Keyconf
+      def keyconf; attributes[:"keyconf"]&.value; end
+    end
+    # Notification about a peer floating (changing its remote UDP endpoint)
+    # 
+    # Multicast group: `peers`.
+    class PeerFloatNtf < ::Nl::Protocols::Genl::Message
+      TYPE = 11
+      FIXED_HEADER = nil
+      ATTRIBUTE_SET = AttributeSets::Ovpn
+      ATTRIBUTES = Ractor.make_shareable(%i[peer])
+      # Gets the value of `peer` attribute in the message.
+      #--
+      # @rbs return: AttributeSets::Peer
+      def peer; attributes[:"peer"]&.value; end
+    end
+  end
+  NOTIFICATIONS = Ractor.make_shareable({5 => Notifications::PeerDelNtf, 9 => Notifications::KeySwapNtf, 11 => Notifications::PeerFloatNtf}) #: Hash[::Integer, ::Class]
   # Add a remote peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> void
   def do_peer_new(**args)
     exchange_message(:"do", Messages::DoPeerNewRequest, nil, args)
   end
   # modify a remote peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> void
   def do_peer_set(**args)
     exchange_message(:"do", Messages::DoPeerSetRequest, nil, args)
   end
   # Retrieve data about existing remote peers (or a specific one)
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> Messages::DoPeerGetReply
   def do_peer_get(**args)
     exchange_message(:"do", Messages::DoPeerGetRequest, Messages::DoPeerGetReply, args)
   end
   # Retrieve data about existing remote peers (or a specific one)
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer) -> Enumerable[Messages::DumpPeerGetReply]
   #   | (?ifindex: ::Integer) { (Messages::DumpPeerGetReply) -> void } -> void
@@ -931,34 +1025,135 @@ class Ovpn < ::Nl::Family
     exchange_message(:"dump", Messages::DumpPeerGetRequest, Messages::DumpPeerGetReply, args, &block)
   end
   # Delete existing remote peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> void
   def do_peer_del(**args)
     exchange_message(:"do", Messages::DoPeerDelRequest, nil, args)
   end
   # Add a cipher key for a specific peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> void
   def do_key_new(**args)
     exchange_message(:"do", Messages::DoKeyNewRequest, nil, args)
   end
   # Retrieve non-sensitive data about peer key and cipher
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> Messages::DoKeyGetReply
   def do_key_get(**args)
     exchange_message(:"do", Messages::DoKeyGetRequest, Messages::DoKeyGetReply, args)
   end
   # Swap primary and secondary session keys for a specific peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> void
   def do_key_swap(**args)
     exchange_message(:"do", Messages::DoKeySwapRequest, nil, args)
   end
   # Delete cipher key for a specific peer
+  # 
+  # Requires CAP_NET_ADMIN in the initial user namespace.
   #--
   # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> void
   def do_key_del(**args)
     exchange_message(:"do", Messages::DoKeyDelRequest, nil, args)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Add a remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> ::Nl::Async::Future[void]
+    def do_peer_new(**args)
+      @exchange.call(:"do", Messages::DoPeerNewRequest, nil, args)
+    end
+    # modify a remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> ::Nl::Async::Future[void]
+    def do_peer_set(**args)
+      @exchange.call(:"do", Messages::DoPeerSetRequest, nil, args)
+    end
+    # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> ::Nl::Async::Future[Messages::DoPeerGetReply]
+    def do_peer_get(**args)
+      @exchange.call(:"do", Messages::DoPeerGetRequest, Messages::DoPeerGetReply, args)
+    end
+    # Retrieve data about existing remote peers (or a specific one)
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer) -> ::Nl::Async::Stream[Messages::DumpPeerGetReply]
+    def dump_peer_get(**args)
+      @exchange.call(:"dump", Messages::DumpPeerGetRequest, Messages::DumpPeerGetReply, args)
+    end
+    # Delete existing remote peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?peer: AttributeSets::Peer) -> ::Nl::Async::Future[void]
+    def do_peer_del(**args)
+      @exchange.call(:"do", Messages::DoPeerDelRequest, nil, args)
+    end
+    # Add a cipher key for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> ::Nl::Async::Future[void]
+    def do_key_new(**args)
+      @exchange.call(:"do", Messages::DoKeyNewRequest, nil, args)
+    end
+    # Retrieve non-sensitive data about peer key and cipher
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> ::Nl::Async::Future[Messages::DoKeyGetReply]
+    def do_key_get(**args)
+      @exchange.call(:"do", Messages::DoKeyGetRequest, Messages::DoKeyGetReply, args)
+    end
+    # Swap primary and secondary session keys for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> ::Nl::Async::Future[void]
+    def do_key_swap(**args)
+      @exchange.call(:"do", Messages::DoKeySwapRequest, nil, args)
+    end
+    # Delete cipher key for a specific peer
+    # 
+    # Requires CAP_NET_ADMIN in the initial user namespace.
+    #--
+    # @rbs (?ifindex: ::Integer, ?keyconf: AttributeSets::Keyconf) -> ::Nl::Async::Future[void]
+    def do_key_del(**args)
+      @exchange.call(:"do", Messages::DoKeyDelRequest, 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
+  #--
+  # @rbs (*(:peers) groups) -> self
+  def subscribe(*groups) = super
+  #--
+  # @rbs (*(:peers) groups) -> self
+  def unsubscribe(*groups) = super
 end
 end; end

data/generated/nl/linux/ovs_datapath.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/ovs_datapath.yaml from Linux v7.2.
 #--
 # frozen_string_literal: true
 # rbs_inline: enabled
@@ -9,6 +11,7 @@ module Nl; module Linux
 class OvsDatapath < ::Nl::Family
   NAME = "ovs_datapath"
   PROTOCOL = Ractor.make_shareable(::Nl::Protocols::Genl.new("ovs_datapath"))
+  MCAST_GROUPS = Ractor.make_shareable({:"ovs_datapath" => ::Nl::McastGroup.new("ovs_datapath", nil)}) #: Hash[::Symbol, ::Nl::McastGroup]
   module Structs
     OvsHeader = Struct.new(
       :"dp_ifindex", #: ::Integer
@@ -112,24 +115,24 @@ class OvsDatapath < ::Nl::Family
         DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
       class MasksCacheSize < Attribute
-        TYPE = 6
+        TYPE = 7
         NAME = :"masks_cache_size"
         DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
       class PerCpuPids < Attribute
-        TYPE = 7
+        TYPE = 8
         NAME = :"per_cpu_pids"
         DATATYPE = ::Nl::Protocols::Genl::DataTypes::Binary.new(check: nil)
       end
       class Ifindex < Attribute
-        TYPE = 8
+        TYPE = 9
         NAME = :"ifindex"
         DATATYPE = ::Nl::Protocols::Genl::DataTypes::Scalar.new(::Nl::Endian::Host::U32, check: nil)
       end
       # :nodoc:
       BY_NAME = Ractor.make_shareable({:"name" => Name, :"upcall_pid" => UpcallPid, :"stats" => Stats, :"megaflow_stats" => MegaflowStats, :"user_features" => UserFeatures, :"masks_cache_size" => MasksCacheSize, :"per_cpu_pids" => PerCpuPids, :"ifindex" => Ifindex}) #: Hash[::Symbol, Attribute]
       # :nodoc:
-      BY_TYPE = Ractor.make_shareable({1 => Name, 2 => UpcallPid, 3 => Stats, 4 => MegaflowStats, 5 => UserFeatures, 6 => MasksCacheSize, 7 => PerCpuPids, 8 => Ifindex}) #: Hash[::Integer, Attribute]
+      BY_TYPE = Ractor.make_shareable({1 => Name, 2 => UpcallPid, 3 => Stats, 4 => MegaflowStats, 5 => UserFeatures, 7 => MasksCacheSize, 8 => PerCpuPids, 9 => Ifindex}) #: Hash[::Integer, Attribute]
       class << self
         # Looks up Attribute class by name.
         #--
@@ -180,11 +183,11 @@ class OvsDatapath < ::Nl::Family
       def upcall_pid; attributes[:"upcall_pid"]&.value; end
       # Gets the value of `stats` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def stats; attributes[:"stats"]&.value; end
       # Gets the value of `megaflow-stats` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def megaflow_stats; attributes[:"megaflow_stats"]&.value; end
       # Gets the value of `user-features` attribute in the message.
       #--
@@ -196,7 +199,7 @@ class OvsDatapath < ::Nl::Family
       def masks_cache_size; attributes[:"masks_cache_size"]&.value; end
       # Gets the value of `per-cpu-pids` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def per_cpu_pids; attributes[:"per_cpu_pids"]&.value; end
     end
     # Get / dump OVS data path configuration and state
@@ -234,11 +237,11 @@ class OvsDatapath < ::Nl::Family
       def upcall_pid; attributes[:"upcall_pid"]&.value; end
       # Gets the value of `stats` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def stats; attributes[:"stats"]&.value; end
       # Gets the value of `megaflow-stats` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def megaflow_stats; attributes[:"megaflow_stats"]&.value; end
       # Gets the value of `user-features` attribute in the message.
       #--
@@ -250,7 +253,7 @@ class OvsDatapath < ::Nl::Family
       def masks_cache_size; attributes[:"masks_cache_size"]&.value; end
       # Gets the value of `per-cpu-pids` attribute in the message.
       #--
-      # @rbs return: untyped
+      # @rbs return: ::String
       def per_cpu_pids; attributes[:"per_cpu_pids"]&.value; end
     end
     # Create new OVS data path
@@ -292,6 +295,9 @@ class OvsDatapath < ::Nl::Family
       def name; attributes[:"name"]&.value; end
     end
   end
+  module Notifications
+  end
+  NOTIFICATIONS = Ractor.make_shareable({}) #: Hash[::Integer, ::Class]
   # Get / dump OVS data path configuration and state
   #--
   # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> Messages::DoGetReply
@@ -317,5 +323,48 @@ class OvsDatapath < ::Nl::Family
   def do_del(**args)
     exchange_message(:"do", Messages::DoDelRequest, nil, args)
   end
+  class AsyncOperations
+    # :nodoc:
+    def initialize(&exchange)
+      @exchange = exchange
+    end
+    # Get / dump OVS data path configuration and state
+    #--
+    # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> ::Nl::Async::Future[Messages::DoGetReply]
+    def do_get(**args)
+      @exchange.call(:"do", Messages::DoGetRequest, Messages::DoGetReply, args)
+    end
+    # Get / dump OVS data path configuration and state
+    #--
+    # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> ::Nl::Async::Stream[Messages::DumpGetReply]
+    def dump_get(**args)
+      @exchange.call(:"dump", Messages::DumpGetRequest, Messages::DumpGetReply, args)
+    end
+    # Create new OVS data path
+    #--
+    # @rbs (?dp_ifindex: ::Integer, ?name: ::String, ?upcall_pid: ::Integer, ?user_features: ::Integer) -> ::Nl::Async::Future[void]
+    def do_new(**args)
+      @exchange.call(:"do", Messages::DoNewRequest, nil, args)
+    end
+    # Delete existing OVS data path
+    #--
+    # @rbs (?dp_ifindex: ::Integer, ?name: ::String) -> ::Nl::Async::Future[void]
+    def do_del(**args)
+      @exchange.call(:"do", Messages::DoDelRequest, 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
+  #--
+  # @rbs (*(:ovs_datapath) groups) -> self
+  def subscribe(*groups) = super
+  #--
+  # @rbs (*(:ovs_datapath) groups) -> self
+  def unsubscribe(*groups) = super
 end
 end; end