Expand description
Versioned C ABI for hns_dane_engine.
Every entry point catches Rust panics. Pointer validity, allocation
ownership, and buffer lengths remain explicit caller obligations documented
in include/hns_dane_engine.h.
Structs§
- HnsDane
Attempt - Opaque admitted-attempt handle declaration.
- HnsDane
Engine - Opaque engine handle declaration.
- HnsDane
Policy V1 - Versioned C policy structure.
- HnsDane
Policy V2 - Versioned C policy structure with recursive-HNS-DoH requester consent.
- HnsDane
Provider Authority - Opaque authorized provider-context handle declaration.
- HnsDane
Provider Authority Info V1 - Immutable typed bindings carried by one authorized provider context.
- HnsDane
Result V1 - Versioned validated response summary.
- HnsDane
Transport Context V1 - Versioned transport identity context.
Enums§
- HnsDane
Status - C ABI status.
Constants§
- ABI_
IDENTITY_ CAPACITY - Maximum bytes in each fixed-size C transport identity.
- ABI_
VERSION - C ABI version implemented by this library.
- POLICY_
ABI_ VERSION_ V2 - Policy ABI version that exposes recursive-HNS-DoH requester consent.
- PREREQUISITES_
ALL_ VERIFIED - All caller-supplied prerequisite bits required before local DANE matching.
- PROVIDER_
AUTHORITY_ ABI_ VERSION_ V1 - Provider-authority consumer ABI version.
Functions§
- hns_
dane_ engine_ provider_ v1_ abi_ version - Return the provider-authority consumer ABI version without dereferencing caller memory.
- hns_
dane_ ⚠engine_ provider_ v1_ authority_ copy_ host - Copy the exact canonical logical-origin host from an opaque authority.
- hns_
dane_ ⚠engine_ provider_ v1_ authority_ destroy - Destroy an opaque provider-authority handle.
- hns_
dane_ ⚠engine_ provider_ v1_ authority_ get_ info - Read immutable typed bindings from an opaque provider authority.
- hns_
dane_ ⚠engine_ provider_ v1_ authority_ is_ current - Check an opaque authority against its retained engine and trusted time.
- hns_
dane_ engine_ v1_ abi_ version - Return the ABI version without dereferencing caller memory.
- hns_
dane_ ⚠engine_ v1_ admit - Admit one exact class-IN query on one transport.
- hns_
dane_ ⚠engine_ v1_ advance_ authority - Advance the explicit authority state machine.
- hns_
dane_ ⚠engine_ v1_ attempt_ destroy - Destroy an admitted attempt.
- hns_
dane_ ⚠engine_ v1_ create - Create an engine.
- hns_
dane_ ⚠engine_ v1_ destroy - Destroy an engine returned by the create function.
- hns_
dane_ ⚠engine_ v1_ export_ policy - Export the versioned persistent policy blob.
- hns_
dane_ ⚠engine_ v1_ get_ policy - Read the policy-V1 projection.
- hns_
dane_ ⚠engine_ v1_ set_ policy - Replace policy through the V1 fail-closed boundary.
- hns_
dane_ ⚠engine_ v1_ transport_ at - Read one current transport candidate by index.
- hns_
dane_ ⚠engine_ v1_ transport_ count - Return the number of currently ordered transport candidates.
- hns_
dane_ ⚠engine_ v1_ validate_ response - Parse, correlate, and locally match one TLSA response and certificate.
- hns_
dane_ engine_ v2_ abi_ version - Return the policy-v2 ABI version without dereferencing caller memory.
- hns_
dane_ ⚠engine_ v2_ get_ policy - Read typed current policy, including recursive-HNS-DoH requester consent.
- hns_
dane_ ⚠engine_ v2_ set_ policy - Replace typed policy, including recursive-HNS-DoH requester consent.
- provider_
authority_ into_ ffi - Move an authorized Rust context into a caller-owned opaque C handle.