qbase 0.0.1

Core structure of the QUIC protocol, a part of gm-quic
Documentation 
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

use nom::error::ErrorKind as NomErrorKind;
use thiserror::Error;

use super::r#type::Type;

/// Parse error of QUIC packet.
#[derive(Debug, PartialEq, Eq, Error)]
pub enum Error {
    #[error("Unsupport version {0}")]
    UnsupportedVersion(u32),
    #[error("Invalid fixed bit in long header")]
    InvalidFixedBit,
    #[error("Incomplete packet type: {0}")]
    IncompleteType(String),
    #[error("Incomplete packet header {0:?}: {1}")]
    IncompleteHeader(Type, String),
    #[error("Incomplete packet body {0:?}: {1}")]
    IncompletePacket(Type, String),
    #[error("Sampling of packet content less than 20 bytes, only {0} bytes available")]
    UnderSampling(usize),
    #[error("Fail to remove protection")]
    RemoveProtectionFailure,
    #[error("Invalid reserved bits: {0:05b} & {1:05b} must be 0")]
    InvalidReservedBits(u8, u8),
    #[error("Fail to decrypt packet")]
    DecryptPacketFailure,
}

impl nom::error::ParseError<&[u8]> for Error {
    fn from_error_kind(_input: &[u8], _kind: NomErrorKind) -> Self {
        debug_assert_eq!(_kind, NomErrorKind::ManyTill);
        unreachable!("QUIC frame parser must always consume")
    }

    fn append(_input: &[u8], _kind: NomErrorKind, source: Self) -> Self {
        // 在解析帧时遇到了source错误，many_till期望通过ManyTill的错误类型告知
        // 这里，源错误更有意义，所以直接返回源错误
        debug_assert_eq!(_kind, NomErrorKind::ManyTill);
        source
    }
}

impl From<Error> for crate::error::Error {
    fn from(e: Error) -> Self {
        match e {
            Error::InvalidReservedBits(_, _) => crate::error::Error::with_default_fty(
                crate::error::ErrorKind::ProtocolViolation,
                e.to_string(),
            ),
            _ => unreachable!(),
        }
    }
}