concinnity-engine 0.18.64

Runtime engine for Concinnity: ECS schedule, graphics, spawn, streaming
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

// src/crash/native.rs
//
// Native fault capture (macOS mach exceptions, Windows SEH) via
// crash-handler. Faults in unsafe or driver code never reach the panic hook;
// this path writes the minidump first (the artifact that matters most, with
// the writer designed for a compromised context) and then attempts a sidecar
// text report with nonblocking snapshots. The fault is reported as unhandled
// so the OS default crash behavior still runs.

use super::report::{CrashReport, ReportKind, UtcTime, file_stem_at};
use super::write;
use crash_handler::{CrashContext, CrashEventResult, CrashHandler};
use std::sync::OnceLock;

// Keeps the handler (and its exception thread on macOS) alive for the
// process lifetime.
static HANDLER: OnceLock<CrashHandler> = OnceLock::new();

pub(crate) fn install() {
    if HANDLER.get().is_some() {
        return;
    }
    // SAFETY: the closure runs in a compromised context; it confines itself
    // to minidump-writer (built for that context), try_lock snapshots, and
    // bounded formatting.
    let event = unsafe {
        crash_handler::make_crash_event(|ctx: &CrashContext| {
            report_fault(ctx);
            CrashEventResult::Handled(false)
        })
    };
    if let Ok(handler) = CrashHandler::attach(event) {
        let _ = HANDLER.set(handler);
    }
}

fn report_fault(ctx: &CrashContext) {
    // The dump lands before the report is gathered. Naming it still costs a
    // path and a few directory probes, but everything else the report needs --
    // formatting the message, snapshotting the notes and the log ring, querying
    // process memory -- runs after the artifact with the compromised-context
    // writer is already on disk.
    let Some(dir) = concinnity_host::store::paths::crashes_dir() else {
        return;
    };
    let time = UtcTime::now();
    let stem = write::unique_stem(&dir, &file_stem_at(time));
    super::minidump::write_fault_dump(&dir, &stem, ctx);

    let mut report = CrashReport::gather_nonblocking(ReportKind::NativeFault, fault_message(ctx));
    report.time = time;
    let _ = write::write_report_named(&dir, &stem, &report);
    write::prune(&dir, write::RETAINED_REPORTS);
}

#[cfg(target_os = "macos")]
fn fault_message(ctx: &CrashContext) -> String {
    match ctx.exception {
        Some(e) => format!(
            "native fault: mach exception kind {:#x}, code {:#x}",
            e.kind, e.code
        ),
        None => "native fault: unknown mach exception".to_string(),
    }
}

#[cfg(target_os = "windows")]
fn fault_message(ctx: &CrashContext) -> String {
    format!(
        "native fault: exception code {:#010x} on thread {}",
        ctx.exception_code, ctx.thread_id
    )
}