Repository navigation
Releases
lssbi 0.0.1
lssbi 0.0.1 adds stable machine-readable output and deterministic per-hart firmware feature queries.
Highlights
- Add
--jsonwith a stable, locale-independent schema that preserves raw SBI values and probe error/value pairs. - Add
--cpu <N>to select the Linux CPU used for FWFT queries and report both the Linux CPU ID and SBI hart ID. - Distinguish unsupported SBI extensions from failed probes while retaining implementation-defined probe values.
- Preserve XLEN-sized register values exactly as hexadecimal strings in JSON.
- Decode version numbers for known SBI implementations, including the RustSBI patch component.
- Localize CPU-selection diagnostics and explain malformed, unavailable, and affinity-restricted CPU values.
- Preserve unsigned SBI values in the DKMS backend when the highest XLEN bit is set.
Debian packaging revision 0.0.1-2
- Build the
lssbi_probeDKMS module during installation and try to load it immediately. - Support both riscv64 and riscv32 userspace and DKMS builds.
- Provide an experimental static RV32GC/ILP32D musl build.
Download the matching userspace package and the common DKMS package into the
same directory, then install both with APT.
For riscv64:
sudo apt install ./lssbi-dkms_0.0.1-2_all.deb \
./lssbi_0.0.1-2_riscv64.debFor riscv32:
sudo apt install ./lssbi-dkms_0.0.1-2_all.deb \
./lssbi_0.0.1-2_riscv32.debAPT installs the userspace command and its matching DKMS backend, resolves the
DKMS dependency, and builds lssbi_probe for the running kernel. Matching
kernel headers must be installed or available from the configured package
sources. If automatic module loading fails, run:
sudo modprobe lssbi_probeThe riscv32 package is an experimental custom dpkg-format package for
RV32GC/ILP32D Linux. Debian does not currently define an official riscv32
architecture, so the target distribution's dpkg and APT must recognize
riscv32. The executable is statically linked with musl; the DKMS module still
requires a compatible riscv32 Linux kernel and matching headers.
Requirements
- RISC-V Linux booted through SBI
- DKMS, GNU Make, and headers matching the running kernel
- Kernel module support and permission to load
lssbi_probe
The source archive contains the userspace command and its matching DKMS backend.
Full changelog: v0.0.0...v0.0.1
lssbi 0.0.0
lssbi 0.0.0 is the first published release of the Linux command for inspecting
the active RISC-V SBI environment.
Highlights
- Report the SBI specification version, implementation, implementation version,
and RISC-V machine vendor, architecture, and implementation identifiers. - Probe all 16 current standard SBI extensions and optionally show the nine
deprecated SBI v0.1 calls with--legacy. - Read all six standard Firmware Features extension values from the calling
hart. - Detect potentially affected OpenSBI versions for the PMU2 crash issue
(CVE-2025-63913) without triggering the vulnerability. - Run the command without privileges after the read-only
lssbi_probeDKMS
backend has been installed and loaded by an administrator. - Provide Arabic, French, Russian, Spanish, Simplified Chinese, and Traditional
Chinese translations in addition to the English fallback.
Installation
The userspace command is available from crates.io:
cargo install lssbi --version 0.0.0cargo install installs only the command. The current release also requires the
DKMS backend and matching Linux kernel headers. Install the backend from the
release source:
git clone --branch v0.0.0 --depth 1 https://github.com/rustsbi/lssbi.git
cd lssbi
sudo dkms add .
sudo dkms build lssbi/0.0.0
sudo dkms install lssbi/0.0.0
sudo modprobe lssbi_probeThe command can then be run as an ordinary user:
lssbi
lssbi --legacyRequirements
- riscv64 Linux booted through SBI
- DKMS, GNU Make, and headers matching the running kernel
- Kernel module support and a policy that permits
lssbi_probeto be loaded
This is an initial 0.0.0 release. Its command output and backend interface may
change in later releases.