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:	https://reviews.freebsd.org/D33754
This commit is contained in:
Warner Losh 2022-03-01 16:58:28 -07:00
parent 912df915c2
commit d0e3860f70

View File

@ -28,7 +28,7 @@
.\" @(#)hier.7 8.1 (Berkeley) 6/5/93
.\" $FreeBSD$
.\"
.Dd December 11, 2021
.Dd March 1, 2022
.Dt HIER 7
.Os
.Sh NAME
@ -566,6 +566,32 @@ and
.It Pa scrnmaps/
console screen maps
.El
.It Pa sysroot/
files necessary for the -sysroot compiler/linker argument to build non-native
binaries.
.Bl -tag -width Fl -compact
.It Pa VERSION/
files for
.Fx
release VERSION.
By convention,
.Dq VERSION
matches
.Xr uname 1
.Fl r .
.Bl -tag -width Fl -compact
.It Pa MACHINE.MACHINE_ARCH/
represent the binary ABI for these files.
.Dq MACHINE
matches
.Xr uname 1
.Fl m .
.Dq MACHINE_ARCH
matches
.Xr uname 1
.Fl p .
.El
.El
.It Pa tabset/
tab description files for a variety of terminals; used in
the termcap file;