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.
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!")?;
$ cargo add fd-lock
This crate uses unsafe
on Windows to interface with windows-sys
. All invariants have been carefully checked, and are manually enforced.
Want to join us? Check out our “Contributing” guide and take a look at some of these issues:
rustix::fs::flock
windows_sys::Win32::Storage::FileSystem::LockFile
MIT OR Apache-2.0