2 # Macro that builds the needed Makefile target to create a root
5 # The following variable must be defined before calling this macro
7 # ROOTFS_$(FSTYPE)_CMD, the command that generates the root
8 # filesystem image. A single command is allowed. The filename of the
9 # filesystem image that it must generate is $$@.
11 # The following variables can optionaly be defined
13 # ROOTFS_$(FSTYPE)_DEPENDENCIES, the list of dependencies needed to
14 # build the root filesystem (usually host tools)
16 # ROOTFS_$(FSTYPE)_PRE_GEN_HOOKS, a list of hooks to call before
17 # generating the filesystem image
19 # ROOTFS_$(FSTYPE)_POST_GEN_HOOKS, a list of hooks to call after
20 # generating the filesystem image
22 # In terms of configuration option, this macro assumes that the
23 # BR2_TARGET_ROOTFS_$(FSTYPE) config option allows to enable/disable
24 # the generation of a filesystem image of a particular type. If
25 # the configuration options BR2_TARGET_ROOTFS_$(FSTYPE)_GZIP,
26 # BR2_TARGET_ROOTFS_$(FSTYPE)_BZIP2 or
27 # BR2_TARGET_ROOTFS_$(FSTYPE)_LZMA exist and are enabled, then the
28 # macro will automatically generate a compressed filesystem image.
30 FS_DIR = $(BUILD_DIR)/buildroot-fs
31 FULL_DEVICE_TABLE = $(FS_DIR)/device_table.txt
32 ROOTFS_DEVICE_TABLES = $(call qstrip,$(BR2_ROOTFS_DEVICE_TABLE) \
33 $(BR2_ROOTFS_STATIC_DEVICE_TABLE))
34 USERS_TABLE = $(FS_DIR)/users_table.txt
35 ROOTFS_USERS_TABLES = $(call qstrip,$(BR2_ROOTFS_USERS_TABLES))
37 ifeq ($(BR2_REPRODUCIBLE),y)
38 define ROOTFS_REPRODUCIBLE
39 find $(TARGET_DIR) -print0 | xargs -0 -r touch -hd @$(SOURCE_DATE_EPOCH)
43 ROOTFS_COMMON_TAR = $(FS_DIR)/rootfs.common.tar
45 # Command to create the common tarball from the base target directory.
46 define ROOTFS_COMMON_TAR_CMD
47 tar cf $(ROOTFS_COMMON_TAR) --numeric-owner \
48 --exclude=$(notdir $(TARGET_DIR_WARNING_FILE)) \
52 # Command to extract the common tarball into the per-rootfs target directory
53 define ROOTFS_COMMON_UNTAR_CMD
54 mkdir -p $(TARGET_DIR)
55 tar xf $(ROOTFS_COMMON_TAR) -C $(TARGET_DIR)
59 rootfs-common: $(ROOTFS_COMMON_TAR)
61 # Emulate being in a filesystem, so that we can have our own TARGET_DIR.
62 ROOTFS_COMMON_TARGET_DIR = $(FS_DIR)/target
64 ROOTFS_COMMON_DEPENDENCIES = \
65 host-fakeroot host-makedevs \
66 $(if $(PACKAGES_USERS)$(ROOTFS_USERS_TABLES),host-mkpasswd)
68 $(ROOTFS_COMMON_TAR): ROOTFS=COMMON
69 $(ROOTFS_COMMON_TAR): FAKEROOT_SCRIPT=$(FS_DIR)/fakeroot.fs
70 $(ROOTFS_COMMON_TAR): $(ROOTFS_COMMON_DEPENDENCIES) target-finalize
71 @$(call MESSAGE,"Generating common rootfs tarball")
74 rsync -au $(BASE_TARGET_DIR)/ $(TARGET_DIR)
75 echo '#!/bin/sh' > $(FAKEROOT_SCRIPT)
76 echo "set -e" >> $(FAKEROOT_SCRIPT)
77 echo "chown -h -R 0:0 $(TARGET_DIR)" >> $(FAKEROOT_SCRIPT)
78 ifneq ($(ROOTFS_USERS_TABLES),)
79 cat $(ROOTFS_USERS_TABLES) >> $(USERS_TABLE)
81 $(call PRINTF,$(PACKAGES_USERS)) >> $(USERS_TABLE)
82 PATH=$(BR_PATH) $(TOPDIR)/support/scripts/mkusers $(USERS_TABLE) $(TARGET_DIR) >> $(FAKEROOT_SCRIPT)
83 ifneq ($(ROOTFS_DEVICE_TABLES),)
84 cat $(ROOTFS_DEVICE_TABLES) > $(FULL_DEVICE_TABLE)
85 ifeq ($(BR2_ROOTFS_DEVICE_CREATION_STATIC),y)
86 $(call PRINTF,$(PACKAGES_DEVICES_TABLE)) >> $(FULL_DEVICE_TABLE)
89 $(call PRINTF,$(PACKAGES_PERMISSIONS_TABLE)) >> $(FULL_DEVICE_TABLE)
90 echo "$(HOST_DIR)/bin/makedevs -d $(FULL_DEVICE_TABLE) $(TARGET_DIR)" >> $(FAKEROOT_SCRIPT)
91 $(foreach s,$(call qstrip,$(BR2_ROOTFS_POST_FAKEROOT_SCRIPT)),\
92 echo "echo '$(TERM_BOLD)>>> Executing fakeroot script $(s)$(TERM_RESET)'" >> $(FAKEROOT_SCRIPT); \
93 echo $(EXTRA_ENV) $(s) $(TARGET_DIR) $(BR2_ROOTFS_POST_SCRIPT_ARGS) >> $(FAKEROOT_SCRIPT)$(sep))
94 $(foreach hook,$(ROOTFS_PRE_CMD_HOOKS),\
95 $(call PRINTF,$($(hook))) >> $(FAKEROOT_SCRIPT)$(sep))
96 $(call PRINTF,$(ROOTFS_COMMON_TAR_CMD)) >> $(FAKEROOT_SCRIPT)
97 $(foreach hook,$(ROOTFS_POST_CMD_HOOKS),\
98 $(call PRINTF,$($(hook))) >> $(FAKEROOT_SCRIPT)$(sep))
99 chmod a+x $(FAKEROOT_SCRIPT)
100 PATH=$(BR_PATH) $(HOST_DIR)/bin/fakeroot -- $(FAKEROOT_SCRIPT)
102 rootfs-common-show-depends:
103 @echo $(ROOTFS_COMMON_DEPENDENCIES)
105 # Since this function will be called from within an $(eval ...)
106 # all variable references except the arguments must be $$-quoted.
109 ROOTFS_$(2)_DIR = $$(FS_DIR)/$(1)
110 ROOTFS_$(2)_TARGET_DIR = $$(ROOTFS_$(2)_DIR)/target
112 ROOTFS_$(2)_DEPENDENCIES += rootfs-common
114 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_GZIP),y)
115 ROOTFS_$(2)_COMPRESS_EXT = .gz
116 ROOTFS_$(2)_COMPRESS_CMD = gzip -9 -c
118 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_BZIP2),y)
119 ROOTFS_$(2)_COMPRESS_EXT = .bz2
120 ROOTFS_$(2)_COMPRESS_CMD = bzip2 -9 -c
122 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_LZMA),y)
123 ROOTFS_$(2)_DEPENDENCIES += host-lzma
124 ROOTFS_$(2)_COMPRESS_EXT = .lzma
125 ROOTFS_$(2)_COMPRESS_CMD = $$(LZMA) -9 -c
127 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_LZ4),y)
128 ROOTFS_$(2)_DEPENDENCIES += host-lz4
129 ROOTFS_$(2)_COMPRESS_EXT = .lz4
130 ROOTFS_$(2)_COMPRESS_CMD = lz4 -l -9 -c
132 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_LZO),y)
133 ROOTFS_$(2)_DEPENDENCIES += host-lzop
134 ROOTFS_$(2)_COMPRESS_EXT = .lzo
135 ROOTFS_$(2)_COMPRESS_CMD = $$(LZOP) -9 -c
137 ifeq ($$(BR2_TARGET_ROOTFS_$(2)_XZ),y)
138 ROOTFS_$(2)_DEPENDENCIES += host-xz
139 ROOTFS_$(2)_COMPRESS_EXT = .xz
140 ROOTFS_$(2)_COMPRESS_CMD = xz -9 -C crc32 -c
143 $$(BINARIES_DIR)/rootfs.$(1): ROOTFS=$(2)
144 $$(BINARIES_DIR)/rootfs.$(1): FAKEROOT_SCRIPT=$$(ROOTFS_$(2)_DIR)/fakeroot
145 $$(BINARIES_DIR)/rootfs.$(1): $$(ROOTFS_$(2)_DEPENDENCIES)
146 @$$(call MESSAGE,"Generating root filesystem image rootfs.$(1)")
147 rm -rf $$(ROOTFS_$(2)_DIR)
148 mkdir -p $$(ROOTFS_$(2)_DIR)
149 echo '#!/bin/sh' > $$(FAKEROOT_SCRIPT)
150 echo "set -e" >> $$(FAKEROOT_SCRIPT)
151 $$(call PRINTF,$$(ROOTFS_COMMON_UNTAR_CMD)) >> $$(FAKEROOT_SCRIPT)
152 $$(foreach hook,$$(ROOTFS_$(2)_PRE_GEN_HOOKS),\
153 $$(call PRINTF,$$($$(hook))) >> $$(FAKEROOT_SCRIPT)$$(sep))
154 $$(call PRINTF,$$(ROOTFS_REPRODUCIBLE)) >> $$(FAKEROOT_SCRIPT)
155 $$(call PRINTF,$$(ROOTFS_$(2)_CMD)) >> $$(FAKEROOT_SCRIPT)
156 chmod a+x $$(FAKEROOT_SCRIPT)
157 PATH=$$(BR_PATH) $$(HOST_DIR)/bin/fakeroot -- $$(FAKEROOT_SCRIPT)
158 ifneq ($$(ROOTFS_$(2)_COMPRESS_CMD),)
159 PATH=$$(BR_PATH) $$(ROOTFS_$(2)_COMPRESS_CMD) $$@ > $$@$$(ROOTFS_$(2)_COMPRESS_EXT)
161 $$(foreach hook,$$(ROOTFS_$(2)_POST_GEN_HOOKS),$$(call $$(hook))$$(sep))
163 rootfs-$(1)-show-depends:
164 @echo $$(ROOTFS_$(2)_DEPENDENCIES)
166 rootfs-$(1): $$(BINARIES_DIR)/rootfs.$(1)
168 .PHONY: rootfs-$(1) rootfs-$(1)-show-depends
170 ifeq ($$(BR2_TARGET_ROOTFS_$(2)),y)
171 TARGETS_ROOTFS += rootfs-$(1)
172 PACKAGES += $$(filter-out rootfs-%,$$(ROOTFS_$(2)_DEPENDENCIES))
175 # Check for legacy POST_TARGETS rules
176 ifneq ($$(ROOTFS_$(2)_POST_TARGETS),)
177 $$(error Filesystem $(1) uses post-target rules, which are no longer supported.\
178 Update $(1) to use post-gen hooks instead)
183 # $(pkgname) also works well to return the filesystem name
184 rootfs = $(call inner-rootfs,$(pkgname),$(call UPPERCASE,$(pkgname)))
186 include $(sort $(wildcard fs/*/*.mk))