introduced conf.d/ for distro, ve config snippets

This was asked for by Leo-sp50 and torabora, and seems quite reasonable:
let's provide means to keep at least some distribution configurations
a bit apart, so that these can be considered more standalone in terms
of hard warranted functionality but at the same time enjoying the common
infrastructure.

Considering lib/distro.mk: it's now experimentally pulled apart so that
parallel development of different distro families can go on without
major merge hassles.  *Please* don't abuse with massive copy-paste.

And before you ask: this might get extended to allow for "private"
out-of-tree configurations being included since apparently there
are goals with no meaning outside of some very particular context...
but otherwise I'd like to encourage getting reusable bits in-tree.

Makefile

@@ -2,44 +2,62 @@
 # --- here
 # 1. initialize new profile (BUILDDIR) as a copy of image.in/
 # 2. configure distro
-# 3. copy subprofiles, script hooks, and package lists/groups
-#    from metaprofile to new profile (as needed)
+# 3. copy the needed bits from metaprofile to a new profile
 # --- in BUILDDIR
-# 4. build subprofiles and subsequently the image
+# 4. build subprofiles and subsequently an image
 
-all help:
-	@echo '** available distribution targets:'
-	@echo $(IMAGES) | fmt -sw"$$((COLUMNS>>1))" | column -t
+MKIMAGE_PROFILES = $(dir $(lastword $(MAKEFILE_LIST)))
+
+# only process the first target (inter-target cleanup is tricky)
+IMAGE_TARGET := $(firstword $(MAKECMDGOALS))#	distro/server-base.iso
+IMAGE_CONF   := $(basename $(MAKECMDGOALS))#	distro/server-base
+IMAGE_CLASS  := $(dir $(IMAGE_TARGET))#		distro/ (let's fix it)
+IMAGE_CLASS  := $(IMAGE_CLASS:%/=%)#		distro
+IMAGE_FILE   := $(notdir $(IMAGE_TARGET))#	server-base.iso
+IMAGE_NAME   := $(basename $(IMAGE_FILE))#	server-base
+IMAGE_TYPE   := $(suffix $(IMAGE_FILE))#	.iso (fix this too)
+IMAGE_TYPE   := $(IMAGE_TYPE:.%=%)#		iso
 
 # most of the actual work done elsewhere
-include clean.mk
-include profile.mk
-include distro.mk
-include log.mk
-include iso.mk
+include lib/*.mk
+include conf.d/*.mk
+include features.in/*/config.mk
 
-# we can't use implicit rules for top-level targets, only for prereqs
-# NB: what about static pattern rules?
-# TODO: move into libdistro?
-DISTROS := $(shell sed -n 's,^distro/\([^:.]\+\):.*$$,\1,p' distro.mk)
-IMAGES := $(addsuffix .iso,$(DISTROS))
+DISTRO_TARGETS := $(shell sed -n 's,^\(distro/[^:.]\+\):.*$$,\1,p' \
+		lib/distro.mk $(wildcard conf.d/*.mk) | sort)
+VE_TARGETS := $(shell sed -n 's,^\(ve/[^:.]\+\):.*$$,\1,p' \
+		lib/ve.mk $(wildcard conf.d/*.mk) | sort)
+DISTROS := $(call addsuffices,$(DISTRO_EXTS),$(DISTRO_TARGETS)) 
+VES     := $(call addsuffices,$(VE_EXTS),$(VE_TARGETS))
+IMAGES  := $(DISTROS) $(VES)
 
-# to be passed into distcfg.mk
-IMAGEDIR ?= $(shell [ -d "$$HOME/out" -a -w "$$HOME/out" ] \
-	&& echo "$$HOME/out" \
-	|| echo "$(BUILDDIR)/out" )
-IMAGENAME ?= mkimage-profiles-$(ARCH).iso
+.PHONY: $(IMAGES) $(DISTRO_TARGETS) $(VE_TARGETS)
 
-$(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"; \
-		test -s "$(IMAGEDIR)/$(IMAGENAME)" && \
-		mv "$(IMAGEDIR)/$(IMAGENAME)" "$$OUTPATH" && \
-		echo "** image: $$OUTPATH" && \
-		ln -sf "$$OUTNAME" "$(IMAGEDIR)/$@" && \
-		ln -sf "$@" "$(IMAGEDIR)/mkimage-profiles.iso"; \
-		if [ -n "$(DEBUG)" ]; then \
-			cp -a "$(BUILDLOG)" "$$OUTPATH.log"; \
-			cp -a "$(CONFIG)" "$$OUTPATH.cfg"; \
-		fi
+help:
+	@echo '** available distribution targets:'
+	@echo $(DISTROS) | fmt -sw"$$((COLUMNS>>1))" | column -t
+	@echo
+	@echo '** available virtual environment targets:'
+	@echo $(VES) | fmt -sw"$$((COLUMNS>>1))" | column -t
+
+### suboptimal but at least clear, reliable and convenient
+all:
+	@for i in $(DISTROS); do \
+		echo "** building $$i:"; \
+		$(MAKE) --no-print-directory BUILDDIR=$(BUILDDIR) $$i; \
+		echo; \
+	done
+
+$(IMAGES): debug \
+	config/with/$(IMAGE_CONF) \
+	config/like/$(IMAGE_CLASS) \
+	config/name/$(IMAGE_NAME) \
+	config/pack/$(IMAGE_TYPE) \
+	build; @:
+
+debug:
+ifeq (2,$(DEBUG))
+	@$(foreach v,\
+		$(filter IMAGE_%,$(sort $(.VARIABLES))),\
+		$(warning $v = $($v)))
+endif

QUICKSTART

@@ -0,0 +1,33 @@
+требуется
+~~~~~~~~~
+- ALT Linux 6.0 или выше (возможна адаптация "вниз")
+- установленный mkimage (свежий, как и hasher)
+- пользователь с правом запуска hasher
+
+полезно
+~~~~~~~
+- смонтированный tmpfs на несколько гигабайт
+  + например, в /tmp или /home/USER/hasher
+  + каталог из prefix в /etc/hasher-priv/system
+- установленный git-core
+- настроенный ~/.gitconfig
+
+команды
+~~~~~~~
+- от имени root:
+# apt-get install hasher git-core
+# hasher-useradd USER
+
+- от имени пользователя (после повторного входа):
+$ git config --global user.email "my@email"
+$ git config --global user.name "My Name"
+
+- тестовая сборка (см. тж. lib/distro.mk, doc/variables.txt):
+$ make distro/icewm.iso
+
+ссылки
+~~~~~~
+- http://www.altlinux.org/tmpfs
+- http://www.altlinux.org/hasher
+- http://www.altlinux.org/mkimage
+- http://www.altlinux.org/Mkimage/Profiles/next

README

@@ -1,12 +1,15 @@
-see also http://www.altlinux.org/Mkimage/Profiles/next
+Welcome to mkimage-profiles!
 
-quickstart: make server-base.iso
-(NB: requires configured http://en.altlinux.org/Hasher)
+English quickstart: make distro/server-base.iso;
+see http://en.altlinux.org/Hasher (and a large tmpfs).
 
-configurables: ~/.mkimage/profiles.mk,
+Configurables: ~/.mkimage/profiles.mk;
 see doc/profiles.mk.sample and libdistro.mk
 
-license: GPLv2+, see COPYING
+License: GPLv2+, see COPYING.
+
+Most docs in Russian, welcome to learn it or ask for English.
+См. тж. http://www.altlinux.org/Mkimage/Profiles/next
 
 Концепция:
 - метапрофиль служит репозиторием для построения индивидуального
@@ -28,8 +31,11 @@ license: GPLv2+, see COPYING
 - сборка дистрибутива
 
 Объекты:
+- виртуальные окружения:
+  + описываются в lib/ve.mk
+  + могут основываться одно на другом
 - дистрибутивы:
-  + описываются в distro.mk
+  + описываются в lib/distro.mk
   + могут основываться один на другом
   + включают один или более субпрофилей по надобности
   + желательно избегать множественного наследования, см. тж. фичи
@@ -48,19 +54,19 @@ license: GPLv2+, see COPYING
   + список собирается в $(FEATURES)
   + законченные блоки функциональности (или наборы таковых)
   + описываются в индивидуальных features.in/*/config.mk
-  + могут зависеть друг от друга и требовать субпрофили
+  + могут требовать другие фичи, а также субпрофили
   + при сборке $(BUILDDIR) содержимое указанных в $(FEATURES) фич
     (подкаталоги, соответствующие входящим в дистрибутив субпрофилям
     под их итоговыми названиями -- например, live, а не stage2/live) 
     добавляется в профиль; затем выполняются generate.sh, generate.mk
-- списки пакетов (*_LISTS): просьба по возможности избегать дублирования
+- списки пакетов (*_LISTS): просьба по возможности избегать дублирования;
   NB: перечисленные в этих переменных файлы автоматически копируются
   в порождаемый профиль => не следует указывать пакаджлисты напрямую
 - индивидуальные пакеты (*_PACKAGES): следует крайне осторожно пользоваться
-  COMMON_PACKAGES -- эти пакеты попадут во все стадии, в том числе в образ
+  SYSTEM_PACKAGES -- эти пакеты попадут во все стадии, в том числе в образ
   чувствительной к объёму install2 (в stage1 -- только в инструментальный
   чрут); применяйте для того, что обязано быть и в инсталяторе, и в готовой
-  системе
+  системе -- и не путайте с COMMON_PACKAGES (main, live, rescue)
 
 Результат:
 - при успешном завершении сборки образ называется сообразно

bin/mktmpdir

@@ -26,4 +26,4 @@ choose_tmpdir() {
 }
 
 DIR="`choose_tmpdir`"
-mktemp -d "${1:-tmpdir}.XXXXXXXXXX" --tmpdir="${DIR:-..}"
+mktemp -d "${1:-tmpdir}.XXXXXXXXXX" --tmpdir="${DIR:-`realpath ..`}"

bin/tags2lists

@@ -29,4 +29,5 @@ transformed="$(sed \
 	-e "s, *( *, ( ,g" \
 	-e "s, *) *, ) ,g")"
 
+[ "$DEBUG" = 2 ] && echo "`basename $0`: transformed = \"$transformed\"" >&2
 [ -z "$transformed" ] || find $transformed | sed 's,^\./,,'

conf.d/README

@@ -0,0 +1,17 @@
+Этот каталог содержит включаемые фрагменты конфигурации образов с тем,
+чтобы было удобнее параллельно разрабатывать специфические дистрибутивы
+без излишних merge conflict'ов.
+
+Следует понимать, что основная цель появления mkimage-profiles на свет
+-- это уменьшение "форков" внутри семейства дистрибутивных профилей.
+Поэтому при возможности следует всё-таки работать над общей базовой
+частью, включая скриптовые хуки и списки пакетов, а также оптимизировать
+граф зависимостей между дистрибутивными конфигурациями.
+
+Попросту говоря, copy-paste -- тревожный признак.
+
+NB: по переменным:
+* $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk;
+* $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании
+  значений -- таким образом их значения могут изменяться до окончания
+  конфигурации, а также зависеть от значений других переменных.

conf.d/desktop.mk

@@ -0,0 +1,13 @@
+# desktop distributions
+ifeq (distro,$(IMAGE_CLASS))
+
+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))
+
+endif

conf.d/live.mk

@@ -0,0 +1,8 @@
+# live images
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/live: distro/.base use/live use/syslinux/ui-menu
+distro/rescue: distro/.base use/rescue use/syslinux/ui-menu
+distro/dos: distro/.init use/dos use/syslinux/ui-menu
+
+endif

conf.d/server.mk

@@ -0,0 +1,30 @@
+# server distributions
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/server-base: distro/installer sub/main \
+	use/syslinux/ui-menu use/memtest use/bootloader/grub
+	@$(call add,BASE_LISTS,server-base)
+
+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,BASE_LISTS,ovz-server)
+	@$(call add,BASE_LISTS,$(call tags,base server))
+	@$(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)
+
+endif

distro.mk

@@ -1,77 +0,0 @@
-# this makefile is designed to be included in toplevel one
-ifndef BUILDDIR
-$(error BUILDDIR not defined)
-endif
-
-# step 2: build up distribution's configuration
-
-# NB: distro/ targets should be defined in this file,
-# see toplevel Makefile's $(DISTROS) assignment
-CONFIG = $(BUILDDIR)/distcfg.mk
-
-# collect use/% (source initial feature snippets)
--include features.in/*/config.mk
-
-# put(), add(), set(), try(), tags():
-# package list names are considered relative to pkg/lists/;
-# tags can do boolean expressions: (tag1 && !(tag2 || tag3))
-include functions.mk
-
-# distro/.%, sub/.%, boot/%
-include libdistro.mk
-
-# bootloader test target; requires recent mkimage to build
-distro/syslinux: distro/.init distro/.branding sub/stage1 \
-	use/syslinux use/syslinux/localboot.cfg \
-	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
-#         and their value requested (so the variable referenced
-#         can change its value during configuration _before_
-#         it's actually used); just peek inside $(CONFIG) ;-)
-# BASE_PACKAGES, BASE_LISTS, MAIN_PACKAGES, MAIN_LISTS: see sub.in/main/
-
-# live images
-
-distro/live: distro/.base use/live use/syslinux/ui-menu
-distro/rescue: distro/.base use/rescue 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/rescue use/firmware/server
-	@$(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)
-
-distro/minicd: distro/server-base
-	@$(call set,KFLAVOURS,pure-emerald)	# usually recent drivers
-	@$(call add,MAIN_PACKAGES,etcnet-full)
-
-# desktop distributions
-
-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
-	@$(call add,BASE_LISTS,$(call tags,icewm desktop))
-
-# NB: if there are too many screens above, it might make sense to distro.d/

doc/assumptions.txt

@@ -1,3 +1,5 @@
+предположения фрагментов кода об окружении
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 - pkg.in/lists/Makefile
   + ожидает, что названия пакаджлистов указываются в переменных
     вида *_LISTS, и копирует в генерируемый профиль только их
@@ -15,3 +17,18 @@
   + если добавить какой-либо 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
+
+- image.in/Makefile
+  + ожидает, что конфигурация будет в distcfg.mk (см. тж. lib/profile.mk),
+    а лог сборки -- в build.log (см. тж. lib/log.mk); альтернативой было
+    бы пробрасывание переменных с полным путём ради единственного места

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,9 +1,9 @@
-### sample ~/.mkimage/profiles.mk
+# sample ~/.mkimage/profiles.mk
 
-### where to look for apt.conf; system one used by default
+# where to look for apt.conf; system one used by default
 #APTCONF = ~/apt/apt.conf.$(ARCH)
 
-### turns on GLOBAL_VERBOSE and prettier output
+# turns on GLOBAL_VERBOSE and prettier output
 #DEBUG = 1
 
 # spares tmpfs, quite recommended unless you need raw workdir chroots

doc/variables.txt

@@ -1,29 +1,35 @@
+переменные make
+~~~~~~~~~~~~~~~
 При запуске на сборку принимается ряд переменных
 (см. тж. profiles.mk.sample):
 
 - APTCONF
   + задаёт путь к требуемому apt.conf
   + значение: пусто (по умолчанию системный) либо строка
-  + см. image.in/Makefile
+  + см. ../image.in/Makefile
 
 - ARCH
   + определяет целевую архитектуру образа
   + значение: пусто (по умолчанию авто), i586 или x86_64
-  + см. iso.mk
+  + см. ../lib/build.mk
 
 - BUILDDIR
   + определяет каталог генерируемого профиля и сборки
   + значение: пусто (по умолчанию авто) либо строка
-  + см. profile.mk
+  + см. ../lib/profile.mk
 
 - CLEAN
-  + экономия RAM при сборке в tmpfs, иначе места на диске
+  + экономия RAM+swap при сборке в tmpfs, иначе места на диске
   + очистка рабочего каталога после успешной сборки очередной стадии
   + может помешать использовать некоторые варианты отладки
   + значение: любая строка, по умолчанию пусто
-  + см. clean.mk
+  + см. ../lib/clean.mk
 
 - DEBUG
   + включение средств отладки
   + значение: пусто (по умолчанию), 1 или 2
-  + см. log.mk
+  + см. ../lib/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 из кусочков, в зависимости от того,
@@ -43,4 +44,4 @@
 произвести из generate.sh и generate.mk.
 
 Пожалуйста, присылайте отзывы о (бес)полезности кода в этом каталоге
-mike@altlinux.
+mike@altlinux.org.

features.in/Makefile

@@ -2,42 +2,97 @@
 #         (only regarding the needed subprofiles)
 
 ifndef BUILDDIR
-$(error BUILDDIR not defined)
-endif
+help all:
+	@echo "** BUILDDIR not defined; available features:"
+	@for dir in */; do \
+		echo -n "$$dir: "; \
+		grep -h '^use/' $$dir/config.mk \
+		| cut -f1 -d: \
+		| tr '\n' ' ' \
+		| sort -u; \
+	done
+else
 
--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: subprofile can be specified as src/dest
+#
+# 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
+
+### sorry for somewhat complicated and overly long lines
 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 \
-			dst="${sub#*/}" && \
-			if test -d "$$dir/$$dst/"; then \
-				if rsync -ab "$$dir/$$dst/" "$(BUILDDIR)/$$dst/"; \
-				then \
-					type -t git >&/dev/null && \
-					pushd "$(BUILDDIR)/$$dst/" && \
-					git add . && \
-					git commit -qam "$@/$$dir/$$dst" ||:; \
-					popd; \
+	@if [ -n "$(GLOBAL_DEBUG)" ]; then \
+		echo "** target subprofiles: $(SUBPROFILES)"; \
+		echo "** requested features: $(FEATURES)"; \
+	fi
+	@for feat in $(FEATURES); do \
+		if [ -n "$(GLOBAL_DEBUG)" ]; then \
+			echo "** adding $$feat feature"; \
+		fi; \
+		pushd "$$feat" >/dev/null && \
+		for sub in / $(SUBPROFILES); do \
+			src="$${sub%/*}"; \
+			dst="$${sub#*/}"; \
+			if [ -d "$$src" ]; then \
+				rsync -qab "$$src/" "$(BUILDDIR)/$$dst/"; \
+				dirtags="&& $$src"; \
+			fi; \
+			if [ -d "$$dst" ]; then \
+				rsync -qab "$$dst/" "$(BUILDDIR)/$$dst/"; \
+				if [ "$$dst" != "$$src" ]; then \
+					dirtags="&& ($$src || $$dst)"; \
 				fi; \
 			fi; \
+			for dir in lib {image-,}scripts.d; do \
+				destdir="$(BUILDDIR)/$$dst/$$dir/"; \
+				if [ -d "$$destdir" ]; then \
+					if [ -d "$$dir" ]; then \
+						rsync -qab "$$dir/" "$$destdir/"; \
+					fi; \
+					if [ -d "tagged/$$dir" ]; then \
+						if pushd "tagged/$$dir" >/dev/null; then \
+							echo "$$feat $$dirtags" \
+							| tags2lists . \
+							| xargs -r cp -vpLt "$$destdir" --; \
+							popd >/dev/null; \
+						fi; \
+					fi; \
+				fi; \
+			done; \
+			if type -t git >&/dev/null && \
+			   pushd "$(BUILDDIR)/$$dst/" >/dev/null; then \
+				test -n "`git status -s`" && \
+				git add . && \
+				if [ -n "$$dst" ]; then \
+					the="$$sub subprofile"; \
+				else \
+					the="toplevel"; \
+				fi && \
+				git commit -qam "$$feat feature: $$the part added"; \
+				popd >/dev/null; \
+			fi; \
 		done; \
-		if test -x "$$dir/generate.sh"; then \
-			pushd "$$dir" && \
-			sh generate.sh; \
-			popd; \
-		fi; \
-		if test -s "$$dir/generate.mk"; then \
-			$(MAKE) -C "$$dir" -f generate.mk; \
+		if [ -x "generate.sh" ]; then sh generate.sh; fi; \
+		if [ -s "generate.mk" ]; then $(MAKE) -f generate.mk; fi; \
+		if type -t git >&/dev/null && \
+		   pushd "$(BUILDDIR)/" >/dev/null; then \
+			if test -n "`git status -s`"; then \
+				git add . && \
+				git commit -qam "$$feat feature generation complete"; \
+			fi; \
+			popd >/dev/null; \
 		fi; \
+		popd >/dev/null; \
 	done
-
-help:
-	@echo "** available features:"
-	@grep -h '^use/' */config.mk
+	@find "$(BUILDDIR)/" -name '*~' \
+	| sed "s,$(BUILDDIR)/,** warning: file clash: ," >&2
+endif

features.in/README

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

features.in/bootloader/README

@@ -6,4 +6,5 @@
 и требует пакет выбранного загрузчика.
 
 Реализация экспериментальная (нужно модуляризовать installer-steps),
-завязана на installer-distro-altlinux-generic = 6.0-alt2.
+пока завязана на installer-distro-altlinux-generic.  Возможно,
+с использованием alterator-lilo связаны проблемы времени установки.

features.in/bootloader/config.mk

@@ -3,7 +3,7 @@
 # - remember .base if adding yet another *_PACKAGES
 
 use/bootloader: use/install2 sub/main
-	@$(call add,BASE_PACKAGES,alterator-$$(GLOBAL_BASE_BOOTLOADER))
+	@$(call add,BASE_PACKAGES,alterator-$$(BASE_BOOTLOADER))
 
 use/bootloader/grub use/bootloader/lilo: use/bootloader/%: use/bootloader
-	@$(call set,GLOBAL_BASE_BOOTLOADER,$*)
+	@$(call set,BASE_BOOTLOADER,$*)

features.in/build-distro/README

@@ -0,0 +1,4 @@
+Эта фича конфигурирует создание образа дистрибутива, включая работу
+с субпрофилями -- которая сейчас нужна только дистрибутивным целям.
+
+Дополняет финальную стадию сборки (lib/, scripts.d/).

features.in/build-distro/config.mk

@@ -0,0 +1,2 @@
+use/build-distro: boot/isolinux
+	@$(call add,FEATURES,build-distro)

features.in/build-distro/lib/build-distro.mk

@@ -0,0 +1,46 @@
+# step 4: build the distribution image
+
+# for complex-specified subprofiles like stage2/live,
+# take the latter part
+SUBDIRS = $(notdir $(SUBPROFILES))
+
+# "main" subprofile needs genbasedir
+CHROOT_PACKAGES = apt-utils
+BOOT_TYPE = isolinux
+
+# Metadata/ needed only for installers (and not for e.g. syslinux.iso)
+# FIXME: installable live needs it too, don't move to install2 feature
+ifneq (,$(findstring install2,$(FEATURES)))
+METADATA = metadata
+endif
+
+all: $(GLOBAL_DEBUG) prep copy-subdirs copy-tree run-scripts pack-image \
+	postprocess $(GLOBAL_CLEAN_WORKDIR)
+
+prep: $(GLOBAL_DEBUG) dot-disk $(METADATA) $(IMAGEDIR)
+
+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,$(MAIN_GROUPS) .base) \
+			$(call group,$(MAIN_GROUPS)) \
+		   | sed 's,$(PKGDIR)/*,,g')
+
+dot-base:
+	@{ \
+		echo -e "\n## added by image.in/Makefile"; \
+		echo "$(call kpackages,$(KMODULES),$(KFLAVOURS))"; \
+	} >> $(call list,.base)
+
+dot-disk:
+	@mkdir -p files/.disk
+	@echo "ALT Linux based" >files/.disk/info
+	@echo "$(ARCH)" >files/.disk/arch
+	@echo "$(DATE)" >files/.disk/date
+	@if type -t git >&/dev/null; then \
+		( cd $(TOPDIR) && \
+		git show-ref --head -ds -- HEAD ) \
+		>files/.disk/commit 2>/dev/null; \
+	fi

features.in/build-distro/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}

features.in/build-distro/scripts.d/01-genbasedir

@@ -1,4 +1,5 @@
 #!/bin/sh
+# FIXME: bring to common style
 
 verbose()
 {
@@ -16,12 +17,15 @@ comps="$(find -mindepth 1 -maxdepth 1 -type d -name 'RPMS.*' -printf '%f\n' |
 
 verbose "comps=$comps"
 
+[ -n "$comps" ] || exit 1
+
 genbasedir \
 	--topdir="$WORKDIR" \
         --architecture="$INFO_ARCH" \
         --no-oldhashfile \
         --partial \
-        --bz2only \
+        --xz \
+        --bz2 \
 	--create \
         --notautomatic=false \
         ${INFO_NAME:+--archive="$INFO_NAME"} \
@@ -30,4 +34,7 @@ genbasedir \
         ${INFO_LABEL:+--label="$INFO_LABEL"} \
         ALTLinux $comps
 
+### drop this when genbasedir is fixed (--no-uncompressed)
+for comp in $comps; do rm -f base/{pkg,src}list.$comp; done
+
 verbose finished

features.in/build-ve/README

@@ -0,0 +1,3 @@
+Эта фича конфигурирует создание образа виртуального окружения (VE).
+
+Дополняет финальную стадию сборки (lib/, image-scripts.d/).

features.in/build-ve/config.mk

@@ -0,0 +1,2 @@
+use/build-ve:
+	@$(call add,FEATURES,build-ve)

features.in/build-ve/image-scripts.d/03services

@@ -0,0 +1,11 @@
+#!/bin/sh
+# VEs typically have no means to communicate with the outer
+# world except for networking; still this might need some
+# more tweaking for networkless LXC case
+
+# candidates:
+# off: keytable
+
+for i in network random syslogd random; do chkconfig $i on; done
+for i in fbsetfont netfs rawdevices; do chkconfig $i off; done
+:

features.in/build-ve/image-scripts.d/04inittab

@@ -0,0 +1,3 @@
+#!/bin/sh -e
+# we don't need no gettys in OpenVZ VEs (might need one in LXC though)
+subst 's,^[0-9]\+:[0-9]\+:respawn:/sbin/mingetty.*,#&,' /etc/inittab

features.in/build-ve/image-scripts.d/05mtab

@@ -0,0 +1,3 @@
+#!/bin/sh -e
+# should be pretty much obsolete but just in case
+[ -L /etc/mtab ] || ln -sf /proc/mounts /etc/mtab

features.in/build-ve/image-scripts.d/06syslog

@@ -0,0 +1,13 @@
+#!/bin/sh -e
+# tweak syslog configuration to:
+# - avoid logging to a nonexistent tty;
+# - avoid hard sync logging (one is better off doing
+#   remote syslog if you do care for reliable data anyways)
+# credits: vvk@, thresh@ (2010)
+
+sed -i \
+	-e 's,/dev/tty12,/var/log/syslog/console,' \
+	-e 's,^.*/var/log/syslog/console$,#&,' \
+	-e 's,-/var/log/,/var/log/,g' \
+	-e 's,/var/log/,-/var/log/,g' \
+	/etc/syslog.conf

features.in/build-ve/lib/build-ve.mk

@@ -0,0 +1,11 @@
+# step 4: build the virtual environment image
+
+MKI_TAR_COMPRESS = $(IMAGE_COMPRESS)
+
+IMAGE_PACKAGES = $(call list,$(BASE_LISTS)) \
+		 $(SYSTEM_PACKAGES) \
+		 $(COMMON_PACKAGES) \
+		 $(BASE_PACKAGES)
+
+all: $(GLOBAL_DEBUG) build-image copy-tree run-image-scripts pack-image \
+	postprocess $(GLOBAL_CLEAN_WORKDIR)

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,21 @@
+#!/bin/sh -efu
+# create a postinstall script to drop temporarily needed packages
+
+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,18 +3,16 @@
 #     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)
-
 use/firmware/wireless: use/firmware
 	@$(call add,MAIN_PACKAGES,firmware-acx100)
 	@$(call add,MAIN_PACKAGES,firmware-i2400m)
+	@$(call add,MAIN_PACKAGES,firmware-carl9170)
 	@$(call add,MAIN_PACKAGES_REGEXP,firmware-ipw.*)
 	@$(call add,MAIN_PACKAGES_REGEXP,firmware-iwl.*)
 	@$(call add,MAIN_PACKAGES_REGEXP,firmware-rt.*)

features.in/hdt/config.mk

@@ -2,5 +2,3 @@ use/hdt: use/syslinux use/memtest
 	@$(call add,FEATURES,hdt)
 	@$(call add,STAGE1_PACKAGES,pciids)
 	@$(call add,SYSLINUX_MODULES,hdt)
-### moved to scripts.d/02-hdt along with compression
-#	@$(call add,SYSLINUX_FILES,/usr/share/misc/pci.ids)

features.in/install2/config.mk

@@ -1,4 +1,4 @@
-use/install2: use/stage2 sub/stage2/install2
+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)

features.in/install2/install2/image-scripts.d/98system

@@ -1,7 +1,4 @@
 #!/bin/sh
 
-# stage1 needs this
-mkdir -p /image
-
 # setup stage2 as init
 mv -f /usr/sbin/install2-init /sbin/init

features.in/install2/install2/stage2cfg.mk

@@ -1,11 +1,17 @@
 # stage2 mod: build install2 subprofile (installer "live" part)
 
-IMAGE_PACKAGES = $(COMMON_PACKAGES) \
-		 $(INSTALL2_PACKAGES) \
+IMAGE_PACKAGES = $(INSTALL2_PACKAGES) \
 		 udev e2fsprogs glibc-nss
 
 MKI_PACK_RESULTS = squash:altinst
 
-debug:
+# 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/install2/tagged/image-scripts.d/90+install2+cleanup+bloat

@@ -0,0 +1,32 @@
+#!/bin/sh
+# purge anything unused during installation
+
+rm -rf /usr/share/icons/{hicolor,large,mini}
+
+# PAM plugins
+rm -rf /lib*/security
+
+rm -rf /usr/share/ca-certificates
+rm -rf /usr/lib/qt4/plugins/codecs
+rm -rf /usr/lib/qt4/plugins/bearer
+rm -rf /usr/lib/qt4/plugins/inputmethods
+rm -rf /usr/share/qt4/{doc,mkspecs,phrasebooks}
+
+rm -rf /usr/share/guile/*/{*.txt,scripts}
+rm -rf /usr/share/awk/
+
+### could it be handled with any grace?
+### TODO: x11vnc, xorg-xvfb: fix installer-common-stage2
+rpmquery -a cpp\* gcc\* perl-base file ipv6calc \
+	bind-utils libbind \
+	gnupg libgcrypt libgnutls\* libgpg-error libsoup\* \
+	libGL glxinfo xdriinfo \
+	make make-initrd x11vnc xorg-xvfb \
+| xargs -r rpmi -e --nodeps --
+
+rpmquery -a bind-utils libbind \
+| xargs -r rpmi -e --
+
+# outstanding binaries
+rm -f /sbin/{sln,tc}
+rm -f /usr/bin/openssl

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

@@ -0,0 +1,5 @@
+#!/bin/sh
+# remove all docs
+
+rpmquery -ad |grep ^/ |xargs -r rm -f --
+rm -rf /usr/share/{doc,man,info,license,gfxboot}

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

@@ -1,64 +1,50 @@
 #!/bin/sh
-
-# remove all docs
-rpmquery -adl |grep ^/ |xargs -r rm -f --
-rm -rf /usr/share/{doc,man,info,license,gfxboot}
-
-# remove unused icons
-rm -rf /usr/share/icons/{hicolor,large,mini}
-
-# remove PAM plugins
-rm -rf /lib*/security
-
-# remove some unused files
-rm -rf /usr/share/ca-certificates
-rm -rf /usr/lib/qt4/plugins/codecs
-rm -f /usr/lib*/gconv/IBM*
-rm -f /usr/lib*/gconv/BIG5*
-rm -f /usr/lib*/gconv/EBCDIC*
-
-# remove unneeded timezones
-rm -rf /usr/share/zoneinfo/{posix,right}/
-
-# remove unneeded l10n
-find /usr/share/locale/ -type f \! -name 'alterator*' -delete
-
-# remove non-utf8 locales
-find /usr/lib*/locale -mindepth 1 -maxdepth 1 -type d \! -name '*.utf8' -print0 |
-	xargs -r0 rm -rf --
+# drop extra drivers et al, purge kernel image(s)
 
 # xorg modules
 rm -r /usr/lib*/X11/modules/dri
 
-# remove ogfs
-rm -f /lib*/evms/*/ogfs*
+# evms modules; see http://evms.sourceforge.net/user_guide/
+rm -f /lib*/evms/*/{bbr,csm,drivelink,ogfs,replace,snapshot}*
 
-# remove cpp, gcc and perl
-rpmquery -a cpp\* gcc\* perl-base |
-	xargs -r rpmi -e --nodeps --
-
-# remove unneeded kernel modules
+# unneeded kernel modules
+### some of these removals belong to a purge grade script
+### TODO: mostly scsi-less and net-less cleanup for antique
 rm -rf /lib/modules/*/kernel/arch
 rm -rf /lib/modules/*/kernel/drivers/atm
-rm -rf /lib/modules/*/kernel/drivers/char/ipmi
+rm -rf /lib/modules/*/kernel/drivers/bluetooth
+rm -rf /lib/modules/*/kernel/drivers/char/{ipmi,hw_random,mwave,tpm}
 rm -rf /lib/modules/*/kernel/drivers/char/watchdog
 rm -rf /lib/modules/*/kernel/drivers/cpufreq
 rm -rf /lib/modules/*/kernel/drivers/edac
 rm -rf /lib/modules/*/kernel/drivers/firmware	###
+rm -rf /lib/modules/*/kernel/drivers/gpio
 rm -rf /lib/modules/*/kernel/drivers/hwmon
 rm -rf /lib/modules/*/kernel/drivers/infiniband	###
 rm -rf /lib/modules/*/kernel/drivers/input/{gameport,joy*}
 rm -rf /lib/modules/*/kernel/drivers/isdn
+rm -rf /lib/modules/*/kernel/drivers/leds
 rm -rf /lib/modules/*/kernel/drivers/media
 rm -rf /lib/modules/*/kernel/drivers/mmc
 rm -rf /lib/modules/*/kernel/drivers/mtd*
+rm -rf /lib/modules/*/kernel/drivers/net/can
+rm -rf /lib/modules/*/kernel/drivers/net/hamradio
 rm -rf /lib/modules/*/kernel/drivers/net/irda
+rm -rf /lib/modules/*/kernel/drivers/net/tokenring
+rm -rf /lib/modules/*/kernel/drivers/net/wimax
 rm -rf /lib/modules/*/kernel/drivers/net/wireless
+rm -rf /lib/modules/*/kernel/drivers/net/wan
+rm -rf /lib/modules/*/kernel/drivers/regulator
 rm -rf /lib/modules/*/kernel/drivers/staging
 rm -rf /lib/modules/*/kernel/drivers/spi
+rm -rf /lib/modules/*/kernel/drivers/target
 rm -rf /lib/modules/*/kernel/drivers/telephony
-rm -rf /lib/modules/*/kernel/drivers/usb/{misc,mon}
+rm -rf /lib/modules/*/kernel/drivers/tty/[^s][^e]*
+rm -rf /lib/modules/*/kernel/drivers/usb/{atm,c67*,image,misc,mon,otg,serial,wusbcore}
+rm -rf /lib/modules/*/kernel/drivers/usb/storage/ums*
+rm -rf /lib/modules/*/kernel/drivers/uwb
 rm -rf /lib/modules/*/kernel/drivers/w1
+rm -rf /lib/modules/*/kernel/drivers/watchdog
 rm -rf /lib/modules/*/kernel/fs/9p
 rm -rf /lib/modules/*/kernel/fs/adfs
 rm -rf /lib/modules/*/kernel/fs/affs
@@ -68,12 +54,16 @@ rm -rf /lib/modules/*/kernel/fs/autofs4
 rm -rf /lib/modules/*/kernel/fs/befs
 rm -rf /lib/modules/*/kernel/fs/bfs
 rm -rf /lib/modules/*/kernel/fs/btrfs
+rm -rf /lib/modules/*/kernel/fs/ceph
 rm -rf /lib/modules/*/kernel/fs/cifs
 rm -rf /lib/modules/*/kernel/fs/coda
 rm -rf /lib/modules/*/kernel/fs/configfs
 rm -rf /lib/modules/*/kernel/fs/cramfs
+rm -rf /lib/modules/*/kernel/fs/dlm
 rm -rf /lib/modules/*/kernel/fs/efs
+rm -rf /lib/modules/*/kernel/fs/exofs
 rm -rf /lib/modules/*/kernel/fs/freevxfs
+rm -rf /lib/modules/*/kernel/fs/fscache
 rm -rf /lib/modules/*/kernel/fs/fuse
 rm -rf /lib/modules/*/kernel/fs/hfs
 rm -rf /lib/modules/*/kernel/fs/hfsplus
@@ -81,18 +71,26 @@ rm -rf /lib/modules/*/kernel/fs/hpfs
 rm -rf /lib/modules/*/kernel/fs/jffs
 rm -rf /lib/modules/*/kernel/fs/jffs2
 rm -rf /lib/modules/*/kernel/fs/lockd
+rm -rf /lib/modules/*/kernel/fs/logfs
 rm -rf /lib/modules/*/kernel/fs/minix
 rm -rf /lib/modules/*/kernel/fs/ncpfs
 rm -rf /lib/modules/*/kernel/fs/nilfs2
 rm -rf /lib/modules/*/kernel/fs/ocfs2
+rm -rf /lib/modules/*/kernel/fs/omfs
 rm -rf /lib/modules/*/kernel/fs/qnx4
+rm -rf /lib/modules/*/kernel/fs/romfs
 rm -rf /lib/modules/*/kernel/fs/smbfs
 rm -rf /lib/modules/*/kernel/fs/sysv
+rm -rf /lib/modules/*/kernel/fs/ubifs
 rm -rf /lib/modules/*/kernel/fs/udf
 rm -rf /lib/modules/*/kernel/fs/ufs
 rm -rf /lib/modules/*/kernel/net/*/netfilter
+rm -rf /lib/modules/*/kernel/net/9p
 rm -rf /lib/modules/*/kernel/net/appletalk
+rm -rf /lib/modules/*/kernel/net/atm
 rm -rf /lib/modules/*/kernel/net/ax25
+rm -rf /lib/modules/*/kernel/net/can
+rm -rf /lib/modules/*/kernel/net/ceph
 rm -rf /lib/modules/*/kernel/net/bluetooth
 rm -rf /lib/modules/*/kernel/net/dccp
 rm -rf /lib/modules/*/kernel/net/decnet
@@ -102,22 +100,24 @@ rm -rf /lib/modules/*/kernel/net/ipx
 rm -rf /lib/modules/*/kernel/net/irda
 rm -rf /lib/modules/*/kernel/net/netfilter
 rm -rf /lib/modules/*/kernel/net/netrom
+rm -rf /lib/modules/*/kernel/net/rds
 rm -rf /lib/modules/*/kernel/net/rose
 rm -rf /lib/modules/*/kernel/net/sctp
 rm -rf /lib/modules/*/kernel/net/tipc
+rm -rf /lib/modules/*/kernel/net/{wimax,wireless,mac80211}
 rm -rf /lib/modules/*/kernel/net/x25
 rm -rf /lib/modules/*/kernel/sound
 
-# remove blacklisted kernel modules
+# blacklisted kernel modules
 sed -n 's/^blacklist[[:space:]]\+\([^[:space:]]\+\).*/\1/p' /etc/modprobe.d/* |
 	while read i; do
 		find /lib/modules/ -type f -name "$i.ko" -delete
 	done
 
-# run depmod after kernel modules removal
+# regenerate module dependencies
 for i in /lib*/modules/*; do
-    /sbin/depmod -a -F /boot/System.map-${i##*/} ${i##*/}
+	/sbin/depmod -a -F /boot/System.map-${i##*/} ${i##*/}
 done
 
-# remove kernel images
+# kernel images
 rm -rf /boot/*

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

@@ -0,0 +1,22 @@
+#!/bin/sh
+# drop unused l10n/i18n data
+
+# the fell swoop
+find /usr/share/locale/ -type f \! -name 'alterator*' -delete
+rm -rf /usr/share/zoneinfo/{posix,right}/
+
+# charset conversion tables
+### NB: BIG5* and friends should be handled consistently
+rm -f /usr/lib*/gconv/IBM*
+rm -f /usr/lib*/gconv/BIG5*
+rm -f /usr/lib*/gconv/EBCDIC*
+
+# en_* variations
+rm -rf /usr/{lib*,share}/locale/en_[^U]*
+
+# non-utf8 locales
+find /usr/lib*/locale -mindepth 1 -maxdepth 1 -type d \! -name '*.utf8' -print0 |
+        xargs -r0 rm -rf --
+
+# dangling symlinks
+find /usr/lib*/locale \! -readable -delete

features.in/live/config.mk

@@ -1,3 +1,3 @@
 use/live: use/stage2 sub/stage2/live
 	@$(call add,FEATURES,live)
-#	@$(call add,LIVE_LISTS,base-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

@@ -2,7 +2,7 @@
 
 IMAGE_PACKAGES = $(COMMON_PACKAGES) \
 		 $(LIVE_PACKAGES) \
-		 $(call map,list,$(LIVE_LISTS) $(LIVE_GROUPS)) \
+		 $(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/install2/image-scripts.d/85cleanup-lowmem

@@ -7,8 +7,8 @@ cd /usr/share/fonts/bitmap/misc/ &&
 # drop unneeded translation
 # FIXME: whitelist is reasonable
 cd /usr/share/qt4/translations/ &&
-	rm -f *_ar* *_cs* *_da* *_de* *_es* *_fr* \
-	      *_gl* *_he* *_hu* *_pl* \
+	rm -f *_ar* *_cs* *_da* *_de* *_es* *_fa* *_fr* \
+	      *_gl* *_he* *_hu* *_ko* *_pl* \
 	      *_sk* *_sl* *_sv*
 
 # ...l10n...
@@ -20,23 +20,19 @@ cd /usr/share/X11/locale &&
 cd /usr/share/X11/xkb/symbols &&
 	ls \
 	| egrep -v 'by|en|kz|pt|ru|ua|us|pc|....*' \
-	| xargs rm -rf
+	| xargs rm -rf --
 
 # gconv
 cd /usr/lib*/gconv &&
 	rm -f EUC* G* I*
 
 # locales
-cd /usr/lib*/locale &&
+for dir in /usr/{lib*,share}/locale; do
+	cd "$dir" && \
 	ls \
-	| egrep -v '^(be|en|kk|pt|ru|uk)_' \
-	| xargs rm -rf
-
-# remove kbd data
-# FIXME: might break things?
-#rm -rf /lib/kbd/
-
-# outstanding binaries
-rm /bin/ipv6calc /sbin/sln
+	| egrep -v '^be|en|kk|pt|ru|uk' \
+	| xargs rm -rf --;
+done
 
+### consider cleaning up kbd data (partially?)
 :

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/pack/README

@@ -0,0 +1,3 @@
+Эта фича определяет формат упаковки создаваемого образа.
+На данный момент поддерживаются iso (загрузочный ISO9660
+для дистрибутивов) и tar (виртуальные окружения).

features.in/pack/config.mk

@@ -0,0 +1,18 @@
+DISTRO_EXTS := .iso
+VE_EXTS     := .tar .tgz
+
+use/pack:
+	@$(call add,FEATURES,pack)
+
+use/pack/iso: use/pack boot/isolinux
+ifeq (distro,$(IMAGE_CLASS))
+	@$(call set,IMAGE_PACKTYPE,isoboot)
+else
+	@$(call set,IMAGE_PACKTYPE,isodata)
+endif
+
+use/pack/tar: use/pack
+	@$(call set,IMAGE_PACKTYPE,tar)
+
+use/pack/tgz: use/pack/tar
+	@$(call set,IMAGE_COMPRESS,gzip)

features.in/powerbutton/README

@@ -0,0 +1,4 @@
+Эта фича конфигурирует поддержку управления кнопкой питания
+-- выключение для ACPI, засыпание для APM (не проверялось).
+
+TODO: учесть изложенное в https://bugzilla.altlinux.org/25018

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/config.mk

@@ -1,3 +1,4 @@
 use/rescue: use/stage2 sub/stage2/rescue
 	@$(call add,FEATURES,rescue)
-	@$(call add,RESCUE_LISTS,base-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

@@ -1,8 +1,5 @@
 #!/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
 

features.in/rescue/rescue/stage2cfg.mk

@@ -7,6 +7,6 @@ IMAGE_PACKAGES = $(COMMON_PACKAGES) \
 
 MKI_PACK_RESULTS = squash:rescue
 
-debug:
+debug::
 	@echo "** rescue: IMAGE_PACKAGES: $(IMAGE_PACKAGES)"
 	@echo "** rescue: IMAGE_PACKAGES_REGEXP: $(IMAGE_PACKAGES_REGEXP)"

features.in/syslinux/README

@@ -1,14 +1,15 @@
-Добавление поддержки syslinux; требуется для инсталяторов, live/rescue.
+Добавление поддержки syslinux; требуется для инсталяторов, live/rescue;
+реализуется в рамках stage1.
 
 Цели config.mk:
 
 * use/syslinux/ui-% -- конфигурирование интерфейса (см. cfg.in/00*.cfg);
-  при использовании автоматически добавляют syslinux в FEATURES
+  при использовании автоматически добавляют syslinux в FEATURES;
 
 * use/syslinux/%.com, use/syslinux/%.c32 -- подключение одноименных модулей
-  (копирование бинарников и включение кусочков конфигурации; экспериментальное)
+  (копирование бинарников и включение кусочков конфигурации; экспериментальное);
 
-* use/syslinux/%.cfg -- подключение кусочков конфигурации (используется)
+* use/syslinux/%.cfg -- подключение кусочков конфигурации.
 
 Переменные generate.mk:
 
@@ -19,3 +20,7 @@
 
 Здесь производится первичная обработка конфигурационных данных,
 окончательно проверяемых и используемых уже в инструментальном чруте.
+
+TODO: может потребоваться обобщение механизма генерации с учётом
+многоуровневых меню и включаемых файлов (которыми лучше не злоупотреблять
+из соображений скорости инициализации загрузчика).

features.in/syslinux/cfg.in/00gfxboot.cfg

@@ -1,3 +1,3 @@
-ui gfxboot bootlogo
+ui gfxboot bootlogo message
 menu title mkimage-profiles 2.0
 prompt 0

features.in/syslinux/cfg.in/10removable.cfg

@@ -0,0 +1,3 @@
+label removable
+  menu label Boot from ^removable drive
+  localboot 0x00

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

@@ -1,5 +1,4 @@
 label live
   menu label ^LiveCD (no hard disk needed)
   kernel alt0/vmlinuz
-  append initrd=alt0/full.cz live ramdisk_size=72000 fastboot stagename=live showopts automatic=method:cdrom
-  ### FIXME: see m-p-d::profiles/scripts.d/03-syslinux
+  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,5 +1,4 @@
 label rescue
   menu label ^Rescue LiveCD
   kernel alt0/vmlinuz
-  append initrd=alt0/full.cz live ramdisk_size=72000 fastboot stagename=rescue showopts automatic=method:cdrom
-  ### FIXME: see m-p-d::profiles/scripts.d/03-syslinux
+  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/config.mk

@@ -1,5 +1,5 @@
 # default is plain text prompt
-use/syslinux:
+use/syslinux: sub/stage1
 	@$(call add,FEATURES,syslinux)
 	@$(call add,STAGE1_PACKAGES,syslinux)
 

features.in/syslinux/generate.mk

@@ -45,10 +45,9 @@ cfg = $(wildcard cfg.in/??$(1).cfg)
 #
 # arguments get evaluated before recipe body execution thus prep
 all: prep debug
-	@echo $(sort \
+	cp -pLt $(DSTDIR) -- $(sort \
 		$(foreach C,$(SYSLINUX_CFG),$(call cfg,$(C))) \
-		$(foreach M,$(SYSLINUX_MODULES),$(call cfg,$(M)))) \
-		| xargs cp -pLt $(DSTDIR) --
+		$(foreach M,$(SYSLINUX_MODULES),$(call cfg,$(M))))
 	@echo $(SYSLINUX_MODULES) > $(DSTDIR)/modules.list
 	@echo $(SYSLINUX_FILES) > $(DSTDIR)/files.list
 	@echo $(BOOTLOADER) > $(DSTDIR)/bootloader

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.

image.in/.gitignore

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

image.in/Makefile

@@ -1,80 +1,53 @@
-# step 4: build image (final stage)
-#
-# NB: this directory forms the initial BUILDDIR/
+# stage 4: dive into mkimage
 
-ifndef GLOBAL_BUILDDIR
-$(error GLOBAL_BUILDDIR not defined)
-endif
+GLOBAL_BUILDDIR ?= $(shell pwd)
+LINKPREFIX := mkimage-profiles
 
+include distcfg.mk
 include functions.mk
-include $(GLOBAL_BUILDDIR)/functions.mk
-include $(GLOBAL_BUILDDIR)/distcfg.mk
 include $(MKIMAGE_PREFIX)/config.mk
 
-# for complex-specified subprofiles like stage2/live,
-# take the latter part
-SUBDIRS = $(notdir $(SUBPROFILES))
+# reconstruct instead of passing yet another variable
+IMAGE_FILE := $(IMAGE_NAME).$(IMAGE_TYPE)
+IMAGE_OUTFILE := $(IMAGE_NAME)-$(DATE)-$(ARCH).$(IMAGE_TYPE)
+MKI_PACK_RESULTS = $(IMAGE_PACKTYPE):$(IMAGE_OUTFILE)
 
-# "main" subprofile needs genbasedir
-CHROOT_PACKAGES = apt-utils
-###
-MKI_PACK_RESULTS = isoboot:$(IMAGENAME)
+# these get opied over as is
 COPY_TREE = ./files
-BOOT_TYPE = isolinux
 
 # outdir shouldn't be wiped clean before use
 CLEANUP_OUTDIR ?=
 
 APTCONF := $(wildcard $(APTCONF))
-ifeq "$(APTCONF)" ""
+ifeq (,$(APTCONF))
 GLOBAL_HSH_APT_CONFIG = /etc/apt/apt.conf
 else
 GLOBAL_HSH_APT_CONFIG = $(APTCONF)
 endif
 
+# the lib/build-*.mk comes from features.in/build-*/lib
+include lib/*.mk
 include $(MKIMAGE_PREFIX)/targets.mk
 
-all: $(GLOBAL_DEBUG) prep copy-subdirs copy-tree run-scripts pack-image \
-	$(GLOBAL_CLEAN_WORKDIR)
-
-# Metadata/ needed only for installer (and not for e.g. syslinux.iso)
-ifeq "$(STAGE1_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)) \
-		   | 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)
+# specified only for the final image (target-specific)
+pack-image: OUTDIR = $(IMAGEDIR)
+pack-image: $(IMAGEDIR)
 
 $(IMAGEDIR):
-	mkdir -p "$(IMAGEDIR)"
+	@mkdir -p "$(IMAGEDIR)"
 
-# specified only for the final image, not for the subparts
-pack-image: OUTDIR = $(IMAGEDIR)
+postprocess:
+	@OUTPATH="$(IMAGEDIR)/$(IMAGE_OUTFILE)"; \
+	echo "** image: $(IMAGE_OUTFILE)" && \
+	ln -sf "$(IMAGE_OUTFILE)" "$(IMAGEDIR)/$(IMAGE_FILE)" && \
+	ln -sf "$(IMAGE_FILE)" "$(IMAGEDIR)/$(LINKPREFIX).$(IMAGE_TYPE)"; \
+	ln -sf "$$OUTPATH" "$(IMAGE_FILE)"; \
+	if [ -n "$(GLOBAL_DEBUG)" ]; then \
+		cp -a build.log "$$OUTPATH.log"; \
+		cp -a distcfg.mk "$$OUTPATH.cfg"; \
+	fi
 
 debug:
 	@echo "TOPDIR=$(TOPDIR)"
 	@echo "ARCH=$(ARCH)"
 	@echo "GLOBAL_HSH_APT_CONFIG=$(GLOBAL_HSH_APT_CONFIG)"
-
-dot-disk:
-	@mkdir -p files/.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

image.in/README

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

image.in/functions.mk

@@ -1,4 +1,9 @@
-PKGDIR=$(GLOBAL_BUILDDIR)/pkg
+# globals
+PKGDIR := $(GLOBAL_BUILDDIR)/pkg
+
+### duplicated from toplevel build.mk, log.mk for sake of "local" builds
+ARCH ?= $(shell arch | sed 's/i686/i586/')
+DATE ?= $(shell date +%Y%m%d)
 
 # prefix pkglist name with its directory to form a path
 list = $(1:%=$(PKGDIR)/lists/%)
@@ -12,6 +17,7 @@ map = $(foreach a,$(2),$(call $(1),$(a)))
 # kernel package list generation; see also #24669
 NULL :=
 SPACE := $(NULL) # the officially documented way of getting a space
+
 list2re = $(subst $(SPACE),|,$(strip $(1)))
 # args: KMODULES, KFLAVOURS
 kpackages = ^kernel-(image|modules-($(call list2re,$(1))))-($(call list2re,$(2)))$$

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))))
+	@:

lib/README

@@ -0,0 +1,7 @@
+Этот каталог содержит вспомогательные makefiles,
+обеспечивающие основную функциональность создания
+конфигурации образа и генерации соответствующего
+профиля для сборки.
+
+Следует помнить, что будучи включаемыми в ../Makefile,
+они работают в каталоге верхнего уровня.

lib/build.mk

@@ -1,33 +1,36 @@
-# this makefile is designed to be included in toplevel one
-ifndef BUILDDIR
-$(error BUILDDIR not defined)
+# step 4 is kicked off here but actually done by image.in/Makefile
+
+ifndef MKIMAGE_PROFILES
+$(error this makefile is designed to be included in toplevel one)
 endif
 
+# NB: /usr/bin/{i586,x86_64} are setarch(8) symlinks
+
 export ARCH ?= $(shell arch | sed 's/i686/i586/')
 
-# step 4 is kicked off here but actually done by image.in/Makefile
-#
-# adding boot/isolinux to prereqs is too late here,
-# since profile/populate target is already done by now
-#
-# NB: /usr/bin/{i586,x86_64} are setarch(8) symlinks
+# to be passed into distcfg.mk
+IMAGEDIR ?= $(shell [ -d "$$HOME/out" -a -w "$$HOME/out" ] \
+	&& echo "$$HOME/out" \
+	|| echo "$(BUILDDIR)/out" )
 
-iso:
+build: profile/populate
 	@echo -n "** starting image build"
-	@if test -n "$(DEBUG)"; then \
+	@if [ -n "$(DEBUG)" ]; then \
 		echo ": tail -f $(BUILDLOG)" $(SHORTEN); \
 	else \
 		echo " (coffee time)"; \
 	fi
 	@if time -f "%E %PCPU %Mk" $(ARCH) \
-		$(MAKE) -C $(BUILDDIR)/ GLOBAL_BUILDDIR=$(BUILDDIR) $(LOG); \
+		$(MAKE) -C $(BUILDDIR)/ $(LOG); \
 	then \
 		echo "** build done (`tail -1 $(BUILDLOG) | cut -f1 -d. \
 			|| echo "no log"`)"; \
 	else \
 		echo "** build failed, see log: $(BUILDLOG)" $(SHORTEN); \
-		if test -z "$(DEBUG)"; then \
+		if [ -z "$(DEBUG)" ]; then \
 			echo "   (you might want to re-run with DEBUG=1)"; \
 		fi; \
 		tail -100 "$(BUILDLOG)" | egrep "^E:|[Ee]rror|[Ww]arning"; \
+		df -P $(BUILDDIR) | awk 'END { if ($$4 < 1024) \
+			{ print "** NB: low space on "$$6" ("$$5" used)"}}'; \
 	fi

lib/clean.mk

@@ -17,7 +17,7 @@ clean:
 	@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); \
+		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG) ||:; \
 	fi
 
 # there can be some sense in writing log here even if normally
@@ -26,7 +26,8 @@ clean:
 distclean: clean
 	@if [ -L build -a -d build/ ]; then \
 		rm -rf build/.git; \
-		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG) && \
+		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG) || \
+			rm -rf build/; \
 		rm -r $(shell readlink build); \
 	fi
 	@rm -f build

lib/distro.mk

@@ -0,0 +1,37 @@
+# step 2: build up distribution's configuration
+
+ifndef MKIMAGE_PROFILES
+$(error this makefile is designed to be included in toplevel one)
+endif
+
+ifeq (distro,$(IMAGE_CLASS))
+
+# request particular image subprofile inclusion
+sub/%:
+	@$(call add,SUBPROFILES,$(@:sub/%=%))
+
+# install media bootloader
+boot/%: profile/bare use/syslinux
+	@$(call set,BOOTLOADER,$*)
+
+# fundamental targets
+
+distro/.init: profile/bare
+
+# NB: the last flavour in KFLAVOURS gets to be the default one;
+# the kernel packages regexp evaluation has to take place at build stage
+distro/.base: distro/.init use/syslinux/localboot.cfg
+	@$(call set,KFLAVOURS,std-def)
+
+# bootloader test target
+distro/syslinux: distro/.init \
+	use/syslinux use/syslinux/localboot.cfg \
+	use/syslinux/ui-vesamenu use/hdt use/memtest
+
+# something marginally 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
+
+endif

lib/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
@@ -37,8 +38,13 @@ endef
 
 # if the rule being executed isn't logged yet, log it
 define log_body
-{ grep -q '^# $@$$' "$(CONFIG)" || printf '# %s\n' '$@' >> "$(CONFIG)"; }
+{ [ -s "$(CONFIG)" ] && \
+	grep -q '^# $@$$' "$(CONFIG)" || printf '# %s\n' '$@' >> "$(CONFIG)"; }
 endef
 
 # convert tag list into a list of relative package list paths
+# NB: tags can do boolean expressions: (tag1 && !(tag2 || tag3))
 tags = $(and $(strip $(1)),$(addprefix tagged/,$(shell echo "$(1)" | bin/tags2lists pkg.in/lists/tagged)))
+
+# toplevel Makefile convenience
+addsuffices = $(foreach s,$(1),$(call addsuffix,$s,$(2)))

lib/log.mk

@@ -1,12 +1,11 @@
-# this makefile is designed to be included in toplevel one
-ifndef BUILDDIR
-$(error BUILDDIR not defined)
-endif
-
 # simple logging switch inspired by netch@'s advice:
 # you can add plain $(LOG) to a rule recipe line to moderate it
 # (logfile is automatically truncated during profile/init)
 
+ifndef MKIMAGE_PROFILES
+$(error this makefile is designed to be included in toplevel one)
+endif
+
 BUILDLOG ?= $(BUILDDIR)/build.log
 
 # LOG holds a postprocessor

lib/profile.mk

@@ -0,0 +1,90 @@
+ifndef MKIMAGE_PROFILES
+$(error this makefile is designed to be included in toplevel one)
+endif
+
+SYMLINK = build
+
+# this could have come from environment;
+# if not, can be symlinked if r/w, or made anew
+# NB: immediate assignment matters
+# NB: PATH has no effect here
+ifndef BUILDDIR
+BUILDDIR := $(shell [ -s "$(SYMLINK)" ] \
+        && realpath "$(SYMLINK)" \
+        || bin/mktmpdir mkimage-profiles.build)
+endif
+
+# even smart caching only hurts when every build goes from scratch
+NO_CACHE ?= 1
+
+PATH := $(CURDIR)/bin:$(PATH)
+
+export BUILDDIR NO_CACHE PATH
+
+CONFIG := $(BUILDDIR)/distcfg.mk
+RC := $(HOME)/.mkimage/profiles.mk
+
+# 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)"/
+	@$(call put,ifndef DISTCFG_MK)
+	@$(call put,DISTCFG_MK = 1)
+	@{ \
+		git show-ref --head -d -s -- HEAD && \
+		git status -s && \
+		echo; \
+	} $(LOG)
+	@mkdir "$(BUILDDIR)"/.mki	# mkimage toplevel marker
+	@if type -t git >&/dev/null && cd $(BUILDDIR); then \
+		git init -q && \
+		git add . && \
+		git commit -qam 'derivative profile initialized'; \
+	fi
+	@rm -f "$(SYMLINK)" && \
+		if [ -w . ]; then \
+			ln -sf "$(BUILDDIR)" "$(SYMLINK)" && \
+			echo "$(SYMLINK)/"; \
+		else \
+			echo "$(BUILDDIR)/"; \
+		fi
+
+profile/bare: profile/init
+	@echo "** preparing distro configuration$${DEBUG:+: see $(CONFIG)}" $(SHORTEN)
+	@$(call try,MKIMAGE_PREFIX,/usr/share/mkimage)
+	@$(call try,GLOBAL_VERBOSE,)
+	@$(call try,IMAGEDIR,$(IMAGEDIR))
+	@$(call try,BRANDING,altlinux-sisyphus)
+	@$(call set,IMAGE_INIT_LIST,+branding-$$(BRANDING)-release)
+	@if type -t git >&/dev/null && cd $(BUILDDIR); then \
+		git init -q && \
+		git add . && \
+		git commit -qam 'image configuration defaults set'; \
+	fi
+
+profile/finalize:
+	@if [ -s $(RC) ]; then $(call put,-include $(RC)); fi
+	@$(call put,endif)
+	@if type -t git >&/dev/null && cd $(BUILDDIR); then \
+		git init -q && \
+		git add . && \
+		git commit -qam 'image configuration finalized'; \
+	fi
+
+# 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 profile/finalize profile/dump-vars
+	@for dir in sub.in features.in pkg.in; do \
+		$(MAKE) -C $$dir $(LOG); \
+	done

lib/sugar.mk

@@ -0,0 +1,15 @@
+# this makefile contains some syntactic sugar for the toplevel one
+
+# strip prefix
+config/with/%: %; @:
+
+# just map to specific features
+config/like/%: use/build-%; @:
+
+# map and preconfigure
+config/pack/%: use/pack/%
+	@$(call set,IMAGE_TYPE,$*)
+
+# just preconfigure
+config/name/%:
+	@$(call set,IMAGE_NAME,$*)

lib/ve.mk

@@ -0,0 +1,19 @@
+# step 2: build up virtual environment's configuration
+
+ifndef MKIMAGE_PROFILES
+$(error this makefile is designed to be included in toplevel one)
+endif
+
+ifeq (ve,$(IMAGE_CLASS))
+
+ve/.bare: profile/bare
+	@$(call add,BASE_PACKAGES,basesystem)
+
+ve/generic: ve/.bare
+	@$(call add,BASE_LISTS,\
+		$(call tags,base && (server || network || security || pkg)))
+
+ve/openvpn: ve/.bare
+	@$(call add,BASE_LISTS,$(call tags,server openvpn))
+
+endif

libdistro.mk

@@ -1,32 +0,0 @@
-# low-level part of distro.mk
-
-# request particular image subprofile inclusion
-sub/%:
-	@$(call add,SUBPROFILES,$(@:sub/%=%))
-
-# 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
-distro/.init:
-	@echo "** preparing distro configuration$${DEBUG:+: see $(CONFIG)}" $(SHORTEN)
-	@$(call try,MKIMAGE_PREFIX,/usr/share/mkimage)
-	@$(call try,GLOBAL_VERBOSE,)
-	@$(call try,IMAGEDIR,$(IMAGEDIR))
-	@$(call try,IMAGENAME,$(IMAGENAME))
-
-distro/.branding: distro/.init
-	@$(call try,BRANDING,altlinux-sisyphus)
-	@$(call set,IMAGE_INIT_LIST,+branding-$$(BRANDING)-release)
-
-# NB: the last flavour in KFLAVOURS gets to be the default one;
-# the kernel packages regexp evaluation has to take place at build stage
-distro/.base: distro/.branding sub/stage1 use/syslinux use/syslinux/localboot.cfg
-	@$(call set,KFLAVOURS,std-def)
-
-# pick up release manager's config
-distro/.rc:
-	@if [ -s $(HOME)/.mkimage/profiles.mk ]; then \
-		$(call put,-include $(HOME)/.mkimage/profiles.mk); \
-	fi

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,17 @@ 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)); \
-		type -t git >&/dev/null && \
-		cd $(TARGET) && \
-		git add . && \
-		git commit -qam "$(SUFFIX)"; \
-		cd - >&/dev/null; \
+		cp -at $(TARGET) -- $(addsuffix .directory,$(MAIN_GROUPS)); \
+		if type -t git >&/dev/null && cd $(TARGET); then \
+			if [ -n "`git status -s`" ]; then \
+				git add . && \
+				git commit -qam "requested $(SUFFIX) copied over"; \
+			fi; \
+			cd - >&/dev/null; \
+		fi; \
 	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,49 @@ 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 && cd $(TARGET); then \
+		if [ -n "`git status -s`" ]; then \
+			git add . && \
+			git commit -qam "requested $(SUFFIX) copied over"; \
+		fi; \
+		cd - >&/dev/null; \
+	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