From nobody Sat Mar 8 17:05:49 2025 X-Original-To: dev-commits-src-main@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 4Z98gM0Zntz5pT2t; Sat, 08 Mar 2025 17:05:51 +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 4Z98gK6FC0z3wrc; Sat, 08 Mar 2025 17:05:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1741453549; 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=BZ3gWjpqZdJYi6wCBylpNkobE3PgGwLv6UTQFRA0Hb8=; b=tudnIpQarDgl150HOkx3FyauSkfekOVQadFdp2FsGJKgjweAAJbynNotGvuK38H4n+nntk 0bdUXCR7IYMpTK6YXqOS0VzQwezfiRwynmIy2XOv5wYUWas25UhW+WI5SxFU/T+r6+2awV i89Oa6sZKgPIeLI/MgE/pAaRFZFjEPJQVCoF7+OJH1MaHlYSJDIkkNmFlszWrgyeApq8o5 IxuOxP6FWjINQAg18RlX8LkiW+LljQ5F9o/c5qSBQlp+qunodNDov/AX6x2LyLkI3vINe1 VNFK6UmBhidt191ApC/tu5pCK+JS6t4I+x2EkgQlPkPexWqYaVb1WJ+iIRRrfQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1741453549; a=rsa-sha256; cv=none; b=tvrwwW8daxTzM2ssFyw3gKBlyyUo5g+ZqFEwiQPvkMoMeGAauSqS+mc6iM30CUE0h5nYHo fq7iJylya3psLMh9Gfx0TlSj1DMcvsM9uLQnMV6Hp1R7UJkiYczY2cEcCaWXp47+TJROV1 ///wwnYbk+IxX01v/1WA+0YARNpw4j09zGopOoRv8tDg/az1dqpjvfsuQWhhtAW3QRvhnV GwF5RzvNl2Iz7yHRiNbFAIJu9JdHHVVTbU4rP3uyy6jJBkKOv9IauFa3TB8hiM+bnIyGJq rTUbFJVluJ/3UX5eWZfOdU9iRmrUuOuyDA2DPxUsBButj1Emcz8wxKIGXOZ6JA== 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=1741453549; 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=BZ3gWjpqZdJYi6wCBylpNkobE3PgGwLv6UTQFRA0Hb8=; b=nIpnISiEe0hzQSUbnSC7VwuKOFbWPqBJO5B0MSESTy4djHi1/7WHxLlYD9/lTw1T7w4qo7 oxZOpsS6pQiEEwiHom9YsrMFUwU4otVud11X5XszqcLL77ccKHVqbLAHXGJdGDjNamqRcO ++t5DT60RTZTHDjFpF9/y5NCXpbNlWM8USU3CwvZWKUyFYnKAlcTA44Nws2zVlmT9PpjHO DZQ1Qqd2/bVbX1seWAp3SUAehiJH58zCpwIAQvEKXPPhrYOtvOtLyNgRdGs07TgeyoC1wz qKE04sYTYqpqyvuXItT2lyEro2d0dAIiaz3dHACB0vxekz+70zUkPT9ntbhm9A== 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 4Z98gK5qwSzYCQ; Sat, 08 Mar 2025 17:05:49 +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 528H5nU9090639; Sat, 8 Mar 2025 17:05:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 528H5nic090636; Sat, 8 Mar 2025 17:05:49 GMT (envelope-from git) Date: Sat, 8 Mar 2025 17:05:49 GMT Message-Id: <202503081705.528H5nic090636@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 9dc4bcb1a63a - main - build(7): Document KERNBUILDDIR List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9dc4bcb1a63acbbe32b4e80b690a843dd37315e7 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=9dc4bcb1a63acbbe32b4e80b690a843dd37315e7 commit 9dc4bcb1a63acbbe32b4e80b690a843dd37315e7 Author: Warner Losh AuthorDate: 2025-03-08 01:32:58 +0000 Commit: Warner Losh CommitDate: 2025-03-08 16:59:03 +0000 build(7): Document KERNBUILDDIR KERNBUILDDIR is used by kmod.mk to find the opt_*.h when matching a kernel to the module. Usually one doesn't need this nob (since most modules are option invariant or default to the default options everyone uses), but there are times this generalization doesn't hold. Sponsored by: Netflix --- share/man/man7/build.7 | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 index 1df9b084726f..2195d1147820 100644 --- a/share/man/man7/build.7 +++ b/share/man/man7/build.7 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd February 3, 2025 +.Dd March 8, 2025 .Dt BUILD 7 .Os .Sh NAME @@ -554,6 +554,13 @@ Overrides which kernel to build and install for the various kernel make targets. It defaults to .Cm GENERIC . +.It Va KERNBUILDDIR +Overrides the default directory to get all the opt_*.h files for +building a kernel module. +Useful for stand-alone modules that depend on +.Xr config 8 +options. +Automatically set for modules built with a kernel. .It Va KERNCONFDIR Overrides the directory in which .Va KERNCONF