Skip to content

Releases

lssbi 0.0.1

Choose a tag to compare

@luojia65 luojia65 released this 23 Aug 14:43

lssbi 0.0.1 adds stable machine-readable output and deterministic per-hart firmware feature queries.

Highlights

  • Add --json with 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_probe DKMS 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.deb

For riscv32:

sudo apt install ./lssbi-dkms_0.0.1-2_all.deb \
    ./lssbi_0.0.1-2_riscv32.deb

APT 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_probe

The 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

Choose a tag to compare

@luojia65 luojia65 released this 21 Aug 04:00

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_probe DKMS
    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.0

cargo 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_probe

The command can then be run as an ordinary user:

lssbi
lssbi --legacy

Requirements

  • riscv64 Linux booted through SBI
  • DKMS, GNU Make, and headers matching the running kernel
  • Kernel module support and a policy that permits lssbi_probe to be loaded

This is an initial 0.0.0 release. Its command output and backend interface may
change in later releases.

Links