docs/fusa: coverage-gap justifications and generic timer arch spec
Get series with b4
b4 am [email protected]Versions newest first
- v1 Latest2 patches 3 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/2 | docs/fusa: add coverage_gap.rst tabulating vGICv3 LCOV exclusionsdocs/ docs/ | +42 | 2 replies | |
| 2/2 | docs/fusa: add generic timer arch spec with ASCII diagramsdocs/ docs/ docs/ | +225 | 1 reply |
Reviews trailers per patch
1 of 2 patches has a Reviewed-by or Acked-by.
| Patch | Weber (US), Matthew L |
|---|---|
| 1/2 | |
| 2/2 | R-b |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [XEN PATCH v1 0/2] docs/fusa: coverage-gap justifications and generic timer arch spec
This series adds two pieces of Functional Safety documentation under docs/fusa/.
Patch 1 introduces docs/fusa/coverage_gap.rst, a table that records the code regions excluded from the coverage report because they are unreachable by design. Code that no test can reach (for example a defensive default arm of a switch that no caller can reach) would otherwise show up as a permanent coverage gap even though it is correct. Each exclusion is given a stable id, the excluded source location, and a justification stating why the code is unreachable and what would make it reachable again, so that a genuine gap is never hidden behind an LCOV marker. The two vGICv3 default arms are documented as the first entries.
Patch 2 adds the arm64 generic timer architecture specification under docs/fusa/architecture_specs/. An architecture spec is a prose document that explains how Xen uses a piece of hardware -- what the hardware does, which parts Xen drives directly, which parts it emulates for a guest, and how they interact over the lifetime of a VM. This one covers the Arm Generic Timer and traces to the existing XenSwdgn~arm64_generic_timer_* design requirements.
Both documents are wired into the docs/fusa Sphinx toctree.
Ayan Kumar Halder (2):
docs/fusa: add coverage_gap.rst tabulating vGICv3 LCOV exclusions docs/fusa: add generic timer arch spec with ASCII diagrams
.../fusa/architecture_specs/generic_timer.rst | 215 ++++++++++++++++++ docs/fusa/architecture_specs/index.rst | 9 + docs/fusa/coverage_gap.rst | 41 ++++ docs/fusa/index.rst | 2 + 4 files changed, 267 insertions(+) create mode 100644 docs/fusa/architecture_specs/generic_timer.rst create mode 100644 docs/fusa/architecture_specs/index.rst create mode 100644 docs/fusa/coverage_gap.rst
Signature · 1 line
2.25.1