From 7441e255ed4a76e2f1bd838df433301220d75c1c Mon Sep 17 00:00:00 2001 From: Bryan Drewery Date: Sun, 29 Oct 2017 01:21:22 +0000 Subject: [PATCH] build(7): Document native-xtools. MFC after: 2 weeks Sponsored by: Dell EMC Isilon --- Makefile | 4 +++- share/man/man7/build.7 | 12 ++++++++++++ 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 144d58dc4abc..78177850303c 100644 --- a/Makefile +++ b/Makefile @@ -39,7 +39,9 @@ # xdev-install - Install cross-development tools. # xdev-links - Create traditional links in /usr/bin for cc, etc # native-xtools - Create host binaries that produce target objects -# for use in qemu user-mode jails. +# for use in qemu user-mode jails. Override +# target location with NXBDESTDIR. TARGET and +# TARGET_ARCH should be defined. # # "quick" way to test all kernel builds: # _jflag=`sysctl -n hw.ncpu` diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 index d5036daf87b5..00659f64fe32 100644 --- a/share/man/man7/build.7 +++ b/share/man/man7/build.7 @@ -222,6 +222,18 @@ variable .Va DISTDIR . This target is used while building a release; see .Xr release 7 . +.It Cm native-xtools +This target builds a cross-toolchain for the given +.Sy TARGET +and +.Sy TARGET_ARCH , +as well as a select list of static userland tools for the host system. +This is intended to be used in a jail where QEMU is used to improve +performance by avoiding emulating binaries that do not need to be emulated. +.Sy TARGET +and +.Sy TARGET_ARCH +should be defined. .It Cm packageworld Archive the results of .Cm distributeworld ,