#methods #convenience #locking #command

fcntl

Wrapper around fcntl (2) and convenience methods to make interacting with it easier

1 unstable release

0.1.0 Jul 24, 2020

#21 in #convenience

Download history 54/week @ 2024-07-21 29/week @ 2024-07-28 29/week @ 2024-08-04 23/week @ 2024-08-11 34/week @ 2024-08-18 68/week @ 2024-08-25 78/week @ 2024-09-01 65/week @ 2024-09-08 64/week @ 2024-09-15 39/week @ 2024-09-22 58/week @ 2024-09-29 62/week @ 2024-10-06 106/week @ 2024-10-13 44/week @ 2024-10-20 70/week @ 2024-10-27 143/week @ 2024-11-03

366 downloads per month

MIT/Apache

17KB
205 lines

fcntl-rs

Wrapper around fcntl (2) and convenience methods to make interacting with it easier. Currently only supports commands related to Advisory record locking.

Usage

Cargo.toml

[dependencies]
fcntl = "0.1"
use std::fs::OpenOptions;
use fcntl::{is_file_locked, lock_file, unlock_file};

// Open file
let file = OpenOptions::new().read(true).open("my.lock").unwrap();

// Check whether any process is currently holding a lock
match is_file_locked(&file, None) {
    Ok(true) => println!("File is currently locked"),
    Ok(false) => println!("File is not locked"),
    Err(err) => println!("Error: {:?}", err),
}


// Attempt to acquire a lock
match lock_file(&file, None, Some(FcntlLockType::Write)) {
    Ok(true) => println!("Lock acquired!"),
    Ok(false) => println!("Could not acquire lock!"),
    Err(err) => println!("Error: {:?}", err),
}


// Release lock again
match unlock_file(&file, None) {
    Ok(true) => println!("Lock successfully release"),
    Ok(false) => println!("Failed to release lock"),
    Err(err) => println!("Error: {:?}", err),
}

License

MIT OR Apache-2.0

Dependencies

~44KB