docs/reports/FRIIDUMP_CANDIDATE15_LINUX_BUILD_HYGIENE.md

   1 # FriiDump Candidate15 Linux Build Hygiene
   2
   3 ## Purpose
   4
   5 Candidate15 preserves Candidate14's explicit Linux `CAP_SYS_RAWIO` contract and
   6 least-privilege authorization workflow while correcting two issues exposed by
   7 the first user-side Candidate14 build.
   8
   9 ## Corrections
  10
  11 1. The Linux validator now clamps only source files whose modification times are
  12    in the future before CMake configuration. This prevents archive time-zone
  13    metadata from causing GNU Make `Clock skew detected` warnings.
  14 2. The production raw-I/O preflight no longer uses a potentially truncating
  15    `snprintf` fallback for the executable path.
  16 3. The native-report authorization note buffer was enlarged so the complete
  17    supported Linux path length fits without `-Wformat-truncation` diagnostics.
  18 4. Source-package ZIP member timestamps are normalized to a stable past date.
  19
  20 ## Preserved authorization behavior
  21
  22 - A normal Linux build never silently runs `sudo` or installs capabilities.
  23 - Vendor-command paths require effective `CAP_SYS_RAWIO`.
  24 - FriiDump refuses whole-process root execution for those paths.
  25 - The explicit capability phase applies only `cap_sys_rawio=ep` to the exact
  26   validated executable and verifies it with `getcap`.
  27 - Rebuilding or replacing the executable clears the capability.
  28
  29 ## Acceptance boundary
  30
  31 Candidate15 requires clean Linux and Windows builds, explicit capability
  32 installation on the exact Linux executable, and one short GCC-4244 B101 live
  33 smoke proving the runtime preflight and seed path.