# Catalogue Generated by `tools/catalog.py` from the files; do not edit by hand. ## Personas (`solnix//SKILL.md`) | skill | when | |---|---| | [`solnix-builder`](solnix/builder/SKILL.md) | Operate a Solnix builder or understand the binary cache: the rebuild queue, the submit flow (unsigned NARs, the site signs), reproduction votes, publish gates. | | [`solnix-contributor`](solnix/contributor/SKILL.md) | Contribute to Solnix: send a patch by email to hackers@solnix.io (a recipe change, a new package or a version bump, a module, a fix to these skills), follow the email-patch governance (+1/0/-1 votes, OWNERS, timers, quorums), report a bug or a security issue the right way, write handbook documentation. Says which team owns what (the build team: the Solnix OS repo; the infra team: solnix.io, the cache, its signing and the queue). | | [`solnix-illumos-dev`](solnix/illumos-dev/SKILL.md) | Change illumos-gate itself from a Solnix context: find code, history, reviewers and open issues with this server's illumos-gate index; build the gate with nightly and bldenv; run git pbchk, cstyle, hdrchk, wsdiff and check_rtime; debug the kernel with mdb, kmdb, CTF and DTrace (fbt, sdt, adding a DTRACE_PROBE); send a change upstream through an illumos issue, code review and a request to integrate (RTI). | | [`solnix-nix-dev`](solnix/nix-dev/SKILL.md) | Write Nix for Solnix: the x86_64-solaris and aarch64-solaris platforms, the pkgs.solnix.* namespace, the illumos stdenv and link editor, SMF modules (smf.services), boot environments as generations. | | [`solnix-porter`](solnix/porter/SKILL.md) | Port Linux software to Solnix and illumos, or package it as a Solnix recipe: configure/cmake/meson platform detection, undefined socket or getaddrinfo symbols (-lsocket -lnsl), the illumos link editor (RUNPATH, $ORIGIN, mapfiles, elfdump, elfedit, lari), epoll vs event ports, sendfile and /proc differences, GNU vs /usr/xpg4 tools in build scripts, wrong-endianness configure probes under gcc 14, leaks with libumem, crashes with mdb, LX zones vs a native port. | | [`solnix-rules`](solnix/rules/SKILL.md) | 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.. | | [`solnix-sysadmin`](solnix/sysadmin/SKILL.md) | Run Solnix machines: SMF services, ZFS pools, datasets and snapshots, boot environments and rollback, zones (LX zones are planned), Crossbow networking (dladm, ipadm, flowadm), FMA faults, RBAC and pfexec, DTrace, users and updates. | | [`solnix-user`](solnix/user/SKILL.md) | Use Solnix as a command-line user: find and install software from the signed binary cache, run it, understand why a familiar Linux/BSD command behaves differently, and recover after a boot-environment rollback. | ## Rules (`solnix/rules/`) | rule | area | impact | |---|---|---| | [Use event ports for native event loops; keep the epoll emulation for Linux code](solnix/rules/api-event-ports-vs-epoll.md) | api | HIGH | | [Link sendfile with -lsendfile, read /proc with the proc tools, and treat libc as illumos libc](solnix/rules/api-sendfile-proc-pthreads-libc.md) | api | HIGH | | [Treat each generation as a boot environment; roll back with beadm activate](solnix/rules/be-generations-and-rollback.md) | be | CRITICAL | | [Pin the byte order for old configure scripts; do not let gcc 14 guess "big](solnix/rules/build-endianness-probe-trap.md) | build | CRITICAL | | [Expect SunOS, sunos and *-solaris2.11 from the build system; fix Linux-only branches in the recipe](solnix/rules/build-autotools-cmake-meson.md) | build | HIGH | | [Read config.log after configure under gcc 14; a clean exit status proves nothing](solnix/rules/build-gcc14-implicit-declarations.md) | build | HIGH | | [Send a recipe change (a new package or a version bump) as a patch to hackers@solnix.io](solnix/rules/contrib-send-a-recipe-change.md) | contrib | MEDIUM | | [Post-mortem a crashed program from /var/cores with mdb and pstack](solnix/rules/debug-mdb-postmortem.md) | debug | HIGH | | [Find leaks and heap corruption with libumem, gcore and mdb](solnix/rules/debug-libumem-leaks.md) | debug | MEDIUM | | [Answer runtime questions with read-only DTrace one-liners, and never allow destructive actions without asking](solnix/rules/dtrace-for-admins.md) | dtrace | MEDIUM | | [Read FMA's diagnosis before you clear it, and run fmadm repaired only after a repair](solnix/rules/fma-faults.md) | fma | MEDIUM | | [Build illumos-gate with nightly and an env file, then bldenv and dmake for one directory](solnix/rules/gate-build-nightly-bldenv.md) | gate | HIGH | | [Send a gate change upstream through an illumos issue, review and an RTI to the core team](solnix/rules/gate-upstream-rti.md) | gate | HIGH | | [Run git pbchk, cstyle -pP and hdrchk before an RTI; check the binaries with wsdiff and check_rtime](solnix/rules/gate-checks-pbchk-cstyle.md) | gate | MEDIUM | | [Link -lsocket -lnsl for socket(), connect() and getaddrinfo()](solnix/rules/link-lsocket-lnsl.md) | link | HIGH | | [Bake library paths into RUNPATH with ld -R; check with elfdump and ldd, fix with elfedit](solnix/rules/link-runpath-origin.md) | link | HIGH | | [Translate a GNU version script into an illumos mapfile, or drop it on purpose; check with pvs and lari](solnix/rules/link-mapfiles-and-lari.md) | link | MEDIUM | | [Port Linux software natively; save LX zones for binaries with no illumos build](solnix/rules/lx-vs-native.md) | lx | HIGH | | [Declare NIC addresses in networking.interfaces, and use dladm and ipadm for the rest](solnix/rules/net-crossbow-dladm-ipadm.md) | net | HIGH | | [Grant admin rights with RBAC profiles in users.users, and run privileged commands with pfexec](solnix/rules/rbac-pfexec.md) | rbac | HIGH | | [Package software as a pkgs.solnix derivation plus a served recipes.tsv row](solnix/rules/recipe-write-a-solnix-recipe.md) | recipe | HIGH | | [Know which grep, sed, date and ls a script runs: illumos /usr/bin, /usr/xpg4/bin, or GNU](solnix/rules/shell-xpg4-vs-gnu.md) | shell | HIGH | | [Declare services with smf.services, not hand-imported manifests](solnix/rules/smf-declare-services.md) | smf | HIGH | | [Diagnose a failed service with svcs -xv, fix it in the module](solnix/rules/smf-diagnose-failures.md) | smf | HIGH | | [Use svcadm -t for experiments, the module for permanent changes](solnix/rules/smf-temporary-vs-persistent.md) | smf | MEDIUM | | [Declare accounts in users.users and software in the configuration; update by building a new generation](solnix/rules/users-and-updates-solnix-way.md) | users | CRITICAL | | [Keep data you need across rollbacks on a dataset outside the BE](solnix/rules/zfs-datasets-and-properties.md) | zfs | HIGH | | [Snapshot, roll back and replicate data datasets with zfs; leave BEs to beadm](solnix/rules/zfs-snapshots-send-receive.md) | zfs | HIGH | | [Port to Solnix natively; LX-branded zones are not built yet](solnix/rules/zones-lx.md) | zones | HIGH | | [Run native zones with the gate's tools, and do not expect an IPS zone install](solnix/rules/zones-native.md) | zones | MEDIUM | ## Steering (`steering/`, always on) - [`confirm-destructive`](steering/confirm-destructive.md): Commands an agent must not run on a Solnix or illumos machine without the user's explicit yes. Always on.. - [`edition-policy`](steering/edition-policy.md): Solnix editions, the default branch and pinning. - [`email-patch-governance`](steering/email-patch-governance.md): How a change lands in Solnix (patches by email, owners, timers, quorums). - [`honesty-over-hype`](steering/honesty-over-hype.md): Never describe planned or partial Solnix work as done. Always on; use whenever stating what Solnix can do.. - [`privacy`](steering/privacy.md): Solnix's privacy rules for telemetry, logs, packages and commits. - [`query-first`](steering/query-first.md): Ask the Solnix MCP server (or its REST API) before reasoning about Solnix from memory. Always on.. - [`reproducibility-as-trust`](steering/reproducibility-as-trust.md): Why a Solnix binary is trusted, and what reproduction votes mean. - [`solnix-is-not-upstream-illumos`](steering/solnix-is-not-upstream-illumos.md): The places Solnix differs from OpenIndiana, OmniOS and SmartOS, and how to explain each. Always on when giving illumos advice to a Solnix user.. - [`trust-and-signing`](steering/trust-and-signing.md): How the Solnix binary cache is signed. - [`upstream-ai-policies`](steering/upstream-ai-policies.md): What upstream projects ask of AI-assisted contributions (nixpkgs, illumos, omnios-extra). - [`voice`](steering/voice.md): How Solnix writes. ## Workflows (`workflows/`) - [`install-a-package`](workflows/install-a-package.md): Find, check and install a package on Solnix (or another Nix host) from the signed cache. - [`port-a-linux-package`](workflows/port-a-linux-package.md): Port a Linux program to Solnix/illumos and get it to build and run. - [`report-a-cve`](workflows/report-a-cve.md): Report a security vulnerability in Solnix without premature disclosure. - [`reproduce-and-vote`](workflows/reproduce-and-vote.md): Rebuild a served Solnix package independently and compare hashes. - [`review-a-rule`](workflows/review-a-rule.md): Independently check a Solnix skill or rule against its cited sources before it ships. - [`roll-back-an-update`](workflows/roll-back-an-update.md): Roll a Solnix machine back to the previous generation (boot environment) after a bad update. - [`triage-a-failed-service`](workflows/triage-a-failed-service.md): Find out why an SMF service is offline or in maintenance on Solnix and get it running.