From 3694633183ae70aeba062d53db3eeb4bf521d090 Mon Sep 17 00:00:00 2001 From: Michael Olbrich Date: Fri, 4 Mar 2022 13:31:56 +0100 Subject: rules: introduce new macros to install files to images/ Signed-off-by: Michael Olbrich --- doc/ref_make_macros.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc') diff --git a/doc/ref_make_macros.rst b/doc/ref_make_macros.rst index 730687daf..684390089 100644 --- a/doc/ref_make_macros.rst +++ b/doc/ref_make_macros.rst @@ -150,6 +150,33 @@ When ``--verbose`` is used then the full command is logged. With .. _install_copy: +ptx/image-install, ptx/image-install-link, world/image-clean +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Usage: + +.. code-block:: make + + @$(call world/image-clean, ) + @$(call ptx/image-install, , $(_BUILD_DIR)/[, ]) + @$(call ptx/image-install-link, , , ) + +These macros are used to install files to ``|ptxdistPlatformDir|/images``. +They are only allowed in the *targetinstall* stage. They are used by +packages that produce files that are not part of a filesystem. Bootloaders +are typical packages that do this. + +``world/image-clean`` will remove the files that were created by the other +two macros in a previous run of the *targetinstall* stage. This also +happens implicitly when the package is cleaned. + +``ptx/image-install`` copies a file. The source must be an absolute path. +The destination must be relative to the image directory. If the destination +file name is the source file without the path, then this argument can be +omitted. + +``ptx/image-install-link`` creates a symlink in the image directory. + install_copy ~~~~~~~~~~~~~ -- cgit v1.2.3