mirror of
https://github.com/stablyai/orca.git
synced 2026-11-02 01:57:57 +00:00
Neil
b6ffc2079b
* fix(windows): keep Orca's std handles out of every spawned child libuv spawns with bInheritHandles=TRUE, so an inheritable std handle reached long-lived children such as the WSL holder and the daemon and held a launcher's pipe open after Orca exited. Clear HANDLE_FLAG_INHERIT on the std handles at the top of main startup; stdio 'inherit' still works because libuv hands the child its own inheritable duplicate. * test(windows): model Orca's Electron main, which keeps std handles inheritable Plain Node clears its std handles' inherit flag at startup, so a Node child never reproduced the leak. Electron main opts out of that, which is why Orca leaks and why the control arm now runs Electron; a plain-Node arm pins the difference. * test(windows): say why the std-handle tests need longer timeouts
62 lines
2.4 KiB
TypeScript
62 lines
2.4 KiB
TypeScript
/** Every call throws an Error whose message names the Win32 call and its error code. */
|
|
|
|
export type GrantAccessOptions = {
|
|
/** Children inherit the grant (OI|CI). Only meaningful on a directory. */
|
|
inheritable: boolean
|
|
/**
|
|
* SET_ACCESS: drop every explicit rule for the trustee, allow and deny, then grant exactly
|
|
* `accessMask`. Otherwise GRANT_ACCESS: add `accessMask` to what the trustee is already allowed.
|
|
*/
|
|
replace: boolean
|
|
}
|
|
|
|
/** The process token's user SID, e.g. `S-1-5-21-…-1001`. */
|
|
export declare function currentUserSid(): string
|
|
|
|
/**
|
|
* One DACL entry as stored. `type` and `flags` are the raw ACE_HEADER bytes; `sid` is set only for
|
|
* plain allow (0) and deny (1) ACEs and is null for every other type.
|
|
*/
|
|
export type WindowsAce = { type: number; flags: number; mask: number; sid: string | null }
|
|
|
|
/** `protected` is SE_DACL_PROTECTED. */
|
|
export type WindowsDacl = { protected: boolean; aces: WindowsAce[] }
|
|
|
|
/** The path's DACL as structure, or null for a NULL DACL (which grants everyone everything). */
|
|
export declare function getDaclAces(path: string): WindowsDacl | null
|
|
|
|
/**
|
|
* Installs exactly the DACL in `sddl`. Its `P` flag picks protected or inheriting. A directory
|
|
* propagates to every existing descendant, which is seconds on a large tree.
|
|
*/
|
|
export declare function setDaclSddl(path: string, sddl: string): void
|
|
export declare function setDaclSddlAsync(path: string, sddl: string): Promise<void>
|
|
|
|
/** Creates a NEW file already carrying the DACL in `sddl`, then writes `data` into it. */
|
|
export declare function createFileWithDacl(path: string, sddl: string, data: Uint8Array): void
|
|
|
|
/**
|
|
* Adds an allow rule for `sid` to the existing DACL, keeping its protection state; Windows orders
|
|
* the result canonically. A NULL DACL already allows everyone, so it is left untouched.
|
|
*/
|
|
export declare function grantAccess(
|
|
path: string,
|
|
sid: string,
|
|
accessMask: number,
|
|
options: GrantAccessOptions
|
|
): void
|
|
export declare function grantAccessAsync(
|
|
path: string,
|
|
sid: string,
|
|
accessMask: number,
|
|
options: GrantAccessOptions
|
|
): Promise<void>
|
|
|
|
export type StdHandleInheritanceFailure = { stream: 'stdin' | 'stdout' | 'stderr'; code: number }
|
|
|
|
/**
|
|
* Makes the process's std handles non-inheritable, skipping absent ones. Never throws; returns the
|
|
* handles SetHandleInformation rejected (e.g. a legacy console pseudo-handle) with their Win32 code.
|
|
*/
|
|
export declare function clearStdHandleInheritance(): StdHandleInheritanceFailure[]
|