pcap-file 1.0.1

A crate to read and write Pcap and read PcapNg
Documentation
use std::io::Read;
use byteorder::{BigEndian, LittleEndian};
use crate::errors::PcapError;
use crate::pcapng::blocks::{Block, ParsedBlock, EnhancedPacketBlock, InterfaceDescriptionBlock};
use crate::Endianness;
use crate::peek_reader::PeekReader;

/// Wraps another reader and uses it to read a PcapNg formated stream.
///
/// It implements the Iterator trait in order to read one block at a time except the first SectionHeaderBlock
///
/// # Examples
///
/// ```rust,no_run
/// use std::fs::File;
/// use pcap_file::pcapng::PcapNgReader;
///
/// let file_in = File::open("test.pcapng").expect("Error opening file");
/// let pcapng_reader = PcapNgReader::new(file_in).unwrap();
///
/// // Read test.pcapng
/// for pcapng in pcapng_reader {
///
///     //Check if there is no error
///     let pcapng = pcapng.unwrap();
///
///     //Do something
/// }
/// ```
pub struct PcapNgReader<R: Read> {
    reader: PeekReader<R>,
    section: Block<'static>,
    interfaces: Vec<Block<'static>>
}

impl<R: Read> PcapNgReader<R> {

    /// Creates a new `PcapNgReader` from a reader.
    /// Parses the first block which must be a valid SectionHeaderBlock
    pub fn new(mut reader: R) -> Result<PcapNgReader<R>, PcapError> {

        let section = Block::from_reader::<_, BigEndian>(&mut reader)?;
        match section.parsed {
            ParsedBlock::SectionHeader(_) => {},
            _ => return Err(PcapError::InvalidField("SectionHeader missing"))
        }

        Ok(
            PcapNgReader {
                reader: PeekReader::new(reader),
                section,
                interfaces: vec![]
            }
        )
    }

    /// Returns the current SectionHeaderBlock
    pub fn section(&self) -> &Block<'static> {
        &self.section
    }

    /// Returns the current interfaces
    pub fn interfaces(&self) -> &[Block] {
        &self.interfaces[..]
    }

    /// Returns the InterfaceDescriptionBlock corresponding to the given packet
    pub fn packet_interface(&self, packet: &EnhancedPacketBlock) -> Option<&InterfaceDescriptionBlock> {
        self.interfaces.get(packet.interface_id as usize).map(|block| block.interface_description().unwrap())
    }
}

impl<R: Read> Iterator for PcapNgReader<R> {
    type Item = Result<Block<'static>, PcapError>;

    fn next(&mut self) -> Option<Self::Item> {

        match self.reader.is_empty() {
            Ok(is_empty) if is_empty => return None,
            Err(err) => return Some(Err(err.into())),
            _ => {}
        }

        let endianess = self.section.section_header().unwrap().endianness();

        let block_res = if endianess == Endianness::Big {
            Block::from_reader::<_, BigEndian>(&mut self.reader)
        }
        else {
            Block::from_reader::<_, LittleEndian>(&mut self.reader)
        };

        if let Ok(block) = block_res {

            if block.section_header().is_some() {
                self.section = block.clone();
                self.interfaces.clear();
            }
            else if block.interface_description().is_some() {
                self.interfaces.push(block.clone());
            }

            Some(Ok(block))
        }
        else {
            Some(block_res)
        }
    }
}