From 7dbf7f266cfc7e66053fb8d01604b58806ee2527 Mon Sep 17 00:00:00 2001
From: Warner Losh <imp@FreeBSD.org>
Date: Wed, 3 Sep 2014 21:59:07 +0000
Subject: [PATCH] Create a /boot/dtb directory to house DTB blobs. The
 flattened device tree support includes a device tree source compiler dtc(8)
 which converts .dts files into .dtb files. /boot/loader will load dtb files
 from this directory by default, allowing for fewer differences between images
 for different SoCs. Compiled dts files will wind up here eventually as an
 alternative to embedding them into the kernel. Document this in hier(7), as
 well as add missing entries for /boot/firmware and /boot/zfs, though the
 latter two should only be considered place holders if someone wants to make
 them better.

---
 etc/mtree/BSD.root.dist |  2 ++
 share/man/man7/hier.7   | 14 +++++++++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/etc/mtree/BSD.root.dist b/etc/mtree/BSD.root.dist
index 7b8d9e7f806..af2f6a9add0 100644
--- a/etc/mtree/BSD.root.dist
+++ b/etc/mtree/BSD.root.dist
@@ -10,6 +10,8 @@
     boot
         defaults
         ..
+        dtb
+        ..
         firmware
         ..
         kernel
diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index ae1a2a1078d..9cba8961d16 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -48,13 +48,25 @@ programs and configuration files used during operating system bootstrap
 .It Pa defaults/
 default bootstrapping configuration files; see
 .Xr loader.conf 5
+.It Pa dtb/
+Compiled flattened device tree (FDT) files; see
+.Xr fdt 4 
+and
+.Xr dtc 1
+.It Pa firmware/
+Loadable modules containing binary firmware for hardware that needs
+firmware downloaded to it to function
 .It Pa kernel/
 pure kernel executable (the operating system loaded into memory
-at boot time).
+at boot time)
 .It Pa modules/
 third-party loadable kernel modules;
 see
 .Xr kldstat 8
+.It Pa zfs/
+Contains 
+.Xr zfs 8 
+zpool cache files.
 .El
 .It Pa /cdrom/
 default mount point for CD-ROM drives