Skip to content

Commit 2abdafc

Browse files
JeffreyDallasclaude
andcommitted
docs: mark the descriptor guarantee as POSIX-only
Review of solo-docs#308 noted the descriptor guarantee read as universal while the Windows caveat further down correctly describes a check-then-open. Scopes the earlier statement to POSIX and points at that note, so the two agree. Related to hiero-ledger/solo#5895 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Signed-off-by: Jeffrey Tang <jeffrey@swirldslabs.com>
1 parent d945412 commit 2abdafc

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

content/en/docs/advanced-solo-setup/subprocess-environment-filtering.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,8 +158,10 @@ than the path.
158158

159159
What that does and does not guarantee, stated precisely:
160160

161-
* **The file itself** is checked and read through the same descriptor, so its contents cannot be
162-
swapped between the check and the read.
161+
* **The file itself** — on POSIX only — is checked and read through the same descriptor, so its
162+
contents cannot be swapped between the check and the read. On Windows there is no equivalent
163+
no-follow open, so the symlink check is a check-then-open and carries a small race; see the
164+
Windows note below.
163165
* **The directories above it** are checked for a static misconfiguration — a group-writable
164166
`SOLO_HOME`, for instance. This is *not* race-free: someone who already has write access to one
165167
of those directories could replace a component between the check and the open. Closing that

0 commit comments

Comments
 (0)