features.in/cleanup: auto-add feature tag

The extra tag to filter on was omitted while
moving the code from features.in/cleanup/generate.mk
into the more generic features.in/Makefile; fixed.

Auto-added tags will definitely see an overhaul
when it's more clear what can be done with them.

Makefile

@@ -18,6 +18,8 @@ include distro.mk
 include log.mk
 include iso.mk
 
+.PHONY: $(IMAGES)
+
 # we can't use implicit rules for top-level targets, only for prereqs
 # NB: what about static pattern rules?
 # TODO: move into libdistro?
@@ -30,10 +32,14 @@ IMAGEDIR ?= $(shell [ -d "$$HOME/out" -a -w "$$HOME/out" ] \
 	|| echo "$(BUILDDIR)/out" )
 IMAGENAME ?= mkimage-profiles-$(ARCH).iso
 
+everything:
+	@for i in $(IMAGES); do $(MAKE) BUILDDIR=$(BUILDDIR) $$i; done
+
 $(IMAGES): %.iso: | profile/init distro/% boot/isolinux profile/populate iso
 	@# TODO: run automated tests (e.g. iso size)
 	@OUTNAME="$(@:.iso=)-$(DATE)-$(ARCH).iso"; \
 	 OUTPATH="$(IMAGEDIR)/$$OUTNAME"; \
+		mkdir -p "$(IMAGEDIR)" && \
 		test -s "$(IMAGEDIR)/$(IMAGENAME)" && \
 		mv "$(IMAGEDIR)/$(IMAGENAME)" "$$OUTPATH" && \
 		echo "** image: $$OUTPATH" && \

README

@@ -38,7 +38,11 @@ license: GPLv2+, see COPYING
   + базовые комплекты помещены в подкаталогах под sub.in/;
     их наборы скриптов могут расширяться фичами
     - stage1: propagator, ядро инсталятора и initrd в т.ч. с firmware
-    - install2: сам инсталятор (и модули ядра)
+    - stage2: базовый live-образ (и модули ядра, соответствующие stage1);
+      используется только с модификаторами (см. соответствующие фичи):
+      + stage2/install2: инсталятор
+      + stage2/live: LiveCD
+      + stage2/rescue: спасательная система
     - main: пакетная база к инсталяции (обязательная и дополнительная)
 - фичи:
   + список собирается в $(FEATURES)
@@ -46,14 +50,17 @@ license: GPLv2+, see COPYING
   + описываются в индивидуальных features.in/*/config.mk
   + могут зависеть друг от друга и требовать субпрофили
   + при сборке $(BUILDDIR) содержимое указанных в $(FEATURES) фич
-    (подкаталоги, соответствующие входящим в дистрибутив субпрофилям) 
+    (подкаталоги, соответствующие входящим в дистрибутив субпрофилям
+    под их итоговыми названиями -- например, live, а не stage2/live) 
     добавляется в профиль; затем выполняются generate.sh, generate.mk
 - списки пакетов (*_LISTS): просьба по возможности избегать дублирования
+  NB: перечисленные в этих переменных файлы автоматически копируются
+  в порождаемый профиль => не следует указывать пакаджлисты напрямую
 - индивидуальные пакеты (*_PACKAGES): следует крайне осторожно пользоваться
-  COMMON_PACKAGES -- эти пакеты попадут во все стадии, в том числе в образ
+  SYSTEM_PACKAGES -- эти пакеты попадут во все стадии, в том числе в образ
   чувствительной к объёму install2 (в stage1 -- только в инструментальный
   чрут); применяйте для того, что обязано быть и в инсталяторе, и в готовой
-  системе
+  системе -- и не путайте с COMMON_PACKAGES (main, live, rescue)
 
 Результат:
 - при успешном завершении сборки образ называется сообразно

clean.mk

@@ -3,8 +3,18 @@
 # drop stock predefined rules
 .DEFAULT:
 
+# tmpfs-sparing extra rule: cleanup workdir after completing each stage
+# (as packed results are saved this only lowers RAM pressure)
+ifdef CLEAN
+export GLOBAL_CLEAN_WORKDIR = clean-current
+ifdef DEBUG
+WARNING = (both CLEAN and DEBUG defined, debug options will be limited)
+endif
+endif
+
+# ordinary clean: destroys workdirs but not the corresponding results
 clean:
-	@echo '** cleaning up'
+	@echo '** cleaning up $(WARNING)'
 	@find -name '*~' -delete >&/dev/null
 	@if [ -L build -a -d build/ ]; then \
 		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG); \

distro.mk

@@ -26,36 +26,61 @@ distro/syslinux: distro/.init distro/.branding sub/stage1 \
 	use/syslinux/ui-vesamenu use/hdt use/memtest use/dos
 
 #  $(VAR) will be substituted before writing them to $(CONFIG);
-# $$(VAR) will remain unsubstituted util $(CONFIG) is included
+# $$(VAR) will remain unsubstituted until $(CONFIG) is included
 #         and their value requested (so the variable referenced
 #         can change its value during configuration _before_
 #         it's actually used); just peek inside $(CONFIG) ;-)
-
-# something actually useful (as a network-only installer)
-distro/installer: distro/.base use/installer
-	@$(call set,INSTALLER,altlinux-generic)
-	@$(call set,INSTALLER_KMODULES_REGEXP,drm.*)	# for KMS
-
 # BASE_PACKAGES, BASE_LISTS, MAIN_PACKAGES, MAIN_LISTS: see sub.in/main/
 
-distro/server-base: distro/installer sub/main use/syslinux/ui-menu use/memtest
+# live images
+
+distro/live: distro/.base use/live use/syslinux/ui-menu
+distro/rescue: distro/.base use/rescue use/syslinux/ui-menu
+distro/dos: sub/stage1 use/dos use/syslinux/ui-menu
+
+# something actually useful (as a network-only installer)
+# NB: doesn't carry stage3 thus cannot use/bootloader
+distro/installer: distro/.base use/install2
+	@$(call set,INSTALLER,altlinux-generic)
+	@$(call set,STAGE1_KMODULES_REGEXP,drm.*)	# for KMS
+
+# server distributions
+
+distro/server-base: distro/installer sub/main \
+	use/syslinux/ui-menu use/memtest use/bootloader/grub
 	@$(call add,BASE_LISTS,server-base)
 
-distro/server-ovz: distro/server-base use/hdt use/firmware/server
-	@$(call set,INSTALLER_KFLAVOUR,std-def)
+distro/server-mini: distro/server-base use/cleanup/x11-alterator
+	@$(call set,KFLAVOURS,el-smp)
+	@$(call add,KMODULES,e1000e igb)
+	@$(call add,BASE_LISTS,\
+		$(call tags,base && (server || network || security || pkg)))
+	@$(call add,BASE_LISTS,$(call tags,extra network))
+
+distro/server-ovz: distro/server-base \
+	use/hdt use/rescue use/firmware/server use/powerbutton/acpi \
+	use/cleanup/x11-alterator
+	@$(call set,STAGE1_KFLAVOUR,std-def)
 	@$(call set,KFLAVOURS,std-def ovz-el)
 	@$(call add,KMODULES,bcmwl e1000e igb ndiswrapper rtl8168 rtl8192)
 	@$(call add,KMODULES,ipset ipt-netflow opendpi pf_ring xtables-addons)
 	@$(call add,KMODULES,drbd83 kvm)
-	@$(call add,MAIN_LISTS,kernel-wifi)
 	@$(call add,BASE_LISTS,ovz-server)
 	@$(call add,BASE_LISTS,$(call tags,base server))
-	@$(call add,GROUPS,dns-server http-server ftp-server kvm-server)
-	@$(call add,GROUPS,ipmi mysql-server dhcp-server mail-server)
-	@$(call add,GROUPS,monitoring diag-tools)
+	@$(call add,MAIN_LISTS,kernel-wifi)
+	@$(call add,MAIN_GROUPS,dns-server http-server ftp-server kvm-server)
+	@$(call add,MAIN_GROUPS,ipmi mysql-server dhcp-server mail-server)
+	@$(call add,MAIN_GROUPS,monitoring diag-tools)
 
-distro/minicd: distro/server-base
-	@$(call set,KFLAVOURS,pure-emerald)	# we might need the most recent drivers
-	@$(call add,MAIN_PACKAGES,etcnet-full)
+# desktop distributions
 
-# if there are too many screens above, it might make sense to distro.d/
+distro/desktop-base: distro/installer sub/main \
+	use/syslinux/ui-vesamenu use/x11/xorg use/bootloader/grub
+
+distro/icewm: distro/desktop-base \
+	use/lowmem use/x11/xdm use/x11/runlevel5 \
+	use/bootloader/lilo use/powerbutton/acpi \
+	use/cleanup/alterator
+	@$(call add,BASE_LISTS,$(call tags,icewm desktop))
+
+# NB: if there are too many screens above, it might make sense to distro.d/

doc/CodingStyle

@@ -1,9 +1,8 @@
 требования по оформлению кода
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 * постарайтесь не вносить без обсуждения разнобой стилей,
   если есть предметные пожелания по коррекции текущего --
-  пишите, обсудим;
+  пишите в devel-distro@, обсудим;
 
 * перед тем, как делать существенные переработки уже имеющегося
   кода -- опять же опишите проблему, идею и предполагаемый результат,
@@ -14,7 +13,6 @@
 
 рекомендации
 ~~~~~~~~~~~~
-
 * трезво относитесь ко входным данным и не пренебрегайте кавычками:
   название дистрибутива с пробелом или получение текста ошибки вместо
   ожидаемого вывода команды могут привести к сложнодиагностируемым
@@ -31,3 +29,8 @@
 * предпочтительно применение $() вместо `` (особенно при вложенности);
 
 * постарайтесь не вылазить за 80 колонок.
+
+ссылки
+~~~~~~
+* https://lists.altlinux.org/mailman/listinfo/devel-distro
+  (подписка по приглашению)

doc/assumptions.txt

@@ -0,0 +1,29 @@
+предположения фрагментов кода об окружении
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+- pkg.in/lists/Makefile
+  + ожидает, что названия пакаджлистов указываются в переменных
+    вида *_LISTS, и копирует в генерируемый профиль только их
+  + если задать имя файла пакаджлиста непосредственно в Makefile
+    субпрофиля, он не будет скопирован
+  + характерное сообщение об ошибке:
+    E: Couldn't find package
+
+- features.in/stage2/stage1/scripts.d/02-kdefault
+- features.in/stage2/stage1/scripts.d/03-test-kernel
+- sub.in/stage1/Makefile
+  + ожидают, что в stage1 попадёт строго одно ядро сообразно
+    явному указанию в STAGE1_KFLAVOUR (либо последнее указанное
+    в KFLAVOURS)
+  + если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
+    результат может быть неожиданным
+  + вероятная ошибка: незагрузка полученного squashfs
+
+- features.in/install2/install2/stage2cfg.mk
+- features.in/live/live/stage2cfg.mk
+- features.in/rescue/rescue/stage2cfg.mk
+- features.in/syslinux/cfg.in/15live.cfg
+- features.in/syslinux/cfg.in/20install2.cfg
+- features.in/syslinux/cfg.in/80rescue.cfg
+- features.in/syslinux/scripts.d/20-propagator-ramdisk
+  + ожидают, что названия squashfs-образов второй стадии инсталятора,
+    livecd и спасательной системы соответственно altinst, live и rescue

doc/debug.txt

@@ -0,0 +1,21 @@
+ловля плюх
+~~~~~~~~~~
+При отладке сборки конфигурации или самого дистрибутива
+могут оказаться полезными следующие средства:
+
+- build/distcfg.mk
+  + формируется автоматически в процессе построения конфигурации;
+  + содержит трассировочную информацию (откуда что взялось);
+  + этот файл применяется как авторитетный конфигурационный
+
+- build/build.log
+  + подробность зависит от значения переменной DEBUG,
+    которую можно передать при запуске make (см. variables.txt);
+  + содержит коммит, из которого происходит сборка, и признак
+    "грязности" рабочего каталога при наличии модификаций после
+    этого коммита;
+  + содержит список конфигурационных переменных и их конечных значений,
+    созданный на основании distcfg.mk (см. тж. build/vars.mk)
+
+Общая информация по отладке сборки профилей mkimage:
+http://www.altlinux.org/Mkimage/debug

doc/features.txt

@@ -1,3 +1,5 @@
+фичи
+~~~~
 Особенности дистрибутива, не учитываемые в пакетной базе
 или зависящие от переменных времени сборки/установки образа,
 могут быть оформлены несколькими образами:
@@ -18,4 +20,10 @@
 * необходимы пакетные зависимости;
 * требуется компилируемый платформозависимый код (для чего бы...);
 * код фичи достаточно специфичен, нетривиален и объёмен,
-  чтобы загромождать метапрофиль было не очень осмысленно.
+  чтобы загромождать метапрофиль было не очень осмысленно;
+* фича представляет из себя отдельный мини-продукт, над которым
+  ведётся активная работа (возможно, несколькими людьми).
+
+Стоит избегать изменения пакетных умолчаний в случае, когда их
+представляется осмысленным и возможным скорректировать в пакете:
+таким образом они станут более дистрибутивными.

doc/profiles.mk.sample

@@ -1,7 +1,10 @@
 ### sample ~/.mkimage/profiles.mk
 
-# ARCH is defined in/for metaprofile's toplevel Makefile, not here
-APTCONF = ~/apt/apt.conf.$(ARCH)
+### where to look for apt.conf; system one used by default
+#APTCONF = ~/apt/apt.conf.$(ARCH)
 
-# can be defined here but passing DEBUG=1 is preferred
-#GLOBAL_VERBOSE = 1
+### turns on GLOBAL_VERBOSE and prettier output
+#DEBUG = 1
+
+# spares tmpfs, quite recommended unless you need raw workdir chroots
+#CLEAN = 1

doc/variables.txt

@@ -0,0 +1,35 @@
+переменные make
+~~~~~~~~~~~~~~~
+При запуске на сборку принимается ряд переменных
+(см. тж. profiles.mk.sample):
+
+- APTCONF
+  + задаёт путь к требуемому apt.conf
+  + значение: пусто (по умолчанию системный) либо строка
+  + см. image.in/Makefile
+
+- ARCH
+  + определяет целевую архитектуру образа
+  + значение: пусто (по умолчанию авто), i586 или x86_64
+  + см. iso.mk
+
+- BUILDDIR
+  + определяет каталог генерируемого профиля и сборки
+  + значение: пусто (по умолчанию авто) либо строка
+  + см. profile.mk
+
+- CLEAN
+  + экономия RAM при сборке в tmpfs, иначе места на диске
+  + очистка рабочего каталога после успешной сборки очередной стадии
+  + может помешать использовать некоторые варианты отладки
+  + значение: любая строка, по умолчанию пусто
+  + см. clean.mk
+
+- DEBUG
+  + включение средств отладки
+  + значение: пусто (по умолчанию), 1 или 2
+  + см. log.mk
+
+пример
+~~~~~~
+make DEBUG=1 CLEAN=1 syslinux.iso

features.in/00example/README

@@ -14,7 +14,8 @@
 её в переменную FEATURES -- к сожалению, реализовать добавление
 автоматом не представляется возможным).  Если название фичи не
 упоминается в списке, содержащемся в этой переменной, то она
-и не задействуется при построении профиля.
+не задействуется при построении профиля, а только при сборке
+конфигурации дистрибутива.
 
 Остальное содержимое является дополнительным и используется
 в таком порядке (см. features.in/Makefile):
@@ -31,11 +32,11 @@
 
 - затем используется generate.mk, если существует и непустой.
 
-Например, если дистрибутив требует субпрофили stage1, install2
+Например, если используются субпрофили stage1, stage2/install2
 и main, вы можете решить собрать специфические для фичи скрипты
 инсталятора в install2/image-scripts.d/ (или необходимые для
-операций с пакетной базой -- в main/scripts.d/, смотря чего надо
-добиться; загляните также в документацию mkimage).
+операций с пакетной базой -- в main/scripts.d/, смотря чего
+надо добиться; загляните также в документацию mkimage).
 
 А если требуются нетривиальные действия по конфигурированию
 (как при сборке syslinux.cfg из кусочков, в зависимости от того,

features.in/Makefile

@@ -5,38 +5,72 @@ ifndef BUILDDIR
 $(error BUILDDIR not defined)
 endif
 
--include $(BUILDDIR)/distcfg.mk
+include $(BUILDDIR)/distcfg.mk
 
-# first rsync what's static, and make backups --
+# first rsync what's static, and make backups (*~) --
 # these might signal of file clashes (or plain dirt);
+# second, care for toplevel and tagged script dirs;
 # then handle two more ways of implementing a feature
+#
+# NB: some subprofiles will be specified as "src/dst"
+#     -- then both src/ and dst/ can hold the addons;
+#     still both pieces go into a single destination
+
+### {image-,}scripts.d/ get rsynced twice :-/
+### still we don't want the trimmed-down case
 
 all:
 	@echo "** starting feature configuration"
-	@if test -n "$(GLOBAL_DEBUG)"; then echo "** requested: $(FEATURES)"; fi
-	@for dir in $(FEATURES); do \
-		for sub in $(SUBPROFILES); do \
-			if test -d $$dir/$$sub/; then \
-				if rsync -ab $$dir/$$sub/ $(BUILDDIR)/$$sub/; \
-				then \
-					type -t git >&/dev/null && \
-					pushd $(BUILDDIR)/$$sub/ && \
-					git add . && \
-					git commit -qam "$@/$$dir/$$sub" ||:; \
-					popd; \
+	@if [ -n "$(GLOBAL_DEBUG)" ]; then \
+		echo "** target subprofiles: $(SUBPROFILES)"; \
+		echo "** requested features: $(FEATURES)"; \
+	fi
+	@for feat in $(FEATURES); do \
+		pushd "$$feat" && \
+		for sub in / $(SUBPROFILES); do \
+			src="$${sub%/*}"; \
+			dst="$${sub#*/}"; \
+			if [ -d "$$src" ]; then rsync -qab "$$src/" "$(BUILDDIR)/$$dst/"; fi; \
+			if [ -d "$$dst" ]; then rsync -qab "$$dst/" "$(BUILDDIR)/$$dst/"; fi; \
+			for scr in {image-,}scripts.d; do \
+				scriptdir="$(BUILDDIR)/$$dst/$$scr/"; \
+				if [ -d "$$scriptdir" ]; then \
+					if [ -d "$$scr" ]; then \
+						rsync -qab "$$scr/" "$$scriptdir/"; \
+					fi; \
+					if [ -d "tagged/$$scr" ]; then \
+						pushd "tagged/$$scr" && \
+						echo "$$feat && ($$src || $$dst)" \
+						| tags2lists . \
+						| xargs -r cp -v -pLt "$$scriptdir" --; \
+						popd; \
+					fi; \
 				fi; \
+			done; \
+			type -t git >&/dev/null && \
+			pushd "$(BUILDDIR)/$$dst/" && \
+			git add . && \
+			if [ -n "$$dst" ]; then \
+				the="$$sub subprofile"; \
+			else \
+				the="toplevel"; \
 			fi; \
-		done; \
-		if test -x $$dir/generate.sh; then \
-			pushd $$dir && \
-			sh generate.sh; \
+			git commit -qam "$$feat feature ($$the part)" ||:; \
 			popd; \
-		fi; \
-		if test -s $$dir/generate.mk; then \
-			$(MAKE) -C $$dir -f generate.mk; \
-		fi; \
+		done; \
+		if [ -x "generate.sh" ]; then sh generate.sh; fi; \
+		if [ -s "generate.mk" ]; then $(MAKE) -f generate.mk; fi; \
+		type -t git >&/dev/null && \
+		pushd "$(BUILDDIR)/" && \
+		git add . && \
+		git commit -qam "$$feat feature generation complete" ||:; \
+		popd; \
+		popd; \
 	done
+	@find "$(BUILDDIR)/" -name '*~' \
+	| sed "s,$(BUILDDIR)/,** warning: file clash: ," >&2
 
-help:
-	@echo "** available features:"
-	@grep -h '^use/' */config.mk
+# FIXME: drop or fix regarding undefined BUILDDIR being ok
+#help:
+#	@echo "** available features:"
+#	@grep -h '^use/' */config.mk | fmt -sw"$$((COLUMNS>>1))" | column -t

features.in/README

@@ -13,8 +13,16 @@
 после инициализации профиля (см. ../image.in/) и копирования
 субпрофилей (см. ../sub.in/).  Для каждой фичи, указанной
 в $(FEATURES), копируются подкаталоги сообразно субпрофилям,
-а также выполняется скрипт generate.sh и задействуется generate.mk
-(при их наличии).
+а также производится обработка {tagged/,}{image-},scripts.d/
+(см. cleanup/ в качестве примера); затем выполняется скрипт
+generate.sh и задействуется generate.mk (при их наличии).
+
+  NB: тегированные скрипты являются экспериментальными,
+      возможны недоработки и существенные изменения!
+
+Если фича дополняет хуками семейство целевых субпрофилей,
+построенных на одном базовом, можно воспользоваться подкаталогом
+с именем исходного базового субпрофиля (см. $src, $dst в Makefile).
 
 Несложный пример содержится в 00example/, более близкий к жизни
 и нынешним пределам возможностей метапрофиля -- в syslinux/.

features.in/bootloader/README

@@ -0,0 +1,9 @@
+Добавление установки загрузчика основной системы, затребованного
+посредством указания "grub" или "lilo" в BASE_BOOTLOADER.
+
+Соответствующий модуль alterator добавляется в устанавливаемую
+систему (он НЕ должен требоваться пакету installer-distro-*)
+и требует пакет выбранного загрузчика.
+
+Реализация экспериментальная (нужно модуляризовать installer-steps),
+пока завязана на installer-distro-altlinux-generic.

features.in/bootloader/config.mk

@@ -0,0 +1,9 @@
+# TODO: invent something prettier (think "lilo+grub" -- or error out?)
+# - add,BASE_PACKAGES,alterator-$* is overly additive
+# - remember .base if adding yet another *_PACKAGES
+
+use/bootloader: use/install2 sub/main
+	@$(call add,BASE_PACKAGES,alterator-$$(BASE_BOOTLOADER))
+
+use/bootloader/grub use/bootloader/lilo: use/bootloader/%: use/bootloader
+	@$(call set,BASE_BOOTLOADER,$*)

features.in/cleanup/README

@@ -0,0 +1,6 @@
+Эта фича вместо созидания занимается выкидыванием лишнего
+(например, части модулей инсталятора из установленной системы).
+
+По возможности стоит работать над дизайном инфраструктуры
+и пакетной базой так, чтобы ставить-удалять приходилось как
+можно меньше.  В идеале такой антифичи не должно быть вовсе :)

features.in/cleanup/config.mk

@@ -0,0 +1,19 @@
+use/cleanup:
+	@$(call add,FEATURES,cleanup)
+
+use/cleanup/installer: use/cleanup
+	@$(call add,CLEANUP_PACKAGES,'installer-*')
+
+use/cleanup/x11: use/cleanup
+	@$(call add,CLEANUP_PACKAGES,libSM libXext libXmu libXi)
+
+# as some alterator modules are installed into stage3 (the destination
+# root filesystem) to perform actions like bootloader setup, we might
+# have to remove them (contrary to the usual build-up)...
+use/cleanup/alterator: use/cleanup
+	@$(call add,CLEANUP_PACKAGES,'alterator*' rpm-macros-alterator)
+	@$(call add,CLEANUP_PACKAGES,'guile*' libvhttpd)
+
+# for lightweight server distros
+use/cleanup/x11-alterator: use/cleanup/x11 use/cleanup/alterator
+	@$(call add,CLEANUP_PACKAGES,libmng qt4-common)

features.in/cleanup/tagged/image-scripts.d/01+install2+cleanup

@@ -0,0 +1,20 @@
+#!/bin/sh -efu
+
+if [ -n "$GLOBAL_VERBOSE" ]; then
+	echo "** GLOBAL_CLEANUP_PACKAGES: $GLOBAL_CLEANUP_PACKAGES"
+fi >&2
+
+SCRIPT="/usr/share/install2/postinstall.d/01+install2+cleanup"
+cat > "$SCRIPT" << EOF
+#!/bin/sh -efu
+
+. install2-init-functions
+
+# don't override the script start message on the same line
+echo "removing $GLOBAL_CLEANUP_PACKAGES"
+
+# remove extra packages from installed system
+list="\$(exec_chroot rpmquery -a --qf='%{NAME}\\n' $GLOBAL_CLEANUP_PACKAGES)"
+[ -z "\$list" ] || exec_chroot apt-get remove -f -y  -- \$list
+EOF
+chmod +x "$SCRIPT"

features.in/dos/README

@@ -0,0 +1,6 @@
+Фича добавляет создание FreeDOS "live floppy" в stage1.
+
+Текущее состояние -- загружается минимальная система.
+Для практического применения (в первую очередь это
+перешивка firmware) требуется сделать подключение
+CD и/или USB Flash с тем, чтобы класть туда прошивки.

features.in/dos/config.mk

@@ -0,0 +1,5 @@
+use/dos: use/syslinux
+	@$(call add,FEATURES,dos)
+	@$(call add,SYSLINUX_CFG,dos)
+	@$(call add,SYSLINUX_FILES,/usr/lib/syslinux/memdisk)
+	@$(call add,STAGE1_PACKAGES,make-freedos-floppy glibc-gconv-modules)

features.in/dos/stage1/scripts.d/50-make-dos-floppy

@@ -0,0 +1,6 @@
+#!/bin/sh -x
+# create a barebone bootable freedos floppy
+# TODO: some sub-framework to populate it as well
+
+mkdir -p "$WORKDIR/syslinux"
+make-freedos-floppy "$WORKDIR/syslinux/freedos.img"

features.in/firmware/README

@@ -0,0 +1,7 @@
+Эта фича добавляет комплекты различного firmware в инсталятор,
+устанавливаемую систему и т.п.
+
+Следует учитывать, что объём добавленного может быть довольно
+существенным -- в десктопе вряд ли нужен микрокод для FC HBA
+или SCSI RAID, который может быть критичен для полезного
+серверного или спасательного дистрибутива (см. #18047).

features.in/firmware/config.mk

@@ -3,14 +3,14 @@
 #     for mkmodpack to use
 
 use/firmware:
-	@$(call add,COMMON_PACKAGES,firmware-linux)
+	@$(call add,SYSTEM_PACKAGES,firmware-linux)
 
 use/firmware/server: use/firmware
-	@$(call add,COMMON_PACKAGES,firmware-aic94xx-seq)
+	@$(call add,SYSTEM_PACKAGES,firmware-aic94xx-seq)
 	@$(call add,MAIN_PACKAGES_REGEXP,firmware-ql.*)
 
 use/firmware/desktop: use/firmware
-	@$(call add,COMMON_PACKAGES,firmware-psb)
+	@$(call add,SYSTEM_PACKAGES,firmware-psb)
 
 use/firmware/wireless: use/firmware
 	@$(call add,MAIN_PACKAGES,firmware-acx100)

features.in/install2/README

@@ -1,11 +1,9 @@
-Этот каталог содержит субпрофиль второй стадии инсталятора,
-требующийся для сборки инсталяционных образов.
+Эта фича дополняет базовый "живой" образ второй стадии
+специфическими для инсталяционного образа настройками
+и скриптовыми хуками.
 
 При добавлении скриптов в image-scripts.d/ следует позаботиться,
 чтобы в компактном livecd, которым является инсталятор, оказались
 нужные им утилиты (INSTALL2_PACKAGES).  Перегружать его не следует,
 поскольку это прямо влияет на требования по минимальному размеру
 оперативной памяти для установки.
-
-Результат -- squashfs в файле altinst, подлежащем копированию
-в образ.

features.in/install2/config.mk

@@ -1,7 +1,6 @@
-use/installer: sub/install2 use/syslinux/install2.cfg
-	@$(call add,FEATURES,installer)
+use/install2: use/stage2 sub/stage2/install2 use/cleanup/installer
+	@$(call add,FEATURES,install2)
 	@$(call set,INSTALL2_PACKAGES,installer-distro-$$(INSTALLER)-stage2)
 	@$(call add,INSTALL2_PACKAGES,branding-$$(BRANDING)-alterator)
 	@$(call add,MAIN_PACKAGES,branding-$$(BRANDING)-release)
-#	@$(call set,BASE_LISTS,base)
 	@$(call add,BASE_LISTS,$(call tags,basesystem))

features.in/install2/install2/image-scripts.d/10bootloader

@@ -0,0 +1,5 @@
+#!/bin/sh
+# FIXME: test run for installer-distro-altlinux-generic 6.0-alt2
+# NB: grub is currently the default in ALT Linux
+
+sed -i "s/^grub$/$GLOBAL_BASE_BOOTLOADER/" /usr/share/install2/installer-steps

features.in/install2/install2/stage2cfg.mk

@@ -0,0 +1,17 @@
+# stage2 mod: build install2 subprofile (installer "live" part)
+
+IMAGE_PACKAGES = $(INSTALL2_PACKAGES) \
+		 udev e2fsprogs glibc-nss
+
+MKI_PACK_RESULTS = squash:altinst
+
+# also removed in a cleanup hook but to spare a few cycles...
+HSH_EXCLUDE_DOCS = 1
+
+# pass downstream
+GLOBAL_BASE_BOOTLOADER := $(BASE_BOOTLOADER)
+
+debug:
+	@echo "** install2: IMAGE_PACKAGES: $(IMAGE_PACKAGES)"
+	@echo "** install2: IMAGE_PACKAGES_REGEXP: $(IMAGE_PACKAGES_REGEXP)"
+	@echo "** install2: CLEANUP_PACKAGES: $(CLEANUP_PACKAGES)"

features.in/installer/stage1/scripts.d/02-kdefault

@@ -1,25 +0,0 @@
-#!/bin/sh
-# symlink default kernel iff requested but not yet done
-
-INSTALLER_KFLAVOUR="$INFO_INSTALLER_KFLAVOUR"
-if [ -n "$GLOBAL_VERBOSE" ]; then
-	echo "** INSTALLER_KFLAVOUR: $INSTALLER_KFLAVOUR"
-fi
-
-# kernel-image in instrumental chroot
-VMLINK=/boot/vmlinuz
-
-# better bail out early rather than make a silly symlink
-shopt -s failglob
-
-if [ -L "$VMLINK" ]; then
-	echo "** $VMLINK -> $(readlink "$VMLINK")"
-fi
-
-if [ -n "$INSTALLER_KFLAVOUR" ]; then
-	VMLINUZ="$(cd /boot; echo vmlinuz-*-$INSTALLER_KFLAVOUR-*)"
-	if [ -n "$VMLINUZ" ]; then
-		ln -sf "$VMLINUZ" "$VMLINK"
-		echo "** overriding $VMLINK with $VMLINUZ"
-	fi
-fi

features.in/live/README

@@ -0,0 +1,3 @@
+Эта фича дополняет базовый "живой" образ второй стадии
+специфическими для полноценного LiveCD настройками
+и скриптовыми хуками.

features.in/live/config.mk

@@ -0,0 +1,3 @@
+use/live: use/stage2 sub/stage2/live
+	@$(call add,FEATURES,live)
+	@$(call add,LIVE_LISTS,$(call tags,(base || desktop) && (live || network || icewm)))

features.in/live/live/image-scripts.d/30-users

@@ -0,0 +1,52 @@
+#!/bin/sh
+# * reset password for root
+# * add user `altlinux' (without password)
+
+verbose()
+{
+    if [ -n "$GLOBAL_VERBOSE" ]; then
+        echo "HOOK: 30-users: $@"
+    fi
+}
+
+add_user()
+{
+    verbose "Add $1 user"
+    local groups=
+    for g in users scanner audio radio proc cdrom cdwriter wheel fuse; do
+	if groupmod $g 2>/dev/null; then
+	    if [ -n "$groups" ]; then
+		groups="$groups,$g"
+	    else
+		groups="$g"
+	    fi
+	fi
+    done
+
+    /usr/sbin/useradd -p "" -G "$groups" "$1" ||:
+    chown -R "$1:auth" "/etc/tcb/$1"
+    chown -R "$1:$1" /home/$1
+
+    if [ -n "$GLOBAL_CRYPT_HOMES" ]; then
+      verbose "Set password for user $1"
+      echo "$1" | passwd --stdin $1
+    fi
+
+    sudoers="/etc/sudoers"
+    if [ -w "$sudoers" ]; then
+        verbose "Add $1 to sudoers."
+        echo "$1   ALL=(root) NOPASSWD:ALL" >> "$sudoers"
+    else
+        verbose "Can't find writable $sudoers file."
+    fi
+}
+
+verbose "has started"
+
+verbose "Clear password for root account"
+/usr/sbin/usermod -p "" root
+chown -R root.auth /etc/tcb/root
+
+add_user altlinux
+
+verbose "finished"

features.in/live/live/stage2cfg.mk

@@ -0,0 +1,8 @@
+# stage2 mod: livecd
+
+IMAGE_PACKAGES = $(COMMON_PACKAGES) \
+		 $(LIVE_PACKAGES) \
+		 $(call map,list,$(LIVE_LISTS) $(LIVE_MAIN_GROUPS)) \
+		 interactivesystem
+
+MKI_PACK_RESULTS = squash:live

features.in/lowmem/README

@@ -0,0 +1,2 @@
+Эта фича дополняет зачистку "живой" стадии инсталятора
+с тем, чтобы уменьшить её размер и требования к памяти.

features.in/lowmem/config.mk

@@ -1,4 +1,4 @@
-use/lowmem: use/installer
+use/lowmem: use/install2
 	@$(call add,FEATURES,lowmem)
 # TODO: http://www.altlinux.org/Branding/slideshow => disable?
 #       also installer-feature-rm-slideshow

features.in/memtest/README

@@ -1,5 +1,2 @@
 Добавление memtest86+ в загрузку с образа и в устанавливаемую пакетную базу;
-востребовано для для инсталяторов, live/rescue.
-
-NB: интегрируется с syslinux (проверено/работает), но _не_ требует
-use/syslinux на случай, если прикрутим поддержку других загрузчиков.
+востребовано для для инсталяторов, live/rescue.  Интегрируется с syslinux.

features.in/memtest/config.mk

@@ -1,4 +1,4 @@
-use/memtest:
+use/memtest: use/syslinux
 	@$(call add,FEATURES,memtest)
-	@$(call add,COMMON_PACKAGES,memtest86+)
+	@$(call add,SYSTEM_PACKAGES,memtest86+)
 	@$(call add,SYSLINUX_CFG,memtest)

features.in/powerbutton/README

@@ -0,0 +1,2 @@
+Эта фича конфигурирует поддержку управления кнопкой питания
+-- выключение для ACPI, засыпание для APM (не проверялось).

features.in/powerbutton/config.mk

@@ -0,0 +1,14 @@
+# common
+use/powerbutton:
+	@$(call add,COMMON_PACKAGES,installer-feature-powerbutton-stage3)
+
+# modern power management
+use/powerbutton/acpi: use/powerbutton
+	@$(call add,COMMON_PACKAGES,acpid acpid-events-power)
+
+use/powerbutton/powersave: use/powerbutton/acpi
+	@$(call add,COMMON_PACKAGES,powersave)
+
+# legacy power management
+use/powerbutton/apm: use/powerbutton
+	@$(call add,COMMON_PACKAGES,apmd)

features.in/rescue/README

@@ -0,0 +1,3 @@
+Эта фича дополняет базовый "живой" образ второй стадии
+специфическими для спасательного образа настройками
+и скриптовыми хуками.

features.in/rescue/config.mk

@@ -0,0 +1,4 @@
+use/rescue: use/stage2 sub/stage2/rescue
+	@$(call add,FEATURES,rescue)
+	@$(call add,RESCUE_LISTS,$(call tags,base && (rescue || network)))
+	@$(call add,RESCUE_LISTS,$(call tags,extra network))

features.in/rescue/rescue/image-scripts.d/98init-rescue

@@ -0,0 +1,21 @@
+#!/bin/sh
+
+# stage1 needs this <-- FIXME: duplicated in sub.in/stage2/image-scripts.d/00propagator
+#mkdir -p /image
+
+# m-p-d::profiles/rescue/image-scripts.d/999system
+mv -f -- /etc/inittab.rescue /etc/inittab
+
+# enable NFS mounts
+chkconfig rpcbind on
+sed -i 's,#\(RPCBIND_ARGS="-l".*\),\1,' /etc/sysconfig/rpcbind
+
+# remove unwanted startup scripts
+find /etc/rc.d/rc{2,3,4,5}.d/ -type l -name 'S*' \
+	-not -name '*logd' \
+	-not -name '*network' \
+	-not -name '*rpcbind' \
+	-not -name '*random' \
+	-not -name '*sysreport' \
+	-not -name '*udev*' \
+	-delete -print

features.in/rescue/rescue/stage2cfg.mk

@@ -0,0 +1,12 @@
+# stage2 mod: rescue "live" image
+
+IMAGE_PACKAGES = $(COMMON_PACKAGES) \
+		 $(RESCUE_PACKAGES) \
+		 $(call list,$(RESCUE_LISTS)) \
+		 interactivesystem startup-rescue
+
+MKI_PACK_RESULTS = squash:rescue
+
+debug:
+	@echo "** rescue: IMAGE_PACKAGES: $(IMAGE_PACKAGES)"
+	@echo "** rescue: IMAGE_PACKAGES_REGEXP: $(IMAGE_PACKAGES_REGEXP)"

features.in/stage2/README

@@ -0,0 +1,5 @@
+Эта фича служит для добавления в первую стадию хуков, необходимых
+при наличии в stage1 ядра (что типично, но не обязательно).
+
+Передача информации о конфигурации ядра между stage1 и stage2 также
+требуется для оптимального сжатия squashfs-образа второй стадии.

features.in/stage2/config.mk

@@ -0,0 +1,8 @@
+# "1" is not a typo
+use/stage2: sub/stage1
+	@$(call add,FEATURES,stage2)
+	@$(call add,STAGE1_PACKAGES,file make-initrd make-initrd-propagator)
+
+# NB: sub/stage2 isn't used standalone but rather
+#     as a base for various livecd modifications
+#     (currently install2, live, rescue)

features.in/stage2/stage1/scripts.d/10-initrd-base

@@ -0,0 +1,6 @@
+#!/bin/sh
+# prepare base make-initrd configuration for stage1
+# see also http://www.altlinux.org/Make-initrd-propagator
+
+subst 's/AUTODETECT/#AUTODETECT/' /etc/initrd.mk
+echo 'FEATURES += propagator' >> /etc/initrd.mk

features.in/stage2/stage1/scripts.d/11-initrd-misc

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+# FIXME: move somewhere else
+#echo 'FEATURES += nfs' >> /etc/initrd.mk
+
+# FIXME: move to plymouth feature
+#if [ -f /etc/plymouth/plymouthd.conf ];then 
+#    subst 's/#\([T\[]\)/\1/' /etc/plymouth/plymouthd.conf
+#    echo 'FEATURES += plymouth' >> /etc/initrd.mk
+#fi
+

features.in/stage2/stage1/scripts.d/80-make-initfs

@@ -0,0 +1,15 @@
+#!/bin/sh -efu
+# NB: /etc/initrd.mk carefully prepared by earlier scripts
+
+kver="$(rpm -qa 'kernel-image*' --qf '%{installtime} %{version}-%{name}-%{release}\n' \
+	| sort -n \
+	| tail -n 1 \
+	| cut -f 2 -d ' ' \
+	| sed 's/kernel-image-//')"
+
+make-initrd --no-checks -k $kver \
+&& gzip < /boot/initrd-$kver.img > $(getconf LIBDIR)/propagator/initfs \
+|| exit 1
+
+[ -h /boot/vmlinuz ] || ln -s vmlinuz-$kver /boot/vmlinuz
+[ -h /boot/initrd.img ] || ln -s initrd-$kver.img /boot/initrd.img

features.in/syslinux/cfg.in/15live.cfg

@@ -0,0 +1,4 @@
+label live
+  menu label ^LiveCD (no hard disk needed)
+  kernel alt0/vmlinuz
+  append initrd=alt0/full.cz live ramdisk_size=@live_size@ fastboot stagename=live showopts automatic=method:cdrom

features.in/syslinux/cfg.in/20install2.cfg

@@ -1,8 +1,8 @@
 label linux
   menu label ^Install ALT Linux
   kernel alt0/vmlinuz
-  append initrd=alt0/full.cz changedisk vga=0x314 quiet=1 showopts automatic=method:cdrom
+  append initrd=alt0/full.cz ramdisk_size=@altinst_size@ changedisk vga=0x314 quiet=1 showopts automatic=method:cdrom
 label noapic
   menu label ^Failsafe install
   kernel alt0/vmlinuz
-  append initrd=alt0/full.cz changedisk showopts nolapic noapic
+  append initrd=alt0/full.cz ramdisk_size=@altinst_size@ changedisk showopts nolapic noapic

features.in/syslinux/cfg.in/80rescue.cfg

@@ -1,4 +1,4 @@
 label rescue
   menu label ^Rescue LiveCD
   kernel alt0/vmlinuz
-  append initrd=alt0/full.cz live fastboot stagename=rescue
+  append initrd=alt0/full.cz live ramdisk_size=@rescue_size@ fastboot stagename=rescue showopts automatic=method:cdrom

features.in/syslinux/cfg.in/85dos.cfg

@@ -0,0 +1,4 @@
+label freedos
+  menu label Live ^FreeDOS
+  kernel memdisk
+  append initrd=freedos.img

features.in/syslinux/generate.mk

@@ -18,9 +18,10 @@ $(warning no syslinux ui configured, default is plain text prompt)
 SYSLINUX_UI := prompt
 endif
 
-# SUBPROFILES are considered SYSLINUX_CFG too;
+# SUBPROFILES are considered SYSLINUX_CFG too
+# (note these can appear like stage2/live);
 # 01defaults.cfg is included indefinitely
-SYSLINUX_CFG := $(SYSLINUX_CFG) $(SUBPROFILES) defaults
+SYSLINUX_CFG := $(SYSLINUX_CFG) $(notdir $(SUBPROFILES)) defaults
 
 ### have to operate BUILDDIR, not pretty...
 DSTDIR := $(BUILDDIR)/stage1/files/syslinux/.in

features.in/syslinux/scripts.d/20-propagator-ramdisk

@@ -0,0 +1,13 @@
+#!/bin/sh -x
+# postprocess isolinux configuration
+# when the image sizes are finally known
+
+cd "$WORKDIR"
+
+# apply size census while looking for potential squashfs images
+find -maxdepth 1 -type f -size +1M \
+| sed 's,^\./,,' \
+| while read image; do
+	size="$[ $(stat -c%s "$image") / 1024 + 1 ]"
+	sed -i "s,@${image}_size@,$size," syslinux/*.cfg
+done

features.in/syslinux/stage1/scripts.d/01-syslinux

@@ -34,3 +34,6 @@ grep -hv '^#' .in/[0-9][0-9]*.cfg > "$BOOTLOADER.cfg"
 
 # snippets are not going into the actual image
 if test "$DEBUG" != 2; then rm -r .in/; fi
+
+# NB: there will be final macro expansion based on actual image sizes
+#     (done by ../../scripts.d/10-propagator-ramdisk)

features.in/x11/README

@@ -0,0 +1 @@
+Эта фича добавляет базовую поддержку графической системы X11.

features.in/x11/config.mk

@@ -0,0 +1,10 @@
+use/x11/xorg:
+	@$(call add,BASE_LISTS,xorg)
+
+### strictly speaking, runlevel5 should require a *dm, not vice versa
+use/x11/runlevel5: use/x11/xorg
+	@$(call add,BASE_PACKAGES,installer-feature-runlevel5-stage3)
+
+### xdm: see also #23108
+use/x11/xdm: use/x11/runlevel5
+	@$(call add,BASE_PACKAGES,xdm installer-feature-no-xconsole)

functions.mk

@@ -15,6 +15,7 @@ endef
 # add() just appends an additive rule...
 add = $(and $(1),$(2),$(add_body))
 define add_body
+$(if $(filter GLOBAL_% INFO_%,$(1)),$(warning add,$(1) might be a problem)) \
 { $(log_body); \
 printf '%s += %s\n' '$(1)' '$(2)' >> "$(CONFIG)"; }
 endef

image.in/.gitignore

@@ -0,0 +1 @@
+build.log

image.in/Makefile

@@ -11,7 +11,9 @@ include $(GLOBAL_BUILDDIR)/functions.mk
 include $(GLOBAL_BUILDDIR)/distcfg.mk
 include $(MKIMAGE_PREFIX)/config.mk
 
-SUBDIRS = $(SUBPROFILES)
+# for complex-specified subprofiles like stage2/live,
+# take the latter part
+SUBDIRS = $(notdir $(SUBPROFILES))
 
 # "main" subprofile needs genbasedir
 CHROOT_PACKAGES = apt-utils
@@ -30,33 +32,35 @@ else
 GLOBAL_HSH_APT_CONFIG = $(APTCONF)
 endif
 
+# Metadata/ needed only for installers (and not for e.g. syslinux.iso)
+ifneq "$(STAGE1_KFLAVOUR)$(KFLAVOURS)" ""
+METADATA = metadata
+endif
+
 include $(MKIMAGE_PREFIX)/targets.mk
 
-all: prep copy-subdirs copy-tree run-scripts pack-image
+all: $(GLOBAL_DEBUG) prep copy-subdirs copy-tree run-scripts pack-image \
+	$(GLOBAL_CLEAN_WORKDIR)
+
+prep: $(GLOBAL_DEBUG) dot-disk $(METADATA) $(IMAGEDIR)
 
-# Metadata/ needed only for installer (and not for e.g. syslinux.iso)
-ifeq "$(INSTALLER_KFLAVOUR)$(KFLAVOURS)" ""
-metadata:
-	@echo "** skipping metadata target, no stage1 kernel installed"
-else
 metadata: dot-base
 	@mkdir -p files/Metadata
 	@rm -f files/Metadata/pkg-groups.tar
 # see also alterator-pkg (backend3/pkg-install); we only tar up what's up to it
 	@tar -cvf files/Metadata/pkg-groups.tar -C $(PKGDIR) \
-		$$(echo $(call list,$(GROUPS) .base) \
-			$(call group,$(GROUPS)) \
+		$$(echo $(call list,$(MAIN_GROUPS) .base) \
+			$(call group,$(MAIN_GROUPS)) \
 		   | sed 's,$(PKGDIR)/*,,g')
-endif
 
 dot-base:
-	@echo -e "# auto-added in image.in/Makefile" >> $(call list,.base)
-	@echo "$(call kpackages,$(KMODULES),$(KFLAVOURS))" >> $(call list,.base)
-
-prep: $(GLOBAL_DEBUG) dot-disk metadata $(IMAGEDIR)
+	@{ \
+		echo -e "\n## added by image.in/Makefile"; \
+		echo "$(call kpackages,$(KMODULES),$(KFLAVOURS))"; \
+	} >> $(call list,.base)
 
 $(IMAGEDIR):
-	mkdir -p "$(IMAGEDIR)"
+	@mkdir -p "$(IMAGEDIR)"
 
 # specified only for the final image, not for the subparts
 pack-image: OUTDIR = $(IMAGEDIR)
@@ -71,7 +75,8 @@ dot-disk:
 	@echo "ALT Linux based" >files/.disk/info
 	@echo "$(ARCH)" >files/.disk/arch
 	@echo "$(DATE)" >files/.disk/date
-	@type -t git >&/dev/null && ( \
-		cd $(TOPDIR) && \
-		git show-ref --head -d -s -- HEAD 2>/dev/null; \
-	) >files/.disk/commit
+	@if type -t git >&/dev/null; then \
+		( cd $(TOPDIR) && \
+		git show-ref --head -ds -- HEAD ) \
+		>files/.disk/commit 2>/dev/null; \
+	fi

image.in/README

@@ -1,7 +1,6 @@
 Этот каталог копируется из метапрофиля в профиль "как есть"
 и формирует "затравку", собирающую собственно образ из результатов
-работы индивидуальных субпрофилей (в т.ч. стадий инсталятора,
-см. ../sub.in/).
+работы индивидуальных субпрофилей (см. ../sub.in/).
 
 Содержимое files/ копируется в корень образа.
 

image.in/scripts.d/00-cleanup

@@ -1,4 +1,4 @@
 #!/bin/sh
 # TODO: invent some way to remove this inter-subprofile thing
 
-rm -vf $WORKDIR/{squashcfg.mk,initfs}
+rm -vf $WORKDIR/{squashcfg.mk,initfs,.gitignore}

image.in/scripts.d/01-genbasedir

@@ -1,4 +1,5 @@
 #!/bin/sh
+# FIXME: bring to common style
 
 verbose()
 {

image.in/vars.mk

@@ -0,0 +1,14 @@
+# dump interesting variables' effective values;
+# based on http://stackoverflow.com/questions/7117978
+
+SPAM := $(.VARIABLES) DISTCFG_MK
+-include distcfg.mk
+HAM := $(.VARIABLES)
+
+.PHONY: dump-vars
+
+dump-vars:
+	$(foreach v, \
+	  $(filter-out $(SPAM) SPAM,$(sort $(HAM))), \
+	    $(info $(v) = $($(v))))
+	@:

libdistro.mk

@@ -4,9 +4,8 @@
 sub/%:
 	@$(call add,SUBPROFILES,$(@:sub/%=%))
 
-sub/install2: sub/stage1
-
-boot/%: distro/.init
+# FIXME: maybe syslinux feature belongs to distro/.init?
+boot/%: distro/.init use/syslinux
 	@$(call set,BOOTLOADER,$*)
 
 # initalize config from scratch, put some sane defaults in

log.mk

@@ -11,6 +11,8 @@ BUILDLOG ?= $(BUILDDIR)/build.log
 
 # LOG holds a postprocessor
 ifdef DEBUG
+# 1) makefile target; 2) also passed to script hooks
+GLOBAL_DEBUG := debug
 GLOBAL_VERBOSE ?= $(DEBUG)
 ifeq (2,$(DEBUG))
 SHELL += -x
@@ -19,8 +21,6 @@ LOG = >>$(BUILDLOG) 2>&1
 else
 MAKE += -s
 LOG = 2>>$(BUILDLOG) >/dev/null
-# 1) makefile target; 2) also passed to script hooks
-GLOBAL_DEBUG := debug
 endif
 
 DATE = $(shell date +%Y%m%d)

pkg.in/Makefile

@@ -5,6 +5,7 @@ ifndef BUILDDIR
 $(error BUILDDIR not defined)
 endif
 
+# sequential execution, no reason to haste
 all:
 	@for dir in lists groups; do \
 		$(MAKE) -C $$dir; \

pkg.in/groups/Makefile

@@ -10,15 +10,15 @@ SUFFIX := pkg/groups
 TARGET := $(BUILDDIR)/$(SUFFIX)
 
 all: $(GLOBAL_DEBUG)
-	@if [ -n "$(GROUPS)" ]; then \
+	@if [ -n "$(MAIN_GROUPS)" ]; then \
 		mkdir -p $(TARGET) && \
-		cp -at $(TARGET) -- $(addsuffix .directory,$(GROUPS)); \
+		cp -at $(TARGET) -- $(addsuffix .directory,$(MAIN_GROUPS)); \
 		type -t git >&/dev/null && \
 		cd $(TARGET) && \
 		git add . && \
-		git commit -qam "$(SUFFIX)"; \
+		git commit -qam "requested $(SUFFIX) copied over"; \
 		cd - >&/dev/null; \
 	fi
 
 debug:
-	@echo "** GROUPS: $(GROUPS)"
+	@echo "** MAIN_GROUPS: $(MAIN_GROUPS)"

pkg.in/groups/README

@@ -1,6 +1,6 @@
 Этот каталог содержит описания групп, копируемые из метапрофиля
 в создаваемый профиль по необходимости (только фигурирующие в
-списке, которым является значение переменной GROUPS).
+списке, которым является значение переменной MAIN_GROUPS).
 
 В данный момент перенесено почти 1:1 из mkimage-profiles-desktop,
 требует увязки с ../lists/tagged/.

pkg.in/lists/Makefile

@@ -10,38 +10,47 @@ SUFFIX := pkg/lists
 TARGET := $(BUILDDIR)/$(SUFFIX)
 
 all: $(TARGET) $(GLOBAL_DEBUG)
-	# env | sort -u | grep _LISTS | xargs cp
+	@# env | sort -u | grep _LISTS | xargs cp
 	@$(foreach V, \
 		$(filter %_LISTS,$(sort $(.VARIABLES))), \
 		$(if $(filter environment% file,$(origin $V)),\
 			$(shell cp --parents -at $(TARGET) \
 				-- $(value $V))))
-	# construct .base packagelist for alterator-pkg
-	@( \
-		echo "### generated via pkg.in/lists/Makefile" && \
-		echo "### BASE_LISTS" && \
-		cat $(BASE_LISTS) /dev/null && \
-		echo "### branding" && \
-		echo "branding-$(BRANDING)-release" && \
-		echo "### COMMON_PACKAGES" && \
-		echo "$(COMMON_PACKAGES)" && \
-		echo "### BASE_PACKAGES" && \
-		echo "$(BASE_PACKAGES)" \
-	) | sed -re '/^[^[:space:]#]/ s/[[:space:]]+/\n/g' >$(TARGET)/.base
-	@[ -z $(GROUPS) ] || cp -at $(TARGET) $(GROUPS)
-	@type -t git >&/dev/null && \
-	cd $(TARGET) && \
-	git add . && \
-	git commit -qam "$(SUFFIX)";
+	@# construct .base packagelist for alterator-pkg
+	@{ \
+		echo "## generated by pkg.in/lists/Makefile"; \
+		if [ -n "$(BRANDING)" ]; then \
+			echo "branding-$(BRANDING)-release"; \
+		fi; \
+		if [ -n "$(SYSTEM_PACKAGES)" ]; then \
+			echo -e "\n## SYSTEM_PACKAGES\n$(SYSTEM_PACKAGES)"; \
+		fi; \
+		if [ -n "$(COMMON_PACKAGES)" ]; then \
+			echo -e "\n## COMMON_PACKAGES\n$(COMMON_PACKAGES)"; \
+		fi; \
+		if [ -n "$(BASE_PACKAGES)" ]; then \
+			echo -e "\n## BASE_PACKAGES\n$(BASE_PACKAGES)"; \
+		fi; \
+		if [ -n "$(BASE_LISTS)" ]; then \
+			echo -e "\n## BASE_LISTS"; cat $(BASE_LISTS); \
+		fi; \
+	} | sed -re '/^[^[:space:]#]/ s/[[:space:]]+/\n/g' >$(TARGET)/.base
+	@if [ -n "$(MAIN_GROUPS)" ]; then \
+		cp -at $(TARGET) -- $(MAIN_GROUPS); \
+	fi
+	@if type -t git >&/dev/null; then \
+		cd $(TARGET) && \
+		git add . && \
+		git commit -qam "requested $(SUFFIX) copied over"; \
+	fi
 
 # do beforehand as foreach gets expanded before recipe execution
 $(TARGET):
 	@mkdir -p $(TARGET)
 
+# figure out *_LISTS variables and print them out nicely
 debug:
-	@$(foreach V, \
+	@echo -e $(foreach V, \
 		$(filter %_LISTS,$(sort $(.VARIABLES))), \
 		$(if $(filter environment% file,$(origin $V)),\
-			$(warning $V=$(value $V))))
-	@echo "** LISTS: -- see above"
-	@echo "** GROUPS: $(GROUPS)"
+			$(shell echo '\\n"**"' $V: $(value $V)))) '\n'

pkg.in/lists/README

@@ -3,10 +3,8 @@
 имён списков в переменных *_LISTS, см. реализацию в Makefile).
 
 Список .base является особенным (формирует базовую систему,
-см. http://www.altlinux.org/Alterator-pkg) и копируется безусловно.
-Это предполагается изменить в будущем -- возможно, генерацией .base
-по тегам.
+см. http://www.altlinux.org/Alterator-pkg); он создаётся из
+содержимого ряда переменных (см. Makefile).
 
 Подкаталог tagged/ стоит рассматривать как экспериментальный,
-хотя весь необходимый код уже на месте -- см. bin/tags2lists
-и distro.mk (в корневом каталоге).
+но находящий всё более широкое практическое использование.

pkg.in/lists/tagged/README

@@ -1,8 +1,8 @@
 Этот каталог содержит тегированные списки; на данный момент
-реализация (bin/tags2lists) требует, чтобы каждый тег был
+реализация (tags2lists) требует, чтобы каждый из тегов был
 отдельным словом, состоящим из символов из набора a-zA-Z0-9_
 (внимание: не используйте в слове "-"); рекомендуется
-разделять слова "+" или ",".
+разделять слова "+" или "," (стандарт ещё не устоялся).
 
 Предположительное применение: дополнение функциональности,
 заданной статически (наследственно или явно), факультативным

pkg.in/lists/tagged/base+live

@@ -0,0 +1,4 @@
+wget
+apt
+vim-console
+mc

pkg.in/lists/tagged/base+network

@@ -0,0 +1,2 @@
+etcnet
+dhcpcd

pkg.in/lists/tagged/base+pkg

@@ -0,0 +1 @@
+apt

pkg.in/lists/tagged/base+rescue

@@ -0,0 +1,126 @@
+### Startup
+rootfiles
+sysvinit
+interactivesystem
+startup
+startup-rescue
+
+udev
+
+### Common
+coreutils
+glibc-locales
+glibc-nss
+glibc-utils
+lilo
+man
+man-pages
+sysfsutils
+sysklogd
+util-linux
+
+### CPU utils
+cpuburn
+x86info
+
+### Disk utils
+bonnie++
+cfdisk
+ddrescue
+disktype
+evms
+evms-ncurses
+gpart
+hdparm
+lvm2
+mdadm
+ms-sys
+parted
+sdparm
+sfdisk
+smartmontools
+testdisk
+mtools
+partimage
+
+### Applications
+binutils
+dmidecode
+hexedit
+pciutils
+procps
+quota
+shadow-suite
+sharutils
+time
+openssl
+
+### Applications/Archiving
+arj
+bzip2
+gzip
+unrar
+unzip
+zip
+
+### Applications/Editors
+vim-console
+
+### Applications/File
+findutils
+file
+less
+mtools
+
+### Filesystem utils
+dosfstools
+e2fsprogs
+jfsprogs
+ntfs-3g
+recover
+recoverdm
+reiserfsprogs
+xfsprogs
+btrfs-progs
+ext3grep
+
+### Applications/Networking
+arpwatch
+elinks
+hostinfo
+iftop
+iproute2
+iptables
+iputils
+lftp
+mailx
+netcat
+netlist
+nfs-utils
+ngrep
+nmap
+openssh-clients
+openssh-server
+p0f
+postfix
+rsync
+scanssh
+#stunnel
+tcpdump
+tcptraceroute
+telnet
+traceroute
+wget
+whois
+
+### Applications/Shells
+zsh
+ash
+bash
+bc
+gpm
+mc
+
+### Development/Debuggers
+strace
+sysstat

pkg.in/lists/tagged/base+security

@@ -0,0 +1,3 @@
+sudo
+su
+passwd

pkg.in/lists/tagged/basesystem,alterator

@@ -1,4 +1,3 @@
-alterator-grub
 alterator-root
 alterator-users
 alterator-net-eth

pkg.in/lists/tagged/desktop+live

@@ -0,0 +1,4 @@
+xdm
+xinit
+xinitrc
+installer-feature-runlevel5-stage3

pkg.in/lists/tagged/desktop,icewm

@@ -0,0 +1 @@
+icewm

pkg.in/lists/tagged/extra+network

@@ -0,0 +1,2 @@
+etcnet-full
+net-tools

pkg.in/lists/tagged/rescue+live

@@ -0,0 +1,5 @@
+fdisk
+parted
+mdadm
+rsync
+etcnet-full

pkg.in/lists/tagged/server+network

@@ -1,7 +1,6 @@
 # network tools
 curl
 elinks
-etcnet
 hostinfo
 iptables
 iputils

pkg.in/lists/xorg

@@ -0,0 +1,46 @@
+xorg-server
+xorg-drv-ati
+xorg-drv-cirrus
+xorg-drv-evdev
+xorg-drv-fbdev
+xorg-drv-intel
+xorg-drv-joystick
+xorg-drv-mga
+xorg-drv-multimedia
+xorg-drv-nouveau
+xorg-drv-nv
+#I586_ONLY@xorg-drv-s3
+#I586_ONLY@xorg-drv-s3virge
+#I586_ONLY@xorg-drv-savage
+xorg-drv-sis
+xorg-drv-synaptics
+xorg-drv-vesa
+xorg-drv-video
+xorg-drv-void
+xorg-drv-wacom
+xorg-drv-qxl
+
+# for those who need these
+xorg-drv-keyboard
+xorg-drv-mouse
+
+#xorg-dri-*
+
+xauth
+xorg-utils
+#xorg-extensions*
+xinit
+
+# TODO: split these into a separate packagelist or no sense?
+#wm-select
+
+fonts-ttf-dejavu
+fonts-bitmap-terminus
+fonts-otf-stix
+fonts-ttf-droid
+x-cursor-theme-jimmac
+
+menu-icons-default
+
+# :-/
+#*-debuginfo-

profile.mk

@@ -1,50 +1,68 @@
 # this makefile is designed to be included in toplevel one
 
+SYMLINK = build
+
 # this could have come from environment;
 # if not, can be symlinked if r/w, or made anew
-# NB: immediate assignment
+# NB: immediate assignment matters
+# NB: PATH has no effect here
 ifndef BUILDDIR
-BUILDDIR := $(shell [ -s build ] \
-        && realpath build \
+BUILDDIR := $(shell [ -s "$(SYMLINK)" ] \
+        && realpath "$(SYMLINK)" \
         || bin/mktmpdir mkimage-profiles.build)
 endif
 
-# holds a postprocessor; shell test executes in particular situation
-# NB: not exported, for toplevel use only
-SHORTEN = $(shell [ "$(DEBUG)" != 2 -a -s build ] \
-	  && echo "| sed 's,$(BUILDDIR),build,'")
-
 # even smart caching only hurts when every build goes from scratch
 NO_CACHE ?= 1
 
-export BUILDDIR NO_CACHE
+PATH := $(CURDIR)/bin:$(PATH)
+
+export BUILDDIR NO_CACHE PATH
+
+# holds a postprocessor; shell test executes in particular situation
+# NB: not exported, for toplevel use only
+SHORTEN = $(shell [ "$(DEBUG)" != 2 -a -s "$(SYMLINK)" ] \
+	  && echo "| sed 's,$(BUILDDIR),$(SYMLINK),'")
 
 # step 1: initialize the off-tree mkimage profile (BUILDDIR)
 profile/init: distclean
 	@echo -n "** initializing BUILDDIR: "
 	@rsync -qaH --delete image.in/ "$(BUILDDIR)"/
-	@:> "$(BUILDDIR)"/distcfg.mk
+	@{ \
+		echo "ifndef DISTCFG_MK"; \
+		echo "DISTCFG_MK = 1"; \
+	} > "$(BUILDDIR)"/distcfg.mk
 	@{ \
 		git show-ref --head -d -s -- HEAD && \
 		git status -s && \
 		echo; \
-	} 2>/dev/null >> "$(BUILDLOG)"
+	} $(LOG)
 	@mkdir "$(BUILDDIR)"/.mki	# mkimage toplevel marker
 	@type -t git >&/dev/null && \
 		cd $(BUILDDIR) && \
 		git init -q && \
 		git add . && \
-		git commit -qam 'init'
-	@rm -f build && \
+		git commit -qam 'distribution profile initialized'
+	@rm -f "$(SYMLINK)" && \
 		if [ -w . ]; then \
-			ln -sf "$(BUILDDIR)" build && \
-			echo "build/"; \
+			ln -sf "$(BUILDDIR)" "$(SYMLINK)" && \
+			echo "$(SYMLINK)/"; \
 		else \
 			echo "$(BUILDDIR)/"; \
 		fi
 
+profile/finalize: distro/.rc
+	@echo "endif" >> "$(BUILDDIR)"/distcfg.mk
+
+# requires already formed distcfg.mk for useful output
+profile/dump-vars:
+	@if [ -s "$(SYMLINK)" ]; then \
+		$(MAKE) --no-print-directory -C "$(SYMLINK)/" -f vars.mk; \
+		echo; \
+	fi $(LOG)
+
 # step 3 entry point: copy the needed parts into BUILDDIR
-profile/populate: profile/init distro/.rc
+profile/populate: profile/init profile/finalize profile/dump-vars
 	@for dir in sub.in features.in pkg.in; do \
 		$(MAKE) -C $$dir $(LOG); \
 	done

sub.in/Makefile

@@ -6,20 +6,26 @@ endif
 
 include $(BUILDDIR)/distcfg.mk
 
+# if the subprofile is specified in src/dst notation,
+# take src/ and put it as dst/ (for stage2 variants)
 all:
-	@for dir in $(SUBPROFILES); do \
-		rsync -a $$dir/ $(BUILDDIR)/$$dir/ && \
+	@for sub in $(SUBPROFILES); do \
+		src="$${sub%/*}" && \
+		dst="$${sub#*/}" && \
+		neq="$${src#$$dst}" && \
+		rsync -a "$$src/" "$(BUILDDIR)/$$dst/" && \
 		type -t git >&/dev/null && \
-		cd $(BUILDDIR)/$$dir/ && \
+		cd "$(BUILDDIR)/$$dst/" && \
 		git add . && \
-		git commit -qam "$@/$$dir"; \
+		git commit -qam "$$dst subprofile initialized$${neq:+ (using $$src)}"; \
 		cd - >&/dev/null; \
-	done ||:
+	done
 
 clean:
-	@for dir in $(SUBPROFILES); do \
-		if [ -n "$$dir" ]; then \
-			rm -rf $(BUILDDIR)/$$dir && \
-			mkdir -p $(BUILDDIR)/$$dir; \
+	@for sub in $(SUBPROFILES); do \
+		dst="${sub#*/}" && \
+		if [ -n "$$dst" -a -n "$(BUILDDIR)" ]; then \
+			rm -r "$(BUILDDIR)/$$dst" && \
+			mkdir -p "$(BUILDDIR)/$$dst"; \
 		fi; \
 	done

sub.in/README

@@ -1,20 +1,31 @@
-Этот каталог содержит субпрофили; содержимое заказанных
-в формируемый профиль (названия которых содержатся в значении
-переменной SUBPROFILES, которую обычно заполняют цели sub/* --
-см. ditro.mk в корневом каталоге) будет скопировано в каталог
-$(BUILDDIR)/image/.
+Этот каталог содержит субпрофили; содержимое затребованных
+(названия которых содержатся в значении переменной SUBPROFILES,
+которую заполняют цели sub/* -- см. ../distro.mk) будет
+скопировано в каталог $(BUILDDIR)/image/ формируемого профиля.
 
 Просьба ответственно относиться к модификации существующих
 и вдумчиво -- к созданию новых; возможно, достаточно всего лишь
 оформить нужное новой фичей (см. ../features.in/).
 
-Краткое описание существующих:
+Обратите внимание: поскольку сборка частей образа и происходит
+в каталогах субпрофилей, то повторное использование одного простого
+субпрофиля в рамках сгенерированного профиля штатным образом невозможно.
+Если требуется создать несколько близких по реализации субпрофилей,
+изучите stage2 и задействующие его фичи.
+
+Краткое описание существующих вариантов:
 
 - stage1: propagator и загрузчик (при подключении фичи syslinux);
-  типично требуется для инсталяторов, live- и rescue-образов
+  типично требуется для инсталяторов, live- и rescue-образов,
+  но может использоваться без добавления таковых в образ,
+  обеспечивая сетевую загрузку второй стадии
 
-- install2: installer, installer-feature-*-stage2 и прочее обычно
-  востребованное в инсталяционных образах
+- stage2: наиболее сложный технологически субпрофиль, поскольку
+  он является только базовым для получения ряда итоговых частей
+  дистрибутива (install2, live, rescue); задействуется для этого
+  только опосредованно через use/stage2/* и модифицирует stage1
+  в силу наличия связи между ними (в stage1 попадает образ ядра
+  и firmware, в stage2 -- соответствующие модули)
 
 - main: пакетная база, укладываемая на образ (NB: поскольку рабочий
   чрут в этом случае не содержит ничего, кроме пакетов, добавлять

sub.in/install2/Makefile

@@ -1,35 +0,0 @@
-# step 4: build install2 subprofile (installer "live" part)
-
-ifndef GLOBAL_BUILDDIR
-$(error GLOBAL_BUILDDIR not defined)
-endif
-
-default: all
-
-include $(GLOBAL_BUILDDIR)/distcfg.mk
-include $(GLOBAL_BUILDDIR)/functions.mk
-include $(MKIMAGE_PREFIX)/config.mk
-
-# this might have been prepared by ../stage1/scripts.d/03-test-kernel
--include $(GLOBAL_BUILDDIR)/squashcfg.mk
-
-# here we also try and come up with the installer kernel/modules, if any;
-# no kernel flavour specified will result in no modules for stage1 vmlinuz
-INSTALLER_KFLAVOUR ?= $(lastword $(KFLAVOURS))
-
-ifeq "$(INSTALLER_KFLAVOUR)" ""
-$(error INSTALLER_KFLAVOUR is utterly empty; cannot guess either)
-endif
-
-# need kernel modules only (which require corresponding kernel-image);
-# these go into work chroot; NB: no vmlinuz there
-IMAGE_PACKAGES_REGEXP = $(call kpackages,$(INSTALLER_KMODULES),$(INSTALLER_KFLAVOUR))
-IMAGE_PACKAGES = $(COMMON_PACKAGES) \
-		 $(INSTALL2_PACKAGES) \
-		 ./packages
-
-MKI_PACK_RESULTS = squash:altinst
-
-include $(MKIMAGE_PREFIX)/targets.mk
-
-all: | build-image run-image-scripts pack-image

sub.in/install2/packages

@@ -1,3 +0,0 @@
-udev
-e2fsprogs
-glibc-nss

sub.in/main/Makefile

@@ -15,7 +15,8 @@ CHROOT_PACKAGES = apt-utils rsync
 IMAGE_PACKAGES_REGEXP = $(call kpackages,$(KMODULES),$(KFLAVOURS)) \
 			$(MAIN_PACKAGES_REGEXP)
 
-IMAGE_PACKAGES = $(call map,list,$(BASE_LISTS) $(MAIN_LISTS) $(GROUPS)) \
+IMAGE_PACKAGES = $(call map,list,$(BASE_LISTS) $(MAIN_LISTS) $(MAIN_GROUPS)) \
+		 $(SYSTEM_PACKAGES) \
 		 $(COMMON_PACKAGES) \
 		 $(BASE_PACKAGES) \
 		 $(MAIN_PACKAGES)
@@ -25,7 +26,7 @@ MKI_PACK_RESULTS = data
 
 include $(MKIMAGE_PREFIX)/targets.mk
 
-all: $(GLOBAL_DEBUG) copy-packages pack-image
+all: $(GLOBAL_DEBUG) copy-packages pack-image $(GLOBAL_CLEAN_WORKDIR)
 
 debug:
 	@echo "** main: IMAGE_PACKAGES: $(IMAGE_PACKAGES)"

sub.in/main/README

@@ -1,12 +1,12 @@
-Этот каталог содержит субпрофиль main, собирающий пакетную базу,
-которая затем укладывается в образ.
+Этот каталог содержит субпрофиль main, собирающий пакетную базу
+для локальной инсталяции системы и возможности установки дополнений.
 
 Подбирает:
-- COMMON_PACKAGES, BASE_PACKAGES, BASE_LISTS: в установку по умолчанию;
+- SYSTEM_PACKAGES, COMMON_PACKAGES, BASE_PACKAGES, BASE_LISTS:
+  в установку по умолчанию;
 - MAIN_PACKAGES, MAIN_LISTS: дополнительные пакеты.
 
 В image-scripts.d/* смысла нет, только scripts.d/* --
 рабочий чрут не содержит исполняемых файлов.
 
-Результат -- каталог ALTLinux/RPMS.main, подлежащий копированию
-в образ.
+Результат -- каталог ALTLinux/RPMS.main для копирования в образ.

sub.in/stage1/Makefile

@@ -21,31 +21,33 @@ COPY_TREE = ./files
 include $(MKIMAGE_PREFIX)/targets.mk
 
 # here we try and come up with the installer kernel/modules, if any;
-# only a single kernel might be needed (INSTALLER_KFLAVOUR sets explicitly);
+# only a single kernel might be needed (STAGE1_KFLAVOUR sets explicitly);
 # kernel image copied from instrumental chroot into .work/syslinux/alt0/
 
-INSTALLER_KFLAVOUR ?= $(lastword $(KFLAVOURS))
+STAGE1_KFLAVOUR ?= $(lastword $(KFLAVOURS))
 
 # propagator needed iff stage1 kernel installed (not for e.g. syslinux.iso)
-ifeq "$(INSTALLER_KFLAVOUR)" ""
-build-propagator:
-	@echo "** skipping build-propagator target, no kernel installed"
-else
-CHROOT_PACKAGES_REGEXP := $(call kpackages,$(INSTALLER_KMODULES_REGEXP),$(INSTALLER_KFLAVOUR))
-INFO_INSTALLER_KFLAVOUR := $(INSTALLER_KFLAVOUR)
+ifneq "$(STAGE1_KFLAVOUR)" ""
+BUILD_PROPAGATOR = build-propagator
+CHROOT_PACKAGES_REGEXP := $(call kpackages,$(STAGE1_KMODULES_REGEXP),$(STAGE1_KFLAVOUR))
+INFO_STAGE1_KFLAVOUR := $(STAGE1_KFLAVOUR)
 endif
 
 CHROOT_PACKAGES_REGEXP += $(STAGE1_PACKAGES_REGEXP)
-CHROOT_PACKAGES = $(STAGE1_PACKAGES) $(COMMON_PACKAGES)
+CHROOT_PACKAGES = $(STAGE1_PACKAGES) $(SYSTEM_PACKAGES)
 
 # scripts prepare bootloader configuration, too
 # NB: we pass tested squashfs options for ../install2/Makefile
-all: | debug prepare-workdir copy-tree run-scripts build-propagator \
-	copy-$(BOOTLOADER) pack-image
-	@cp $(OUTDIR)/squashcfg.mk $(GLOBAL_BUILDDIR)/
+all: | debug prepare-workdir copy-tree run-scripts $(BUILD_PROPAGATOR) \
+	copy-$(BOOTLOADER) $(COPY_SQUASHCFG) pack-image $(GLOBAL_CLEAN_WORKDIR)
+	@if test -s $(OUTDIR)/squashcfg.mk; then \
+		cp $(OUTDIR)/squashcfg.mk $(GLOBAL_BUILDDIR)/; \
+	fi
 
 debug:
 	@if test -n "$(GLOBAL_VERBOSE)"; then \
+		echo "** BRANDING: $(BRANDING)"; \
+		echo "** IMAGE_INIT_LIST: $(IMAGE_INIT_LIST)"; \
 		echo "** STAGE1_PACKAGES: $(STAGE1_PACKAGES)"; \
 		echo "** STAGE1_PACKAGES_REGEXP: $(STAGE1_PACKAGES_REGEXP)"; \
 		echo "** CHROOT_PACKAGES: $(CHROOT_PACKAGES)"; \

sub.in/stage1/README

@@ -2,18 +2,17 @@
 здесь место syslinux (загрузчик) и propagator (ориентировка
 на местности, вытягивание второй стадии с CD/FTP/...).
 
-Скрипты обычно запускаются извне формируемого образа,
-т.е. это scripts.d/; следует крайне бережно относиться
-к составу STAGE1_PACKAGES и объёму этой стадии.
+Скрипты запускаются извне формируемого образа (scripts.d/);
+следует крайне бережно относиться к составу STAGE1_PACKAGES
+и объёму этой стадии.
 
 Обратите внимание: если не указать явно требуемый вариант
-ядра посредством INSTALLER_KFLAVOUR, будет взят последний
+ядра посредством STAGE1_KFLAVOUR, будет взят последний
 из перечисленных в KFLAVOURS; если не указать явно регэкс,
 описывающий требуемые в инсталяторе модули, посредством
-INSTALLER_KMODULES_REGEXP -- будет подмножество модулей
+STAGE1_KMODULES_REGEXP -- будет подмножество модулей
 из kernel-image (упаковываются в syslinux/alt0/full.cz).
 
 Требуется для инсталяционных, live- и rescue-образов.
 
-Результат -- каталог syslinux/, подлежащий копированию
-в образ.
+Результат -- каталог syslinux/ для копирования в образ.

sub.in/stage2/Makefile

@@ -0,0 +1,46 @@
+# step 4: build a stage2 subprofile (custom livecd)
+
+# NB: stage2 is not standalone but rather a common base
+#     for all livecd images (installer, live, rescue)
+
+ifndef GLOBAL_BUILDDIR
+$(error GLOBAL_BUILDDIR not defined)
+endif
+
+default: all
+
+include $(GLOBAL_BUILDDIR)/distcfg.mk
+include $(GLOBAL_BUILDDIR)/functions.mk
+include $(MKIMAGE_PREFIX)/config.mk
+
+# this might have been prepared by ../stage1/scripts.d/03-test-kernel
+-include $(GLOBAL_BUILDDIR)/squashcfg.mk
+
+# this should be brought in by corresponding specific stage2 feature
+include stage2cfg.mk
+
+# requisite stuff
+IMAGE_PACKAGES += $(SYSTEM_PACKAGES)
+
+# here we also try and come up with the stage1 kernel/modules, if any;
+# no kernel flavour specified will result in no modules for stage1 vmlinuz
+STAGE1_KFLAVOUR ?= $(lastword $(KFLAVOURS))
+
+ifeq "$(STAGE1_KFLAVOUR)" ""
+$(error STAGE1_KFLAVOUR is utterly empty; cannot guess either)
+endif
+
+# need kernel modules only (which require corresponding kernel-image);
+# these go into work chroot; NB: no vmlinuz there
+IMAGE_PACKAGES_REGEXP = $(call kpackages,$(STAGE1_KMODULES),$(STAGE1_KFLAVOUR))
+
+include $(MKIMAGE_PREFIX)/targets.mk
+
+# NB: it's a collector variable, add()ing to a GLOBAL_ results in lost hair
+GLOBAL_CLEANUP_PACKAGES := $(CLEANUP_PACKAGES)
+
+all: | $(GLOBAL_DEBUG) build-image run-image-scripts pack-image \
+	$(GLOBAL_CLEAN_WORKDIR)
+
+# dummy
+debug: ;

sub.in/stage2/README

@@ -0,0 +1,6 @@
+Этот каталог содержит общий базовый субпрофиль "живой" второй стадии,
+используемый для сборки образов install2, live, rescue (возможно,
+нескольких одновременно в составе одного дистрибутива).
+
+Результат -- соответственно названный файл со squashfs,
+подлежащий копированию в итоговый образ.

sub.in/stage2/image-scripts.d/00stage1

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+# propagator needs this,
+# "FATAL ERROR IN INIT: overmounting /image" otherwise
+mkdir -p /image