From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Tue, 06 Dec 2022 12:13:08 +0100 Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1p2Vsp-00CTom-W0 for lore@lore.pengutronix.de; Tue, 06 Dec 2022 12:13:08 +0100 Received: from localhost ([127.0.0.1] helo=metis.ext.pengutronix.de) by metis.ext.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1p2Vsp-0008UQ-N7; Tue, 06 Dec 2022 12:13:07 +0100 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1p2Vry-0008Td-BA; Tue, 06 Dec 2022 12:12:14 +0100 Received: from [2a0a:edc0:0:1101:1d::ac] (helo=dude04.red.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtp (Exim 4.94.2) (envelope-from ) id 1p2Vrw-002gRV-VK; Tue, 06 Dec 2022 12:12:13 +0100 Received: from rhi by dude04.red.stw.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1p2Vrx-00GcaU-4O; Tue, 06 Dec 2022 12:12:13 +0100 From: Roland Hieber To: ptxdist@pengutronix.de Date: Tue, 6 Dec 2022 12:12:11 +0100 Message-Id: <20221206111211.3961424-3-rhi@pengutronix.de> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20221206111211.3961424-1-rhi@pengutronix.de> References: <20221206111211.3961424-1-rhi@pengutronix.de> MIME-Version: 1.0 Mail-Followup-To: Roland Hieber , ptxdist@pengutronix.de Content-Transfer-Encoding: 8bit Subject: [ptxdist] [PATCH 3/3] doc: ref: document config hash macros and variables X-BeenThere: ptxdist@pengutronix.de X-Mailman-Version: 2.1.29 Precedence: list List-Id: PTXdist Development Mailing List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: ptxdist@pengutronix.de Cc: Roland Hieber Sender: "ptxdist" X-SA-Exim-Connect-IP: 127.0.0.1 X-SA-Exim-Mail-From: ptxdist-bounces@pengutronix.de X-SA-Exim-Scanned: No (on metis.ext.pengutronix.de); SAEximRunCond expanded to false Signed-off-by: Roland Hieber --- doc/ref_make_macros.rst | 18 ++++++++++++++++++ doc/ref_make_variables.rst | 9 +++++++++ 2 files changed, 27 insertions(+) diff --git a/doc/ref_make_macros.rst b/doc/ref_make_macros.rst index 4c1ca2f0375f..3ea331baee4b 100644 --- a/doc/ref_make_macros.rst +++ b/doc/ref_make_macros.rst @@ -681,6 +681,24 @@ be installed with some other ``install_*`` command before @$(call install_replace, timezone, /etc/timezone, @TIMEZONE@, \ $(PTXCONF_TIMEZONE_LOCALTIME)) +.. _ptx/cfghash: +.. _ptx/cfghash-file: + +ptx/cfghash, ptx/cfghash-file +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Usage: + +.. code-block:: make + + $(call ptx/cfghash, , ) + $(call ptx/cfghash-file, , ) + +Add an arbitrary **** or the content of **** to the config hash +for ****. +This has the effect that the package will be rebuilt when the string or the +content of the file changes. + .. _param_macros: .. _ptxEndis: .. _ptxDisen: diff --git a/doc/ref_make_variables.rst b/doc/ref_make_variables.rst index beca984edccc..7ec09cbb3e91 100644 --- a/doc/ref_make_variables.rst +++ b/doc/ref_make_variables.rst @@ -345,6 +345,15 @@ Build Environment for all Stages Prepare Stage ^^^^^^^^^^^^^ +``_CFGHASH`` + This variable contains the config hash for the package. + If it changes, PTXdist rebuilds the prepare stage of the package (and + successively, all following stages). + + You should not need to touch this variable directly. + To add content to the config hash, you can use the macros :ref:`ptx/cfghash + and ptx/cfghash-file `. + ``_CONF_ENV`` The environment for the prepare stage. If undefined, PTXdist will use ``$(CROSS_ENV)`` for target packages, ``$(HOST_ENV)`` for host packages -- 2.30.2