aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBryan Drewery <bdrewery@FreeBSD.org>2017-10-29 01:21:22 +0000
committerBryan Drewery <bdrewery@FreeBSD.org>2017-10-29 01:21:22 +0000
commit7441e255ed4a76e2f1bd838df433301220d75c1c (patch)
tree7c031cdcc201eb056a52ba80250985f0f1099fda
parent24830684f299ed8e7649b03cc72384cf3163ba24 (diff)
downloadsrc-7441e255ed4a76e2f1bd838df433301220d75c1c.tar.gz
src-7441e255ed4a76e2f1bd838df433301220d75c1c.zip
build(7): Document native-xtools.
MFC after: 2 weeks Sponsored by: Dell EMC Isilon
Notes
Notes: svn path=/head/; revision=325080
-rw-r--r--Makefile4
-rw-r--r--share/man/man7/build.712
2 files changed, 15 insertions, 1 deletions
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 ,