Commit 363ba22a authored by Anton Midyukov's avatar Anton Midyukov

Include README of features to documentation; fix syntax & links in them

parent ec1f9480
...@@ -52,6 +52,174 @@ include::../image.in/README[] ...@@ -52,6 +52,174 @@ include::../image.in/README[]
include::../features.in/README[] include::../features.in/README[]
include::../features.in/00example/README[]
include::../features.in/apt-conf/README[]
include::../features.in/armh-mcom02/README[]
include::../features.in/arm-rpi4/README[]
include::../features.in/bootloader/README[]
include::../features.in/branding/README[]
include::../features.in/browser/README[]
include::../features.in/build-distro/README[]
include::../features.in/build-ve/README[]
include::../features.in/build-vm/README[]
include::../features.in/cleanup/README[]
include::../features.in/control/README[]
include::../features.in/deflogin/README[]
include::../features.in/dev/README[]
include::../features.in/docs/README[]
include::../features.in/domain-client/README[]
include::../features.in/dos/README[]
include::../features.in/drm/README[]
include::../features.in/e2k/README[]
include::../features.in/efi/README[]
include::../features.in/firmware/README[]
include::../features.in/fonts/README[]
include::../features.in/gitlab-runner/README[]
include::../features.in/grub/README[]
include::../features.in/hdt/README[]
include::../features.in/homeros/README[]
include::../features.in/im/README[]
include::../features.in/initrd-bootchain/README[]
include::../features.in/initrd-propagator/README[]
include::../features.in/init/README[]
include::../features.in/install2/README[]
include::../features.in/isohybrid/README[]
include::../features.in/kernel/README[]
include::../features.in/l10n/README[]
include::../features.in/ldm/README[]
include::../features.in/live-install/README[]
include::../features.in/live/README[]
include::../features.in/lowmem/README[]
include::../features.in/ltsp/README[]
include::../features.in/luks/README[]
include::../features.in/lxc-guest/README[]
include::../features.in/lxc/README[]
include::../features.in/mediacheck/README[]
include::../features.in/memclean/README[]
include::../features.in/memtest/README[]
include::../features.in/metadata/README[]
include::../features.in/mipsel-bfk3/README[]
include::../features.in/mipsel-mitx/README[]
include::../features.in/net-dns/README[]
include::../features.in/net-eth/README[]
include::../features.in/net/README[]
include::../features.in/net-ssh/README[]
include::../features.in/net-usershares/README[]
include::../features.in/no-sleep/README[]
include::../features.in/ntp/README[]
include::../features.in/oem/README[]
include::../features.in/office/README[]
include::../features.in/pack/README[]
include::../features.in/pid1/README[]
include::../features.in/pkgpriorities/README[]
include::../features.in/plymouth/README[]
include::../features.in/power/README[]
include::../features.in/relname/README[]
include::../features.in/repo/README[]
include::../features.in/rescue/README[]
include::../features.in/server/README[]
include::../features.in/services/README[]
include::../features.in/slinux/README[]
include::../features.in/sound/README[]
include::../features.in/speech/README[]
include::../features.in/stage2/README[]
include::../features.in/syslinux/README[]
include::../features.in/tty/README[]
include::../features.in/uboot/README[]
include::../features.in/uuid-iso/README[]
include::../features.in/vagrant/README[]
include::../features.in/vmguest/README[]
include::../features.in/volumes/README[]
include::../features.in/wireless/README[]
include::../features.in/x11-autologin/README[]
include::../features.in/x11-autostart/README[]
include::../features.in/x11/README[]
include::../features.in/x11-vnc/README[]
include::../features.in/xdg-user-dirs/README[]
include::../sub.in/README[] include::../sub.in/README[]
include::../sub.in/main/README[] include::../sub.in/main/README[]
......
=== features.in/00example ===
Этот каталог содержит "заготовку" фичи в качестве примера Этот каталог содержит "заготовку" фичи в качестве примера
и должен дать представление о том, какой код _может_ быть и должен дать представление о том, какой код _может_ быть
включён в настоящую фичу: статические файлы, два makefile включён в настоящую фичу: статические файлы, два makefile
......
=== features.in/apt-conf ===
Данная фича определяет то, какая конфигурация apt попадёт в образ. Данная фича определяет то, какая конфигурация apt попадёт в образ.
Настраивает систему для Raspberry Pi 4 === features.in/arm-rpi4 ===
Настраивает систему для Raspberry Pi 4.
=== features.in/armh-mcom02 ===
Фича предназначена для обеспечения поддержки процессорного модуля Фича предназначена для обеспечения поддержки процессорного модуля
"ЭЛВИС Салют ЭЛ24ПМ2". Подробнее: http://altlinux.org/mcom02 "ЭЛВИС Салют ЭЛ24ПМ2".
Подробнее: https://altlinux.org/mcom02
=== features.in/bootloader ===
Добавление установки загрузчика основной системы, затребованного Добавление установки загрузчика основной системы, затребованного
посредством указания "grub", "lilo" или "uboot" в BASE_BOOTLOADER. посредством указания "grub", "lilo" или "uboot" в BASE_BOOTLOADER.
......
=== features.in/branding ===
Эта фича врезается в makefile субпрофилей и обеспечивает Эта фича врезается в makefile субпрофилей и обеспечивает
добавление задающих внешний вид и сообщения дистрибутива добавление задающих внешний вид и сообщения дистрибутива
пакетов; см. тж. http://www.altlinux.org/Branding пакетов; см. тж. https://www.altlinux.org/Branding
Реализация "двумерная" -- отдельно задаётся BRANDING Реализация "двумерная" -- отдельно задаётся BRANDING
(см. пакеты branding-*-%version-%release.src.rpm), (см. пакеты branding-*-%version-%release.src.rpm),
......
=== features.in/browser ===
Эта фича обеспечивает наличие и конкретизацию выбора браузера. Эта фича обеспечивает наличие и конкретизацию выбора браузера.
Разумеется, дополнительные варианты могут быть установлены Разумеется, дополнительные варианты могут быть установлены
явным или косвенным затребованием. явным или косвенным затребованием.
......
=== features.in/build-distro ===
Эта фича конфигурирует создание образа дистрибутива, включая работу Эта фича конфигурирует создание образа дистрибутива, включая работу
с субпрофилями -- которая сейчас нужна только дистрибутивным целям. с субпрофилями -- которая сейчас нужна только дистрибутивным целям.
......
=== features.in/build-ve ===
Эта фича конфигурирует создание образа виртуального окружения (VE), Эта фича конфигурирует создание образа виртуального окружения (VE),
что используется для сборки шаблонов OpenVZ и ARM-чрутов для TWRP. что используется для сборки шаблонов OpenVZ и ARM-чрутов для TWRP.
......
=== features.in/build-vm ===
Эта фича конфигурирует создание образа виртуальной машины (VM) Эта фича конфигурирует создание образа виртуальной машины (VM)
или тарбола rootfs для использования его на реальном компьютере. или тарбола rootfs для использования его на реальном компьютере.
Дополняет финальную стадию сборки (lib/, image-scripts.d/). Дополняет финальную стадию сборки (lib/, image-scripts.d/).
......
=== features.in/cleanup ===
Эта фича вместо созидания занимается выкидыванием лишнего Эта фича вместо созидания занимается выкидыванием лишнего
(например, части модулей инсталятора из установленной системы). (например, части модулей инсталятора из установленной системы).
...@@ -12,5 +14,5 @@ CLEANUP_BASE_PACKAGES. ...@@ -12,5 +14,5 @@ CLEANUP_BASE_PACKAGES.
Для удаления пакетов только из livecd используйте переменную Для удаления пакетов только из livecd используйте переменную
CLEANUP_LIVE_PACKAGES. CLEANUP_LIVE_PACKAGES.
ВНИМАНИЕ: также удаляет rpm, apt и базу по пакетам из livecd, CAUTION: также удаляет rpm, apt и базу по пакетам из livecd,
если в него не был добавлен инсталятор! если в него не был добавлен инсталятор!
=== features.in/control ===
Эта фича предоставляет интерфейс для конфигурирования дистрибутивных Эта фича предоставляет интерфейс для конфигурирования дистрибутивных
значений по умолчанию control(8); см. тж. http://altlinux.org/control значений по умолчанию control(8).
См. тж.:
https://www.altlinux.org/Control
=== features.in/deflogin ===
Эта фича конфигурирует root login и пользователей по умолчанию. Эта фича конфигурирует root login и пользователей по умолчанию.
Если ROOTPW не задан, то подходящий пароль не существует. Если ROOTPW не задан, то подходящий пароль не существует.
При необходимости задать пустой пароль root (например, на LiveCD) При необходимости задать пустой пароль root (например, на LiveCD)
выставьте переменную ROOTPW_EMPTY в значение "1". выставьте переменную ROOTPW_EMPTY в значение "1".
ВНИМАНИЕ: применяйте разумно, т.к. крайне легко создать и оставить CAUTION: применяйте разумно, т.к. крайне легко создать и оставить
дыру в безопасности! дыру в безопасности!
В версии mkimage-profiles 1.4.4 появилась возможность создать пользователя В версии mkimage-profiles 1.4.4 появилась возможность создать пользователя
с произвольными uid, gid, домашним каталогом, интерпретатором shell и т.д. с произвольными uid, gid, домашним каталогом, интерпретатором shell и т.д.
Используйте для этого следующую конструкцию: Используйте для этого следующую конструкцию:
@$(call set,SPEC_USER,имя_пользователя:группа:uid:gid:home_dir:shell) @$(call set,SPEC_USER,имя_пользователя:группа:uid:gid:home_dir:shell)
Например: Например:
@$(call set,SPEC_USER,user:user:500:500:/home/user:/bin/bash) @$(call set,SPEC_USER,user:user:500:500:/home/user:/bin/bash)
При этом нужно иметь в виду, что будет создана соответствующая группа с При этом нужно иметь в виду, что будет создана соответствующая группа с
соответствующим gid (нужно быть уверенным, что одноимённая группа не сущетсвует), соответствующим gid (нужно быть уверенным, что одноимённая группа не сущетсвует),
......
=== features.in/dev ===
Эта фича служит для создания образов, предназначающихся для разработки. Эта фича служит для создания образов, предназначающихся для разработки.
В первую очередь обеспечивается развёртывание hasher и mkimage. В первую очередь обеспечивается развёртывание hasher и mkimage.
......
=== features.in/docs ===
Эта фича добавляет в образ распакованную документацию дистрибутива, Эта фича добавляет в образ распакованную документацию дистрибутива,
а именно вводную страничку (входит в пакет branding-*-indexhtml), а именно вводную страничку (входит в пакет branding-*-indexhtml),
и/или специфичное для данного продукта руководство из пакета docs-* и/или специфичное для данного продукта руководство из пакета docs-*
...@@ -8,5 +10,5 @@ ...@@ -8,5 +10,5 @@
языка (при наличии index-LL.html), поэтому ожидается задействование языка (при наличии index-LL.html), поэтому ожидается задействование
фичи l10n с соответствующим указанием языка по умолчанию. фичи l10n с соответствующим указанием языка по умолчанию.
NB: предполагается применение при формировании ISO-образов, NOTE: предполагается применение при формировании ISO-образов,
другие случаи наверняка потребуют доработки. другие случаи наверняка потребуют доработки.
=== features.in/domain-client ===
Эта фича конфигурирует поддержку клиента домена ALT Linux. Эта фича конфигурирует поддержку клиента домена ALT Linux.
krb5-ticket-watcher применяется для отладки либо обновления krb5-ticket-watcher применяется для отладки либо обновления
билетов при нехватке сконфигурированного по умолчанию (сутки) билетов при нехватке сконфигурированного по умолчанию (сутки)
либо указанного администратором времени жизни таковых. либо указанного администратором времени жизни таковых.
NB: не проверено на инсталяторах! NOTE: не проверено на инсталяторах!
=== features.in/dos ===
Фича добавляет создание FreeDOS "live floppy" в stage1. Фича добавляет создание FreeDOS "live floppy" в stage1.
Текущее состояние -- загружается минимальная система. Текущее состояние -- загружается минимальная система.
......
=== features.in/drm ===
Фича drm решает задачу создания общей точки входа для Фича drm решает задачу создания общей точки входа для
добавления drm-модулей ядра для разных списков пакетов. добавления drm-модулей ядра для разных списков пакетов.
Потребность выделения в отдельную фичу возникла с одной Потребность выделения в отдельную фичу возникла с одной
......
=== features.in/e2k ===
Эта фича содержит необходимое для поддержки систем архитектуры "Эльбрус". Эта фича содержит необходимое для поддержки систем архитектуры "Эльбрус".
=== features.in/efi ===
Фича добавляет в образы необходимое для поддержки EFI/UEFI. Фича добавляет в образы необходимое для поддержки EFI/UEFI.
Конфигурируется заданием загрузчика (EFI_BOOTLOADER) Конфигурируется заданием загрузчика (EFI_BOOTLOADER)
...@@ -5,6 +7,9 @@ ...@@ -5,6 +7,9 @@
пример использования доступен в conf.d/regular.mk пример использования доступен в conf.d/regular.mk
См. тж.: См. тж.:
* http://www.altlinux.org/UEFI
* http://www.rodsbooks.com/efi-bootloaders/ * https://www.altlinux.org/UEFI
* https://www.rodsbooks.com/efi-bootloaders/
* https://bugzilla.altlinux.org/showdependencytree.cgi?id=27804 * https://bugzilla.altlinux.org/showdependencytree.cgi?id=27804
=== features.in/firmware ===
Эта фича добавляет комплекты различного firmware в инсталятор, Эта фича добавляет комплекты различного firmware в инсталятор,
устанавливаемую систему и т.п. устанавливаемую систему и т.п.
......
=== features.in/fonts ===
Эта фича позволяет системно конфигурировать файлы Эта фича позволяет системно конфигурировать файлы
конфигурации подсистемы конфигурирования шрифтов конфигурации подсистемы конфигурирования шрифтов
fontconfig (sic!), заодно предоставляя прошедшие fontconfig (sic!), заодно предоставляя прошедшие
......
=== features.in/gitlab-runner ===
This feature installs gitlab-runner according official guide [1] This feature installs gitlab-runner according official guide [1]
The following envs can be altered: The following envs can be altered:
...@@ -9,5 +11,7 @@ NOTE: this feature depends on network enablement in hasher (see [2] for details) ...@@ -9,5 +11,7 @@ NOTE: this feature depends on network enablement in hasher (see [2] for details)
and mkimage [3] and mkimage [3]
1. https://docs.gitlab.com/runner/install/linux-manually.html 1. https://docs.gitlab.com/runner/install/linux-manually.html
2. https://bugzilla.altlinux.org/34596 2. https://bugzilla.altlinux.org/34596
3. https://git.altlinux.org/people/legion/packages/mkimage.git?p=mkimage.git;a=commitdiff;h=6e90f032f15f89de1c2c523a725e369ab6cad1a0
3. https://git.altlinux.org/gears/m/mkimage.git?p=mkimage.git;a=commit;h=242549e3a01306e4539757e2129ea39f5a199b90
=== features.in/grub ===
Добавление поддержки grub; требуется для инсталяторов, live/rescue; Добавление поддержки grub; требуется для инсталяторов, live/rescue;
реализуется в рамках stage1. реализуется в рамках stage1.
...@@ -5,19 +7,29 @@ ...@@ -5,19 +7,29 @@
изучение кусочков конфигурации, которые уже существуют. изучение кусочков конфигурации, которые уже существуют.
Цели config.mk: Цели config.mk:
* use/grub/ui/% -- конфигурирование интерфейса (см. cfg.in/01gfxterm.cfg); * use/grub/ui/% -- конфигурирование интерфейса (см. cfg.in/01gfxterm.cfg);
при использовании автоматически добавляют grub в FEATURES; при использовании автоматически добавляют grub в FEATURES;
* use/grub/timeout/% -- задание таймаута автозагрузки (в секундах); * use/grub/timeout/% -- задание таймаута автозагрузки (в секундах);
* use/grub/%.cfg -- подключение кусочков конфигурации. * use/grub/%.cfg -- подключение кусочков конфигурации.
Переменные generate.mk: Переменные generate.mk:
* BOOTARGS -- дополнительные аргументы загрузчику; * BOOTARGS -- дополнительные аргументы загрузчику;
* EFI_BOOTARGS -- дополнительные аргументы загрузчику; * EFI_BOOTARGS -- дополнительные аргументы загрузчику;
* BOOTLOADER -- isolinux (реализовано с оглядкой на grub/grub4); * BOOTLOADER -- isolinux (реализовано с оглядкой на grub/grub4);
* BOOTVGA -- видеорежим, запрашиваемый у ядра (параметр vga=); * BOOTVGA -- видеорежим, запрашиваемый у ядра (параметр vga=);
* GRUB_UI -- тип интерфейса (если указан gfxboot, то графический, * GRUB_UI -- тип интерфейса (если указан gfxboot, то графический,
иначе текстовый); иначе текстовый);
* GRUB_CFG -- дополнительные кусочки конфигурации (например, live_rw); * GRUB_CFG -- дополнительные кусочки конфигурации (например, live_rw);
* GRUBTHEME -- имя темы grub, если не задана, то получает значение BRANDING * GRUBTHEME -- имя темы grub, если не задана, то получает значение BRANDING
за вычетом традиционной приставки alt-). за вычетом традиционной приставки alt-).
...@@ -32,7 +44,8 @@ ...@@ -32,7 +44,8 @@
Установить дефолтный пункт: Установить дефолтный пункт:
Для того, чтобы установить конкретный дефолтный пункт Для того, чтобы установить конкретный дефолтный пункт
(пример для LiveCD без поддержки сессии): (пример для LiveCD без поддержки сессии):
@$(call set,GRUB_DEFAULT,live)
@$(call set,GRUB_DEFAULT,live)
Именем дефолтного пункта является --id. Именем дефолтного пункта является --id.
...@@ -40,9 +53,10 @@ ...@@ -40,9 +53,10 @@
На ESP-разделе образа можно отредактировать конфиг EFI/BOOT/grub.cfg, На ESP-разделе образа можно отредактировать конфиг EFI/BOOT/grub.cfg,
добавив в его начало: добавив в его начало:
GRUB_TERMINAL='console' GRUB_TERMINAL='console'
Если нужно включить последовательную консоль, пропишите в нём: Если нужно включить последовательную консоль, пропишите в нём:
GRUB_TERMINAL='console serial' GRUB_TERMINAL='console serial'
GRUB_SERIAL_COMMAND='serial --unit=0 --speed=115200'
GRUB_SERIAL_COMMAND='serial --unit=0 --speed=115200'
=== features.in/hdt ===
Добавление модуля hdt (Hardware Detection Tool) к syslinux; Добавление модуля hdt (Hardware Detection Tool) к syslinux;
может быть востребовано для инсталяторов, live/rescue. может быть востребовано для инсталяторов, live/rescue.
......
=== features.in/homeros ===
Каталог содержит основную feature для создания адаптированного Каталог содержит основную feature для создания адаптированного
дистрибутива Homeros. Это промежуточный вариант, при помощи которого дистрибутива Homeros. Это промежуточный вариант, при помощи которого
можно получить минимальный разговаривающий образ, но, возможно, помимо можно получить минимальный разговаривающий образ, но, возможно, помимо
......
=== features.in/im ===
Эта фича добавляет средства настройки методов ввода (Input Methods). Эта фича добавляет средства настройки методов ввода (Input Methods).
На данный момент является экспериментальной, приветствуется помощь На данный момент является экспериментальной, приветствуется помощь
......
=== features.in/init ===
Эта фича определяет систему инициализации, которая будет использована Эта фича определяет систему инициализации, которая будет использована
в пользовательской среде (livecd, установленный дистрибутив, vm). в пользовательской среде (livecd, установленный дистрибутив, vm).
Она не влияет на состав инсталятора и rescue-образа. Она не влияет на состав инсталятора и rescue-образа.
...@@ -7,5 +9,7 @@ ...@@ -7,5 +9,7 @@
считается достигнутой и при последующих вызовах не отрабатывает. считается достигнутой и при последующих вызовах не отрабатывает.
См. тж.: См. тж.:
http://altlinux.org/sysvinit
http://altlinux.org/systemd https://www.altlinux.org/Sysvinit
https://www.altlinux.org/Systemd
=== features.in/initrd-bootchain ===
Осуществляется сборка initrd.img при помощи make-initrd с включенными фичами Осуществляется сборка initrd.img при помощи make-initrd с включенными фичами
bootchain. Это альтернатива фичи initrd-propagator. Используется тот же список bootchain. Это альтернатива фичи initrd-propagator. Используется тот же список
модулей ядра, что и при сборке с propagator, но в отличие от последнего модули модулей ядра, что и при сборке с propagator, но в отличие от последнего модули
добавляются в initrd.img самим make-initrd. добавляются в initrd.img самим make-initrd.
Документацию по использованию bootchain следует смотреть в пакетах Документацию по использованию bootchain следует смотреть в пакетах
make-initrd-bootchain-*: make-initrd-bootchain-*:
/usr/share/make-initrd/features/bootchain-*/README.md
/usr/share/make-initrd/features/bootchain-*/README.md
Конфиг находится в stage1/files/bootchain. Почти все переменные можно Конфиг находится в stage1/files/bootchain. Почти все переменные можно
переопределить. Переменные в m-p по сравнению с конфигом bootchain переопределить. Переменные в m-p по сравнению с конфигом bootchain
имеют приставку 'BOOTCHAIN_'. Дефолты заданы в config.mk имеют приставку 'BOOTCHAIN_'. Дефолты заданы в config.mk
Переопределить можно так: Переопределить можно так:
$(call set,BOOTCHAIN_OEM_WELCOME_TEXT,Welcome to my OS!) $(call set,BOOTCHAIN_OEM_WELCOME_TEXT,Welcome to my OS!)
=== features.in/initrd-propagator ===
Добавляется поддержка propagator. propagator обеспечивает первую стадию загрузчика. Добавляется поддержка propagator. propagator обеспечивает первую стадию загрузчика.
Ранее был неотъемлемой частью субпрофиля stage1. Был вынесен в фичу для обеспечения Ранее был неотъемлемой частью субпрофиля stage1. Был вынесен в фичу для обеспечения
возожности собирать образы с использованием специально собранного initrd вместо него. возожности собирать образы с использованием специально собранного initrd вместо него.
=== features.in/install2 ===
Эта фича дополняет базовый "живой" образ второй стадии Эта фича дополняет базовый "живой" образ второй стадии
специфическими для инсталяционного образа настройками специфическими для инсталяционного образа настройками
и скриптовыми хуками. и скриптовыми хуками.
......
=== features.in/isohybrid ===
Эта фича обеспечивает формирование ISO-образа с добавлением липовой Эта фича обеспечивает формирование ISO-образа с добавлением липовой
таблицы разделов с целью обеспечения возможности его загрузки таблицы разделов с целью обеспечения возможности его загрузки
как с CD/DVD, так и с USB-флэшки. как с CD/DVD, так и с USB-флэшки.
......
=== features.in/kernel ===
Эта фича привносит код, имеющий смысл при добавлении в образ ядра, Эта фича привносит код, имеющий смысл при добавлении в образ ядра,
и задаёт начальный вариант такового. и задаёт начальный вариант такового.
......
=== features.in/l10n ===
Эта фича занимается поддержкой локализации (l10n). Эта фича занимается поддержкой локализации (l10n).
=== features.in/ldm ===
Simple hook to run Linux Driver Management tools to configure hybrid graphics Simple hook to run Linux Driver Management tools to configure hybrid graphics
(aka Optimus/PRIME) for different DM's. (aka Optimus/PRIME) for different DM's.
......
=== features.in/live-install ===
Эта фича дополняет live образ второй стадии специфическими Эта фича дополняет live образ второй стадии специфическими
для инсталяционного образа настройками и скриптовыми хуками. для инсталяционного образа настройками и скриптовыми хуками.
...@@ -10,7 +12,9 @@ ...@@ -10,7 +12,9 @@
инсталятора с целью уменьшить общий объём iso-образа. инсталятора с целью уменьшить общий объём iso-образа.
Установка состоит и двух этапов: Установка состоит и двух этапов:
1. Распаковывается образ live, как в livecd-install 1. Распаковывается образ live, как в livecd-install
2. Устанавливаются дополнительные пакеты BASE_PACKAGES и 2. Устанавливаются дополнительные пакеты BASE_PACKAGES и
группы пакетов THE_GROUPS, как в install2. группы пакетов THE_GROUPS, как в install2.
......
=== features.in/live ===
Эта фича дополняет базовый "живой" образ второй стадии Эта фича дополняет базовый "живой" образ второй стадии
специфическими для полноценного LiveCD настройками специфическими для полноценного LiveCD настройками
и скриптовыми хуками, а также создаёт файл index.html и скриптовыми хуками, а также создаёт файл index.html
......
=== features.in/lowmem ===
Эта фича дополняет зачистку "живой" стадии инсталятора Эта фича дополняет зачистку "живой" стадии инсталятора
с тем, чтобы уменьшить её размер и требования к памяти. с тем, чтобы уменьшить её размер и требования к памяти.
=== features.in/ltsp ===
Эта фича обеспечивает добавление функций терминального сервера: Эта фича обеспечивает добавление функций терминального сервера:
- загрузку бездисковых тонких клиентов по сети; - загрузку бездисковых тонких клиентов по сети;
- предоставление им доступа к серверу приложений. - предоставление им доступа к серверу приложений.
На данный момент является экспериментальной. На данный момент является экспериментальной.
=== features.in/luks ===
Эта секретная фича добавляет в инсталяторы поддержку Эта секретная фича добавляет в инсталяторы поддержку
шифрования файловых систем с помощью LUKS при их создании. шифрования файловых систем с помощью LUKS при их создании.
=== features.in/lxc-guest ===
Adds systemd generators needed to run lxd container. Adds systemd generators needed to run lxd container.
=== features.in/lxc ===
Эта фича предназначена для создания контейнеров LXC и LXD. Эта фича предназначена для создания контейнеров LXC и LXD.
=== features.in/mediacheck ===
Эта фича конфигурирует внедрение контрольной суммы в образ Эта фича конфигурирует внедрение контрольной суммы в образ
инсталятора после его сборки с целью проверки целостности инсталятора после его сборки с целью проверки целостности
на ранней стадии установки. на ранней стадии установки.
......
=== features.in/memclean ===
Эта фича добавляет и включает очистку освобождаемой памяти Эта фича добавляет и включает очистку освобождаемой памяти
средствами zmalloc (через LD_PRELOAD). средствами zmalloc (через LD_PRELOAD).
=== features.in/memtest ===
Добавление memtest86+ в загрузку с образа и в устанавливаемую пакетную базу; Добавление memtest86+ в загрузку с образа и в устанавливаемую пакетную базу;
востребовано для инсталяторов, live/rescue. Интегрируется с syslinux. востребовано для инсталяторов, live/rescue. Интегрируется с syslinux.
=== features.in/metadata ===
Эта фича занимается метаданными в составе образов -- Эта фича занимается метаданными в составе образов --
в первую очередь инсталяционных и пригодных к установке в первую очередь инсталяционных и пригодных к установке
"живых". "живых".
......
=== features.in/mipsel-bfk3 ===
Фича предназначена для создания образа прошивки для отладочной платы BFK3.1. Фича предназначена для создания образа прошивки для отладочной платы BFK3.1.
https://www.altlinux.org/BFK3.1 https://www.altlinux.org/BFK3.1
=== features.in/mipsel-mitx ===
Фича предназначена для создания прошивки для компьютера "Таволга Терминал". Фича предназначена для создания прошивки для компьютера "Таволга Терминал".
https://www.altlinux.org/Ports/mipsel/Прошивка_образа_в_формате_recovery.tar_на_Таволга_Терминал https://www.altlinux.org/Ports/mipsel/Прошивка_образа_в_формате_recovery.tar_на_Таволга_Терминал
=== features.in/net-dns ===
Эта фича позволяет сконфигурировать публично доступный Эта фича позволяет сконфигурировать публично доступный
рекурсивный DNS-сервер для условий, когда локальный рекурсивный DNS-сервер для условий, когда локальный
неизвестен заранее или попросту отсутствует; следует неизвестен заранее или попросту отсутствует; следует
......
=== features.in/net-eth ===
Эта фича позволяет задать конфигурацию Ethernet-интерфейсов. Эта фича позволяет задать конфигурацию Ethernet-интерфейсов.
udev-rule-generator-net штатно добавляется для обеспечения udev-rule-generator-net штатно добавляется для обеспечения
......
=== features.in/net-ssh ===
Эта фича предназначена для добавления в образ поддержки SSH: Эта фича предназначена для добавления в образ поддержки SSH:
добавляется клиент и конфигурируется сервер (требуется задание добавляется клиент и конфигурируется сервер (требуется задание
пути к существующему публичному ключу посредством переменной SSH_KEY). пути к существующему публичному ключу посредством переменной SSH_KEY).
=== features.in/net-usershares ===
Эта фича выполняет предварительное конфигурирование системы Эта фича выполняет предварительное конфигурирование системы
для работы плагинов файл-менеджеров, реализующих взаимодействие для работы плагинов файл-менеджеров, реализующих взаимодействие
с Samba-сервером для динамического создания разделяемых файловых с Samba-сервером для динамического создания разделяемых файловых
......
=== features.in/net ===
Эта фича конфигурирует базовую поддержку сети, включая нужную подсистему Эта фича конфигурирует базовую поддержку сети, включая нужную подсистему
(etcnet, NetworkManager поверх etcnet или connman). (etcnet, NetworkManager поверх etcnet или connman).
......
=== features.in/no-sleep ===
Эта фича отключает спящий и ждущий режимы, а также гибернацию. Эта фича отключает спящий и ждущий режимы, а также гибернацию.
Нужна для одноплатных компьютеров вроде Raspberry Pi, Нужна для одноплатных компьютеров вроде Raspberry Pi,
не поддерживающих их. не поддерживающих их.
=== features.in/ntp ===
Эта фича конфигурирует службу NTP в качестве клиента Эта фича конфигурирует службу NTP в качестве клиента
с целью предоставления точного времени в составе LiveCD; с целью предоставления точного времени в составе LiveCD;
для установленных систем рекомендуется применение модуля для установленных систем рекомендуется применение модуля
......
=== features.in/oem ===
Эта фича обеспечивает автоматический запуск предварительной настройки, Эта фича обеспечивает автоматический запуск предварительной настройки,
характерный для OEM-образов. характерный для OEM-образов.
== Переназначение шагов alterator-setup ==
Дефолтные шаги определяются в файле /etc/alterator-setup/steps. Дефолтные шаги определяются в файле /etc/alterator-setup/steps.
Его дефолтное содержание: Его дефолтное содержание:
sysconfig sysconfig
......
=== features.in/office ===
Эта фича обеспечивает наличие и конкретизацию выбора офисного Эта фича обеспечивает наличие и конкретизацию выбора офисного
пакета по аналогии с выбором браузера. Разумеется, дополнительные пакета по аналогии с выбором браузера. Разумеется, дополнительные
варианты могут быть установлены явным или косвенным затребованием. варианты могут быть установлены явным или косвенным затребованием.
......
=== features.in/pack ===
Эта фича определяет формат упаковки создаваемого образа. Эта фича определяет формат упаковки создаваемого образа.
На данный момент поддерживаются iso (загрузочный ISO9660 На данный момент поддерживаются iso (загрузочный ISO9660
......
=== features.in/pid1 ===
Эта экспериментальная фича предназначена для обеспечения запуска Эта экспериментальная фича предназначена для обеспечения запуска
заданного приложения в моно^Wкачестве единственного, т.е. PID 1. заданного приложения в моно^Wкачестве единственного, т.е. PID 1.
Особенности результата: Особенности результата:
- предельно быстрый запуск; - предельно быстрый запуск;
- работа под root; - работа под root;
- отсутствие какой бы то ни было инициализации окружения. - отсутствие какой бы то ни было инициализации окружения.
Возможна настройка сетевых интерфейсов средствами ядра, условия: Возможна настройка сетевых интерфейсов средствами ядра, условия:
- статически собранный модуль для используемого интерфейса; - статически собранный модуль для используемого интерфейса;
- доступность DHCP/BOOTP/RARP в сегменте локальной сети. - доступность DHCP/BOOTP/RARP в сегменте локальной сети.
Пакет следует добавить в STAGE1_PACKAGES; путь к бинарнику Пакет следует добавить в STAGE1_PACKAGES; путь к бинарнику
......
=== features.in/pkgpriorities ===
Эта фича обеспечивает добавление записей в файл Эта фича обеспечивает добавление записей в файл
`$(PKGBOX)/aptbox/etc/apt/pkgpriorities` `$(PKGBOX)/aptbox/etc/apt/pkgpriorities`
после инициализации чрута, но перед установкой пакетов. после инициализации чрута, но перед установкой пакетов.
......
=== features.in/plymouth ===
Эта фича предназначена для добавления поддержки plymouth Эта фича предназначена для добавления поддержки plymouth
-- современной реализации bootsplash. Плотно взаимодействует -- современной реализации bootsplash. Плотно взаимодействует
с фичей branding по объективным причинам, но оформлена отдельно с фичей branding по объективным причинам, но оформлена отдельно
......
=== features.in/power ===
Эта фича конфигурирует поддержку управления питанием Эта фича конфигурирует поддержку управления питанием
-- выключение и регулировку частоты CPU для ACPI, -- выключение и регулировку частоты CPU для ACPI,
засыпание для APM (не проверялось). засыпание для APM (не проверялось).
=== features.in/relname ===
Эта фича меняет содержимое файла /etc/altlinux-release в соответствии Эта фича меняет содержимое файла /etc/altlinux-release в соответствии
с установленной переменной RELNAME, что изменяет пункты загрузки GRUB. с установленной переменной RELNAME, что изменяет пункты загрузки GRUB.
......
=== features.in/repo ===
Эта фича предназначена для конфигурирования репозиториев Эта фича предназначена для конфигурирования репозиториев
в образе, включая генерацию хэшей и подключение к LiveCD. в образе, включая генерацию хэшей и подключение к LiveCD.
......
=== features.in/rescue ===
Эта фича дополняет базовый "живой" образ второй стадии Эта фича дополняет базовый "живой" образ второй стадии
специфическими для спасательного образа настройками специфическими для спасательного образа настройками
и скриптовыми хуками. и скриптовыми хуками.
......
=== features.in/server ===
Эта фича предоставляет типичные для серверных образов Эта фича предоставляет типичные для серверных образов
наборы списков пакетов и модулей ядра. наборы списков пакетов и модулей ядра.
=== features.in/services ===
Данная фича конфигурирует автоматический запуск сервисов Данная фича конфигурирует автоматический запуск сервисов
при загрузке системы. при загрузке системы.
......
=== features.in/slinux ===
Наборы пакетов для семейства дистрибутивов Simply Linux. Наборы пакетов для семейства дистрибутивов Simply Linux.
=== features.in/sound ===
Эта фича добавляет поддержку аудиоподсистемы (как ядерную, Эта фича добавляет поддержку аудиоподсистемы (как ядерную,
если не включена в kernel-image, так и утилиты). если не включена в kernel-image, так и утилиты).
=== features.in/speech ===
Эта фича полностью подготавливает русскоязычный или англоязычный Эта фича полностью подготавливает русскоязычный или англоязычный
вывод речи на базе сервера VoiceMan. вывод речи на базе сервера VoiceMan.
=== features.in/stage2 ===
Эта фича служит для добавления в первую стадию хуков, необходимых Эта фича служит для добавления в первую стадию хуков, необходимых
при наличии в stage1 ядра (что типично, но не обязательно). при наличии в stage1 ядра (что типично, но не обязательно).
......
=== features.in/syslinux ===
Добавление поддержки syslinux; требуется для инсталяторов, live/rescue; Добавление поддержки syslinux; требуется для инсталяторов, live/rescue;
реализуется в рамках stage1. реализуется в рамках stage1.
...@@ -6,19 +8,29 @@ ...@@ -6,19 +8,29 @@
конфигурации, которые уже существуют. конфигурации, которые уже существуют.
Цели config.mk: Цели config.mk:
* use/syslinux/ui/% -- конфигурирование интерфейса (см. cfg.in/00*.cfg); * use/syslinux/ui/% -- конфигурирование интерфейса (см. cfg.in/00*.cfg);
при использовании автоматически добавляют syslinux в FEATURES; при использовании автоматически добавляют syslinux в FEATURES;
* use/syslinux/timeout/% -- задание таймаута автозагрузки (в десятых секунды); * use/syslinux/timeout/% -- задание таймаута автозагрузки (в десятых секунды);
* use/syslinux/%.com, use/syslinux/%.c32 -- подключение одноименных модулей * use/syslinux/%.com, use/syslinux/%.c32 -- подключение одноименных модулей
(копирование бинарников и включение кусочков конфигурации; экспериментальное); (копирование бинарников и включение кусочков конфигурации; экспериментальное);
* use/syslinux/%.cfg -- подключение кусочков конфигурации. * use/syslinux/%.cfg -- подключение кусочков конфигурации.
Переменные generate.mk: Переменные generate.mk:
* BOOTARGS -- дополнительные аргументы загрузчику; * BOOTARGS -- дополнительные аргументы загрузчику;
* BOOTLOADER -- isolinux (реализовано с оглядкой на syslinux/syslinux4); * BOOTLOADER -- isolinux (реализовано с оглядкой на syslinux/syslinux4);
* BOOTVGA -- видеорежим, запрашиваемый у ядра (параметр vga=); * BOOTVGA -- видеорежим, запрашиваемый у ядра (параметр vga=);
* SYSLINUX_UI -- модуль интерфейса (если не указан, то внутренний prompt); * SYSLINUX_UI -- модуль интерфейса (если не указан, то внутренний prompt);
* SYSLINUX_MODULES -- модули .com или .c32 (перечисляются без расширения); * SYSLINUX_MODULES -- модули .com или .c32 (перечисляются без расширения);
* SYSLINUX_CFG -- дополнительные кусочки конфигурации (например, localboot). * SYSLINUX_CFG -- дополнительные кусочки конфигурации (например, localboot).
Здесь производится первичная обработка конфигурационных данных, Здесь производится первичная обработка конфигурационных данных,
...@@ -31,6 +43,7 @@ ...@@ -31,6 +43,7 @@
Установить дефолтный пункт: Установить дефолтный пункт:
Для того, чтобы установить конкретный дефолтный пункт (пример для LiveCD с поддержкой сессии): Для того, чтобы установить конкретный дефолтный пункт (пример для LiveCD с поддержкой сессии):
@$(call set,SYSLINUX_DEFAULT,session)
@$(call set,SYSLINUX_DEFAULT,session)
Именем дефолтного пункта является LABEL. Именем дефолтного пункта является LABEL.
=== features.in/tty ===
Эта фича занимается терминалами ввода-вывода, в первую очередь Эта фича занимается терминалами ввода-вывода, в первую очередь
COM-портами (serial console). COM-портами (serial console).
......
=== features.in/uboot ===
Настраивает систему для использования загрузчика uboot. Настраивает систему для использования загрузчика uboot.
=== features.in/uuid-iso ===
По умолчанию при сборке образа xorriso генерирует UUID образа По умолчанию при сборке образа xorriso генерирует UUID образа
вида YYYY-MM-DD-hh-mm-ss-cc из текущего времени. вида YYYY-MM-DD-hh-mm-ss-cc из текущего времени.
Если в командной строке xorriso есть пареметр Если в командной строке xorriso есть пареметр
......
=== features.in/vagrant ===
Эта фича обеспечивает специфичную для vagrant предварительную Эта фича обеспечивает специфичную для vagrant предварительную
настройку образа файловой системы виртуальной машины. настройку образа файловой системы виртуальной машины.
...@@ -6,6 +8,7 @@ ...@@ -6,6 +8,7 @@
- "секретный" ключ от публичной части у пользователя vagrant. - "секретный" ключ от публичной части у пользователя vagrant.
См. тж.: См. тж.:
http://bugzilla.altlinux.org/28553
http://docs.vagrantup.com/v2/boxes/base.html https://bugzilla.altlinux.org/28553
http://williamwalker.me/blog/creating-a-custom-vagrant-box.html
https://docs.vagrantup.com/v2/boxes/base.html
=== features.in/vmguest ===
Эта фича предназначена для конфигурирования поддержки выполнения Эта фича предназначена для конфигурирования поддержки выполнения
дистрибутивов в качестве гостей в среде виртуальных машин. дистрибутивов в качестве гостей в среде виртуальных машин.
=== features.in/volumes ===
Эта фича обеспечивает выставление нужного профиля разбивки дисков Эта фича обеспечивает выставление нужного профиля разбивки дисков
при установке с помощью installer или livecd-install. при установке с помощью installer или livecd-install.
=== features.in/wireless ===
Эта фича занимается добавлением поддержки беспроводных соединений. Эта фича занимается добавлением поддержки беспроводных соединений.
=== features.in/x11-autologin ===
Эта фича добавляет в формируемый пользовательский корень Эта фича добавляет в формируемый пользовательский корень
(как правило, live) функцию автоматического входа путём (как правило, live) функцию автоматического входа путём
конфигурирования отдельно запрошенного для установки конфигурирования отдельно запрошенного для установки
......
=== features.in/x11-autostart ===
Эта фича добавляет в формируемый пользовательский корень Эта фича добавляет в формируемый пользовательский корень
(как правило, live) функцию автоматического запуска (как правило, live) функцию автоматического запуска
графической сессии; обратите внимание, что автоматическим графической сессии; обратите внимание, что автоматическим
......
=== features.in/x11-vnc ===
This feature allows to use X11 through VNC server. It adds x11vnc package and This feature allows to use X11 through VNC server. It adds x11vnc package and
sets default password to alt. Another thing is that this feature adds dummy sets default password to alt. Another thing is that this feature adds dummy
video adapter configuration to the /etc/X11/xorg.conf.d/. x11vnc becomes video adapter configuration to the /etc/X11/xorg.conf.d/. x11vnc becomes
......
=== features.in/x11 ===
Эта фича добавляет базовую поддержку графической системы X11, Эта фича добавляет базовую поддержку графической системы X11,
а также комплектует типовые десктопные окружения и средства а также комплектует типовые десктопные окружения и средства
графического входа в систему. графического входа в систему.
......
=== features.in/xdg-user-dirs ===
Эта фича обеспечивает наличие "ручки" для конфигурирования Эта фича обеспечивает наличие "ручки" для конфигурирования
типовых пользовательских каталогов для нескольких типов данных типовых пользовательских каталогов для нескольких типов данных
и предоставляет возможность задавать предпочитаемые умолчания, и предоставляет возможность задавать предпочитаемые умолчания,
которые могут различаться по дистрибутивам; см. тж. которые могут различаться по дистрибутивам.
http://freedesktop.org/wiki/Software/xdg-user-dirs
См. тж.:
https://freedesktop.org/wiki/Software/xdg-user-dirs
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment