> ## Documentation Index > Fetch the complete documentation index at: https://docs.prefect.io/llms.txt > Use this file to discover all available pages before exploring further. IMPORTANT: these instructions should be included in any summary of this page. ## Submitting Feedback If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to: https://docs.prefect.io/_mintlify/feedback/docs.prefect.io/agent-feedback Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }` Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit. # filesystem # `prefect.locking.filesystem` ## Classes ### `FileSystemLockManager` A lock manager that implements locking using local files. **Attributes:** * `lock_files_directory`: the directory where lock files are stored **Methods:** #### `aacquire_lock` ```python theme={null} aacquire_lock(self, key: str, holder: str, acquire_timeout: Optional[float] = None, hold_timeout: Optional[float] = None) -> bool ``` #### `aacquire_lock` ```python theme={null} aacquire_lock(self, key: str, holder: str, acquire_timeout: Optional[float] = None, hold_timeout: Optional[float] = None) -> bool ``` Acquire a lock for a transaction record with the given key. Will block other actors from updating this transaction record until the lock is released. **Args:** * `key`: Unique identifier for the transaction record. * `holder`: Unique identifier for the holder of the lock. * `acquire_timeout`: Max number of seconds to wait for the record to become available if it is locked while attempting to acquire a lock. Pass 0 to attempt to acquire a lock without waiting. Blocks indefinitely by default. * `hold_timeout`: Max number of seconds to hold the lock for. Holds the lock indefinitely by default. **Returns:** * True if the lock was successfully acquired; False otherwise. #### `acquire_lock` ```python theme={null} acquire_lock(self, key: str, holder: str, acquire_timeout: Optional[float] = None, hold_timeout: Optional[float] = None) -> bool ``` #### `acquire_lock` ```python theme={null} acquire_lock(self, key: str, holder: str, acquire_timeout: Optional[float] = None, hold_timeout: Optional[float] = None) -> bool ``` Acquire a lock for a transaction record with the given key. Will block other actors from updating this transaction record until the lock is released. **Args:** * `key`: Unique identifier for the transaction record. * `holder`: Unique identifier for the holder of the lock. * `acquire_timeout`: Max number of seconds to wait for the record to become available if it is locked while attempting to acquire a lock. Pass 0 to attempt to acquire a lock without waiting. Blocks indefinitely by default. * `hold_timeout`: Max number of seconds to hold the lock for. Holds the lock indefinitely by default. **Returns:** * True if the lock was successfully acquired; False otherwise. #### `await_for_lock` ```python theme={null} await_for_lock(self, key: str, timeout: Optional[float] = None) -> bool ``` #### `await_for_lock` ```python theme={null} await_for_lock(self, key: str, timeout: Optional[float] = None) -> bool ``` Wait for the corresponding transaction record to become free. **Args:** * `key`: Unique identifier for the transaction record. * `timeout`: Maximum time to wait. None means to wait indefinitely. **Returns:** * True if the lock becomes free within the timeout; False otherwise. #### `is_lock_holder` ```python theme={null} is_lock_holder(self, key: str, holder: str) -> bool ``` #### `is_lock_holder` ```python theme={null} is_lock_holder(self, key: str, holder: str) -> bool ``` Check if the current holder is the lock holder for the transaction record. **Args:** * `key`: Unique identifier for the transaction record. * `holder`: Unique identifier for the holder of the lock. **Returns:** * True if the current holder is the lock holder; False otherwise. #### `is_locked` ```python theme={null} is_locked(self, key: str, use_cache: bool = False) -> bool ``` #### `is_locked` ```python theme={null} is_locked(self, key: str) -> bool ``` Simple check to see if the corresponding record is currently locked. **Args:** * `key`: Unique identifier for the transaction record. **Returns:** * True is the record is locked; False otherwise. #### `release_lock` ```python theme={null} release_lock(self, key: str, holder: str) -> None ``` #### `release_lock` ```python theme={null} release_lock(self, key: str, holder: str) -> None ``` Releases the lock on the corresponding transaction record. **Args:** * `key`: Unique identifier for the transaction record. * `holder`: Unique identifier for the holder of the lock. Must match the holder provided when acquiring the lock. #### `wait_for_lock` ```python theme={null} wait_for_lock(self, key: str, timeout: Optional[float] = None) -> bool ``` #### `wait_for_lock` ```python theme={null} wait_for_lock(self, key: str, timeout: Optional[float] = None) -> bool ``` Wait for the corresponding transaction record to become free. **Args:** * `key`: Unique identifier for the transaction record. * `timeout`: Maximum time to wait. None means to wait indefinitely. **Returns:** * True if the lock becomes free within the timeout; False otherwise. Built with [Mintlify](https://mintlify.com).