← all corpora

openbsd-faq

reference corpus · status live · domain OPS (Operations and SRE) · lane A · refresh pinned · tags GLOBAL · UNIX · OPERATIONS

What an agent uses it for

an agent hardening an OpenBSD host queries this for the pf FAQ's rule grammar, upgrade procedures and faq-page hardening steps

Use it
curl -fsSLO https://raw.githubusercontent.com/xerj-org/xerj/corpus-hub/tools/xerj-code/hub/openbsd-faq.json
xerj corpus add --from ./openbsd-faq.json
xerj corpus index openbsd-faq then xerj code openbsd-faq "your question"

Needs the xerj CLI and a local node running; the copy prompt covers both, checks each step, and shows how to stop only the node you started. No shell: the MCP tool xerj_code_search with corpus: "openbsd-faq", once the corpus is indexed on the node.

Sources and pins

sourcepinlicencesizereview note
openbsd-faq cab1d91061ffISC-style per-chapter grants 760.8 MB / 13,328 files No repo-level LICENSE (detector: NONE-FOUND); each FAQ chapter carries an ISC-style grant: 'Permission to use, copy, modify, and distribute this documentation for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies' (faq15: Mestdagh 2005-2009; faq17: Breuil 2018; per-chapter holders). Notices are preserved in-f

760.8 MB across 13,328 files. Added 2026-10-02.

People behind this corpus

Upstream authors (1)

Owners of the pinned repositories, credited under each repository's licence. They have not signed up here; their pages are attribution.

openbsd@openbsd · upstream

All contributors.

Rights

ISC-style per-chapter grants. Redistribution permitted with attribution per the licence review. The review block records a human opening each licence file at the pin. Detector output is a hint, never the verdict.

Retrieval spot-check (G7)

3.0/5 relevant. Graded .

Q: Is keep state on by default for PF filter rules?
expect:
top-5: openbsd-faq/papers/asiabsdcon07-ipsec/mgp00073.txt:2 / openbsd-faq/papers/ven05-henning/mgp00015.txt:2 / openbsd-faq/papers/fosdem2k3-pf.mgp:340 / openbsd-faq/papers/fosdem2k3-pf.mgp:158 / openbsd-faq/faq/pf/filter.html
grade: pass
Q: Why does OpenBSD only use half of my CPU cores by default?
expect:
top-5: openbsd-faq/faq/faq10.html / openbsd-faq/faq/faq10.html / openbsd-faq/papers/eurobsdcon2018-mandoc.roff:1651 / openbsd-faq/papers/bsdcan18-mandoc.roff:571 / openbsd-faq/papers/cuug2007/mgp00008.txt
grade: pass
Q: How do I configure a static IPv4 address for a network interface on OpenBSD so it comes up at boot?
expect:
top-5: openbsd-faq/papers/bgpd_sucon04/mgp00028.txt:2 / openbsd-faq/faq/pf/nat.html / openbsd-faq/papers/eurobsd2012/phessler-rdomains/mgp00002.txt:2 / openbsd-faq/faq/faq6.html / openbsd-faq/papers/opencon07-complex/mgp00002.txt:2
grade: pass
Q: How do I install a package such as rsync on OpenBSD?
expect:
top-5: openbsd-faq/advisories/sslUSA:121 / openbsd-faq/papers/eurobsdcon_2010_pkg_add/mgp00017.txt:1 / openbsd-faq/papers/eurobsd2012/espie-dpb/mgp00028.txt:1 / openbsd-faq/openssh/openssh_pr.txt:1 / openbsd-faq/papers/bsdcan14-mandoc.roff:1231
grade: miss
Q: How do I make OpenBSD come up with a graphical login screen at boot instead of a text console?
expect:
top-5: openbsd-faq/faq/faq7.html / openbsd-faq/papers/eurobsd2005/niallo-uwe/mgp00027.txt:2 / openbsd-faq/faq/faq7.html / openbsd-faq/papers/bgpd_sucon04/mgp00028.txt:2 / openbsd-faq/papers/eurobsd2005/niallo-uwe/mgp00019.txt:2
grade: miss

Agent score

From structured reviews that AI agents send after they use this corpus: through xerj hub pull, MCP queries, or the xerj_corpus_feedback tool. Each review rates usefulness 1–5, whether the answer was found, and freshness. This is not the human hub star count shown above. The two are never mixed.

Loading agent reviews…

Score = Bayesian mean of usefulness (prior 3.0 with weight 5), so a few reviews cannot swing it. One voice per installation per corpus per week; abnormal-volume reviewers are dropped. Coverage gaps appear only once 3 or more agents report the same one. How it works.

Traffic

Traffic stats load from /api/hub-traffic when this page runs JavaScript.

Views: visits to this page (search-engine crawlers excluded). Unique: distinct visitors per day, by a hash salted with the day, so the 14-day unique figure adds up daily uniques. Pulls: growth of the GitHub release download count of this corpus’s pack (xerj hub pull downloads from there; includes our own pack-verification downloads). Searches: hosted-hub queries for this corpus. Referring sites appear after 3 views. What is collected.

Agent usage

Usage stats load from /api/hub-usage when this page runs JavaScript.

Counted: requests agents send to the hosted hub API (hub.xerj.org/api/v1/code, /def) for this corpus. Queries on your own node (xerj code, xerj ask with a local pack, the MCP tools) never leave your machine and are not counted. Templates replace identifiers, versions, paths, numbers and quoted text with placeholders; one is shown only once it has been seen 3 times in 30 days, and any word asked fewer than 3 times shows as <term>. Raw queries are never published. What is collected.