docs/BUILDING.md

   1 # Building FriiDump
   2
   3 ## Windows
   4
   5 The maintained direct build path is:
   6
   7 ```powershell
   8 .\build_msvc32.cmd
   9 ```
  10
  11 It calls `.vscode\msvc32.cmd`, which currently locates the Visual Studio 2019
  12 Build Tools 32-bit environment, then invokes:
  13
  14 ```text
  15 cl @msvc32_friidump.rsp
  16 ```
  17
  18 The build script runs `friidump.exe --help` after compilation and packages a
  19 local result ZIP. These generated files are ignored by Git.
  20
  21 ## Linux / Unix
  22
  23 ```bash
  24 cmake -S . -B build -DBUILD_STATIC_BINARY=ON
  25 cmake --build build
  26 ./build/src/friidump --help
  27 ```
  28
  29 The standalone repository candidate was tested with GCC 14.2 and CMake. The
  30 build succeeded. The inherited `libfriidump/rs.c` shift-count warning remains
  31 open and should be corrected only as a separately reviewed source change.
  32
  33 ## External runtime requirements
  34
  35 Dumping requires operating-system access to the selected optical drive.
  36 Privileges and device permissions vary by platform. Avoid broadly running
  37 unrelated tools with elevated privileges; grant only the access required for
  38 the optical device.