23 stable releases (3 major)

4.0.4 Mar 10, 2025
4.0.2 Dec 29, 2023
4.0.0 Jun 30, 2023
3.0.13 Jun 29, 2023
1.1.0 Jun 28, 2019

#3 in Windows APIs

Download history 104111/week @ 2024-12-28 169871/week @ 2025-01-04 197760/week @ 2025-01-11 171774/week @ 2025-01-18 182273/week @ 2025-01-25 204415/week @ 2025-02-01 204759/week @ 2025-02-08 179164/week @ 2025-02-15 198340/week @ 2025-02-22 189732/week @ 2025-03-01 210116/week @ 2025-03-08 219824/week @ 2025-03-15 219202/week @ 2025-03-22 231475/week @ 2025-03-29 244656/week @ 2025-04-05 237310/week @ 2025-04-12

969,912 downloads per month
Used in 449 crates (43 directly)

MIT/Apache

26KB
503 lines

fd-lock

crates.io version downloads docs.rs docs

Advisory cross-platform file locks using file descriptors. Adapted from mafintosh/fd-lock.

Note that advisory lock compliance is opt-in, and can freely be ignored by other parties. This means this crate should never be used for security purposes, but solely to coordinate file access.

Examples

Basic usage

use std::io::prelude::*;
use std::fs::File;
use fd_lock::RwLock;

// Lock a file and write to it.
let mut f = RwLock::new(File::open("foo.txt")?);
write!(f.write()?, "chashu cat")?;

// A lock can also be held across multiple operations.
let mut f = f.write()?;
write!(f, "nori cat")?;
write!(f, "bird!")?;

Installation

$ cargo add fd-lock

Safety

This crate uses unsafe on Windows to interface with windows-sys. All invariants have been carefully checked, and are manually enforced.

Contributing

Want to join us? Check out our "Contributing" guide and take a look at some of these issues:

References

License

MIT OR Apache-2.0

Dependencies

~2–11MB
~143K SLoC