Struct TftpLayer 

pub struct TftpLayer {
    pub index: LayerIndex,
}

A zero-copy view into a TFTP layer within a packet buffer.

Fields

index: LayerIndex

Implementations

impl TftpLayer

pub fn new(index: LayerIndex) -> Self

pub fn at_start(len: usize) -> Self

pub fn opcode(&self, buf: &[u8]) -> Result<u16, FieldError>

Returns the 2-byte opcode.

Errors

Returns FieldError::BufferTooShort if fewer than 2 bytes are available.

pub fn op_name(&self, buf: &[u8]) -> Result<String, FieldError>

Returns the opcode name.

Errors

Returns FieldError::BufferTooShort if fewer than 2 bytes are available.

pub fn filename(&self, buf: &[u8]) -> Result<String, FieldError>

Returns the filename from a RRQ or WRQ packet.

The filename is a null-terminated string starting at byte 2.

Errors

Returns FieldError::InvalidValue if the opcode is not RRQ/WRQ or the filename bytes are not valid UTF-8, or FieldError::BufferTooShort if the buffer is too small.

pub fn mode(&self, buf: &[u8]) -> Result<String, FieldError>

Returns the mode string from a RRQ or WRQ packet (“netascii”, “octet”, “mail”).

Errors

Returns FieldError::InvalidValue if the opcode is not RRQ/WRQ or the mode bytes are not valid UTF-8.

pub fn block_num(&self, buf: &[u8]) -> Result<u16, FieldError>

Returns the block number from a DATA or ACK packet.

Errors

Returns FieldError::InvalidValue if the opcode is not DATA/ACK, or FieldError::BufferTooShort if fewer than 4 bytes are available.

pub fn data(&self, buf: &[u8]) -> Result<Vec<u8>, FieldError>

Returns the data payload from a DATA packet.

Errors

Returns FieldError::InvalidValue if the opcode is not DATA, or FieldError::BufferTooShort if fewer than 4 bytes are available.

pub fn error_code(&self, buf: &[u8]) -> Result<u16, FieldError>

Returns the error code from an ERROR packet.

Errors

Returns FieldError::InvalidValue if the opcode is not ERROR, or FieldError::BufferTooShort if fewer than 4 bytes are available.

pub fn error_msg(&self, buf: &[u8]) -> Result<String, FieldError>

Returns the error message from an ERROR packet.

Errors

Returns FieldError::InvalidValue if the opcode is not ERROR or the message is not valid UTF-8, or FieldError::BufferTooShort if fewer than 5 bytes are available.

pub fn get_field( &self, buf: &[u8], name: &str, ) -> Option<Result<FieldValue, FieldError>>

Get a field by name.

Trait Implementations

impl Clone for TftpLayer

fn clone(&self) -> TftpLayer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TftpLayer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<TftpLayer> for LayerEnum

fn from(v: TftpLayer) -> LayerEnum

Converts to this type from the input type.

impl Layer for TftpLayer

fn kind(&self) -> LayerKind

Get the kind of this layer

fn summary(&self, buf: &[u8]) -> String

Get a human-readable summary of this layer

fn header_len(&self, buf: &[u8]) -> usize

Get the header length for this layer

fn hashret(&self, buf: &[u8]) -> Vec<u8>

Compute a hash for packet matching.

fn field_names(&self) -> &'static [&'static str]

Get the list of field names for this layer

fn answers(&self, _data: &[u8], _other: &Self, _other_data: &[u8]) -> bool

Check if this packet answers another packet.

fn extract_padding<'a>(&self, data: &'a [u8]) -> (&'a [u8], &'a [u8])

Extract padding from the packet.

impl LayerDispatch for TftpLayer

fn dispatch_kind(&self) -> LayerKind

Get the kind of this layer.

fn dispatch_index(&self) -> &LayerIndex

Get the layer index (start/end offsets).

fn dispatch_summary(&self, buf: &[u8]) -> String

Get a human-readable summary.

fn dispatch_header_len(&self, buf: &[u8]) -> usize

Get the header length in bytes.

fn dispatch_hashret(&self, buf: &[u8]) -> Vec<u8>

Compute a hash for packet matching.

fn dispatch_field_names(&self) -> &'static [&'static str]

Get field names for this layer type.

fn dispatch_get_field( &self, buf: &[u8], name: &str, ) -> Option<Result<FieldValue, FieldError>>

Get a field value by name.

fn dispatch_set_field( &self, _buf: &mut [u8], _name: &str, _value: FieldValue, ) -> Option<Result<(), FieldError>>

Set a field value by name.

fn dispatch_show_fields(&self, buf: &[u8]) -> Vec<(&'static str, String)>

Get show-fields output.

impl TryInto<TftpLayer> for LayerEnum

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(self) -> Result<TftpLayer, <Self as TryInto<TftpLayer>>::Error>

Performs the conversion.