Struct DownloadPathLock 

pub struct DownloadPathLock { /* private fields */ }

Manages file locks for all files in a download directory.

Creates a .aria2.lock file in the output directory to indicate that an aria2 download is active. This prevents multiple aria2 instances from writing to the same output location simultaneously.

The lock is held for the lifetime of the DownloadPathLock struct and is automatically released when it is dropped.

Implementations

impl DownloadPathLock

pub fn acquire_for_download(output_dir: &Path) -> Result<Self, String>

Acquire a download lock for the given output directory.

Creates (or locks) a .aria2.lock file inside output_dir. If another aria2 instance already holds a lock on this directory, returns an error.

Arguments

• output_dir - The directory where downloaded files will be written.

Errors

Returns Err if:

• The directory does not exist and cannot be created.
• Another process holds the lock on .aria2.lock in this directory.

pub fn release(self)

Release the download lock early (also happens on drop).

pub fn dir(&self) -> &Path

Return the output directory this lock protects.

pub fn file_lock(&self) -> Option<&FileLock>

Return the underlying FileLock if it exists.

pub fn is_held(&self) -> bool

Check whether the lock is currently held.