From nobody Sat Nov 30 17:11:50 2024 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 4Y0xRV5NSxz5fL8H; Sat, 30 Nov 2024 17:11:50 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Y0xRV2MKZz41vj; Sat, 30 Nov 2024 17:11:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732986710; 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=l1oOt8qwbZNVoAm6f5RIrFMNAE1Dvyb3l8Plzl28psM=; b=cp8A6nrTlUd6yvhMcMGjKKGmCkd+zFPsMDyKZWzsdyzVO1qzQeu7B10hMrMRckek8orsIA Yx6/pHuol/Qv1o3SqKuKqA6MmfbPx4tLilUauSgo+ZrBZ5f12KAF7ivGjIZBI8L8am8aAW jScBclD1X4nUq0T5LJhY/QqcGDmHD+K924vgM23PoFnBiGz3NPZyyrydHkEPyv+TyQ8+QA i6PSoihAxKgobZ0OHywyFIGKyhzk1tphsPKJbcCx/o/3jronYqYlWRAeeBBRCL50VtlfLc ftGflf9NGuInRvmz68tsVkQlF2n6FQoQ08j7GjR5ZUv/4ti+jM0wWz5/setS0A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732986710; 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=l1oOt8qwbZNVoAm6f5RIrFMNAE1Dvyb3l8Plzl28psM=; b=R3I/TMv/y61fe9Be1HnzmMjh2YqOvfO7iJaJn+LRIXnxBwPd/Dtap4zivJNPCKTlcsax4x 0dCLllJfB9IAlHN6Uzxca8jy86o/vawlcRjqnJaALqo7jzwOB+90pw7iA5Hw7rc9m6FhL4 TthL1N9GAykKRX1aBzVNyIW0t2VTcOmvemur0vkcNaKRGOEBIdGcRfJToua3qlfVu4nnKG QWKqURjX03BGFPakXHjpzXyRmRgUCGh9Bc09TstRfeKMYXDlHI2+YXaSHn+KcQ3rS8MvIr vZIO1w5imEqiatWReRVtlBw5xPfCtw5shI5OpBQI98oDWw5ux6CxOZKZ6YZONA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1732986710; a=rsa-sha256; cv=none; b=A47gTS2thlM9+Bo6K5AmZMdGR4QR7BKnEslTzIMXcw1vGfBq1q5WKSc/tv4YP3uBkykUrP aClwz9ThcmrGi4BxWJ4Y4grOim2RuxyZColnLabW7n/mGIG7F17evzo04mwCbVsfaa0J6M 11wqIiXCnfbPiqIyv7uSLUsG+fcS6onGPIA/pAOXaZhrCmvR5WPv+Jz/fSyIm91FKFixo/ O10yG75Q6RABKHRXARMJIydAEHw8ge1kWLOgu1Mcrw0Ax7ZMKBIij3JENN4fgBEOWmnU/7 6ajFjWi6SPImSq8Y21PwCX6znSVeVctc85aMtmGAYbJgrvRsix4FMURQ5wK2TQ== 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 4Y0xRV1zs8zHHJ; Sat, 30 Nov 2024 17:11:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4AUHBoIb089614; Sat, 30 Nov 2024 17:11:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4AUHBoLh089611; Sat, 30 Nov 2024 17:11:50 GMT (envelope-from git) Date: Sat, 30 Nov 2024 17:11:50 GMT Message-Id: <202411301711.4AUHBoLh089611@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: John Baldwin Subject: git: 60b9e2fac13a - stable/13 - 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: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-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/stable/13 X-Git-Reftype: branch X-Git-Commit: 60b9e2fac13ad381518acd253dd33a680dc7a0c8 Auto-Submitted: auto-generated The branch stable/13 has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=60b9e2fac13ad381518acd253dd33a680dc7a0c8 commit 60b9e2fac13ad381518acd253dd33a680dc7a0c8 Author: John Baldwin AuthorDate: 2023-08-01 21:01:58 +0000 Commit: John Baldwin CommitDate: 2024-11-30 16:56:29 +0000 build.7: Document several toolchain make variables. Document CROSS_TOOLCHAIN, UNIVERSE_TOOLCHAIN, and USE_GCC_TOOLCHAINS. Differential Revision: https://reviews.freebsd.org/D40778 (cherry picked from commit 21ef3591b6119f6972896e6c00cbf9ffb759646e) --- share/man/man7/build.7 | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 index 0c352c9f3547..57280f967a38 100644 --- a/share/man/man7/build.7 +++ b/share/man/man7/build.7 @@ -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. @@ -705,7 +721,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 @@ -775,6 +791,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 @@ -804,7 +824,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 @@ -826,6 +846,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