Function reset_dependencies

pub unsafe fn reset_dependencies<T: Traced>(traced: &T)

Reset the dependencies for the given entity.

Performance

This function locks the dependency graph to remove the item from it. This is an O(E) operation with E being the number of dependencies directly associated with this particular instance. As such, it is not advisable to call this method from a hot loop.

Safety

Use of this method invalidates the deadlock prevention guarantees that this library makes. As such, it should only be used when it is absolutely certain this will not introduce deadlocks later.

Other than deadlocks, no undefined behaviour can result from the use of this function.

Example

use tracing_mutex::stdsync::Mutex;
use tracing_mutex::util;

let first = Mutex::new(());
let second = Mutex::new(());

{
    let _first_lock = first.lock().unwrap();
    second.lock().unwrap();
}

// Reset the dependencies for the first mutex
unsafe { util::reset_dependencies(&first) };

// Now we can unlock the mutexes in the opposite order without a panic.
let _second_lock = second.lock().unwrap();
first.lock().unwrap();