Module hardware 

Machine description and a disk read sample for benchmark provenance.

Portable facts come from libc: kernel, memory, CPU count, and the volume holding the model. GPU and drive identity come from system_profiler on macOS and are absent elsewhere. Only hardware-class fields are recorded; serial numbers, host names and user paths stay out so a report can be shared.

Constants

READ_BLOCK 🔒

READ_SAMPLE_BYTES

Bytes sampled from the expert store to estimate uncached read bandwidth.

READ_SAMPLE_THREADS

Parallel readers for the sample, matching the engine’s per-record fan-out.

Functions

archive

Zip a results directory beside itself for sharing; returns the archive path. Entries sit under the directory’s name so the archive unpacks to a folder wherever it is sent.

bypass_cache 🔒

Advisory: keep the sample off the page cache so it measures the device.

describe

Describe this machine and the volume holding the prepared artifact model. A probe that fails records its error in place instead of aborting the benchmark.

kernel

sysname release machine, the fields of uname -srm.

or_error 🔒

os_version 🔒

Product version of the operating system, where the platform reports one.

physical_memory

Installed physical memory in bytes.

profile 🔒

Chip, GPU and drive identity. macOS exposes these through system_profiler; other platforms record nothing here.

profile_fields

Pick the hardware-class fields from system_profiler -json output.

read_rate

Read bytes from path past the page cache with threads parallel readers at spread offsets, and report the achieved rate in decimal GB/s.

read_uncached 🔒

volume

Capacity and free space of the file system holding path.