1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Protocol {
/// Netlink-raw protocol
Raw {
/// Value supplied to socket(2)
protonum: u16,
/// Value of `type` field in the message header
request_type: u16,
},
/// Generic netlink protocol
Generic(&'static [u8]),
}
/// A trait describing how to handle a particular request.
/// It designed to be used by a netlink socket implementation.
pub trait NetlinkRequest {
/// Netlink protocol to use
fn protocol(&self) -> Protocol;
/// Additional `flags` specified in the message header
fn flags(&self) -> u16;
/// Encoded payload of the message (without message header)
fn payload(&self) -> &[u8];
// type RequestType<'buf>;
// fn decode_request(buf: &[u8]) -> Self::RequestType<'_>;
type ReplyType<'buf>;
fn decode_reply(buf: &[u8]) -> Self::ReplyType<'_>;
/// Lookup an attribute and it's parents in the request payload by offset
fn lookup(
buf: &[u8],
offset: usize,
missing_type: Option<u16>,
) -> (Vec<(&'static str, usize)>, Option<&'static str>) {
let _ = buf;
let _ = offset;
let _ = missing_type;
(Vec::new(), None)
}
}
/// Function signature of [`NetlinkRequest::lookup`]
pub type LookupFn =
fn(&[u8], usize, Option<u16>) -> (Vec<(&'static str, usize)>, Option<&'static str>);
/// A chain of requests encoded into the single buffer (experimental)
pub trait NetlinkChained {
fn protonum(&self) -> u16;
/// Encoded payload of the messages (including message headers)
fn payload(&self) -> &[u8];
/// Number of messages in the chain
fn chain_len(&self) -> usize;
fn get_index(&self, seq: u32) -> Option<usize>;
fn name(&self, index: usize) -> &'static str;
fn lookup(&self, index: usize) -> LookupFn {
let _ = index;
|_, _, _| Default::default()
}
/// Packet supports ack on success with NLM_F_ACK (assumed true by default).
/// To date, this's only used to workaround a bug in nftables prior to linux 6.10.
///
/// Caller sequentially peeks indexes 0..chain_len() until it encounters None.
#[doc(hidden)]
fn supports_ack(&self, index: usize) -> Option<bool> {
let _ = index;
None
}
}