mirror of
https://github.com/stablyai/orca.git
synced 2026-10-08 00:02:38 +00:00
76c79f473a
* fix(linux): move Chromium shared memory off a tiny /dev/shm Containers such as GitHub Codespaces mount a 64 MB /dev/shm by default. When it fills, Chromium aborts the renderer (IMMEDIATE_CRASH, SIGILL/SIGTRAP) on every reload, trapping Orca in a renderer crash loop. On Linux, stat /dev/shm before app ready and append --disable-dev-shm-usage when it is under 512 MB or unreadable (ORCA_DEV_SHM=off|force overrides). Records a dev_shm_policy crash breadcrumb so future container crashes are diagnosable. * docs(linux): correct dev-shm hasSwitch rationale --------- Co-authored-by: m4air <m4air@m4airs-Air.localdomain> Co-authored-by: m4air <m4air@Mac.localdomain>
55 lines
1.8 KiB
TypeScript
55 lines
1.8 KiB
TypeScript
import { statfsSync } from 'node:fs'
|
|
import { app } from 'electron'
|
|
import { recordCrashBreadcrumb } from '../crash-reporting/crash-breadcrumb-store'
|
|
|
|
const DEV_SHM_PATH = '/dev/shm'
|
|
const DEV_SHM_OVERRIDE_ENV_VAR = 'ORCA_DEV_SHM'
|
|
// Why 512: Docker/Codespaces default to 64 MB, where Chromium's ring-buffer and
|
|
// texture allocations fail and IMMEDIATE_CRASH the renderer on every reload.
|
|
const MIN_DEV_SHM_TOTAL_MIB = 512
|
|
const MIB = 1024 * 1024
|
|
|
|
type DevShmReading = { totalMib: number; freeMib: number } | null
|
|
|
|
function readDevShm(): DevShmReading {
|
|
try {
|
|
const stats = statfsSync(DEV_SHM_PATH)
|
|
return {
|
|
totalMib: Math.floor((stats.blocks * stats.bsize) / MIB),
|
|
freeMib: Math.floor((stats.bavail * stats.bsize) / MIB)
|
|
}
|
|
} catch {
|
|
return null
|
|
}
|
|
}
|
|
|
|
/**
|
|
* On Linux hosts with a tiny or missing /dev/shm (containers, Codespaces),
|
|
* back Chromium shared memory with /tmp files instead of letting renderers abort.
|
|
*/
|
|
export function configureLinuxDevShmUsage(): void {
|
|
if (process.platform !== 'linux') {
|
|
return
|
|
}
|
|
const override = (process.env[DEV_SHM_OVERRIDE_ENV_VAR] ?? '').trim().toLowerCase()
|
|
const reading = readDevShm()
|
|
const reason =
|
|
override === 'off' || override === 'force'
|
|
? override
|
|
: reading === null
|
|
? 'unreadable'
|
|
: reading.totalMib < MIN_DEV_SHM_TOTAL_MIB
|
|
? 'small'
|
|
: 'ok'
|
|
const disable = reason === 'force' || reason === 'small' || reason === 'unreadable'
|
|
// Why hasSwitch: user argv may already carry it (headless serve appends its own later).
|
|
if (disable && !app.commandLine.hasSwitch('disable-dev-shm-usage')) {
|
|
app.commandLine.appendSwitch('disable-dev-shm-usage')
|
|
}
|
|
recordCrashBreadcrumb('dev_shm_policy', {
|
|
...(reading ? { devShmTotalMB: reading.totalMib, devShmFreeMB: reading.freeMib } : {}),
|
|
devShmUsageDisabled: disable,
|
|
reason
|
|
})
|
|
}
|