2026-10-01 23:29:49 +08:00
|
|
|
|
#ifndef UTSM_PANIC_H
|
|
|
|
|
|
#define UTSM_PANIC_H
|
|
|
|
|
|
|
|
|
|
|
|
#include <utsm/types.h>
|
|
|
|
|
|
|
|
|
|
|
|
/* ===================================================================
|
|
|
|
|
|
* F1: 内核 panic 统一兜底（莲花崩溃屏）
|
|
|
|
|
|
*
|
|
|
|
|
|
* 崩了也得崩出莲花：
|
|
|
|
|
|
* - 帧缓冲直接绘制（不走 console_fb 驱动——崩溃时驱动可能已挂）
|
|
|
|
|
|
* - 淡金莲花 + panic_symbol + 消息 + 寄存器简表
|
|
|
|
|
|
* - DRR 归档（crash_buf）后 halt
|
|
|
|
|
|
*
|
|
|
|
|
|
* 本路径只依赖：Limine framebuffer（Limine 常驻映射）+ serial + DRR
|
|
|
|
|
|
* Emergency Pool（静态区），不依赖堆/驱动/中断。
|
|
|
|
|
|
* =================================================================== */
|
|
|
|
|
|
|
|
|
|
|
|
/* 寄存器简表（可传 0：无异常帧的普通 panic） */
|
|
|
|
|
|
typedef struct panic_regs {
|
|
|
|
|
|
u64 rip;
|
|
|
|
|
|
u64 rsp;
|
|
|
|
|
|
u64 rflags;
|
|
|
|
|
|
u64 cs;
|
|
|
|
|
|
u64 err;
|
|
|
|
|
|
u64 vector;
|
|
|
|
|
|
u64 cr2;
|
|
|
|
|
|
u64 rax, rcx, rdx, rsi, rdi, r8, r9, r10, r11;
|
|
|
|
|
|
} panic_regs;
|
|
|
|
|
|
|
2026-10-12 23:57:19 +08:00
|
|
|
|
/* ===================================================================
|
|
|
|
|
|
* panic 模式（FUCK [panic] mode=strict|fallback，默认 strict）
|
|
|
|
|
|
*
|
|
|
|
|
|
* strict ：panic_full 画莲花屏 + DRR 归档 + halt，不返回（零降级铁律）。
|
|
|
|
|
|
* fallback：panic_full 只留串口坐标 + 计数后返回，调用点必须紧跟一条
|
|
|
|
|
|
* 可执行的备用路径（返回错误码 / 跳过该能力 / 回退实现）。
|
|
|
|
|
|
* 寄存器帧非空（CPU 异常）时无论模式都 halt。
|
|
|
|
|
|
*
|
|
|
|
|
|
* panic_halt 无视模式恒 halt，仅用于"没有任何可继续的状态"的终点：
|
|
|
|
|
|
* CPU 异常、LA57 激活（4 级页表 walk 会写坏内存）、DSK 交接失败、
|
|
|
|
|
|
* panic_test 演示钩子。
|
|
|
|
|
|
* =================================================================== */
|
|
|
|
|
|
|
|
|
|
|
|
/* 统一 panic 入口：strict 模式不返回；fallback 模式记录后返回 */
|
2026-10-01 23:29:49 +08:00
|
|
|
|
void panic_full(const char *symbol, const char *msg, const panic_regs *regs);
|
|
|
|
|
|
|
2026-10-12 23:57:19 +08:00
|
|
|
|
/* 恒 halt 的 panic（不受 fallback 模式影响） */
|
|
|
|
|
|
__attribute__((noreturn))
|
|
|
|
|
|
void panic_halt(const char *symbol, const char *msg, const panic_regs *regs);
|
|
|
|
|
|
|
|
|
|
|
|
/* 设置/查询 fallback 模式（kernel/main.c 读 FUCK 后设置一次） */
|
|
|
|
|
|
void panic_set_fallback(int enable);
|
|
|
|
|
|
int panic_fallback_enabled(void);
|
|
|
|
|
|
/* fallback 模式下被吞掉的 panic 次数 */
|
|
|
|
|
|
u32 panic_fallback_hits(void);
|
|
|
|
|
|
|
2026-10-01 23:29:49 +08:00
|
|
|
|
/* 兼容旧接口：panic("msg") = panic_full("UTSM-PANIC", msg, 0) */
|
|
|
|
|
|
void panic(const char *msg);
|
|
|
|
|
|
|
|
|
|
|
|
#endif /* UTSM_PANIC_H */
|
