Trait shellcoder::Op

pub trait Op: Debug {
    // Required method
    fn write_to(&self, out: impl AsMut<[u8]>) -> Result<usize>;
}

Generic interface for operations.

This trait describes a generic interface for operations. An operation is a function that outputs some data for building a payload.

Popular operations are implemented in this crates, such as ops::Fill, ops::WriteInteger or ops::WriteBuffer.

Required Methods

fn write_to(&self, out: impl AsMut<[u8]>) -> Result<usize>

Writes the operation to a buffer.

Errors

error::Error::OutputBufferTooSmall: the provided output buffer is too small to contain the result of the operation.

Examples

Writes an operation to a buffer.

use shellcoder::ops::Fill;
use shellcoder::Op as _;

let mut buffer = [0u8; 10];
Fill::new(10, b'A')
    .write_to(&mut buffer)?;
assert_eq!(&buffer, b"AAAAAAAAAA");

Writes to a buffer that is too small to contain the output of the operation.

use shellcoder::ops::WriteInteger;
use shellcoder::Op as _;

let mut buffer = [0u8; 3];
let error = WriteInteger::new_be(0xdeadbeefu32)
    .write_to(&mut buffer)
    .unwrap_err();
assert!(matches!(error, Error::OutputBufferTooSmall(4)));

Object Safety

This trait is not object safe.

Implementors

impl Op for Advance

impl Op for Fill

impl Op for WriteBuffer<'_>

impl<I> Op for WriteInteger<I>

where I: EncodableInteger,