refactor(decompress): move legacy threshold policy to Rust

Keep the target-specific ZSTD_LEGACY_SUPPORT macro in the C translation unit, but pass its scalar value through a Rust policy bridge before legacy dispatch. Rust now accepts only the historical supported range 1 through 7 and normalizes all other values, including a missing projection, to disabled. ABI assertions and focused tests preserve the compile-time configuration contract.

Test Plan: Not run in this atomic commit; the capped serial Rust, native, smoke, and original test-suite verification follows.
This commit is contained in:
2026-07-21 07:57:10 +02:00
parent 78c4118a67
commit f077d71e8b
2 changed files with 73 additions and 7 deletions
+18 -7
View File
@@ -187,6 +187,15 @@ typedef char ZSTD_rust_decompress_stack_callbacks_layout[
size_t ZSTD_rust_decompress_stack_action(
const ZSTD_rustDecompressStackProjection* projection,
const ZSTD_rustDecompressStackCallbacks* callbacks);
typedef struct {
unsigned configured_level;
} ZSTD_rustLegacySupportProjection;
typedef char ZSTD_rust_legacy_support_projection_layout[
(offsetof(ZSTD_rustLegacySupportProjection, configured_level) == 0
&& sizeof(ZSTD_rustLegacySupportProjection) == sizeof(unsigned))
? 1 : -1];
unsigned ZSTD_rust_legacy_support_policy(
const ZSTD_rustLegacySupportProjection* projection);
unsigned ZSTD_rust_legacy_support(void);
#if ZSTD_TRACE
@@ -352,15 +361,17 @@ void ZSTD_rust_dctx_trace_view(ZSTD_DCtx* dctx,
}
/* The Rust dispatcher has all version-specific legacy implementations. Keep
* the active C configuration as a leaf so test builds, which compile every
* Rust legacy module but vary this C macro per target, retain the historical
* support boundary. */
* the active C configuration as a scalar leaf so test builds, which compile
* every Rust legacy module but vary this C macro per target, retain the
* historical support boundary. Rust owns normalization of that scalar. */
unsigned ZSTD_rust_legacy_support(void)
{
#if defined(ZSTD_LEGACY_SUPPORT) && (ZSTD_LEGACY_SUPPORT >= 1) \
&& (ZSTD_LEGACY_SUPPORT <= 7)
return ZSTD_LEGACY_SUPPORT;
ZSTD_rustLegacySupportProjection const projection = {
#if defined(ZSTD_LEGACY_SUPPORT)
ZSTD_LEGACY_SUPPORT
#else
return 0;
0
#endif
};
return ZSTD_rust_legacy_support_policy(&projection);
}
+55
View File
@@ -299,6 +299,17 @@ struct ZSTD_rustDctxView {
dctx_size: usize,
}
#[repr(C)]
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub struct ZSTD_rustLegacySupportProjection {
pub configured_level: c_uint,
}
const _: () = {
assert!(offset_of!(ZSTD_rustLegacySupportProjection, configured_level) == 0);
assert!(size_of::<ZSTD_rustLegacySupportProjection>() == size_of::<c_uint>());
};
const _: () = {
assert!(offset_of!(ZSTD_rustDctxView, dctx) == 0);
assert!(offset_of!(ZSTD_rustDctxView, static_size) == 29 * size_of::<usize>());
@@ -645,6 +656,50 @@ unsafe fn configured_legacy_support() -> u32 {
}
}
/// Normalize the C build's legacy-support threshold before dispatch.
///
/// C supplies the active compile-time value because test builds intentionally
/// compile every legacy module while varying `ZSTD_LEGACY_SUPPORT`. Rust owns
/// the public policy that accepts levels 1 through 7 and treats every other
/// value as legacy-disabled.
#[no_mangle]
pub unsafe extern "C" fn ZSTD_rust_legacy_support_policy(
projection: *const ZSTD_rustLegacySupportProjection,
) -> c_uint {
let Some(projection) = (unsafe { projection.as_ref() }) else {
return 0;
};
let configured = projection.configured_level;
if (1..=7).contains(&configured) {
configured
} else {
0
}
}
#[cfg(test)]
mod legacy_support_policy_tests {
use super::*;
#[test]
fn preserves_supported_thresholds_and_disables_other_values() {
for (configured, expected) in [(0, 0), (1, 1), (4, 4), (7, 7), (8, 0), (c_uint::MAX, 0)] {
let projection = ZSTD_rustLegacySupportProjection {
configured_level: configured,
};
assert_eq!(
unsafe { ZSTD_rust_legacy_support_policy(&projection) },
expected
);
}
}
#[test]
fn rejects_missing_configuration_projection() {
assert_eq!(unsafe { ZSTD_rust_legacy_support_policy(ptr::null()) }, 0);
}
}
/* This is the Rust equivalent of ZSTD_isLegacy(). The v0.1 magic is the one
* historical exception: its bytes are checked as the little-endian constant
* 0x1EB52FFD, while v0.2 through v0.7 use the usual 0xFD2FB52N values. */