← Rule catalog

Clippy · Correctness

Mutex guard held across an await point

clippy::await_holding_lock

Drop the guard before the await point, or use a lock designed to be held across await.

Category
Correctness
Default level
warn
Tier
P1
Producer
Clippy
Diff scope
item

Not a defect when

No other task can lock the mutex while the future is suspended, such as a mutex created inside the future and never shared, so holding the guard across the await cannot deadlock.

What it reads

Clippy, with the compiler behind it. The only pass that compiles.

Tier

Serious: worth interrupting other work for.

The tier bounds how severe a rule may be; its category bounds the tier.

Diff scope

The function or item around the changed line.

What --scope contextual looks at to decide whether a change caused the finding.

Change it

Turn it off, or make it blocking, without touching the code it flags:

rust-doctor --rule clippy::await_holding_lock=off .
rust-doctor --rule clippy::await_holding_lock=error .

Set it once in rust-doctor.toml

Upstream

Clippy's own documentation for this lint

Other Correctness rules