| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950 |
- """The unusable scoped-lock dir report (#134889 W2). :mod:`gateway.status` raises it from
- ``acquire_scoped_lock``; nothing here reads back into that module."""
- from __future__ import annotations
- import logging
- from pathlib import Path
- from hermes_dir_acl import unusable_dir_remedy
- log = logging.getLogger("gateway.status")
- class ScopedLockDirUnusable(PermissionError):
- """This token cannot create, read or replace locks in the scoped-lock dir (#134889 W2).
- On Windows an elevated install/update creates ``gateway-locks`` owned by Administrators with
- no entry for the user; the same user's non-elevated gateway then gets ``Permission denied`` on
- every token lock. The adapter reports it once and names the repair; it stays retryable (the
- dir is shared by every token-locked adapter), so a repair is picked up without a restart. A
- ``PermissionError`` subclass so existing callers keep their handling.
- """
- # Lock dirs already reported unusable by this process: WARNING once per dir, DEBUG after, since the
- # reconnect watcher and every adapter sharing the dir re-enter the acquire path.
- _warned: set[Path] = set()
- def unusable_lock_dir(lock_dir: Path, exc: PermissionError) -> ScopedLockDirUnusable:
- """Log *lock_dir* as unusable (WARNING once, then DEBUG) and return the error to raise."""
- level = logging.DEBUG if lock_dir in _warned else logging.WARNING
- _warned.add(lock_dir)
- log.log(level, "Gateway lock directory %s is not usable by this process (%s); it was likely created "
- "by an elevated (administrator) Hermes. Platforms that need a token lock stay down until it "
- "is repaired. To repair, %s", lock_dir, exc, unusable_dir_remedy(lock_dir))
- return ScopedLockDirUnusable(exc.errno, f"gateway lock directory is not usable: {exc}", str(lock_dir))
- def unusable_lock_dir_recovered(lock_dir: Path) -> None:
- """A lock was taken in *lock_dir*: warn again if it ever becomes unusable later."""
- _warned.discard(lock_dir)
- def reset_unusable_lock_dir_reports() -> None:
- """Forget every report (a fresh process's view; tests)."""
- _warned.clear()
- def unusable_lock_dir_reported(lock_dir: Path) -> bool:
- return lock_dir in _warned
|