A successful bindgen run proves that libclang parsed something. It does not prove that the resulting Rust types match the C library shipped in the target image. Make the parser’s target, headers, preprocessor configuration and ABI flags explicit, then compare generated layouts with an independent target C probe. This procedure is pinned to bindgen 0.71.1…
If a public header changes layout under a compile definition, the library and its consumers must receive a compatible value. Setting the definition only while building the library can produce a successful link with a mismatched consumer. Express the requirement on the CMake target, then verify the actual downstream compile command. This guide uses the…
An OpenSSL algorithm fetch can fail even when the expected provider files are installed. The requested implementation must be available in the application’s library context and satisfy its effective property query. Diagnose those two conditions before changing module paths or weakening cryptographic policy. This guide pins OpenSSL 3.5.7 primary documentation and an executed host fixture…
A useful compiler cache reuses an object only when the relevant compilation inputs still describe the same result. Before increasing hit rate, write down how compiler identity, generated headers, options and paths enter that decision. An unexplained cache hit is not evidence of reproducibility, and an explained miss can be the correct outcome. This procedure…
In a merged-usr image, /bin can be a symlink while /bin/tool remains a valid installed pathname. The compatibility question is whether package installers, overlays and inspection scripts preserve that structure. Test the path’s resolution and filesystem object type separately before changing an install prefix. This guide pins Buildroot 2025.02. An owned host fixture created relative…
A new input section can survive linking even when a custom linker script never mentions it. GNU BFD ld can create or select an output section for that orphan and place it according to target-specific rules. Treat a successful link as a reason to inspect the placement, not proof that the script accounts for every…
Qualify an AddressSanitizer build in stages: the compiler must instrument the application, the image must provide the matching userspace runtime, and the process must initialize its shadow-memory layout before a bug report is meaningful. A successful cross-link establishes none of the target startup or resource limits by itself. This guide pins GCC 14.2, its bundled…
When a local source edit does not affect a Buildroot package, compare the checkout file, synchronized build-tree file and generated output as three separate artifacts. OVERRIDE_SRCDIR does not compile directly in the original checkout. Its synchronization rules can preserve a newer destination file or exclude an input before the package build even starts. This guide…
A plugin boundary that exchanges polymorphic C++ objects needs more than matching exported function names. The host and plugin must agree on class definitions, runtime type information and exception identity. Test dynamic_cast and typed exception matching across the actual DSO boundary before treating the interface as compatible. This guide uses GCC 14.2, its libstdc++ ABI…
For 32-bit Arm objects, floating-point instruction support and floating-point argument passing are separate compatibility questions. A library can use hardware floating-point instructions while still accepting parameters through the base calling convention. Before mixing vendor archives, inspect the ABI attributes and the actual public call boundary, not just the CPU name. This procedure uses GCC 14.2’s…