Skip to main content

qualia_core_db/net/qdnf/bearer/
mtu.rs

1//! Bounded MTU negotiation for QDNF bearers.
2//!
3//! Negotiated MTU is `min(local, remote)` clamped to
4//! `[MIN_QDNF_MTU, MAX_QDNF_MTU]`. Jumbo advertisements are reduced; too-small
5//! advertisements fail closed. Oversize payload without fragmentation is
6//! [`QdnfError::Capacity`].
7
8use crate::net::qdnf::errors::QdnfError;
9
10/// Conservative floor (IPv6 minimum). Below this, PQ handshake fragments
11/// cannot be negotiated honestly.
12pub const MIN_QDNF_MTU: u16 = 1280;
13/// Ethernet-II payload ceiling without jumbo frames.
14pub const MAX_QDNF_MTU: u16 = 1500;
15/// Default advertised MTU when the adapter has not reported one.
16pub const DEFAULT_QDNF_MTU: u16 = MIN_QDNF_MTU;
17
18/// `?::negotiate_mtu`.
19pub fn negotiate_mtu(local: u16, remote: u16) -> Result<u16, QdnfError> {
20    if local == 0 || remote == 0 {
21        return Err(QdnfError::Range);
22    }
23    let n = local.min(remote);
24    if n < MIN_QDNF_MTU {
25        return Err(QdnfError::Range);
26    }
27    Ok(n.min(MAX_QDNF_MTU))
28}
29
30/// Oversize application/handshake bytes on a single unfragmented frame.
31pub fn unfragmented_fit(payload_len: usize, mtu: u16) -> Result<(), QdnfError> {
32    if mtu == 0 {
33        return Err(QdnfError::Range);
34    }
35    if payload_len > mtu as usize {
36        Err(QdnfError::Capacity)
37    } else {
38        Ok(())
39    }
40}
41
42/// Interface loss: closed adapter vs platform that never had a bearer.
43pub fn interface_loss_error(platform_unsupported: bool) -> QdnfError {
44    if platform_unsupported {
45        QdnfError::PlatformUnsupported
46    } else {
47        QdnfError::Closed
48    }
49}
50
51/// Reconnect after loss never reuses a prior fragment admission.
52pub const fn reconnect_requires_new_admission() -> bool {
53    true
54}
55
56#[cfg(test)]
57mod tests {
58    use super::*;
59
60    #[test]
61    fn negotiate_takes_min_within_bounds() {
62        assert_eq!(negotiate_mtu(1500, 1280).unwrap(), 1280);
63        assert_eq!(negotiate_mtu(9000, 9000).unwrap(), MAX_QDNF_MTU);
64        assert_eq!(negotiate_mtu(0, 1500), Err(QdnfError::Range));
65        assert_eq!(negotiate_mtu(512, 512), Err(QdnfError::Range));
66    }
67
68    #[test]
69    fn oversize_without_fragment_is_capacity() {
70        assert_eq!(unfragmented_fit(1501, 1500), Err(QdnfError::Capacity));
71        assert_eq!(unfragmented_fit(1280, 1280), Ok(()));
72    }
73
74    #[test]
75    fn interface_loss_is_closed_or_unsupported() {
76        assert_eq!(interface_loss_error(false), QdnfError::Closed);
77        assert_eq!(interface_loss_error(true), QdnfError::PlatformUnsupported);
78        assert!(reconnect_requires_new_admission());
79    }
80}