diff --git a/README.md b/README.md --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ | secure | Cryptographic libraries and commands. | | share | Shared resources. | | stand | Boot loader sources. | -| sys | Kernel sources. | +| sys | Kernel sources (see [sys/README.md](sys/README.md)). | | sys/`arch`/conf | Kernel configuration files. GENERIC is the configuration used in release builds. NOTES contains documentation of all possible entries. | | tests | Regression tests which can be run by Kyua. See [tests/README](tests/README) for additional information. | | tools | Utilities for regression testing and miscellaneous tasks. | diff --git a/sys/README.md b/sys/README.md new file mode 100644 --- /dev/null +++ b/sys/README.md @@ -0,0 +1,34 @@ +FreeBSD Kernel Source: +---------------------- + +This directory contains the source files and build glue that make up the FreeBSD +kernel and its modules, including both original and contributed software. + +Source Roadmap: +--------------- +| Directory | Description | +| --------- | ----------- | +| amd64 | AMD64 architecture support | +| arm | ARM architecture support | +| arm64 | ARMv8 architecture support | +| cam | `cam(4)` and `ctl(4)` | +| cddl | CDDL-licensed optional sources, including ZFS and DTrace | +| ddb | `ddb(4)` | +| fs | most filesystems | +| dev | device drivers | +| geom | `geom(4)` | +| i386 | i386 (32 bit) architecture support | +| kern | main part of the kernel | +| net80211 | `net80211(4)` | +| netgraph | `netgraph(4)` | +| netinet | `inet(4)` | +| netinet6 | `inet6(4)` | +| netipsec | `ipsec(4)` | +| netpfil | `ipfw(4)` and `pf(4)` | +| opencrypto | `crypto(7)` | +| powerpc | PowerPC/POWER architecture support | +| riscv | RISC-V architecture support | +| security | `audit(4)` and `mac(4)` | +| sys | kernel headers | +| ufs | Unix File System | +| x86 | code shared by AMD64 and i386 architectures |