git: d0e3860f706e - main - heir: Document SYSROOT conventions

From: Warner Losh <>
Date: Wed, 02 Mar 2022 00:00:34 UTC
The branch main has been updated by imp:


commit d0e3860f706e389417c8b56b1d423104b830f4ad
Author:     Warner Losh <>
AuthorDate: 2022-03-01 23:58:28 +0000
Commit:     Warner Losh <>
CommitDate: 2022-03-02 00:00:40 +0000

    heir: Document SYSROOT conventions
    Define a place for sysroot trees to live. This assumes they come from
    the base in some way, though there's not yet a build/install/etc sysroot
    target. Include the FreeBSD version so multiple verrsions can be
    installed on one system (it also includes the whole uname version, so
    one could, in theory, install variants like CheriBSD or whatever on the
    same system as FreeBSD). Use MACHINE.MACHINE_ARCH to be consistent with
    the release practices, /usr/obj and other naming conventions.
    Sponsored by:           Netflix
    Reviewed by:            brooks
    Differential Revision:
 share/man/man7/hier.7 | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index 2826050c3307..150ba4c4b719 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -28,7 +28,7 @@
 .\"	@(#)hier.7	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
-.Dd December 11, 2021
+.Dd March 1, 2022
 .Dt HIER 7
@@ -566,6 +566,32 @@ and
 .It Pa scrnmaps/
 console screen maps
+.It Pa sysroot/
+files necessary for the -sysroot compiler/linker argument to build non-native
+.Bl -tag -width Fl -compact
+files for
+release VERSION.
+By convention,
+.Xr uname 1
+.Fl r .
+.Bl -tag -width Fl -compact
+represent the binary ABI for these files.
+.Xr uname 1
+.Fl m .
+.Xr uname 1
+.Fl p .
 .It Pa tabset/
 tab description files for a variety of terminals; used in
 the termcap file;