From nobody Wed Oct 4 16:56:55 2023 X-Original-To: dev-commits-doc-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 4S117W6wV5z4wHff for ; Wed, 4 Oct 2023 16:56:55 +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 4S117W6SNLz3LTR; Wed, 4 Oct 2023 16:56:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1696438615; 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=UjDhkA3HPdliHJOunYqzQhp90RMQyLGSMJmz5mJ3GCc=; b=TkLpm6lY7j93okGQvt97JCvyVCZKeS+8RaBG20hbndWDg9u1rLlXTaX5/1SNfLReD+k8iD n7lF+/EnWiXl21ZaxOoUa6g9dsA2dA/35qx0Ylw/CTNAsqEUJQvv/5DPeNc1fD06QO6SA4 Cy50a/pW+jlMaST/NqcoLLg4KVjKf4OWpAIeHUxYPvhd6YOHo3TCzc4TBA261DEQ19QGb6 yOUZEK3Ld2PyjsI/hyCQgWOzzbm8icmrHNqoy67cZOtzjWCnxRAQEc1mh+XreMYi/KGjL3 p4wNJnX2IMxwcYj7xzo8s7z48Wt36HPhu/i3zM/QLVHTuG2awBNrI7/S0ndfHA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1696438615; a=rsa-sha256; cv=none; b=RNF2u5ReT77fbKW9B560l2RnKMBnwmJfHcC7XBThzECTAc1fAmEAvq07puvVNx3MAZHkSu K2mw8WQ96erR/7wwqL3gigNKRAmkfB7JRi6F9SXsPNhkDIhHrByf1zSAyq4oeSNc+pD/4L Gd7M8UKimQrRGw24szExcXqKz/3tJjdpka7rvdI32qlHSzZZr2Lgkm8Ujlk+3RzMxKaiPg DVx3Fg8QXTvVb0nomdC29ELVTZ4J9psXXG7XykLOhJANZ+uSOge2pZArGXABKq+tgFtSYh raXNZSmQcnOpBCfYSWp2weZZS24rR5qIj17Q0FKWdTeYzY8uCmlwINQwfloXbw== 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=1696438615; 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=UjDhkA3HPdliHJOunYqzQhp90RMQyLGSMJmz5mJ3GCc=; b=uQCEjxbJXK/oDxtuOEVRVeacsMxN0l6tpUpzhwN52Mr4yVa49jNylnAtbhJqqX0MwCecOM jAhpPYssGWHlGPrsYFyy2+c045l9XkQfyD4HWnb7Jhop+YMVKvSk6VTTd8PJqJoD+JagTC OARlosEovgsbRbq0N36TDXiXGY7rINNxWmLWrBlGqHbrkEZERdwKH39P+8INNG9jHLp3lp FLXckgDf7JRV6XFMU/+0hfp0gBrM6IkHDjArjv2rDtHuVOzz37gVQtaau1FYrnomJmdSRd 58R4axr5YlYhg/NdL88Jp0QkjqlgIgIThGXiZnxXbz/84i9YENeEBtENvW0K5Q== 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 4S117W5WqqzmCB; Wed, 4 Oct 2023 16:56:55 +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 394GutDI039047; Wed, 4 Oct 2023 16:56:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 394GutUY039044; Wed, 4 Oct 2023 16:56:55 GMT (envelope-from git) Date: Wed, 4 Oct 2023 16:56:55 GMT Message-Id: <202310041656.394GutUY039044@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: cd8ea66a93 - main - handbook/cutting-edge: Add more details about MAKEOBJDIRPREFIX List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cd8ea66a938b444da8537088a88b3afcb948cf11 Auto-Submitted: auto-generated The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=cd8ea66a938b444da8537088a88b3afcb948cf11 commit cd8ea66a938b444da8537088a88b3afcb948cf11 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2023-10-03 15:30:02 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2023-10-04 16:54:28 +0000 handbook/cutting-edge: Add more details about MAKEOBJDIRPREFIX Previously, the handbook suggested /tmp for MAKEOBJDIRPREFIX. This was fine, but suggesting /tmp/obj instead is even better as build artifacts will not mix with other files in /tmp. Also note that MAKEOBJDIRPREFIX must exist. Sponsored by: Klara, Inc. --- documentation/content/en/books/handbook/cutting-edge/_index.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index 07e97a396f..ec6f8537f6 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -1179,10 +1179,11 @@ For example, the following `tools/build/make.py` invocation builds the world: [source,shell] .... -MAKEOBJDIRPREFIX=/tmp tools/build/make.py -j 8 TARGET=arm64 TARGET_ARCH=aarch64 buildworld +MAKEOBJDIRPREFIX=/tmp/obj tools/build/make.py -j 8 TARGET=arm64 TARGET_ARCH=aarch64 buildworld .... -It builds the world for target `aarch64:arm64` on 8 CPUs and uses [.filename]#/tmp# for object files. +It builds the world for target `aarch64:arm64` on 8 CPUs and uses [.filename]#/tmp/obj# for object files. Note that the variables `MAKEOBJDIRPREFIX`, `TARGET`, and `TARGET_ARCH` are mandatory when building on non-FreeBSD hosts. +Also, make sure to create the object directory pointed to by the `MAKEOBJDIRPREFIX` environment variable. Refer to man:arch[7] and man:build[7] for more details.