nl 0.4.1 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +28 -0
  3. data/lib/nl/async/dispatcher.rb +2 -2
  4. data/lib/nl/attribute_set.rb +19 -153
  5. data/lib/nl/attributes.rb +193 -0
  6. data/lib/nl/blocking_transport.rb +5 -5
  7. data/lib/nl/datagram.rb +4 -4
  8. data/lib/nl/datatypes/checked.rb +66 -0
  9. data/lib/nl/datatypes/defaults.rb +13 -0
  10. data/lib/nl/datatypes/scalar.rb +28 -0
  11. data/lib/nl/datatypes.rb +97 -125
  12. data/lib/nl/decoder.rb +79 -25
  13. data/lib/nl/encoder.rb +4 -6
  14. data/lib/nl/endian.rb +5 -4
  15. data/lib/nl/exchange.rb +18 -17
  16. data/lib/nl/family.rb +33 -15
  17. data/lib/nl/genl/client.rb +1 -0
  18. data/lib/nl/genl/protocol.rb +16 -3
  19. data/lib/nl/genl/wire.rb +10 -3
  20. data/lib/nl/genl.rb +0 -20
  21. data/lib/nl/message.rb +21 -0
  22. data/lib/nl/notification_router.rb +2 -5
  23. data/lib/nl/raw/client.rb +1 -1
  24. data/lib/nl/raw/protocol.rb +27 -21
  25. data/lib/nl/raw/wire.rb +21 -50
  26. data/lib/nl/raw.rb +1 -51
  27. data/lib/nl/{sub_message.rb → selector.rb} +13 -23
  28. data/lib/nl/socket.rb +21 -5
  29. data/lib/nl/version.rb +1 -1
  30. data/lib/nl.rb +2 -2
  31. data/sig/generated/nl/attribute_set.rbs +21 -29
  32. data/sig/generated/nl/attributes.rbs +51 -0
  33. data/sig/generated/nl/datagram.rbs +4 -4
  34. data/sig/generated/nl/datatypes/checked.rbs +31 -0
  35. data/sig/generated/nl/datatypes/defaults.rbs +11 -0
  36. data/sig/generated/nl/datatypes/scalar.rbs +11 -0
  37. data/sig/generated/nl/datatypes.rbs +38 -34
  38. data/sig/generated/nl/decoder.rbs +12 -4
  39. data/sig/generated/nl/encoder.rbs +1 -1
  40. data/sig/generated/nl/endian.rbs +1 -0
  41. data/sig/generated/nl/exchange.rbs +2 -2
  42. data/sig/generated/nl/family.rbs +40 -22
  43. data/sig/generated/nl/genl/protocol.rbs +3 -1
  44. data/sig/generated/nl/genl.rbs +0 -15
  45. data/sig/generated/nl/message.rbs +14 -0
  46. data/sig/generated/nl/raw/client.rbs +0 -1
  47. data/sig/generated/nl/raw/protocol.rbs +29 -43
  48. data/sig/generated/nl/raw/wire.rbs +0 -36
  49. data/sig/generated/nl/raw.rbs +0 -35
  50. data/sig/generated/nl/{sub_message.rbs → selector.rbs} +8 -19
  51. data/sig/generated/nl/socket.rbs +29 -10
  52. metadata +14 -6
  53. data/lib/nl/structured_payload.rb +0 -61
  54. data/sig/generated/nl/structured_payload.rbs +0 -25
data/lib/nl/exchange.rb CHANGED
@@ -1,5 +1,6 @@
1
1
  require_relative 'error'
2
2
  require_relative 'raw/protocol'
3
+ require_relative 'message'
3
4
 
4
5
  module Nl
5
6
  # State machine for one Netlink request/reply exchange.
@@ -46,27 +47,27 @@ module Nl
46
47
  @mutex = Mutex.new
47
48
  end
48
49
 
49
- def accept(frame)
50
+ def accept(header, message)
50
51
  @mutex.synchronize do
51
52
  return if @complete
52
53
 
53
- case frame
54
- when Raw::UnknownFrame
54
+ case message
55
+ when Raw::Unknown
55
56
  nil
56
- when Raw::ErrorFrame
57
- @cancelled ? complete(nil) : fail_with(SystemCallError.new(frame.errno))
58
- when Raw::DoneFrame
59
- if frame.errno && !@cancelled
60
- fail_with(SystemCallError.new(frame.errno))
57
+ when Raw::Error
58
+ @cancelled ? complete(nil) : fail_with(SystemCallError.new(message.errno))
59
+ when Raw::Done
60
+ if message.errno && !@cancelled
61
+ fail_with(SystemCallError.new(message.errno))
61
62
  else
62
63
  complete(@reply)
63
64
  end
64
- when Raw::AckFrame
65
+ when Raw::Ack
65
66
  accept_ack
66
- when Raw::DataFrame
67
- accept_reply(frame)
67
+ when Message
68
+ accept_reply(header, message)
68
69
  else
69
- raise ArgumentError, "unexpected exchange input: #{frame.inspect}"
70
+ raise ArgumentError, "unexpected exchange input: #{message.inspect}"
70
71
  end
71
72
  end
72
73
  end
@@ -87,13 +88,13 @@ module Nl
87
88
  end
88
89
  end
89
90
 
90
- private def accept_reply(frame)
91
+ private def accept_reply(header, message)
91
92
  return if @cancelled
92
93
 
93
- multipart = (frame.header.flags.to_i & Raw::NLM_F_MULTI) != 0
94
+ multipart = (header.flags.to_i & Raw::NLM_F_MULTI) != 0
94
95
  case @state
95
96
  when :dump
96
- return Item.new(frame.message)
97
+ return Item.new(message)
97
98
  when :no_reply
98
99
  return fail_with(ProtocolViolation.new('unexpected data message in a no-reply Netlink response'))
99
100
  when :initial
@@ -106,8 +107,8 @@ module Nl
106
107
  end
107
108
  end
108
109
 
109
- @reply ||= frame.message
110
- complete(frame.message) if @acked && @state == :single
110
+ @reply ||= message
111
+ complete(message) if @acked && @state == :single
111
112
  end
112
113
 
113
114
  private def complete(value)
data/lib/nl/family.rb CHANGED
@@ -34,18 +34,20 @@ module Nl
34
34
  # end
35
35
 
36
36
  class Family
37
- DEFAULT_NOTIFICATION_CAPACITY = Connection::DEFAULT_NOTIFICATION_CAPACITY
37
+ DEFAULT_NOTIFICATION_CAPACITY = Connection::DEFAULT_NOTIFICATION_CAPACITY #: Integer
38
38
 
39
+ # Socket-owning family.
40
+ #
41
+ # {Family} instances that owns sockets are extended with this module.
39
42
  module Session
40
- def close #: nil
43
+ # Closes the Netlink socket owned by this {Family}.
44
+ # @rbs () -> void
45
+ def close
41
46
  @connection.close
42
47
  end
43
48
  end
44
49
 
45
- #--
46
- # @rbs connection: _Connection
47
- # @rbs endpoint: Raw::Endpoint
48
- # @rbs return: instance
50
+ # @rbs (_Connection connection, endpoint: Raw::Endpoint) -> instance
49
51
  def initialize(connection, endpoint:)
50
52
  @endpoint = endpoint
51
53
  @connection = connection
@@ -59,38 +61,54 @@ module Nl
59
61
  @connection.exchange(@endpoint, kind, request_class, reply_class, args, &block)
60
62
  end
61
63
 
62
- def async_capable? #: bool
64
+ # Returns if this family supports asynchronous operations.
65
+ #
66
+ # @rbs () -> bool
67
+ def async_capable?
63
68
  @connection.async_capable?
64
69
  end
65
70
 
66
- # Adds multicast memberships to the existing family socket. Membership is
67
- # additive and remains active until explicitly removed or the owner closes.
71
+ # Adds multicast memberships to the netlink socket.
72
+ #
73
+ # Membership is additive and remains active until explicitly removed or the owner closes.
74
+ #
75
+ # @param [Array<Symbol>] groups
76
+ # @return [Family] self
77
+ # @rbs (Symbol *groups) -> self
68
78
  def subscribe(*groups)
69
79
  @connection.add_memberships(multicast_group_ids(groups))
70
80
  self
71
81
  end
72
82
 
83
+ # Removes multicast memberships from the netlink socket.
84
+ #
85
+ # @param [Array<Symbol>] groups
86
+ # @return [Family] self
87
+ # @rbs (Symbol *groups) -> self
73
88
  def unsubscribe(*groups)
74
89
  @connection.drop_memberships(multicast_group_ids(groups))
75
90
  self
76
91
  end
77
92
 
93
+ # Receives the next unsolicited message.
94
+ #
95
+ # @rbs (?timeout: Integer?) -> Message
78
96
  def receive_notification(timeout: nil)
79
97
  @notification_stream.next(timeout:)
80
98
  end
81
99
 
100
+ # Receives unsolicited messages.
101
+ #
102
+ # @rbs () { (Message) -> void } -> void
82
103
  def each_notification(&block)
83
104
  return @notification_stream.each unless block
84
105
 
85
106
  @notification_stream.each(&block)
86
107
  end
87
108
 
88
- # Builds a generated asynchronous-operation facade with a narrowly scoped
89
- # callback, so the facade does not need access to Family's private API.
90
- #--
91
- # @rbs operations_class: Class
92
- # @rbs stream_capacity: Integer?
93
- # @rbs return: untyped
109
+ # Builds a asynchronous-operation facade.
110
+ #
111
+ # @rbs (Class operations_class, ?stream_capacity: Integer?) -> untyped
94
112
  private def build_async_facade(operations_class, stream_capacity: nil)
95
113
  unless async_capable?
96
114
  raise Async::UnavailableError, 'async operations require an executor'
@@ -1,4 +1,5 @@
1
1
  # Generic Netlink client handling
2
+ #-
2
3
 
3
4
  require_relative '../connection'
4
5
  require_relative 'wire'
@@ -30,6 +30,19 @@ module Nl
30
30
  super(Raw::NETLINK_GENERIC)
31
31
  end
32
32
 
33
+ private def decode_message(endpoint, header, decoder, message_class)
34
+ unless header.type == endpoint.family_id
35
+ raise ProtocolViolation, "Expected family ID #{endpoint.family_id}, got #{header.type}"
36
+ end
37
+
38
+ command = GenlMsgHdr.decode(decoder).cmd
39
+ unless message_class::TYPE == command
40
+ raise ProtocolViolation, "Expected command #{message_class::TYPE}, got #{command}"
41
+ end
42
+
43
+ message_class.decode(decoder)
44
+ end
45
+
33
46
  def encode_message(encoder, endpoint, request, seq:, pid:)
34
47
  message = request.message
35
48
  header = Raw::NlMsgHdr.new(0, request.type, request.flags, seq, pid)
@@ -48,11 +61,11 @@ module Nl
48
61
  header.type == endpoint.family_id
49
62
  end
50
63
 
51
- def notification_class(endpoint, header, payload, classes)
64
+ def decode_notification(endpoint, header, payload, classes)
52
65
  return unless notification_frame?(endpoint, header, payload)
53
66
 
54
- command = Nl::Genl::GenlMsgHdr.decode(Decoder.new(payload)).cmd
55
- classes[command]
67
+ command = GenlMsgHdr.decode(payload).cmd
68
+ classes[command]&.decode(payload)
56
69
  end
57
70
  end
58
71
  end
data/lib/nl/genl/wire.rb CHANGED
@@ -1,4 +1,5 @@
1
1
  # Generic Netlink wire definitions
2
+ #-
2
3
 
3
4
  require_relative '../raw/wire'
4
5
  require_relative '../endian'
@@ -65,11 +66,12 @@ module Nl
65
66
  )
66
67
 
67
68
  class GenlMsgHdr
68
- FORMAT = Ractor.make_shareable([
69
+ FORMAT = [
69
70
  Endian::Host::U8,
70
71
  Endian::Host::U8,
71
72
  Endian::Host::U16,
72
- ])
73
+ ].freeze
74
+ Ractor.make_shareable(FORMAT) if defined?(Ractor)
73
75
  private_constant :FORMAT
74
76
 
75
77
  # Decodes a header from the decoder's current position.
@@ -78,7 +80,12 @@ module Nl
78
80
  # @return [GenlMsgHdr] the decoded header
79
81
  # @rbs (Decoder decoder) -> instance
80
82
  def self.decode(decoder)
81
- new(*decoder.get_values(FORMAT))
83
+ # Unrolling get_values improves performance for this small header.
84
+ new(
85
+ decoder.get_U8,
86
+ decoder.get_U8,
87
+ decoder.get_host_u16,
88
+ )
82
89
  end
83
90
 
84
91
  # Encodes this header at the encoder's current position.
data/lib/nl/genl.rb CHANGED
@@ -1,5 +1,3 @@
1
- # Generic Netlink family support
2
-
3
1
  require_relative 'genl/wire'
4
2
  require_relative 'family'
5
3
  require_relative 'raw'
@@ -50,24 +48,6 @@ module Nl
50
48
  end
51
49
  end
52
50
  end
53
-
54
- # Base class for Generic Netlink messages.
55
- #
56
- # A Generic Netlink message payload begins with a {GenlMsgHdr}, followed by
57
- # the optional fixed header and attributes handled by {Raw::Message}.
58
- class Message < Raw::Message
59
- # Decodes a Generic Netlink message payload.
60
- #
61
- # @param [Decoder] decoder the source decoder
62
- # @param [Integer] type the family ID from the Netlink message header
63
- # @return [Message] the decoded message
64
- # @raise [RuntimeError] if the command does not match the message class's type
65
- # @rbs (Decoder decoder, type: Integer) -> instance
66
- def self.decode(decoder, type:)
67
- genlhdr = GenlMsgHdr.decode(decoder)
68
- super(decoder, type: genlhdr.cmd)
69
- end
70
- end
71
51
  end
72
52
  end
73
53
 
data/lib/nl/message.rb ADDED
@@ -0,0 +1,21 @@
1
+ require_relative 'attribute_set'
2
+
3
+ module Nl
4
+ # Family payload with fixed-header fields and attribute values stored inline.
5
+ class Message
6
+ include Attributes
7
+
8
+ EMPTY_FIELD_NAMES = [].freeze
9
+
10
+ class << self
11
+ def from_params(params = {})
12
+ build_instance(params)
13
+ end
14
+
15
+ private def validate_params(params, header_names, attribute_names)
16
+ unknown = params.keys - header_names - attribute_names
17
+ raise ArgumentError, "unknown parameters: #{unknown.join(', ')}" unless unknown.empty?
18
+ end
19
+ end
20
+ end
21
+ end
@@ -58,11 +58,8 @@ module Nl
58
58
  return false unless entry
59
59
  return false unless @protocol.notification_frame?(entry.endpoint, header, payload)
60
60
 
61
- message_class = @protocol.notification_class(entry.endpoint, header, payload, entry.classes)
62
- return true unless message_class
63
-
64
- notification = @protocol.decode_notification(entry.endpoint, header, payload, message_class)
65
- entry.channel.push(notification)
61
+ notification = @protocol.decode_notification(entry.endpoint, header, payload, entry.classes)
62
+ entry.channel.push(notification) if notification
66
63
  true
67
64
  rescue => error
68
65
  entry&.channel&.fail(error)
data/lib/nl/raw/client.rb CHANGED
@@ -1,4 +1,5 @@
1
1
  # Raw Netlink client handling
2
+ #-
2
3
 
3
4
  require_relative '../connection'
4
5
  require_relative 'protocol'
@@ -73,7 +74,6 @@ module Nl
73
74
  # Closes the underlying Netlink connection.
74
75
  #
75
76
  # @return [void]
76
- #--
77
77
  # @rbs () -> void
78
78
  def close
79
79
  @connection.close
@@ -6,11 +6,13 @@ require_relative '../socket'
6
6
 
7
7
  module Nl
8
8
  module Raw
9
- AckFrame = Data.define(:header)
10
- ErrorFrame = Data.define(:header, :errno)
11
- DoneFrame = Data.define(:header, :errno)
12
- UnknownFrame = Data.define(:header)
13
- DataFrame = Data.define(:header, :message)
9
+ Ack = Data.define
10
+ Error = Data.define(:errno)
11
+ Done = Data.define(:errno)
12
+ Unknown = Data.define
13
+ ACK = Ack.new
14
+ DONE = Done.new(nil)
15
+ UNKNOWN = Unknown.new
14
16
  Request = Data.define(:type, :flags, :message)
15
17
 
16
18
  # A generated raw Netlink family bound to its fixed wire identity.
@@ -46,37 +48,45 @@ module Nl
46
48
  end
47
49
  end
48
50
 
49
- # Decodes one frame using the reply class associated with its sequence.
50
- def decode_frame(_endpoint, header, payload, message_class)
51
- decoder = Decoder.new(payload)
51
+ # Returns a decoded reply or control result for one Netlink frame.
52
+ # @rbs (Endpoint endpoint, NlMsgHdr header, Decoder decoder, Class? message_class) -> (Message | Ack | Done | Error | Unknown)
53
+ def decode_frame(endpoint, header, decoder, message_class)
52
54
  if header.type < Raw::NLMSG_MIN_TYPE
53
55
  case header.type
54
56
  when Raw::NLMSG_ERROR
55
- errno = decoder.get_value(Endian::Host::SINT)
57
+ errno = decoder.get_host_sint
56
58
  if errno.positive?
57
59
  raise ProtocolViolation, "expected zero or negative NLMSG_ERROR errno, got #{errno}"
58
60
  end
59
61
 
60
- errno.zero? ? AckFrame.new(header:) : ErrorFrame.new(header:, errno: -errno)
62
+ errno == 0 ? ACK : Error.new(-errno)
61
63
  when Raw::NLMSG_DONE
62
- return DoneFrame.new(header:, errno: nil) unless decoder.available?
64
+ return DONE unless decoder.available?
63
65
 
64
- errno = decoder.get_value(Endian::Host::SINT)
66
+ errno = decoder.get_host_sint
65
67
  if errno.positive?
66
68
  raise ProtocolViolation, "expected zero or negative NLMSG_DONE errno, got #{errno}"
67
69
  end
68
70
 
69
- DoneFrame.new(header:, errno: errno.negative? ? -errno : nil)
71
+ errno < 0 ? Done.new(-errno) : DONE
70
72
  else
71
- UnknownFrame.new(header:)
73
+ UNKNOWN
72
74
  end
73
75
  else
74
76
  raise ArgumentError, 'reply class is required for a data message' unless message_class
75
77
 
76
- DataFrame.new(header:, message: message_class.decode(decoder, type: header.type))
78
+ decode_message(endpoint, header, decoder, message_class)
77
79
  end
78
80
  end
79
81
 
82
+ private def decode_message(_endpoint, header, decoder, message_class)
83
+ unless message_class::TYPE == header.type
84
+ raise ProtocolViolation, "Expected message type #{message_class::TYPE}, got #{header.type}"
85
+ end
86
+
87
+ message_class.decode(decoder)
88
+ end
89
+
80
90
  def send_message(socket, endpoint, request, seq:, pid:)
81
91
  encoder = Encoder.new
82
92
  encode_message(encoder, endpoint, request, seq:, pid:)
@@ -100,12 +110,8 @@ module Nl
100
110
  header.type >= Raw::NLMSG_MIN_TYPE
101
111
  end
102
112
 
103
- def notification_class(_endpoint, header, _payload, classes)
104
- classes[header.type]
105
- end
106
-
107
- def decode_notification(endpoint, header, payload, message_class)
108
- decode_frame(endpoint, header, payload, message_class).message
113
+ def decode_notification(_endpoint, header, payload, classes)
114
+ classes[header.type]&.decode(payload)
109
115
  end
110
116
  end
111
117
  end
data/lib/nl/raw/wire.rb CHANGED
@@ -1,4 +1,5 @@
1
1
  # Netlink wire definitions
2
+ #-
2
3
 
3
4
  require_relative '../endian'
4
5
 
@@ -67,13 +68,14 @@ module Nl
67
68
  )
68
69
 
69
70
  class NlMsgHdr
70
- FORMAT = Ractor.make_shareable([
71
+ FORMAT = [
71
72
  Endian::Host::U32,
72
73
  Endian::Host::U16,
73
74
  Endian::Host::U16,
74
75
  Endian::Host::U32,
75
76
  Endian::Host::U32,
76
- ])
77
+ ].freeze
78
+ Ractor.make_shareable(FORMAT) if defined?(Ractor)
77
79
  private_constant :FORMAT
78
80
 
79
81
  # Decodes a header from the decoder's current position.
@@ -82,9 +84,23 @@ module Nl
82
84
  # @return [NlMsgHdr] the decoded header
83
85
  # @rbs (Decoder decoder) -> instance
84
86
  def self.decode(decoder)
85
- obj = new(*decoder.get_values(FORMAT))
86
- decoder.align_to(Constants::NLMSG_ALIGNTO)
87
- obj
87
+ len = decoder.get_host_u32
88
+ type_flags = decoder.get_host_u32
89
+ if IO::Buffer::HOST_ENDIAN == IO::Buffer::LITTLE_ENDIAN
90
+ type = type_flags & 0xffff
91
+ flags = type_flags >> 16
92
+ else
93
+ type = type_flags >> 16
94
+ flags = type_flags & 0xffff
95
+ end
96
+
97
+ new(
98
+ len,
99
+ type,
100
+ flags,
101
+ decoder.get_host_u32,
102
+ decoder.get_host_u32,
103
+ )
88
104
  end
89
105
 
90
106
  # Encodes this header at the encoder's current position.
@@ -95,51 +111,6 @@ module Nl
95
111
  def encode(encoder)
96
112
  encoder.reserve(Constants::NLMSG_HDRLEN)
97
113
  encoder.put_values(FORMAT, to_a)
98
- encoder.align_to(Constants::NLMSG_ALIGNTO)
99
- end
100
- end
101
-
102
- # Fixed-format header prepended to every Netlink attribute.
103
- #
104
- # This corresponds to Linux's +struct nlattr+.
105
- #
106
- # @!attribute [rw] len
107
- # @return [Integer] attribute length in bytes, including this header but
108
- # excluding trailing alignment padding
109
- # @!attribute [rw] type
110
- # @return [Integer] attribute type combined with optional +NLA_F_+ flags
111
- NlAttr = Struct.new(
112
- :len, #: Integer
113
- :type, #: Integer
114
- )
115
-
116
- class NlAttr
117
- FORMAT = Ractor.make_shareable([
118
- Endian::Host::U16,
119
- Endian::Host::U16,
120
- ])
121
- private_constant :FORMAT
122
-
123
- # Decodes an attribute header from the decoder's current position.
124
- #
125
- # @param [Decoder] decoder the source decoder
126
- # @return [NlAttr] the decoded header
127
- # @rbs (Decoder decoder) -> instance
128
- def self.decode(decoder)
129
- obj = new(*decoder.get_values(FORMAT))
130
- decoder.align_to(Constants::NLA_ALIGNTO)
131
- obj
132
- end
133
-
134
- # Encodes this attribute header at the encoder's current position.
135
- #
136
- # @param [Encoder] encoder the destination encoder
137
- # @return [void]
138
- # @rbs (Encoder encoder) -> void
139
- def encode(encoder)
140
- encoder.reserve(Constants::NLA_HDRLEN)
141
- encoder.put_values(FORMAT, to_a)
142
- encoder.align_to(Constants::NLA_ALIGNTO)
143
114
  end
144
115
  end
145
116
  end
data/lib/nl/raw.rb CHANGED
@@ -1,8 +1,7 @@
1
1
  require_relative 'family'
2
2
  require_relative 'raw/protocol'
3
3
  require_relative 'raw/client'
4
- require_relative 'attribute_set'
5
- require_relative 'structured_payload'
4
+ require_relative 'message'
6
5
 
7
6
  module Nl
8
7
  # Classic (Raw) Netlink families.
@@ -51,54 +50,5 @@ module Nl
51
50
  end
52
51
  end
53
52
  end
54
-
55
- # Base class for raw Netlink messages.
56
- #
57
- # A message may contain a fixed header followed by a set of Netlink
58
- # attributes.
59
- class Message
60
- include Nl::StructuredPayload
61
-
62
- # @param [Object, nil] fixed_header the family-specific fixed header
63
- # @param [AttributeSet, nil] attributes the message's attributes
64
- # @rbs (?untyped fixed_header, ?AttributeSet? attributes) -> void
65
- def initialize(fixed_header = nil, attributes = self.class::ATTRIBUTE_SET.new)
66
- super
67
- end
68
-
69
- # Appends an attribute to the message.
70
- #
71
- # @param [AttributeSet::Attribute] attribute the attribute to append
72
- # @return [void]
73
- # @rbs (AttributeSet::Attribute attribute) -> void
74
- def append_attribute(attribute)
75
- @attributes << attribute
76
- end
77
-
78
- # Decodes a raw Netlink message payload.
79
- #
80
- # @param [Decoder] decoder the source decoder
81
- # @param [Integer] type the message type from its Netlink header
82
- # @return [Message] the decoded message
83
- # @raise [RuntimeError] if +type+ does not match the message class's type
84
- # @rbs (Decoder decoder, type: Integer) -> instance
85
- def self.decode(decoder, type:)
86
- unless self::TYPE == type
87
- raise "Expected message type #{self::TYPE}, got #{type}"
88
- end
89
-
90
- super(decoder)
91
- end
92
-
93
- class << self
94
- # Returns the attribute names accepted by this message.
95
- #
96
- # @return [Array<Symbol>] the attribute names
97
- # @rbs () -> Array[Symbol]
98
- private def attribute_names
99
- self::ATTRIBUTES
100
- end
101
- end
102
- end
103
53
  end
104
54
  end
@@ -1,7 +1,8 @@
1
- require_relative 'structured_payload'
2
-
3
1
  module Nl
4
2
  module Selector
3
+ EMPTY_VALUES = [].freeze
4
+ Ractor.make_shareable(EMPTY_VALUES) if defined?(Ractor)
5
+
5
6
  class MissingSelectorValueError < StandardError
6
7
  attr_reader :scope, :index
7
8
 
@@ -48,8 +49,14 @@ module Nl
48
49
  end
49
50
 
50
51
  class State
51
- def initialize(local_count, external)
52
- @local = Array.new(local_count)
52
+ def self.for(local_selector_count, external)
53
+ return EMPTY if local_selector_count == 0 && external.empty?
54
+
55
+ new(local_selector_count, external)
56
+ end
57
+
58
+ def initialize(local_selector_count, external)
59
+ @local = Array.new(local_selector_count)
53
60
  @external = external
54
61
  end
55
62
 
@@ -69,26 +76,9 @@ module Nl
69
76
  value = values[key]
70
77
  value.nil? ? yield : value
71
78
  end
72
- end
73
- end
74
-
75
- # A selector-specific payload containing an optional fixed header followed by
76
- # an optional set of Netlink attributes.
77
- class SubMessage
78
- include StructuredPayload
79
- end
80
-
81
- # An unrecognized selector-specific payload retained without interpretation.
82
- class RawSubMessage < SubMessage
83
- attr_reader :payload, :nlattr_type_flags
84
-
85
- def initialize(payload, nlattr_type_flags:)
86
- @payload = payload
87
- @nlattr_type_flags = nlattr_type_flags
88
- end
89
79
 
90
- def encode(encoder, external_selectors: [])
91
- encoder.put_string(payload)
80
+ EMPTY = new(0, EMPTY_VALUES).freeze
81
+ Ractor.make_shareable(EMPTY) if defined?(Ractor)
92
82
  end
93
83
  end
94
84
  end