**影响** 后端从「平台层里塞业务知识」改成「装配根 + 业务层自带 spec/菜单/路由」;闸门 5 道 → 6 道, 契约尺子 2 条 → 3 条;两把尺子**默认自起隔离后端** ⇒ 不用先起后端就能冒烟(CI 可跑)。 单测 220 passed / 0 failed;静态闸门 93 + 11 + 10 + 4 全绿;面 A 32/32、面 B 18/18 全绿。 **改动** - 后端:新增 `platform/guard.rs`(生产档弱口令守卫六条判据 + 配置级/库内级两道检查)、 `platform/menu.rs`(菜单 spec 的类型)、`bootstrap.rs`(装配根:唯一同时认识平台层与业务层的地方); 业务模块的菜单与路由下沉到 `modules/<app>.rs`,平台层只 `merge(modules::router())` 一次。 - 闸门:新增 `check-boundary.sh`(分层红线 CP1–CP6)、`check-contract.sh`(契约端点表 + 官方端点台账 ↔ 代码真实路由,CC2–CC10)、`check-citations.sh`(文档引文 `路径:行号` 逐条核对); `check-module.sh` 改为从契约期望值派生(63 → 93 条);三把尺子各带反自证用例。 - 契约:`docs/contract.md` 附录 A 扩成机器可读区段(`[ENDPOINT]` / `[FACE]` / `[OFFICIAL]` / `[RULER]` …) ⇒ 六把尺子的期望值只有一处;`[OFFICIAL]` 官方端点台账 53 行四态 ⇒ 覆盖 **8/47**(算出来的)。 - 尺子:`scripts/smoke_backend.sh` 让两把契约尺子默认自起隔离后端(显式给了 `B` ⇒ 不自起、不可达即退出码 2)。 - 文档:CLAUDE.md / SKILL.md / README.md / HANDOFF.md / HOWTO_MODULE.md / docs/* 同步到新结构与新闸门; 裁决 96 → 98 条(P91 尺子自起设计、P92 官方端点覆盖账本)。 Co-Authored-By: Claude Code <[email protected]>
124 lines
4.5 KiB
C
124 lines
4.5 KiB
C
/*
|
||
* ipc-reap —— macOS(SysV) 信号量泄漏回收器
|
||
*
|
||
* 🔴 为什么需要它:
|
||
* macOS(XNU) 的 SysV 信号量集**在创建进程退出后不回收**(与 Linux 不同,
|
||
* 且 macOS 不带 ipcrm/ipcs)⇒ 每次 `cargo test` 都会新建若干 PGlite 实例
|
||
* (本仓 7 个测试文件各 1 个 `Db::open_temp()`),
|
||
* 每个实例在 initdb 阶段 semget 一个 **nsems=20** 的 set,进程退出后这 20 个
|
||
* 信号量就永久留在系统表里。
|
||
* 累积到 kern.sysv.semmns(87381)上限后,**任何新的 PostgreSQL 实例都起不来**
|
||
* (initdb 报 `semget(...): No space left on device`)。
|
||
*
|
||
* 回收口径(刻意保守,宁可漏回收也不误伤活进程):
|
||
* ① 只回收 nsems == 20(= PGlite/postgres-pglite 的指纹)的 set;
|
||
* ② 只回收创建者 uid == 当前用户的 set(不碰 root / 其他用户的);
|
||
* ③ 只回收「最近一次操作时间」距今超过 --min-idle 秒的 set
|
||
* (活着的 PostgreSQL 会持续 semop ⇒ otime 是新的 ⇒ 不会被误删)。
|
||
*
|
||
* 用法:
|
||
* cc -O2 -o ipc-reap ipc-reap.c && ./ipc-reap [--dry-run] [--nsems 20]
|
||
* [--min-idle 3600] [--max-id 2000000]
|
||
* 退出码:0 = 正常(--dry-run 时不落任何修改) / 2 = 参数错
|
||
*/
|
||
|
||
#include <errno.h>
|
||
#include <stdio.h>
|
||
#include <stdlib.h>
|
||
#include <string.h>
|
||
#include <time.h>
|
||
#include <unistd.h>
|
||
#include <sys/sem.h>
|
||
|
||
static int g_dry_run = 0;
|
||
static int g_nsems = 20; /* PGlite 指纹 */
|
||
static long g_min_idle = 3600; /* 秒:最近操作距今超过它才算「死的」 */
|
||
static long g_max_id = 2000000;
|
||
|
||
static void usage(void)
|
||
{
|
||
fprintf(stderr,
|
||
"用法: ipc-reap [--dry-run] [--nsems N] [--min-idle SECONDS] [--max-id N]\n");
|
||
exit(2);
|
||
}
|
||
|
||
/** 当前还能新建多大的 set(每个建完立刻释放 ⇒ 净中性)⇒ 余量。 */
|
||
static long free_capacity(void)
|
||
{
|
||
long lo = 0, hi = 4096;
|
||
while (lo < hi) {
|
||
long mid = lo + (hi - lo + 1) / 2;
|
||
int id = semget(IPC_PRIVATE, (int)mid, 0600 | IPC_CREAT);
|
||
if (id == -1) {
|
||
hi = mid - 1;
|
||
} else {
|
||
semctl(id, 0, IPC_RMID);
|
||
lo = mid;
|
||
}
|
||
}
|
||
return lo;
|
||
}
|
||
|
||
int main(int argc, char **argv)
|
||
{
|
||
for (int i = 1; i < argc; i++) {
|
||
if (strcmp(argv[i], "--dry-run") == 0) {
|
||
g_dry_run = 1;
|
||
} else if (strcmp(argv[i], "--nsems") == 0 && i + 1 < argc) {
|
||
g_nsems = atoi(argv[++i]);
|
||
} else if (strcmp(argv[i], "--min-idle") == 0 && i + 1 < argc) {
|
||
g_min_idle = atol(argv[++i]);
|
||
} else if (strcmp(argv[i], "--max-id") == 0 && i + 1 < argc) {
|
||
g_max_id = atol(argv[++i]);
|
||
} else {
|
||
usage();
|
||
}
|
||
}
|
||
|
||
uid_t me = getuid();
|
||
time_t now = time(NULL);
|
||
long before = free_capacity();
|
||
|
||
long scanned_sets = 0, matched = 0, reaped = 0, freed_sems = 0, skipped_busy = 0;
|
||
|
||
for (long id = 0; id < g_max_id; id++) {
|
||
struct semid_ds ds;
|
||
if (semctl((int)id, 0, IPC_STAT, &ds) == -1)
|
||
continue;
|
||
scanned_sets++;
|
||
if ((int)ds.sem_nsems != g_nsems)
|
||
continue;
|
||
if (ds.sem_perm.cuid != me)
|
||
continue;
|
||
matched++;
|
||
if (now - ds.sem_otime < g_min_idle) {
|
||
skipped_busy++; /* 最近还被用过 ⇒ 大概率是活着的实例 */
|
||
continue;
|
||
}
|
||
if (!g_dry_run) {
|
||
if (semctl((int)id, 0, IPC_RMID) == -1) {
|
||
fprintf(stderr, " ⚠️ id=%ld IPC_RMID 失败:%s\n", id, strerror(errno));
|
||
continue;
|
||
}
|
||
}
|
||
reaped++;
|
||
freed_sems += ds.sem_nsems;
|
||
}
|
||
|
||
long after = g_dry_run ? before : free_capacity();
|
||
|
||
printf("回收前余量:最多可建 %ld 个信号量的 set\n", before);
|
||
printf("扫描 id 空间 [0, %ld):现存 set %ld 个\n", g_max_id, scanned_sets);
|
||
printf("命中口径(nsems=%d 且 uid=%d):%ld 个\n", g_nsems, (int)me, matched);
|
||
printf(" 其中最近被使用过(疑似活实例,保留):%ld 个\n", skipped_busy);
|
||
printf("%s:回收 %ld 个 set / %ld 个信号量\n",
|
||
g_dry_run ? "[dry-run] 本应回收" : "已回收", reaped, freed_sems);
|
||
printf("回收后余量:最多可建 %ld 个信号量的 set\n", after);
|
||
if (!g_dry_run && after < g_nsems) {
|
||
printf("⚠️ 余量仍不足 %d 个信号量 ⇒ 还有别处的占用(PGlite 需要 %d 个)\n",
|
||
g_nsems, g_nsems);
|
||
return 1;
|
||
}
|
||
return 0;
|
||
}
|