--- name: solnix-rules description: > The shared Solnix rule library the persona skills point into: one rule per file on SMF, ZFS, boot environments, zones, Crossbow networking, FMA, RBAC, DTrace, users and updates, build systems, the illumos link editor, event ports, libc and /proc differences, GNU vs xpg4 tools, configure traps, libumem, mdb, and Solnix recipes. Load a single rule when a persona names it, or when a task spans several personas. license: CC0-1.0 metadata: author: solnix version: "0.3.0" --- # Solnix rule library Each rule is one file, `-.md`, in the same shape: - the rule, and what goes wrong without it; - **Antipattern**: the habit from Linux, a BSD or upstream illumos; - **The Solnix way**: what to do on Solnix; - **The illumos way**: what OpenIndiana, OmniOS and SmartOS do; - **The difference.**: why they differ, or "same as illumos"; - **Check.**: one command whose output shows the rule holds; - **Sources**: the man page sections, handbook anchors, Solnix commits and handoffs it rests on. Anything not verified is under **Unverified**. Impact: CRITICAL (data loss, lock-out, wrong binaries shipped), HIGH (a broken build, service or rollback), MEDIUM (wasted time, surprising behaviour), LOW (style). The full list, with titles and impact, is in [`CATALOG.md`](../../CATALOG.md), generated from these files. ## Areas | prefix | area | persona | |---|---|---| | `smf-` | services | sysadmin | | `zfs-` | pools, datasets, snapshots | sysadmin | | `be-` | boot environments and generations | sysadmin, user | | `zones-` | native and LX zones | sysadmin | | `net-` | Crossbow: dladm, ipadm, flowadm | sysadmin | | `fma-` | fault management | sysadmin | | `rbac-` | roles, profiles, pfexec | sysadmin | | `dtrace-` | tracing | sysadmin, porter | | `users-` | accounts and updates, the Solnix way | sysadmin, user | | `build-` | configure, cmake, meson, compiler traps | porter | | `link-` | the illumos link editor | porter, nix-dev | | `api-` | kernel and libc API differences | porter | | `shell-` | userland tool differences | porter, user | | `lx-` | LX zones vs native ports | porter | | `debug-` | libumem, mdb | porter | | `recipe-` | packaging for Solnix | porter, nix-dev | | `gate-` | building, checking and upstreaming illumos-gate changes | illumos-dev | | `contrib-` | sending a change to Solnix | contributor | ## Data tables Two tab-separated tables in this directory feed MCP verbs; each row cites its own sources, like a rule. - [`tasks.tsv`](tasks.tsv): everyday Linux admin commands (systemctl, journalctl, ip, ss, apt, dnf, ...), the illumos command for each, the Solnix configuration way, and a note. `translate_command` serves it with the compare pages' task maps. - [`errors.tsv`](errors.tsv): build and run errors on Solnix and illumos (a regular expression, the cause, the fix, the rule). `explain_error` matches one error line; `portability_check` scans a build log.