SRC(7)

📦 version 11.0, in nixpkgs unstable

✨ SRC(7) ✨

okay bestie, so you want the tea on the NetBSD source tree layout? this is the SRC(7) page from the Miscellaneous Information Manual and honestly it's giving map-of-the-whole-realm energy 🗺️✨. buckle up, we're going on a tour of every single directory, no cap.

🌸 DESCRIPTION 🌸

An outline of the NetBSD source code hierarchy. literally the whole vibe of where stuff lives. slay.

  • bin/ — Critical utilities for the system and users. the essentials, periodt.
  • sbin/ — Critical utilities for the system and the superuser. big main-character privileges only 👑
  • usr.bin/ — Not-so critical utilities for the system and users. still cute, just less life-or-death 💅
  • usr.sbin/ — Not-so critical utilities for the system and the superuser. chill but still for the sudo girlies.
  • common/ — Sources shared between kernel and userland.
    • dist/ — Utilities. Every utility has its own subdirectory, where its source and Makefile are located.
    • include/ — Include headers. Every group of header files has its own subdirectory, where it and its Makefile are located.
    • lib/ — Libraries. Every library has its own subdirectory, where it and its Makefile are located.
  • compat/ — A framework to (re)build the libraries shipped with NetBSD for different ABI than the default for that platform. iykyk.
    • compat/<arch1>/<arch2>/ — Every compat/<arch1>/<arch2>/ directory contains a Makefile and a makefile fragment for building an <arch2> compat libraries for <arch1>. For example, compat/amd64/i386/ is where the 32-bit compat libraries for the amd64 port are being built.
    • compatsubdir.mk — The list of subdirectories (the libraries and ld.elf_so) to build with this ABI.
    • archdirs.mk — The list of subdirectories for each port.
    • Makefile.compat — The basic framework to force the right paths for library and ld.elf_so linkage.
    • dirshack/Makefile — A hack to get objdirs created timely. it's called a hack, I'm just reporting the facts bestie 🫶
  • crypto/ — Cryptographic source, which may have import or export restrictions. ⚠️ careful with this one.
    • dist/ — Original sources. This is deprecated; crypto/external/ should be used instead.
    • external/ — Original sources, grouped by license, and then package per license. crypto/external/<license>/<package>/dist/ contain original sources for given package; other directories contain Makefiles and given package's config files.
  • dist/ — Unmodified sources from third parties. This is deprecated; external/ should be used instead. bye bestie 👋
  • distrib/ — Tools and data-files for making distributions.
    • <arch>/ — Architecture-specific files, grouped by image type. For example, distrib/<arch>/floppies/ contains Makefiles for making images for various types of floppies; <arch>/ramdisk/ contains makefiles for making ramdisks etc.
    • cdrom/ — Was used to create bootable CD images. This is deprecated; build.sh's iso-image target should be used instead.
    • common/ — Common files for images generation.
    • miniroot/ — Files for miniroot.
    • notes/<arch> — Architecture-specific parts of release notes.
    • sets/ — Scripts for making file sets.
    • utils/ — Utilities for installation ramdisk.
  • doc/ — Development documentation files: changelogs, build readmes etc. doc/roadmaps/ contains roadmaps. reading the docs is self-care fr fr 📚
  • etc/ — Default configuration files to be put into /etc.
    • etc/etc.<arch>/ — Architecture-specific config files.
  • external/ — Unmodified sources from third parties, grouped by license. Every external/<license>/<package>/ may contain:
    • dist/ — Unmodified third party source for a given package
    • bin/
    • usr.bin/
    • usr.sbin/
    • etc. — Such subdirectories contain reachover Makefiles, README's and various import helper scripts. For example, external/public-domain/ contains sources licensed under Public Domain license; external/public-domain/sqlite/dist/ contains original sources; external/public-domain/sqlite/bin/, external/public-domain/sqlite/lib/ and external/public-domain/sqlite/ itself contain reachover Makefiles.
  • games/ — Sources for utilities/files in /usr/games; each utility has its own subdirectory, where its sources and Makefiles are located. 🎮 iconic.
  • include/ — Files to be put into /usr/include.
  • lib/ — Source for libraries in /usr/lib and some scripts for them. Every directory contains source for given library and Makefiles.
  • libexec/ — Source for utilities in /usr/libexec. Every directory contains source for given utility and Makefiles.
  • regress/ — Various regression tests in /usr/tests. This is deprecated; most tests are being migrated into tests/ once they are migrated to the atf(7) test framework.
  • rescue/ — Makefiles for copying utilities to /rescue.
  • share/ — Source for utilities/files in /usr/share. Every utility has its own subdirectory, where its source and Makefile are located.
  • sys/ — Kernel source. this is the big one bestie, hold on tight 😤
    • altq/ — Network packet alternate queueing.
    • arch/ — Files to specific hardware platforms.
    • coda/ — Coda file system driver.
    • compat/ — Support for older version NetBSD binaries and non-NetBSD binaries.
    • conf/ — Misc files for building kernel.
    • crypto/ — Crypt algorithms used by IPsec.
    • ddb/ — Client code for local kernel debugger.
    • dev/ — Device drivers.
    • dist/ — Parent directory for the OpenBSD packet filter pf(4).
    • external/ — Sources from third parties, grouped by license.
    • fs/ — File systems storing data on physical drives.
    • gdbscripts/ — gdb(1) macros.
    • kern/ — NetBSD's Kernel code, such as resource management, signal delivering, etc.
    • lib/ — Libraries used by the kernel.
    • miscfs/ — Drivers for file systems used to store layered data for kernel features.
    • modules/ — Kernel components, including hardware specific drivers and upper-level drivers.
    • net/ — Lowlevel network: protocol drivers, packet filters and access interfaces for NICs.
    • net80211/ — Drivers for 802.11 wireless network.
    • netatalk/ — Appletalk protocol stack atalk(4).
    • netbt/ — Bluetooth stack bluetooth(4).
    • netcan/ — Controller Area Network stack can(4).
    • netinet/ — IPv4 protocol stack ip(4).
    • netinet6/ — IPv6 protocol stack.
    • netipsec/ — IPsec protocol stack ipsec(4).
    • netmpls/ — MPLS protocol stack mpls(4).
    • nfs/ — Network file system driver.
    • opencrypto/ — Cryptographic hardware framework opencrypto(9).
    • rump/ — Rump kernel rump(3).
    • secmodel/ — Security model framework secmodel(9).
    • stand/ — Source for several standalone programs that aren't used by NetBSD currently.
    • sys/ — Header files that get installed into /usr/include/sys.
    • ufs/ — UFS file system driver.
    • uvm/ — Virtual memory manager.
  • tests/ — Source for test programs in /usr/tests. These tests use the atf(7) test framework. For library routines, including system calls, the directory structure of the tests should follow the directory structure of the real source tree. For instance, interfaces available via the C library should follow: src/lib/libc/gen -> src/tests/lib/libc/gen, src/lib/libc/sys -> src/tests/lib/libc/sys, etc. Equivalently, all tests for userland utilities should try to follow their location in the source tree. If this can not be satisfied, the tests for a utility should be located under the directory to which the utility is installed. Thus, a test for env(1) should go to src/tests/usr.bin/env. Likewise, a test for tcpdump(8) should be in src/tests/usr.sbin/tcpdump, even though the source code for the program is located under src/external. the way that test layout mirrors reality? obsessed 💖
  • tools/ — Reachover build structure for the host build tools. Every utility has its own directory, where its Makefile is located.
  • x11/ — Reachover build structure for X11R7; the source is in X11SRCDIR. The directory structure copies the system's; every directory contains a Makefile.

🦋 SEE ALSO 🦋

  • hier(7) — go read it bestie, it's the companion piece ✨

💜 HISTORY 💜

This file was created as a part of Google Code-in 2012/2013. a whole era, honestly.

👑 AUTHORS 👑

This manpage was written by Elvira Khabirova <skinder0@gmail.com>, the sys/ part by Mingzhe Wang. absolute icons, both of them 🌟

ok that's the whole tree bestie. go forth and navigate src/ like the main character you are. periodt. 💅✨

Debian · May 14, 2020 · that's the version + date tea, mwah 🎀

📦 where this page comes from