Skip to main content

ParseOptions

Struct ParseOptions 

Source
pub struct ParseOptions {
    pub max_key_len: usize,
    pub max_collection_elements: usize,
    pub max_bulk_string_len: usize,
    pub max_depth: usize,
    pub max_total_items: usize,
}
Expand description

Configuration options for RESP value parsing.

These options allow customizing the DoS protection limits for different deployment scenarios. More restrictive limits provide better protection against resource exhaustion attacks.

Fields§

§max_key_len: usize

Maximum key length in bytes.

§max_collection_elements: usize

Maximum number of elements in a single collection.

§max_bulk_string_len: usize

Maximum size of a bulk string in bytes.

§max_depth: usize

Maximum nesting depth for recursive structures.

§max_total_items: usize

Maximum total items across all collections in a single parse.

This is the critical limit for preventing exponential allocation attacks from nested collections. Without this, an attacker could send nested arrays where total items = max_collection_elements^max_depth.

Implementations§

Source§

impl ParseOptions

Source

pub const fn new() -> Self

Create new parse options with default values.

Source

pub const fn max_key_len(self, len: usize) -> Self

Set the maximum key length.

Source

pub const fn max_collection_elements(self, count: usize) -> Self

Set the maximum collection element count.

Source

pub const fn max_bulk_string_len(self, len: usize) -> Self

Set the maximum bulk string length.

Source

pub const fn max_depth(self, depth: usize) -> Self

Set the maximum nesting depth.

Source

pub const fn max_total_items(self, count: usize) -> Self

Set the maximum total items across all collections.

Trait Implementations§

Source§

impl Clone for ParseOptions

Source§

fn clone(&self) -> ParseOptions

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ParseOptions

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ParseOptions

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Copy for ParseOptions

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.