keremet/mkimage-profiles
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
2987fa8f61
mkimage-profiles/doc/params.txt

139 lines
6.6 KiB
Plaintext
Raw Normal View History

added asciidoc support
2012-10-31 01:21:23 +04:00
== Переменные make ==
clean.mk and friends: introduced CLEAN control variable make CLEAN=1 will prune workdirs after packing their results, so disk (or preferably tmpfs) usage will be lower
2011-08-16 00:30:20 +04:00
При запуске на сборку принимается ряд переменных
(см. тж. profiles.mk.sample):
added asciidoc support
2012-10-31 01:21:23 +04:00
* APTCONF
** задаёт путь к требуемому apt.conf
** значение: пусто (по умолчанию системный) либо строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. image.in/Makefile, doc/apt.conf.sample
added asciidoc support
2012-10-31 01:21:23 +04:00
* ARCH
** задаёт целевую архитектуру образов
doc: drop the outdated arch list It was misleading already, and riscv64 is going to join the gang (but not there yet) following aarch64, mipsel, ppc64le and more e2k* subarches...
2019-08-19 23:43:41 +03:00
** значение: пусто (по умолчанию авто) либо строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/build.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* ARCHES
** задаёт набор целевых архитектур при параметрическом задании APTCONF
** значение: пусто (по умолчанию авто) либо список через пробел
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. Makefile, doc/profiles.mk.sample
added asciidoc support
2012-10-31 01:21:23 +04:00
build.mk: added AUTOCLEAN variable This performs distclean upon successful image build. Suggested-by: Andrey Cherepanov <cas@altlinux.org>
2016-09-09 09:22:07 +03:00
* AUTOCLEAN
** включает уборку (distclean) после успешной сборки образа
** значение: пусто (по умолчанию нет) либо любая строка
** см. lib/build.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* BELL
** подаёт сигнал после завершения сборки
** значение: пусто (по умолчанию нет) либо любая строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/build.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* BUILDDIR
** задаёт каталог генерируемого профиля и сборки
** значение: пусто (по умолчанию авто) либо строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/profile.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* BUILDDIR_PREFIX
** задаёт префикс каталога генерируемого профиля и сборки
** значение: строка; по умолчанию выбирается алгоритмически
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. main.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* BUILDLOG
** задаёт путь к файлу журнала сборки/очистки
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** значение: $(BUILDDIR)/build.log (по умолчанию) либо строка
** см. lib/log.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* CHECK
** включает режим проверки сборки конфигурации (без сборки образа)
** значение: пусто (по умолчанию) либо любая строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/build.mk, lib/clean.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* CLEAN
** экономия RAM+swap при сборке в tmpfs, иначе места на диске
** очистка рабочего каталога после успешной сборки очередной стадии
** может помешать использовать некоторые варианты отладки
clean.mk: allow to forbid cleanup explicitly The behaviour that sort of settled didn't actually follow the principle of the least surprise when one really wanted to have BUILDDIR available for inspection; DEBUG=2 would be effective to achieve that but CLEAN=0 would not. Thanks led@ for spotting and reporting this.
2013-08-13 22:32:27 +04:00
** значение: пусто, 0, 1, 2; по умолчанию пусто при DEBUG, иначе 1
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/clean.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* DEBUG
** включает средства отладки, может отключить зачистку после сборки
** значение: пусто (по умолчанию), 1 или 2
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/log.mk, lib/clean.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
image: Add DISTRO_VERSION variable support Use it in the image filename, so we'll know what version of a distro it is.
2017-03-27 18:32:09 +03:00
* DISTRO_VERSION
** задаёт версию дистрибутива, если применимо
** значение: пусто (по умолчанию) либо любая строка
** см. image.in/Makefile
added asciidoc support
2012-10-31 01:21:23 +04:00
* HOMEPAGE, HOMENAME, HOMEWAIT
** указывают адрес, название и таймаут перехода для домашней страницы
** значение: корректный URL, строка, целое неотрицательное число
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. features.in/live/generate.mk (тж. по умолчаниям)
added asciidoc support
2012-10-31 01:21:23 +04:00
* ISOHYBRID
isohybrid: drop postprocessing, xorriso is enough The original mkisofs would only care for the proper ISO9660 image but we've switched to xorriso which is able to perform the hack to yield UEFI hybrid images; thus no need for the postprocessing. Requires mkimage >= 0.2.5 and xorriso (obviously).
2013-03-19 16:21:50 +04:00
** включает создание гибриднго ISO-образа
added asciidoc support
2012-10-31 01:21:23 +04:00
** значение: пусто (по умолчанию) либо любая строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. features.in/pack/config.mk, features.in/isohybrid/config.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* NICE
** понижает нагрузку системы сборочной задачей
** значение: пусто (по умолчанию) либо любая строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. lib/build.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
introduce QUIET variable This one reduces the amount of output that's only interesting when one is actually watching the console during builds (at least the early stage) -- these tend to look boilerplate and be useless when inspecting the output of a large batch build like [[regular]] one.
2015-04-02 20:46:48 +03:00
* QUIET
** отключает поясняющие сообщения при сборке (например, под cron)
** значение: пусто (по умолчанию) либо любая строка
** см. Makefile, lib/build.mk, lib/clean.mk, lib/profile.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* REPORT
** запрашивает создание отчётов о собранном образе
** значение: пусто (по умолчанию) либо любая строка
** NB: в силу специфики обработки передаётся только явно
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. Makefile, report.mk, lib/report.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* ROOTPW
** устанавливает пароль root по умолчанию для образов виртуальных машин
** значение: пусто (по умолчанию root) либо строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. features.in/deflogin/rootfs/image-scripts.d/50-root
added asciidoc support
2012-10-31 01:21:23 +04:00
* SAVE_PROFILE
** сохраняет архив сгенерированного профиля в .disk/
** значение: пусто (по умолчанию) либо любая строка
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. image.in/Makefile
added asciidoc support
2012-10-31 01:21:23 +04:00
* SORTDIR
** дополнительно структурирует каталог собранных образов
** значение: пусто (по умолчанию) либо строка
*** например, '$(IMAGE_NAME)/$(DATE)'
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. image.in/Makefile
added asciidoc support
2012-10-31 01:21:23 +04:00
* SQUASHFS
** определяет характер сжатия squashfs для stage2
** значение:
*** пусто (по умолчанию) либо normal: xz
*** tight: xz с -Xbcj по платформе (лучше, но дольше -- подбор в два прохода)
*** fast: gzip/lzo (быстрее запаковывается и распаковывается, меньше степень)
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. features.in/stage2/stage1/scripts.d/03-test-kernel
added asciidoc support
2012-10-31 01:21:23 +04:00
* STATUS
** добавляет в имя образа указанный префикс
** значение:
*** пусто (по умолчанию) либо строка (например, "alpha", "beta")
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. image.in/Makefile
added asciidoc support
2012-10-31 01:21:23 +04:00
build-vm, image.in: add VM_SAVE_TARBALL parameter The parameter is used to save the intermediate tarball used to build the virtual machine image.
2021-04-30 20:50:47 +03:00
* VM_SAVE_TARBALL
** указывает, что нужно сохранить промежуточный тарбол, из которого
** создаётся образ виртуальной машины, в заданном формате
** значения: tar tar.gz tar.xz
** см. features.in/build-vm/lib/90-build-vm.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
* VM_SIZE
** задаёт размер несжатого образа виртуальной машины в байтах
** значение: пусто (по умолчанию двойной размер чрута) или целое
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
** см. features.in/build-vm/lib/90-build-vm.mk, bin/tar2vm
added asciidoc support
2012-10-31 01:21:23 +04:00
[float]
=== пример ===
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
make DEBUG=1 CLEAN=1 syslinux.iso
Reference in New Issue Copy Permalink