seehandshake 1.0.5

Visualize TLS handshakes in your terminal, in real time.
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

// SPDX-License-Identifier: MIT

//! Packet capture backends.
//!
//! [`PacketSource`] is the trait that connects the capture layer to
//! everything downstream. The MVP provides [`live::LivePcapSource`], a
//! libpcap-backed implementation. Future work will add a
//! `PcapFileSource` for replaying `.pcap` files and a test-only mock.

pub mod frame;
pub mod interfaces;
pub mod live;

pub use frame::{extract_tcp, Frame, TcpSegment};
pub use interfaces::{list_interfaces, Interface};
pub use live::LivePcapSource;

use crate::error::Result;

/// A source of raw link-layer frames.
///
/// Implementations must be [`Send`] so that the capture loop can run on a
/// dedicated thread.
pub trait PacketSource: Send {
    /// Return the next frame, or `Ok(None)` if the source is exhausted
    /// (e.g., a PCAP file has reached EOF).
    ///
    /// # Errors
    ///
    /// Returns any transport-layer error surfaced by the underlying
    /// backend. Transient timeouts should be surfaced as `Ok(None)` rather
    /// than errors so that the caller can loop cleanly.
    fn next_frame(&mut self) -> Result<Option<Frame>>;
}