Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F161888894
D40778.id125455.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
2 KB
Referenced Files
None
Subscribers
None
D40778.id125455.diff
View Options
diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
--- a/share/man/man7/build.7
+++ b/share/man/man7/build.7
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 10, 2021
+.Dd August 1, 2023
.Dt BUILD 7
.Os
.Sh NAME
@@ -509,7 +509,23 @@
are influenced by the following
.Xr make 1
variables:
-.Bl -tag -width ".Va SUBDIR_OVERRIDE"
+.Bl -tag -width ".Va LOCAL_MODULES_DIR"
+.It Va CROSS_TOOLCHAIN
+Requests use of an external toolchain to build either the world or kernel.
+This value of this variable can either be the full path to a file,
+or the base name of a file in
+.Pa ${LOCALBASE}/share/toolchains .
+The file should be a make file which sets variables to request an external
+toolchain such as
+.Va XCC .
+.Pp
+External toolchains are available in ports for both LLVM and GCC/binutils.
+For external toolchains available in ports,
+.Va CROSS_TOOLCHAIN
+should be set to the name of the package.
+LLVM toolchain packages use the name llvm<major version>.
+GCC toolchains provide separate packages for each architecture and use the
+name ${MACHINE_ARCH}-gcc<major version>.
.It Va KERNCONF
Overrides which kernel to build and install for the various kernel
make targets.
@@ -713,7 +729,7 @@
.Fl D
option of
.Xr make 1 :
-.Bl -tag -width ".Va -DNO_KERNELCONFIG"
+.Bl -tag -width ".Va LOADER_DEFAULT_INTERP"
.It Va LOADER_DEFAULT_INTERP
Defines what interpreter the default loader program will have.
Valid values include
@@ -783,6 +799,10 @@
If set, no object directories will be created.
This should only be used if object directories were created in a
previous build and no new directories are connected.
+.It Va UNIVERSE_TOOLCHAIN
+Requests use of the toolchain built as part of the
+.Cm universe
+target as an external toolchain.
.It Va WORLDFAST
If set, the build target
.Cm buildworld
@@ -812,7 +832,7 @@
and related targets are influenced by the following
.Xr make 1
variables:
-.Bl -tag -width ".Va MAKE_JUST_KERNELS"
+.Bl -tag -width ".Va USE_GCC_TOOLCHAINS"
.It Va JFLAG
Pass the value of this variable to each
.Xr make 1
@@ -834,6 +854,10 @@
building a world and one or more kernels.
This variable implies
.Va WITHOUT_KERNELS .
+.It Va USE_GCC_TOOLCHAINS
+Use external GCC toolchains to build the requested targets.
+If the required toolchain package for a supported architecture is not installed,
+the build for that architecture is skipped.
.It Va TARGETS
Only build the listed targets instead of each supported architecture.
.It Va EXTRA_TARGETS
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Wed, Jul 8, 6:14 PM (11 h, 52 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
34855358
Default Alt Text
D40778.id125455.diff (2 KB)
Attached To
Mode
D40778: build.7: Document several toolchain make variables.
Attached
Detach File
Event Timeline
Log In to Comment