Skip to main content

mysql_replication/events/
header.rs

1use super::Event;
2use crate::{Result, error::invalid, wire::Cursor};
3use std::io::Write;
4
5/// The complete MySQL binlog v4 common header. Unknown codes and flags survive.
6#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
7pub struct EventHeader {
8    /// Producer-recorded event time in Unix seconds.
9    pub timestamp: u32,
10    /// Raw wire code; named constants live in `crate::event_type`.
11    pub event_type: u8,
12    /// Producer's server ID, independent from a consumer's replication ID.
13    pub server_id: u32,
14    /// Complete event length, including this header and any trailer/checksum.
15    pub event_size: u32,
16    /// Recorded position, normally the next event; not an acknowledged checkpoint.
17    pub log_pos: u32,
18    /// Common-header flags, distinct from flags in individual event bodies.
19    pub flags: u16,
20}
21impl EventHeader {
22    pub const LEN: usize = 19;
23    pub fn parse(data: &[u8]) -> Result<Self> {
24        let mut header = Self::default();
25        header.decode(data)?;
26        Ok(header)
27    }
28}
29impl<'a> Event<'a> for EventHeader {
30    fn dump(&self, writer: &mut dyn Write) -> Result<()> {
31        writeln!(writer, "Timestamp: {}", self.timestamp)?;
32        writeln!(writer, "Event type: {}", self.event_type)?;
33        writeln!(writer, "Server ID: {}", self.server_id)?;
34        writeln!(writer, "Event size: {}", self.event_size)?;
35        writeln!(writer, "Log position: {}", self.log_pos)?;
36        writeln!(writer, "Flags: {}", self.flags)?;
37        writeln!(writer)?;
38        Ok(())
39    }
40
41    fn decode(&mut self, data: &'a [u8]) -> Result<()> {
42        let mut input = Cursor::new(data);
43        let parsed = Self {
44            timestamp: input.le(4)? as u32,
45            event_type: input.byte()?,
46            server_id: input.le(4)? as u32,
47            event_size: input.le(4)? as u32,
48            log_pos: input.le(4)? as u32,
49            flags: input.le(2)? as u16,
50        };
51        input.finish()?;
52        if parsed.event_size < Self::LEN as u32 {
53            return Err(invalid("event smaller than common header"));
54        }
55        *self = parsed;
56        Ok(())
57    }
58}