packet_parser 1.4.0

A powerful and modular Rust crate for network packet parsing.
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

// Copyright (c) 2026 Cyprien Avico avicocyprien@yahoo.com
//
// Licensed under the MIT License <LICENSE-MIT or http://opensource.org/licenses/MIT>.
// This file may not be copied, modified, or distributed except according to those terms.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum DnsPacketError {
    #[error("Insufficient data: expected at least {expected} bytes, but got {actual}")]
    InsufficientData { expected: usize, actual: usize },
    #[error("DNS header parsing error: {0}")]
    HeaderError(#[from] DnsHeaderError),
    #[error("DNS Query parsing error: {0}")]
    QueryError(#[from] DnsQueryParseError),
}

#[derive(Debug, Error)]
pub enum DnsHeaderError {
    #[error("Packet too short to be a DNS packet")]
    PacketTooShort,
    #[error("Invalid DNS packet: non-zero resource record counts with zero questions")]
    InvalidCounts,
    #[error("DNS Flags parsing error: {0}")]
    FlagsError(#[from] DnsFlagsError),
}

#[derive(Debug, Error)]
pub enum DnsQueryParseError {
    #[error(
        "Insufficient data: required {required} more bytes at offset {offset}, but only {available} bytes available"
    )]
    InsufficientData {
        required: usize,
        offset: usize,
        available: usize,
    },
    #[error("Out of bound parse")]
    OutOfBoundParse,
    #[error("UTF-8 parsing error: {0}")]
    Utf8Error(#[from] std::string::FromUtf8Error),
}

#[derive(Debug, Error, PartialEq)]
pub enum DnsFlagsError {
    #[error("Invalid Z field, must be 0. Here it's: {0}")]
    InvalidZField(u16),

    #[error("Invalid Opcode, must be between 0 and 5. Here it's: {0}")]
    InvalidOpcode(u16),

    #[error("Invalid RCode, must be between 0 and 5. Here it's: {0}")]
    InvalidRCode(u16),

    #[error("RA must be 0 in queries. Here it's: {0}")]
    RaInQuery(u16),

    #[error("AA and TC must be 0 in STATUS responses. Here AA is: {0}, TC is: {1}")]
    AaTcInStatusResponse(u16, u16),

    #[error("Rcode = 2, so AA must be 0 in Server failure responses. Here it's: {0}")]
    AaInServerFailure(u16),

    #[error("Rcode = 3, AA must be 1 in Name Error responses. Here it's: {0}")]
    AaInNameError(u16),

    #[error("Rcode = 5, AA must be 0 in Refused responses. Here it's: {0}")]
    AaInRefused(u16),
}