Files
bare-operating-system/docs/concepts/posix-stance.md
T
2026-04-25 23:04:56 -04:00

24 lines
1.4 KiB
Markdown

# Concept — POSIX stance
Bare OS exposes a **POSIX-shaped** shell, **`/bin`**, and VFS, but it is **not** a certified UNIX kernel. The project publishes a **declared profile** so you know what is promised vs out of scope.
## What “POSIX-like” means here
- **Tier-1 `/bin`** — a curated set of utilities built from [bare-os-coreutils](../../packages/bare-os-coreutils/README.md); names and behavior are tracked against a declared profile and Issue 7 traceability docs.
- **Syscalls** — many operations go through **`ctx.bareOsSyscall`** and **`/proc`** JSON mirrors rather than a hardware trap interface — see the syscall facade map.
- **Sockets** — optional **socket FD bridge** behind env gates; not “Linux identical.”
## Where the contract lives
| Artifact | Role |
| --- | --- |
| [POSIX declared profile](../architecture/POSIX_DECLARED_PROFILE.md) | Narrative stance, non-goals |
| [POSIX compliance dashboard](../reference/posix-dashboard.md) | Generated summary |
| [POSIX Issue 7 traceability](../reference/posix-issue7-traceability.md) | XBD/XSH/XCU mapping |
| [Compatibility matrix](../reference/compatibility-matrix.md) | Profile version, ctx API, schemas |
## Read next
- **Handbook** — [Chapter 9 — POSIX, shell, VFS](../../handbook/09-posix-utilities-shell-and-vfs.md).
- **Reference** — [posix-syscall-facade-map.md](../reference/posix-syscall-facade-map.md) · [syscall-socket-contract.md](../reference/syscall-socket-contract.md).