Struct Packet 

pub struct Packet<B> { /* private fields */ }

A full TACACS+ protocol packet.

Implementations

impl<B> Packet<B>

pub fn header(&self) -> &HeaderInfo

Some of the header information associated with a packet.

pub fn body(&self) -> &B

The body of the packet.

impl<B: PacketBody> Packet<B>

pub fn new(header: HeaderInfo, body: B) -> Self

Assembles a header and body into a full packet.

NOTE: Some fields in the provided header may be updated for consistency. These may include:

• The protocol minor version, depending on authentication method choice
• The UNENCRYPTED flag, depending on if a key is specified

impl<B: PacketBody + Serialize> Packet<B>

pub fn wire_size(&self) -> usize

Calculates the size of this packet as encoded into its binary format.

pub fn serialize<K: AsRef<[u8]>>( self, secret_key: K, buffer: &mut [u8], ) -> Result<usize, SerializeError>

Serializes the packet into a buffer, obfuscating the body using a pseudo-pad generated by iterating the MD5 hash function.

This consumes the packet and also ensures the UNENCRYPTED flag is unset.

pub fn serialize_unobfuscated( self, buffer: &mut [u8], ) -> Result<usize, SerializeError>

Serializes the packet into a buffer, leaving the body as cleartext.

This consumes the packet and sets the UNENCRYPTED flag if necessary.

Note that RFC8907 deprecated the UNENCRYPTED flag and states that it “MUST NOT be used in production” (section 4.5).

impl<'raw, B: PacketBody + Deserialize<'raw>> Packet<B>

pub fn deserialize<K: AsRef<[u8]>>( secret_key: K, buffer: &'raw mut [u8], ) -> Result<Self, DeserializeError>

Attempts to deserialize an obfuscated packet with the provided secret key.

This function also ensures that the UNENCRYPTED is not set, and returns an error if it is.

pub fn deserialize_unobfuscated( buffer: &'raw [u8], ) -> Result<Self, DeserializeError>

Attempts to deserialize a cleartext packet from a buffer.

This function also ensures that the UNENCRYPTED is set, and returns an error if it is not.

pub fn to_owned<'b, O: FromBorrowedBody<Borrowed<'b> = B>>(&self) -> Packet<O>

Available on crate feature std only.

Converts this packet to one with a body that owns its fields.

Trait Implementations

impl<B: Clone> Clone for Packet<B>

fn clone(&self) -> Packet<B>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<B: Debug> Debug for Packet<B>

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

Formats the value using the given formatter.

impl<B: Hash> Hash for Packet<B>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<B: PartialEq> PartialEq for Packet<B>

fn eq(&self, other: &Packet<B>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<B: Eq> Eq for Packet<B>

impl<B> StructuralPartialEq for Packet<B>