bitwrap

Intro

bitwrap is a derive macro and interface to declare a struct data member with explicit size, in bits.

Example

bits attribute accept only one argument - field size in bits. For example packet has next format:

| Field | Bits | |---|---| | f1 | 1 | | f2 | 1 | | f3 | 2 | | f4 | 4 | | f5 | 16 |

```rust use bitwrap::*;

[derive(Default, BitWrap)]

struct Packet { #[bits(1)] f1: u8, #[bits(1)] f2: u8, #[bits(2)] f3: u8, #[bits(4)] f4: u8, #[bits(16)] f5: u16, }

const DATA: &[u8] = &[0xAA, 0x12, 0x34];

let mut packet = Packet::default(); packet.unpack(DATA);

asserteq!(packet.f1, 1); asserteq!(packet.f2, 0); asserteq!(packet.f3, 2); asserteq!(packet.f4, 0x0A); assert_eq!(packet.f5, 0x1234);

let mut buffer: Vec = Vec::new(); buffer.resize(3, 0); let result = packet.pack(&mut buffer);

assert_eq!(&buffer[.. result], DATA); ```

Nested objects

Nested field is an object with BitWrap interface.

For example part of IPv4 packet:

| Field | Bits | |---|---| | ttl | 8 | | protocol | 8 | | checksum | 16 | | src | 32 | | dst | 32 |

```rust use std::net::Ipv4Addr; use bitwrap::*;

[derive(BitWrap)]

struct IP4 { #[bits(8)] ttl: u8, #[bits(8)] protocol: u8, #[bits(16)] checksum: u16, #[bitwrap] src: Ipv4Addr, #[bitwrap] dst: Ipv4Addr, }

const DATA: &[u8] = &[ 0x40, 0x88, 0x37, 0x5D, 0xC0, 0xA8, 0xC8, 0xB0, 0xC0, 0xA8, 0xC8, 0xB7, ];

let mut packet = IP4 { ttl: 0, protocol: 0, checksum: 0, src: Ipv4Addr::new(0, 0, 0, 0), dst: Ipv4Addr::new(0, 0, 0, 0), };

packet.unpack(DATA);

asserteq!(packet.ttl, 64); asserteq!(packet.protocol, 136); asserteq!(packet.checksum, 0x375D); asserteq!(packet.src, Ipv4Addr::new(192, 168, 200, 176)); assert_eq!(packet.dst, Ipv4Addr::new(192, 168, 200, 183));

let mut buffer: Vec = Vec::new(); buffer.resize(32, 0); let result = packet.pack(&mut buffer);

assert_eq!(&buffer[.. result], DATA); ```

Skip bits

Some packets contains reserved or fixed bits. This bits could be skiped with bits_skip attribute. For example packet has next format:

| Field | Bits | |---|---| | Data | 6 | | 0b00 | 2 | | 0b1111 | 4 | | Data | 4 |

bits_skip attribute accept next arguments:

• size in bits
• value. optional argument. by the default: 0

```rust use bitwrap::*;

[derive(Default, BitWrap)]

struct Packet { #[bits(6)] f1: u8, #[bitsskip(2)] #[bitsskip(4, 0b1111)] #[bits(4)] f2: u8, }

const DATA: &[u8] = &[0xAC, 0xF5];

let mut packet = Packet::default(); packet.unpack(DATA);

asserteq!(packet.f1, 0x2B); asserteq!(packet.f2, 0x05);

let mut buffer: Vec = Vec::new(); buffer.resize(2, 0); let result = packet.pack(&mut buffer);

assert_eq!(&buffer[.. result], DATA); ```