mirror of
https://github.com/lgcosta/pf-linux-port.git
synced 2026-11-12 22:18:04 -03:00
lgcosta
0a8ba69340
caveats §13 documents the capacity ceiling the stress test found: the workqueue backlog grows with the offered rate and OOM-panics a 1 GB guest above ~1 Gbit/s. Gate count, suite status and the doc indexes move to 16/16 green.
Documentação do PF-on-Linux (português)
English documentation: docs/en/README.md.
Este é o conjunto de documentação de usuário do port do packet filter do
OpenBSD 8.0 (PF) para o Linux 7.3.4 — o engine PF real (pf.c,
pf_norm.c, pf_table.c, pf_lb.c, hfsc.c, …) rodando como o módulo
out-of-tree pf.ko, controlado pelo pfctl real do OpenBSD sobre a ABI ioctl
de /dev/pf.
Índice
| Doc | O que cobre |
|---|---|
| guide.md | Arquitetura em uma página: componentes, caminho de dados, plano de controle, milestones |
| install.md | Receita de apply/build/install (kernel, módulo, ferramentas) |
| debian13.md | Implementação completa do zero no Debian 13 (trixie): preparar host, compilar kernel/módulo/ferramentas, lab libvirt, teste de stress |
| build.md | Pipeline de build em detalhe: fetch → vendorize → kernel → módulo → pfctl |
| vm-lab.md | O lab de validação em libvirt: topologia, recriar/rodar, o que cada um dos 16 gates prova |
| feature-matrix.md | Status por feature: VERIFIED-in-VM / VERIFIED-offline / COMPILES-untested / NOT-ENABLED |
| pf-guide.md | Uso diário: o que funciona hoje em /etc/pf.conf e as divergências a conhecer |
| screencast.md | Os vídeos narrados (inglês e português): fases, pipeline, como regravar |
| patches.md | Conjunto de patches de core do Linux (hoje vazio) + regras e template para futuros 000N-*.patch |
| caveats.md | Divergências conhecidas em relação ao OpenBSD e limitações atuais |
Fontes da verdade
Os docs descrevem o código como ele existe nesta árvore. Na dúvida, as referências autoritativas são:
docs/superpowers/specs/2026-11-11-pf-linux-port-design.md— designdocs/superpowers/plans/2026-11-11-pf-linux-port.md— plano dos milestones (tarefas T1–T19)docs/porting-notes.md— log de staging + registro das divergências (a verdade sobre as divergências da camada de compat)
Vocabulário de status usado nestes docs:
- VERIFIED-in-VM — exercitado de ponta a ponta no lab libvirt; o gate que prova está nomeado (veja vm-lab.md).
- VERIFIED-offline — provado por um teste de fixture ou de ABI, não por tráfego.
- COMPILES-untested — o código é compilado dentro do
pf.ko/pfctlmas nenhum gate o exercitou. - NOT-ENABLED — o código existe mas a feature está desligada neste build.
- OUT-OF-SCOPE — fora de escopo por desenho (spec §3).
A suíte do lab está 16/16 verde (./scripts/vm-run-tests.sh).