mck 0.7.1

Utility crate for the formal verification tool machine-check
Documentation
use crate::{
    abstr::BitvectorDomain,
    bitvector::{
        abstr::three_valued::RThreeValuedBitvector, refin::three_valued::RMarkBitvector, RBound,
    },
    concr::RConcreteBitvector,
    traits::misc::Meta,
};

impl Meta<RThreeValuedBitvector> for RMarkBitvector {
    fn proto_first(&self) -> RThreeValuedBitvector {
        // all known bits are 0
        let known_bits = self.marked_bits().to_u64();
        let bound = RBound::new(self.width);
        RThreeValuedBitvector::new_value_known(
            RConcreteBitvector::new(0, bound),
            RConcreteBitvector::new(known_bits, bound),
        )
    }

    fn proto_increment(&self, proto: &mut RThreeValuedBitvector) -> bool {
        // the marked bits should be split into possibilities
        let known_bits = self.marked_bits().to_u64();
        let bound = RBound::new(self.width);

        if known_bits == 0 {
            // if full-unknown, stop immediately after first to avoid shl overflow
            return false;
        }

        // manual addition-style updates: only update marked positions
        // start with lowest marked position
        // if it is 0 within current, update it to 1 and end
        // if it is 1, update it to 0, temporarily forget mark and update next
        // end if we overflow

        // work with bitvector of only values, the unknowns do not change
        let mut current = proto.umin().to_u64();
        let mut considered_bits = known_bits;

        loop {
            let one_pos = considered_bits.trailing_zeros();
            let one_mask = 1u64 << one_pos;
            if current & one_mask == 0 {
                // if considered bit is 0 within current, update it to 1 and end
                current |= one_mask;
                let result = RThreeValuedBitvector::new_value_known(
                    RConcreteBitvector::new(current, bound),
                    RConcreteBitvector::new(known_bits, bound),
                );

                *proto = result;
                return true;
            }
            // if it is 1, update it to 0, temporarily do not consider it and update next
            current &= !one_mask;
            considered_bits &= !one_mask;

            // end if we overflow
            // reset possibility to allow for cycling
            if considered_bits == 0 {
                *proto = self.proto_first();
                return false;
            }
        }
    }
}