---
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.