From nobody Tue Aug 1 21:02:09 2023 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4RFnc72Gh3z4prLh; Tue, 1 Aug 2023 21:02:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4RFnc163PSz3Lcp; Tue, 1 Aug 2023 21:02:09 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1690923729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=A512sQ4CAZism0X1FfvR6QQahZUEOO655Vb42uRt+8Q=; b=HN2lM6f6Y+7EhoBAmClfpuPC4z1LSR0R3SrWhZWdEoxdJrwt48YONNyL/toXe6LHvET28W F05uA6O5TxM/b+Oi34znpfyCK7qLPFNrbFHvNHxgNIqQw9NgRNecDzpfNs5ks72YvmBN/6 rxpHHC0XckmlfE8SyecvUMAn1mBd/kA/8I28FBZ+A6v8NnDHMTxKnZmQIEu16+AP3YHdmi +t0uFrTeDeCIT40/OnDaZ6wArICLnvX4yimBgHJIgp1fA0mZxR2BVw2x1vtDuyIiOKrFeN 5Gl38xJJx/RtqgsisHIu6nrJhbrlW8nzy5vv16MKXKvRTHg3xEHFsiQtDxNKeg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1690923729; a=rsa-sha256; cv=none; b=b45wCnIXPJuBp88ocpcxbmtxCeDD/J7Yps1n9X9cDgAjpEuvVqxQRPHeTs/DP1B6MprX5K qDn2mR2OOJB69JfNnA4mOMRBzMT7RnsXDs32QHjSzZWf+YKCNqNJkEGRZP56ju+7spiY7+ pZ7nopxjZceCPl0tQNIWkwJ5yGTr1pbuWOBW8bsh9825FgzOBWKJFE3YnVKaywTBVS/ay8 KpTtubjb8b7MEmEuwd60cAKeLTQ7Rwv+Hlxou8w1U2UV/A0ufZKqdA9enOaCD5K1oSglNt SZtx5FfT0Kg7kXdLT85RwCzbi4UvKaR2SrysgzM7NM9M5vCc8faumAxDFXpuLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1690923729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=A512sQ4CAZism0X1FfvR6QQahZUEOO655Vb42uRt+8Q=; b=UmLYFOLHGJdP7neTOyhRsl9tSuhviA+jtMpVF4fz65NVX0fo/Xusbvj925dpIcagtreSsE cgBcRqsDzr72yL9NKm7p2+jdca7VifTEcxRGHyTxCqQVdlQwVzdj4UzAlxiAUHV/SNCYVG nEmI0/tQMMGasImLX3yDXqvSlwQt0QyUBlZsHY3VfSjCA1hoAz7w2oU4BDDsaeRygATCBd JJezPGVrgI/ZSRvwKRNV5zQH44fj7sDbfchIjw2AaaPsJFE/PSqtCBwvF53t+K/7gHHcFi wO/dh1X9uRlIM3XDVrCcsVtvYAmzTZDZf2kZBXTjTN5fPB2Q4aT+tDLHr//nVQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4RFnc14nHgzsvf; Tue, 1 Aug 2023 21:02:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 371L29V6012848; Tue, 1 Aug 2023 21:02:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 371L291M012847; Tue, 1 Aug 2023 21:02:09 GMT (envelope-from git) Date: Tue, 1 Aug 2023 21:02:09 GMT Message-Id: <202308012102.371L291M012847@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: John Baldwin Subject: git: 21ef3591b611 - main - build.7: Document several toolchain make variables. List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jhb X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 21ef3591b6119f6972896e6c00cbf9ffb759646e Auto-Submitted: auto-generated The branch main has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=21ef3591b6119f6972896e6c00cbf9ffb759646e commit 21ef3591b6119f6972896e6c00cbf9ffb759646e Author: John Baldwin AuthorDate: 2023-08-01 21:01:58 +0000 Commit: John Baldwin CommitDate: 2023-08-01 21:01:58 +0000 build.7: Document several toolchain make variables. Document CROSS_TOOLCHAIN, UNIVERSE_TOOLCHAIN, and USE_GCC_TOOLCHAINS. Differential Revision: https://reviews.freebsd.org/D40778 --- share/man/man7/build.7 | 32 ++++++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 index a2fb5ea77149..c1ea4e56ccaf 100644 --- 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 @@ Additionally, builds in 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. +GCC toolchains provide separate packages for each architecture and use the +name ${MACHINE_ARCH}-gcc. .It Va KERNCONF Overrides which kernel to build and install for the various kernel make targets. @@ -713,7 +729,7 @@ using the .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, the libraries phase will be skipped. 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 @@ Builds using the 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 @@ target for each supported architecture instead of the default action of 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