This utility provides a thin wrapper around RwLock
(and Mutex
in the future) for debugging lock stalls.
The wrapper keeps track of the callers' and creators' stackframes to provide debugging context.
- see debugging_locks_run.rs for reference
- you need to include debug symbols to see the stacktraces
using Env:
RUSTFLAGS=-g cargo build --release
or add to Cargo.toml:
[profile.release]
debug = true
(this will increase the binary size by 20x; performance/optimization of machine code is NOT affected)
there are two levels of information available:
- basic information about the lock (e.g. who got blocked and how log)
- stacktraces of the callers, the lock creator and the lock holder
env_logger::Builder::from_env(Env::default().default_filter_or("debug")).init();
RUST_LOG=rust_debugging_locks::debugging_locks=info the_binary
- detect if debug symbols are available and warn/fail if not
- define interface for callbacks
- remove hex from method name "debugging_locks_run.rs:rust_basics::debugging_locks_run::runit::hbcf42217d721148f"
- add string (e.g. hash) to each log line to allow grouping (using grep)
- enhance benchmark for rwlock wrapper
- symbolize stacktraces lazy; keep only the instruction pointer/symbol address
- check if last_returned_lock_from is expensive; if yes make it an optional feature
- make thresholds configurable (e.g. via env variables)
[2023-05-02T18:17:53Z INFO rust_debugging_locks::debugging_locks] NEW WRAPPED RWLOCK (v0.0.0)
[2023-05-03T09:33:26Z INFO rust_debugging_locks::debugging_locks] READER BLOCKED on thread main:ThreadId(1) for 7.597502ms (locktag xFxiD)
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> blocking call:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:60
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> current lock holder:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::{{closure}}::h56d46ee0d6ad82da:51
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> rwlock constructed here:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:47
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z INFO rust_debugging_locks::debugging_locks] READER BLOCKED on thread main:ThreadId(1) for 9.658057ms (locktag xFxiD)
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> blocking call:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:60
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> current lock holder:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::{{closure}}::h56d46ee0d6ad82da:51
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> rwlock constructed here:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:47
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z INFO rust_debugging_locks::debugging_locks] READER BLOCKED on thread main:ThreadId(1) for 20.825162ms (locktag xFxiD)
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> blocking call:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:60
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> current lock holder:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::{{closure}}::h56d46ee0d6ad82da:51
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> rwlock constructed here:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:47
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z INFO rust_debugging_locks::debugging_locks] READER BLOCKED on thread main:ThreadId(1) for 24.683994ms (locktag xFxiD)
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> blocking call:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:60
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> current lock holder:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::{{closure}}::h56d46ee0d6ad82da:51
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> rwlock constructed here:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:47
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z INFO rust_debugging_locks::debugging_locks] READER BLOCKED on thread main:ThreadId(1) for 38.673215ms (locktag xFxiD)
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> blocking call:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:60
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> current lock holder:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::{{closure}}::h56d46ee0d6ad82da:51
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> rwlock constructed here:
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::writer_blocks_reader::h90b32e8be4ee69f9:47
[2023-05-03T09:33:26Z DEBUG rust_debugging_locks::debugging_locks] |xFxiD> simple.rs!simple::main::h51d8a2c7c463da66:12
A locktag is assigned a RwLock instance when it is created. The locktag is used to group log lines together. The locktag is a hash of the stacktrace of the caller of the RwLock::new() method.