From nobody Sun Jan 5 21:38:48 2025 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 4YR9fx15cbz5kHhK for ; Sun, 05 Jan 2025 21:38:49 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YR9fw5X1Yz4WcG; Sun, 5 Jan 2025 21:38:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736113128; 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=8svSbbDwBYH7sTuXP+FahluB2f7YbMVnSkKXuWX2a3A=; b=qCn7zdUAsQLpkHV2skNbXEIFJNNHgi+PLkE9MnU5WHLnfZSzyaoh1RaxAlu/W5ZwQRG/VZ dI4NUkFrNYIPP/Yn2NzS9roPY6MrdgUljaNKbU8KuWhs5rm2bTgXirIXIhn5KGk2D8qsM8 496dA08ZqYUHS5qYHmBuWqhWyb+f2FupG7WEwq0YqLJjnDh563/rhhVpo47zTKk5qHFPV8 Al1UScSdOXg8oSW9bEvWFas+iE7I0cy2xbWKrwck3ppXTLxywu8FodpfGpRr/72hZ7XTiz 1qMnTHidfw77Ianjhcz7amjQBYDGBBb/zRyy1M3WHELHYYac5+s5JqWDK6yXrA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736113128; 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=8svSbbDwBYH7sTuXP+FahluB2f7YbMVnSkKXuWX2a3A=; b=aWS2VSY7/GFy9rfYE6ot+WWSS71bgB641leBmNL2aCft+UFTPG8c6kXa/o8NbUMfue/wTv zDR42Wzi9wVoXiMdXgXEPCFgyCEBAwW9LCj1GllWytpSyd7zoOZneAnkQLzfeUsRBQTcMS kS9lALQ3ni7Dc5XlA/VSnL+wa+pZB/OsZBPx9CDLGuVlH5VCSvyhm4cskOPkbbSXQeZpCJ OTJPu8hAvoLOWVujiaaEeyOCXaUZT8O+trYXeEVjTKIbi1i5YPHAkx/XHECtBuotlnMXWg Ay5/AktwkbeY/1g1loQIOur5WvtifiecGDaUoPtJc404MpbapdwmEp8Gi4WzQg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1736113128; a=rsa-sha256; cv=none; b=S/Mafgm7PDACpTlRPkWY51JCa/4ovsLniSgMQFQF1glT1urYDBLCevmtLjdI3skiWNn7hs Va5ZGl1+tQ9SCcF6KJOkcp0gDWO0uV9jRC/Fgy0fKtN76+fTVuRTrW0G3xoK6MtHzwtZNY hGWMB9rZIzjysFPwjMtXKfTU9baNBbFuHWUdKhyRzCWxYg4xA24PAjHsbVowMxlMcYleTf q2VAPImUqcIQyIzM2m8gIdXTP0LUjJvjdJ2jupNvkbXKXKY9pEpb5zM1K1/bXtIBOiEkxe AXYJfbe/pcMGw7M06VlppjclYyqhfdayfd7OUhYUv2rn4sKEA0YzyZa4hKkJzg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4YR9fw4hd9zw5c; Sun, 05 Jan 2025 21:38:48 +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 505Lcm13006151; Sun, 5 Jan 2025 21:38:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 505Lcm0M006148; Sun, 5 Jan 2025 21:38:48 GMT (envelope-from git) Date: Sun, 5 Jan 2025 21:38:48 GMT Message-Id: <202501052138.505Lcm0M006148@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Joseph Mingrone Subject: git: de3e8d6de9 - main - porters-handbook: Document updates to USES=elfctl 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: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jrm X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: de3e8d6de905a43838d6bb486bc79ace4b8283ae Auto-Submitted: auto-generated The branch main has been updated by jrm: URL: https://cgit.FreeBSD.org/doc/commit/?id=de3e8d6de905a43838d6bb486bc79ace4b8283ae commit de3e8d6de905a43838d6bb486bc79ace4b8283ae Author: Joseph Mingrone AuthorDate: 2025-01-05 15:37:48 +0000 Commit: Joseph Mingrone CommitDate: 2025-01-05 21:38:46 +0000 porters-handbook: Document updates to USES=elfctl Document two new USES=elfctl arguments: `build` and `stage`. The arguments control the location and timing of ELF feature flag modifications. Reviewed by: carlavilla, Pau Amma Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D48327 --- .../content/en/books/porters-handbook/uses/_index.adoc | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index ab59854f3d..b9f797b576 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -489,9 +489,12 @@ Add dependency on package:math/eigen[]. [[uses-elfctl]] == `elfctl` -Possible arguments: (none) +Possible arguments: (none), `build` (default), `stage` + +Set ELF binary feature control notes by setting `ELF_FEATURES`. -Change an ELF binary's feature control note by setting ELF_FEATURES. +When either no argument or the `build` argument is supplied, binaries under `BUILD_WRKSRC` are operated on, and files listed in `ELF_FEATURES` are relative to `BUILD_WRKSRC`. +When the `stage` argument is supplied, binaries under `STAGEDIR` are operated on and files listed in `ELF_FEATURES` are relative to `STAGEDIR`. [[uses-elfct-ex1]] .Uses=elfctl @@ -501,13 +504,12 @@ Change an ELF binary's feature control note by setting ELF_FEATURES. .... USES= elfctl ELF_FEATURES= featurelist:path/to/file1 \ - featurelist:path/to/file1 \ featurelist:path/to/file2 .... ==== -The format of `featurelist` is described in man:elfctl[1]. The file paths are relative to ${BUILD_WRKSRC}. +The format of `featurelist` is described in man:elfctl[1]. [[uses-erlang]] == `erlang`