Andrea Fioraldi ce63b76558
Update to v0.15.3 (#3259)
Co-authored-by: Dominik Maier <domenukk@gmail.com>
Co-authored-by: Dongjia "toka" Zhang <tokazerkje@outlook.com>
2025-05-23 22:50:23 +02:00
..
2025-03-10 17:27:55 +01:00
2025-05-16 15:23:44 +02:00
2025-05-16 15:23:44 +02:00
2025-03-10 17:27:55 +01:00
2025-05-23 22:50:23 +02:00
2025-03-10 17:27:55 +01:00
2025-03-10 17:27:55 +01:00

rasan

rasan is a library intended to be used by a guest running in QEMU to support address sanitizer.

It has a modular design intended to support different use cases and environments. The following initial variants are implemented:

  • qasan - Intended as a drop in replacement for the original libqasan, this will interact with QEMU using the bespoke syscall interface to perform memory tracking and shadow mapping.
  • gasan - This is similar to qasan, but rather than having QEMU perform the management of the shadow memory and memory tracking, this work will be carried out purely in the guest (and hence should be more performant).
  • zasan - This variant is intended to have no dependencies on libc, nor any other libraries. It is intended to be used as a starting point for bare-metal targets or targets which have statically linked libc.

The componentized nature of the design is intended to permit the user to adapt rasan to their needs with minimal modification by selecting and combining alternative implementations of the various key components.

Features

  • dlmalloc - Enable support for the dlmalloc allocator backend.
  • guest - Enable support for shadow memory and tracking in the guest
  • host - Enable support for shadow memory and tracking in the host
  • libc - Enable use of LibcMmap to support creation of mappings using libc
  • linux - Enable use of LinuxMmap to support creation of mappings and host interaction using rustix.
  • std - Disable the magic used to support no_std environments

Testing

This project makes use of a number of unit and integration tests to validate the implementation.

Fuzzing

The project also includes a couple of fuzzing harnesses supported by cargo-fuzz in order to supplement unit and integration tests.