Enum bincode::SizeLimit

pub enum SizeLimit {
    Infinite,
    Bounded(u64),
}

A limit on the amount of bytes that can be read or written.

Size limits are an incredibly important part of both encoding and decoding.

In order to prevent DOS attacks on a decoder, it is important to limit the amount of bytes that a single encoded message can be; otherwise, if you are decoding bytes right off of a TCP stream for example, it would be possible for an attacker to flood your server with a 3TB vec, causing the decoder to run out of memory and crash your application! Because of this, you can provide a maximum-number-of-bytes that can be read during decoding, and the decoder will explicitly fail if it has to read any more than that.

On the other side, you want to make sure that you aren't encoding a message that is larger than your decoder expects. By supplying a size limit to an encoding function, the encoder will verify that the structure can be encoded within that limit. This verification occurs before any bytes are written to the Writer, so recovering from an error is easy.

Variants

InfiniteBounded(u64)

Trait Implementations

impl Clone for SizeLimit

fn clone(&self) -> SizeLimit

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for SizeLimit

impl Debug for SizeLimit

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Hash for SizeLimit

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

Feeds this value into the state given, updating the hasher as necessary.

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

Feeds a slice of this type into the state provided.

impl Eq for SizeLimit

impl PartialEq for SizeLimit

fn eq(&self, __arg_0: &SizeLimit) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &SizeLimit) -> bool

This method tests for !=.

impl Ord for SizeLimit

fn cmp(&self, __arg_0: &SizeLimit) -> Ordering

This method returns an Ordering between self and other.

impl PartialOrd for SizeLimit

fn partial_cmp(&self, __arg_0: &SizeLimit) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, __arg_0: &SizeLimit) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, __arg_0: &SizeLimit) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, __arg_0: &SizeLimit) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, __arg_0: &SizeLimit) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.