Files
bare-operating-system/docs/schemas/bare-os-syscalls.schema.json
T
Raven Scott 64a1270d18 - disk.os: replication_operator_sketch schema 7 + corestoreSnapshotUxHint; wire corestore into bridge
- HRPC: bare_os.pkg_index_get, route table schema 3; pkg-swarm-index list/get; pathcap-verify --trusted
- POSIX: profile 1.0.17, ctx API 1.53.0, syscalls.json schema 11 + susv4Refs; JSON schemas + matrix/dashboard
- Feature bits: BARE_OS_KERNEL_FEATURE_BITS_DOC 16; contract + verify scripts; ctx.d.ts + gen helper sync
- Ops: BARE_OS_HOLEPUNCH_DRIFT_TIER1 + tier1Repos; mktemp avoids false XXX marker; /proc boot_budget_summary test list
- Docs: contract spine, env appendix, handbook, compatibility matrix, boot budget schema, vault threat model notes

Covers bare-os P2P roadmap items 1–20 where implemented in-tree; kernel/lib/bare/README left minimal per maintainer edit.
2026-04-05 15:52:59 -04:00

116 lines
3.6 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://bare-os.local/schemas/bare-os-syscalls.schema.json",
"title": "Bare OS /proc/bare_os/syscalls.json",
"type": "object",
"required": ["schemaVersion", "ops"],
"properties": {
"schemaVersion": { "type": "integer", "const": 11 },
"ctxApiVersion": { "type": "string" },
"posixProfile": {
"type": "object",
"properties": {
"id": { "type": "string" },
"version": { "type": "string" },
"utilitiesIndexPath": {
"type": "string",
"description": "VFS path to sparse POSIX utility coverage JSON (see posix-utilities.schema.json)"
}
}
},
"ops": {
"type": "array",
"items": { "type": "string" }
},
"opsDetail": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "category", "stability"],
"properties": {
"name": { "type": "string" },
"category": {
"type": "string",
"enum": ["fs", "proc", "ipc", "signal", "vfs_meta"]
},
"stability": { "type": "string", "enum": ["stable", "experimental"] },
"posixAlignment": {
"type": "string",
"enum": ["supported", "simulated", "partial", "ENOTSUP"]
},
"mapsTo": {
"type": "array",
"items": { "type": "string" }
},
"errnoHint": { "type": "string" },
"susv4Refs": {
"type": "array",
"items": { "type": "string" },
"description": "Stable Issue-7 / XSH trace tokens for audits"
}
}
}
},
"posixXsh": {
"type": "object",
"description": "POSIX.1 XSH logical names merged into opsDetail",
"properties": {
"schema": { "type": "integer" },
"note": { "type": "string" },
"namesCsv": { "type": "string" }
}
},
"socketMsgSurface": {
"type": "object",
"description": "sendmsg/recvmsg metadata (defaults ENOTSUP; bridge uses recv/recvfrom buffers only); schema 5 documents SOCK_STREAM logical SCM_RIGHTS parity with SOCK_DGRAM",
"properties": {
"schema": { "type": "integer" },
"ancillaryControl": {
"type": "object",
"properties": {
"supported": { "type": "boolean" },
"errno": { "type": "string" },
"rejectKeys": {
"type": "array",
"items": { "type": "string" }
},
"note": { "type": "string" }
}
},
"sendmsg": { "type": "object" },
"recvmsg": { "type": "object" }
}
},
"errnoHints": {
"type": "object",
"additionalProperties": { "type": "integer" }
},
"fdModel": {
"type": "object",
"description": "Logical FD table contract (guest); see process_table.json",
"properties": {
"schema": { "type": "integer" },
"note": { "type": "string" },
"stdio": { "type": "array", "items": { "type": "integer" } },
"register": { "type": "string" },
"processTablePath": { "type": "string" },
"processTableSchema": { "type": "integer" }
}
},
"signalModel": {
"type": "object",
"description": "Synthetic signal names for ctx.bareOsSendSignal",
"properties": {
"schema": { "type": "integer" },
"note": { "type": "string" },
"names": {
"type": "array",
"items": { "type": "string" }
}
}
},
"caps": { "type": "object" },
"atMs": { "type": "integer" }
}
}