dec7e45f7c
* libfuzzer: track unique runs instead of deduplicated runs - easier for consumers to notice when to recheck the covered bits. * move common definitions to `std.Build.Fuzz.abi`. build runner sends all the information needed to fuzzer web interface client needed in order to display inline coverage information along with source code.
56 lines
1.7 KiB
Zig
56 lines
1.7 KiB
Zig
//! This file is shared among Zig code running in wildly different contexts:
|
|
//! libfuzzer, compiled alongside unit tests, the build runner, running on the
|
|
//! host computer, and the fuzzing web interface webassembly code running in
|
|
//! the browser. All of these components interface to some degree via an ABI.
|
|
|
|
/// libfuzzer uses this and its usize is the one that counts. To match the ABI,
|
|
/// make the ints be the size of the target used with libfuzzer.
|
|
///
|
|
/// Trailing:
|
|
/// * pc_addr: usize for each pcs_len
|
|
/// * 1 bit per pc_addr, usize elements
|
|
pub const SeenPcsHeader = extern struct {
|
|
n_runs: usize,
|
|
unique_runs: usize,
|
|
pcs_len: usize,
|
|
lowest_stack: usize,
|
|
};
|
|
|
|
pub const ToClientTag = enum(u8) {
|
|
source_index,
|
|
coverage_update,
|
|
_,
|
|
};
|
|
|
|
/// Sent to the fuzzer web client on first connection to the websocket URL.
|
|
///
|
|
/// Trailing:
|
|
/// * std.debug.Coverage.String for each directories_len
|
|
/// * std.debug.Coverage.File for each files_len
|
|
/// * std.debug.Coverage.SourceLocation for each source_locations_len
|
|
/// * u8 for each string_bytes_len
|
|
pub const SourceIndexHeader = extern struct {
|
|
flags: Flags,
|
|
directories_len: u32,
|
|
files_len: u32,
|
|
source_locations_len: u32,
|
|
string_bytes_len: u32,
|
|
|
|
pub const Flags = packed struct(u32) {
|
|
tag: ToClientTag = .source_index,
|
|
_: u24 = 0,
|
|
};
|
|
};
|
|
|
|
/// Sent to the fuzzer web client whenever the set of covered source locations
|
|
/// changes.
|
|
///
|
|
/// Trailing:
|
|
/// * one bit per source_locations_len, contained in u8 elements
|
|
pub const CoverageUpdateHeader = extern struct {
|
|
tag: ToClientTag = .coverage_update,
|
|
n_runs: u64 align(1),
|
|
unique_runs: u64 align(1),
|
|
lowest_stack: u64 align(1),
|
|
};
|