Struct gstuff::FileLock

pub struct FileLock<'a> {
    pub lock_path: &'a dyn AsRef<Path>,
    pub ttl_sec: f64,
    pub file: File,
}

Allows several threads or processes to compete for a shared resource by tracking resource ownership with a file.
If the lock file is older than ttl_sec then it is removed, allowing us to recover from a thread or process dying while holding the lock.

Fields

lock_path: &'a dyn AsRef<Path>

Filesystem path of the lock file.

ttl_sec: f64

The time in seconds after which an outdated lock file can be removed.

file: File

The owned lock file. Removed upon unlock.

Implementations

impl<'a> FileLock<'a>

pub fn lock( lock_path: &'a dyn AsRef<Path>, ttl_sec: f64, ) -> Result<Option<FileLock<'a>>, String>

Tries to obtain a file lock.

No blocking. Returns None if the file already exists and is recent enough (= locked).

The returned structure will automatically remove the lock file when dropped.

if let Some (lock) = try_s! (FileLock::lock (&"something.lock", 600.)) {
  // ... Your code here ...
  drop (lock)
}

Trait Implementations

impl<'a> Debug for FileLock<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Drop for FileLock<'a>

fn drop(&mut self)

Executes the destructor for this type.