mpeg_ps/
error.rs

1//! Error type for MPEG Program Stream parsing.
2
3/// Result alias for Program Stream parsing.
4pub type Result<T> = core::result::Result<T, Error>;
5
6/// A Program Stream parse error.
7#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
8#[non_exhaustive]
9pub enum Error {
10    /// Input shorter than required.
11    #[error("buffer too short: need {need}, have {have} ({what})")]
12    BufferTooShort {
13        /// Bytes required.
14        need: usize,
15        /// Bytes available.
16        have: usize,
17        /// What was being parsed.
18        what: &'static str,
19    },
20    /// `pack_start_code` was not `0x000001BA`.
21    #[error("invalid pack_start_code: {0:#010X} (expected 0x000001BA)")]
22    BadPackStartCode(u32),
23    /// `system_header_start_code` was not `0x000001BB`.
24    #[error("invalid system_header_start_code: {0:#010X} (expected 0x000001BB)")]
25    BadSystemHeaderStartCode(u32),
26    /// `map_stream_id` was not `0xBC`.
27    #[error("invalid map_stream_id: {0:#04X} (expected 0xBC)")]
28    BadMapStreamId(u8),
29    /// Invalid PSM CRC_32.
30    #[error("PSM CRC_32 mismatch: computed {computed:#010X}, stored {stored:#010X}")]
31    BadCrc {
32        /// CRC computed over the PSM bytes.
33        computed: u32,
34        /// CRC stored in the PSM trailer.
35        stored: u32,
36    },
37    /// A required `marker_bit` was not `1`.
38    #[error("bad marker bit in {0}")]
39    BadMarker(&'static str),
40    /// The `01` prefix after `pack_start_code` was not `01`.
41    #[error("bad SCR prefix: {0:#04b} (expected 0b01)")]
42    BadScrPrefix(u8),
43    /// The pack header carries the ISO/IEC 11172-1 (MPEG-1) `'0010'` pack
44    /// prefix, a different (12-byte, no SCR extension) layout this crate
45    /// does not parse — distinct from [`Self::BadScrPrefix`], which means
46    /// the bytes are neither a valid MPEG-1 nor MPEG-2 pack header (#1119).
47    #[error(
48        "MPEG-1 (ISO/IEC 11172-1) pack header is not supported (only ISO/IEC 13818-1 MPEG-2 packs are)"
49    )]
50    Mpeg1NotSupported,
51    /// `system_header` `stream_id == 0xB7` but the extension form prefix is wrong.
52    #[error("bad stream_id_extension prefix byte: {0:#04X}")]
53    BadStreamIdExtensionPrefix(u8),
54    /// `program_mux_rate` is 0 (forbidden).
55    #[error("program_mux_rate is 0 (forbidden)")]
56    ZeroMuxRate,
57    /// `pack_stuffing_length` exceeds 7 (3-bit field).
58    #[error("pack_stuffing_length {0} exceeds maximum 7")]
59    StuffingLengthTooLarge(u8),
60    /// `PackHeader::stuffing.len()` does not match `stuffing_length` — the
61    /// two are independently-settable public fields (#1119 W8).
62    #[error("pack_header stuffing_length ({declared}) does not match stuffing.len() ({actual})")]
63    StuffingLengthMismatch {
64        /// The `stuffing_length` field value.
65        declared: u8,
66        /// The actual `stuffing.len()`.
67        actual: usize,
68    },
69    /// `header_length` overflows the available buffer.
70    #[error("header_length {header_length} exceeds available bytes ({available})")]
71    HeaderLengthOverflow {
72        /// The header_length value.
73        header_length: usize,
74        /// Bytes available after the header_length field.
75        available: usize,
76    },
77    /// `program_stream_map_length` overflows the available buffer.
78    #[error("program_stream_map_length {map_length} exceeds available bytes ({available})")]
79    MapLengthOverflow {
80        /// The program_stream_map_length value.
81        map_length: usize,
82        /// Bytes available after the length field.
83        available: usize,
84    },
85    /// PES packet parse error from `mpeg-pes`.
86    #[error("PES parse error: {0}")]
87    Pes(#[from] mpeg_pes::Error),
88
89    /// A length or count field's value does not fit its wire field
90    /// (see `broadcast_common::len`, #1129).
91    #[error(transparent)]
92    FieldOverflow(#[from] broadcast_common::len::FieldOverflow),
93}
mpeg_ps/error.rs

mpeg_ps/
error.rs
