#buffer #network

buffering

A library primarily designed for network packet buffer operations

10 releases

0.5.0 Aug 5, 2020
0.4.2 Sep 24, 2019
0.3.4 Jun 25, 2019
0.3.2 May 3, 2019
0.1.0 Jul 22, 2018

#186 in Network programming

Download history 93/week @ 2020-05-12 70/week @ 2020-05-19 106/week @ 2020-05-26 130/week @ 2020-06-02 92/week @ 2020-06-09 66/week @ 2020-06-16 110/week @ 2020-06-23 152/week @ 2020-06-30 141/week @ 2020-07-07 149/week @ 2020-07-14 142/week @ 2020-07-21 102/week @ 2020-07-28 183/week @ 2020-08-04 303/week @ 2020-08-11 191/week @ 2020-08-18 180/week @ 2020-08-25

519 downloads per month
Used in 5 crates (3 directly)

BSD-3-Clause

4KB
55 lines

buffering

A library for handling buffer operations

Purpose

This library is primarily aimed at simple network serialization and deserialization for stack allocated struct types. It provides a macro to generate a union type that allows access to fields for inspection and the underlying buffer for network transfer.


lib.rs:

Approach

This crate is meant to provide a macro which behaves as follows:

  • The provided macro uses a more restrictive approach. It uses procedural macros and unions to provide some level of safety when writing to fields in a struct while allowing the underlying struct to be interpreted as a slice. This is a C-like workflow but does provide some helpful guarantees that come with Rust like protection against buffer overflows and bounds checking. One very important note is that structs that use the provided procedural macro must be completely stack allocated. Compilation will fail if certain constructs that prevent size computation at compile time are used. As a result this really should only be used as a Rust substitute with some additional safety for the common C workflow when doing things like parsing network packets.

Dependencies

~0.4–0.8MB
~21K SLoC