Struct libafl::mutators::token_mutations::Tokens

pub struct Tokens { /* private fields */ }

A state metadata holding a list of tokens

Implementations

impl Tokens

The metadata used for token mutators

pub fn new() -> Self

Creates a new tokens metadata (old-skool afl name: dictornary)

pub fn add_tokens<IT, V>(&mut self, tokens: IT) -> &mut Self where
    IT: IntoIterator<Item = V>,
    V: AsRef<Vec<u8>>, 

Add tokens from a slice of Vecs of bytes

pub fn add_from_files<IT, P>(self, files: IT) -> Result<Self, Error> where
    IT: IntoIterator<Item = P>,
    P: AsRef<Path>, 

Build tokens from files

pub fn parse_autodict(&mut self, slice: &[u8], size: usize)

Parse autodict section

pub unsafe fn from_ptrs(
    token_start: *const u8,
    token_stop: *const u8
) -> Result<Self, Error>

Create a token section from a start and an end pointer Reads from an autotokens section, returning the count of new entries read

Safety

The caller must ensure that the region between token_start and token_stop is a valid region, containing autotokens in the exepcted format.

pub fn from_file<P>(file: P) -> Result<Self, Error> where
    P: AsRef<Path>, 

Creates a new instance from a file

pub fn add_token(&mut self, token: &Vec<u8>) -> bool

Adds a token to a dictionary, checking it is not a duplicate Returns false if the token was already present and did not get added.

pub fn add_from_file<P>(&mut self, file: P) -> Result<&mut Self, Error> where
    P: AsRef<Path>, 

Reads a tokens file, returning the count of new entries read

pub fn len(&self) -> usize

Returns the amount of tokens in this Tokens instance

pub fn is_empty(&self) -> bool

Returns if this tokens-instance is empty

pub fn tokens(&self) -> &[Vec<u8>]

Gets the tokens stored in this db

Trait Implementations

impl Add<&[Vec<u8, Global>]> for Tokens

type Output = Tokens

The resulting type after applying the + operator.

fn add(self, other: &[Vec<u8>]) -> Self

Performs the + operation.

impl Add<&Tokens> for &Tokens

type Output = Tokens

The resulting type after applying the + operator.

fn add(self, other: Self) -> Tokens

Performs the + operation.

impl Add<Tokens> for Tokens

type Output = Tokens

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self

Performs the + operation.

impl AddAssign<&[Vec<u8, Global>]> for Tokens

fn add_assign(&mut self, other: &[Vec<u8>])

Performs the += operation.

impl AddAssign<Tokens> for Tokens

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl AsSlice<Vec<u8, Global>> for Tokens

fn as_slice(&self) -> &[Vec<u8>]

Convert to a slice

impl Clone for Tokens

fn clone(&self) -> Tokens

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Tokens

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

Formats the value using the given formatter.

impl Default for Tokens

fn default() -> Tokens

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Tokens

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<IT, V> From<IT> for Tokens where
    IT: IntoIterator<Item = V>,
    V: AsRef<Vec<u8>>, 

fn from(tokens: IT) -> Self

Converts to this type from the input type.

impl<'it> IntoIterator for &'it Tokens

type Item = <Iter<'it, Vec<u8, Global>> as Iterator>::Item

The type of the elements being iterated over.

type IntoIter = Iter<'it, Vec<u8, Global>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl SerdeAny for Tokens

fn as_any(&self) -> &dyn Any

returns this as Any trait

fn as_any_mut(&mut self) -> &mut dyn Any

returns this as mutable Any trait

fn as_any_boxed(self: Box<Tokens>) -> Box<dyn Any>

returns this as boxed Any trait

impl Serialize for Tokens

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.