2022-01-11 20:02:46 +00:00
|
|
|
// Copyright 2022 Signal Messenger, LLC
|
|
|
|
// SPDX-License-Identifier: AGPL-3.0-only
|
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
import { app, crashReporter, ipcMain as ipc } from 'electron';
|
|
|
|
import { realpath, readdir, readFile, unlink, stat } from 'fs-extra';
|
2022-01-11 20:02:46 +00:00
|
|
|
import { basename, join } from 'path';
|
2024-02-13 21:41:48 +00:00
|
|
|
import { toJSONString as dumpToJSONString } from '@signalapp/libsignal-client/dist/Minidump';
|
|
|
|
import z from 'zod';
|
2022-01-11 20:02:46 +00:00
|
|
|
|
|
|
|
import type { LoggerType } from '../ts/types/Logging';
|
|
|
|
import * as Errors from '../ts/types/errors';
|
2024-05-02 19:52:53 +00:00
|
|
|
import { isProduction } from '../ts/util/version';
|
2023-04-20 21:23:19 +00:00
|
|
|
import OS from '../ts/util/os/osMain';
|
2022-01-11 20:02:46 +00:00
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
const dumpSchema = z
|
|
|
|
.object({
|
|
|
|
crashing_thread: z
|
|
|
|
.object({
|
|
|
|
frames: z
|
|
|
|
.object({
|
|
|
|
registers: z.unknown(),
|
|
|
|
})
|
|
|
|
.passthrough()
|
|
|
|
.array()
|
|
|
|
.optional(),
|
|
|
|
})
|
|
|
|
.passthrough()
|
|
|
|
.optional(),
|
|
|
|
})
|
|
|
|
.passthrough();
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
async function getPendingDumps(): Promise<ReadonlyArray<string>> {
|
|
|
|
const crashDumpsPath = await realpath(app.getPath('crashDumps'));
|
2022-01-20 01:50:16 +00:00
|
|
|
let pendingDir: string;
|
|
|
|
if (OS.isWindows()) {
|
|
|
|
pendingDir = join(crashDumpsPath, 'reports');
|
|
|
|
} else {
|
|
|
|
// macOS and Linux
|
|
|
|
pendingDir = join(crashDumpsPath, 'pending');
|
|
|
|
}
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
const files = await readdir(pendingDir);
|
|
|
|
|
|
|
|
return files.map(file => join(pendingDir, file));
|
|
|
|
}
|
|
|
|
|
|
|
|
async function eraseDumps(
|
|
|
|
logger: LoggerType,
|
|
|
|
files: ReadonlyArray<string>
|
|
|
|
): Promise<void> {
|
|
|
|
logger.warn(`crashReports: erasing ${files.length} pending dumps`);
|
|
|
|
await Promise.all(
|
|
|
|
files.map(async fullPath => {
|
|
|
|
try {
|
|
|
|
await unlink(fullPath);
|
|
|
|
} catch (error) {
|
|
|
|
logger.warn(
|
|
|
|
`crashReports: failed to unlink crash report ${fullPath} due to error`,
|
|
|
|
Errors.toLogFormat(error)
|
|
|
|
);
|
|
|
|
}
|
|
|
|
})
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
export function setup(
|
|
|
|
getLogger: () => LoggerType,
|
2024-05-02 19:52:53 +00:00
|
|
|
showDebugLogWindow: () => Promise<void>,
|
|
|
|
forceEnable = false
|
2024-02-13 21:41:48 +00:00
|
|
|
): void {
|
2024-05-02 19:52:53 +00:00
|
|
|
const isEnabled = !isProduction(app.getVersion()) || forceEnable;
|
|
|
|
|
|
|
|
if (isEnabled) {
|
|
|
|
getLogger().info(`crashReporter: ${forceEnable ? 'force ' : ''}enabled`);
|
|
|
|
crashReporter.start({ uploadToServer: false });
|
|
|
|
}
|
2022-01-11 20:02:46 +00:00
|
|
|
|
|
|
|
ipc.handle('crash-reports:get-count', async () => {
|
2024-05-02 19:52:53 +00:00
|
|
|
if (!isEnabled) {
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
const pendingDumps = await getPendingDumps();
|
|
|
|
if (pendingDumps.length !== 0) {
|
|
|
|
getLogger().warn(
|
|
|
|
`crashReports: ${pendingDumps.length} pending dumps found`
|
|
|
|
);
|
|
|
|
}
|
|
|
|
return pendingDumps.length;
|
|
|
|
});
|
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
ipc.handle('crash-reports:write-to-log', async () => {
|
2024-05-02 19:52:53 +00:00
|
|
|
if (!isEnabled) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
const pendingDumps = await getPendingDumps();
|
|
|
|
if (pendingDumps.length === 0) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
const logger = getLogger();
|
2024-02-13 21:41:48 +00:00
|
|
|
logger.warn(`crashReports: logging ${pendingDumps.length} dumps`);
|
2022-01-11 20:02:46 +00:00
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
await Promise.all(
|
2022-01-11 20:02:46 +00:00
|
|
|
pendingDumps.map(async fullPath => {
|
|
|
|
try {
|
2024-02-13 21:41:48 +00:00
|
|
|
const content = await readFile(fullPath);
|
|
|
|
const { mtime } = await stat(fullPath);
|
|
|
|
|
|
|
|
const dump = dumpSchema.parse(JSON.parse(dumpToJSONString(content)));
|
|
|
|
for (const frame of dump.crashing_thread?.frames ?? []) {
|
|
|
|
delete frame.registers;
|
|
|
|
}
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
logger.warn(
|
2024-02-13 21:41:48 +00:00
|
|
|
`crashReports: dump=${basename(fullPath)} ` +
|
|
|
|
`mtime=${JSON.stringify(mtime)}`,
|
|
|
|
JSON.stringify(dump, null, 2)
|
|
|
|
);
|
|
|
|
} catch (error) {
|
|
|
|
logger.error(
|
2022-01-11 20:02:46 +00:00
|
|
|
`crashReports: failed to read crash report ${fullPath} due to error`,
|
|
|
|
Errors.toLogFormat(error)
|
|
|
|
);
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
})
|
|
|
|
);
|
|
|
|
|
2024-02-13 21:41:48 +00:00
|
|
|
await eraseDumps(logger, pendingDumps);
|
|
|
|
await showDebugLogWindow();
|
2022-01-11 20:02:46 +00:00
|
|
|
});
|
|
|
|
|
|
|
|
ipc.handle('crash-reports:erase', async () => {
|
2024-05-02 19:52:53 +00:00
|
|
|
if (!isEnabled) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2022-01-11 20:02:46 +00:00
|
|
|
const pendingDumps = await getPendingDumps();
|
|
|
|
|
|
|
|
await eraseDumps(getLogger(), pendingDumps);
|
|
|
|
});
|
|
|
|
}
|