pub struct VerifyDriver<'target, 'tcx> {
tcx: TyCtxt<'tcx>,
target: &'target FunctionTarget<'tcx>,
path_info: Vec<CallGroup<'tcx>>,
engine: VerifyEngine<'tcx>,
allow_repeat: usize,
}Expand description
Orchestrates the three-stage verification pipeline (backward data-dependency analysis → forward state simulation → SMT checking) for a single function under analysis.
Each VerifyDriver instance bundles together:
-
The problem statement (
target) — which unsafe checkpoints and raw-pointer dereferences exist, what safety contracts they demand, and what entry assumptions (from#[rapx::requires]) and struct invariants apply. -
The reachability model (
path_info) — SCC-aware acyclic paths from function entry to each checkpoint, produced by flattening the MIR control-flow graph with bounded loop unrolling. -
The verification engine (
engine) — a stateless pipeline shared across all (checkpoint, path, property) triples. -
The loop-unrolling budget (
allow_repeat) — caps how many extra iterations a loop body may appear beyond its first occurrence, trading completeness against path enumeration cost.
Verification proceeds in two phases per driver instance:
verify_function: checks safety properties at each unsafe checkpoint (callee#[rapx::requires]contracts).verify_struct_invariants: checks struct invariants at return-block checkpoints (constructors) or at all path endpoints (non-constructor methods).
Fields§
§tcx: TyCtxt<'tcx>§target: &'target FunctionTarget<'tcx>§path_info: Vec<CallGroup<'tcx>>§engine: VerifyEngine<'tcx>§allow_repeat: usizeImplementations§
Source§impl<'target, 'tcx> VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> VerifyDriver<'target, 'tcx>
pub fn new(tcx: TyCtxt<'tcx>, target: &'target FunctionTarget<'tcx>) -> Self
pub fn new_with_repeat( tcx: TyCtxt<'tcx>, target: &'target FunctionTarget<'tcx>, allow_repeat: usize, ) -> Self
Sourcepub fn target(&self) -> &'target FunctionTarget<'tcx>
pub fn target(&self) -> &'target FunctionTarget<'tcx>
Return the function target managed by this driver.
Sourcepub fn path_info(&self) -> &[CallGroup<'tcx>]
pub fn path_info(&self) -> &[CallGroup<'tcx>]
Return the per-callee call groups managed by this driver.
Sourcepub fn verify_function(&self) -> VerificationReport<'tcx>
pub fn verify_function(&self) -> VerificationReport<'tcx>
Run unsafe-checkpoint verification for the managed function target.
fn check_or_property( &self, report: &mut VerificationReport<'tcx>, view: &CheckpointCheckView<'_, '_, 'tcx>, property_index: usize, or_property: &Property<'tcx>, )
Sourcepub fn properties_for_callsite(
&self,
checkpoint: &Checkpoint<'tcx>,
) -> &'target [Property<'tcx>]
pub fn properties_for_callsite( &self, checkpoint: &Checkpoint<'tcx>, ) -> &'target [Property<'tcx>]
Return the required properties for a concrete unsafe checkpoint.
Dispatches on [CheckpointKind]: synthetic checkpoints (raw pointer
dereference, static mut access) carry their properties in
target.raw_ptr_deref_checks / target.static_mut_checks; real
unsafe calls look up target.callee_requires by callee DefId.
Sourcepub fn iter_callsite_checks(
&self,
) -> impl Iterator<Item = CheckpointCheckView<'_, 'target, 'tcx>> + '_
pub fn iter_callsite_checks( &self, ) -> impl Iterator<Item = CheckpointCheckView<'_, 'target, 'tcx>> + '_
Iterate over checkpoints together with their shared path tree and properties.
Sourcepub fn verify_struct_invariants(&self) -> VerificationReport<'tcx>
pub fn verify_struct_invariants(&self) -> VerificationReport<'tcx>
Run struct invariant verification for the managed function target.
For constructors (functions returning Self), paths are filtered to
return blocks to avoid unwinding paths where the struct may not be
fully initialised. For methods, all whole-CFG paths from
PathGraph::enumerate_paths_repeat are used directly.
fn build_invariant_trees( &self, is_constructor: bool, ) -> FxHashMap<CheckpointLocation, PathTree>
Auto Trait Implementations§
impl<'target, 'tcx> !RefUnwindSafe for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> !Send for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> !Sync for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> !UnwindSafe for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> DynSend for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> DynSync for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> Freeze for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> Unpin for VerifyDriver<'target, 'tcx>
impl<'target, 'tcx> UnsafeUnpin for VerifyDriver<'target, 'tcx>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more