[Buildroot] [PATCH v3 1/1] Makefile: add target to clean targetfs
Baruch Siach
baruch at tkos.co.il
Mon Apr 27 04:11:26 UTC 2015
Hi Emeric,
Thanks for following up on this. A few comments below.
On Sun, Apr 26, 2015 at 08:45:55PM -0400, Emeric Vigier wrote:
> If you had some files added to the targetfs (fs-overlay, new packages,
> ...) and you no longer need them, buildroot does not offer a simple way
> to remove these items from the output/target directory. The rule added
> by this commit allows you to clean the targetfs. Issuing 'make'
> afterward will generate a new and clean targetfs.
>
> A section in the documentation is also added. It describes few examples
> when developers could need it. 'make help' is also updated accordingly.
> And full-rebuild section of the documentation is updated with content
> and links.
>
> Change-Id: I42b640e845bb4195fb7b160281b16ee40883f01f
This Gerrit specific line is not useful for upstream Buildroot. Please remove.
> Signed-off-by: Emeric Vigier <emeric.vigier at savoirfairelinux.com>
[snip]
> diff --git a/docs/manual/clean-target-filesystem.txt
> b/docs/manual/clean-target-filesystem.txt
> new file mode 100644
> index 0000000..3e8181e
> --- /dev/null
> +++ b/docs/manual/clean-target-filesystem.txt
> @@ -0,0 +1,39 @@
> +// -*- mode:doc; -*-
> +// vim: set syntax=asciidoc:
> +
> +[[clean-target-filesystem]]
> +==== Clean target filesystem
> +
> +There are various cases where you would like to clean the target
> +filesystem. Especially once you understood that buildroot does not
> +have rules to uninstall files. Let's take some examples:
> +
> +1. You enabled +PACKAGE_OPENSSH+ to have a SSH server running on your
> + board. But you figure out that +sshd+ does not run well on your
> + target's architecture. Thus you decide to disable +PACKAGE_OPENSSH+
> + and enable +PACKAGE_DROPBEAR+ instead. You run +make+: +dropbear+
> + gets built and installed, fine. But +openssh+ files are still present
> + in +output/target+!
> +
> +2. You enabled +PACKAGE_NTPD+ and set the local timezone to
> + +America/Montreal+ with +BR2_TARGET_LOCALTIME+ config. Then you find
> + out that +Montreal+ local has been replaced by +Toronto+ (French
> + looks like a rogue language). You enter +make menuconfig+, make the
> + change, save, and run +make+ again. Problem:
> + +output/target/etc/timezone+ still has +America/Montreal+ content!
> +
> +Solution to this is either to identify which package to reconfigure, or
> +remove files manually, or destroy the target filesystem and recreate it.
> +This latter option is convenient: you don't have to care about which
> +packages to rebuild, and it is quite fast. Here is how to recreate your
> +target filesystem, and get rid of filesystem _stains_:
> +
> +------------------
> +make target-clean
> +make
> +------------------
> +
> ++target-clean+ removes +output/target+. That tells buildroot to recreate
> +the target skeleton, and install each package again. This is a
> +convenient way to rebuild your target filesystem cleanly without
> +rebuilding everything.
The warning is worth repeating here, I think.
> diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt
> index 6faa67a..82385ae 100644
> --- a/docs/manual/rebuilding-packages.txt
> +++ b/docs/manual/rebuilding-packages.txt
> @@ -39,17 +39,22 @@ can help you understand how to work with Buildroot:
> you would like to have SSL support in +ctorrent+, so you enable the
> +openssl+ package in Buildroot configuration and restart the
> build. Buildroot will detect that +openssl+ should be built and
> - will be build it, but it will not detect that +ctorrent+ should be
> - rebuilt to benefit from +openssl+ to add OpenSSL support. You will
> - either have to do a full rebuild, or rebuild +ctorrent+ itself.
> + will build it, but it will not detect that +ctorrent+ should be
> + rebuilt to benefit from +openssl+ support. You will either have to
> + do a full rebuild, or rebuild +ctorrent+ itself.
This is an unrelated fix. Please submit in a separate patch.
baruch
--
http://baruch.siach.name/blog/ ~. .~ Tk Open Systems
=}------------------------------------------------ooO--U--Ooo------------{=
- baruch at tkos.co.il - tel: +972.2.679.5364, http://www.tkos.co.il -
More information about the buildroot
mailing list