ovstorage-contributor-regenerate-c-headers

Use when Rust changes affect the ovstorage plugin ABI header and the checked-in generated copies must be refreshed.

SKILL.md

GitHub

Regenerate C Headers

Goal

Keep the checked-in copies of the plugin ABI header synchronized with the Rust source they are generated from.

Scope

Only ovstorage_plugin.h is generated, from the ovstorage-plugin crate. It has to be: plugins are prebuilt cdylibs loaded at runtime, so host and plugin compile separately and must agree on struct layout.

ovstorage.h is NOT generated. The C application API ships as source, so consumers compile that header together with the implementation it declares and there is no binary boundary to freeze. Edit it directly, alongside ovstorage-c-source/src; the link-completeness gate in make c-source-examples is what holds the two in agreement.

Recipe

  1. Make the ABI-affecting Rust change under ovstorage-core/ovstorage-plugin.
  2. Run make regenerate-headers.
  3. Inspect the diff under ovstorage-plugin/include and its copy in ovstorage-c-source/include.
  4. Run make verify-headers-clean.
  5. Commit the Rust source and regenerated headers together.

References