From e22a3d03f791f79f57e58b4b512f0f8af3f74a97 Mon Sep 17 00:00:00 2001 From: MiraMaX166 Date: Thu, 30 Mar 2023 13:33:46 +0600 Subject: [PATCH] update readme in project ubl-settings-bootloader --- ubl-settings-bootloader/README.md | 79 +++++++++++++++++++++++-------- 1 file changed, 59 insertions(+), 20 deletions(-) diff --git a/ubl-settings-bootloader/README.md b/ubl-settings-bootloader/README.md index 5546830..5113750 100644 --- a/ubl-settings-bootloader/README.md +++ b/ubl-settings-bootloader/README.md @@ -99,12 +99,14 @@ 1. лэйбл "Загрузка по умолчанию:". Статический элемент. Выравнивание по левому краю. 1. комбобокс с вариантами выбора ОС для загрузки. Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами. 1. чекбокс "Последний выбор станет выбором загрузки по умолчанию". Статический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами. + 1. лэйбл "Режим загрузки:". Статический элемент. Выравнивание по левому краю. + 1. комбобокс вариантов режима загрузки: "Анимация загрузки, полный лог", "Анимация загрузки, нет лога", Без анимации загрузки, полный лог", "Без анимации загрузки, минимальный лог". Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами. 1. лэйбл "Логин защиты:". Статический элемент. Выравнивание по левому краю. 1. комбобокс вариантов пароля защиты: "По умолчанию", "Свой". Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами. 1. поле ввода логина. Динамический элемент. Делит пространство с соседними элементами. Активно только если выбран пункт "Свой", если выбрано "По умолчанию" - поле неактивно, заполнено логином "superadmin". 1. лэйбл "Пароль защиты:". Статический элемент. Выравнивание по левому краю. 1. комбобокс вариантов пароля защиты: "По умолчанию", "Свой", "Отключен". Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами. - 1. поле ввода пароля (функция скрытого ввода). Динамический элемент. Делит пространство с соседними элементами. Активно только если выбран пункт "Свой". + 1. поле ввода пароля (функция скрытого ввода). Динамический элемент. Делит пространство с соседними элементами. Активно только если выбран пункт "Свой". Активно только если выбран пункт "Свой", если выбрано "По умолчанию" - поле неактивно, пароль по умолчанию "ublinux". 1. Блок с заголовком "Параметры, передаваемые ядру". Динамический элемент. От края до края окна по горизонтали. 1. Таблица со скроллбаром. Динамический элемент. От края до края родительского элемента по горизонтали. Заголовок: столбец "Активно" чекбоксы (на активацию опции), столбец "Опция", столбец "Значение". Содержимое: 1. чекбокс, quiet, Загрузка без текстовых сообщений @@ -168,9 +170,9 @@ https://wiki.ublinux.com/ru/Программное_обеспечение/Про 1. Поля "Параметры командной строки" заполняются автоматически при выборе необходимых параметров в таблицах соответствующих блоков (активация через чекбоксы), в поле передаётся название параметра и его значение (если значение имеется), разделение через пробел. 1. При удалении параметра из поля "Параметры командной строки" соответствующий параметр теряет свой статус активности (галочка снимается) в таблице соответствующего блока. 1. При редактировании (изменении) параметра в поле "Параметры командной строки" соответствующий параметр теряет свой статус активности (галочка снимается) в таблице соответствующего блока. - 1. Значения параметров, передаваемых ядру, берутся из файла /usr/share/ubl-sttings-bootloadr/boot-options.csv - 1. Значения параметров, терминала для ввода, берутся из файла /usr/share/ubl-sttings-bootloadr/input-options.csv - 1. Значения параметров, терминала для вывода, берутся из файла /usr/share/ubl-sttings-bootloadr/output-options.csv + 1. Значения параметров, передаваемых ядру, берутся из файла /usr/share/${NAME_APPLICATION}/boot-options.csv + 1. Значения параметров, терминала для ввода, берутся из файла /usr/share/${NAME_APPLICATION}/input-options.csv + 1. Значения параметров, терминала для вывода, берутся из файла /usr/share/${NAME_APPLICATION}/output-options.csv 1. Вывод файлов csv так же должен быть локализован средствами pot-, po-, mo- файлов. 1. **КОМАНДЫ** @@ -179,14 +181,23 @@ https://wiki.ublinux.com/ru/Программное_обеспечение/Про 1. Меню загрузки 1. Таймер выбора варианта загрузки: 1. Чтение значения: - 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config XXXXXX` - 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config XXXXXX` + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_TIMEOUT` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_TIMEOUT` 1. Установить значение: - 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config XXXXXX=$VALUE` - 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config XXXXXX=$VALUE` + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_TIMEOUT=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_TIMEOUT=$VALUE` где \$VALUE - параметр, цифровой, от 1 до 60. 1. Загрузка по умолчанию: 1. Должен быть получен список ОС и вариантов загрузки. + 1. Получить активный выбор: + 1. Чтение значения: + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_DEFAULT` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_DEFAULT` + 1. Задать параметр загрузки: + 1. Установить значение: + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_DEFAULT=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_DEFAULT=$VALUE` +где \$VALUE - параметр, строковый, получен из содержимого выбранной строки комбобокса выбора "Загрузка по умолчанию". 1. Последний выбор станет выбором загрузки по умолчанию: 1. Чтение значения: 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config XXXXXX` @@ -195,35 +206,63 @@ https://wiki.ublinux.com/ru/Программное_обеспечение/Про 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config XXXXXX=$VALUE` 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config XXXXXX=$VALUE` где \$VALUE - параметр, цифровой, 1 или 0. Указывает на включение или отключение данной опции. + 1. Режим загрузки: + 1. Чтение значения: + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_BOOT_SILENT` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_BOOT_SILENT` + 1. Установить значение: + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_BOOT_SILENT=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_BOOT_SILENT=$VALUE` +где \$VALUE - параметр, строковый. Соответствие: +*splash* - анимация загрузки, полный лог +*splash quiet ub.silent* - анимация загрузки, нет лога +*quiet ub.silent* - без анимации загрузки, минимальный лог +*plymouth.enable=0* - без анимации загрузки, полный лог + 1. Логин защиты: + 1. Чтение значения: + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_USER` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_USER` + 1. Установить значение: + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_USER=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_USER=$VALUE` +где \$VALUE - параметр, строковый. Если выбран параметр комбобокса "Свой" значение взять из поля "Логин защиты". Если параметр комбобокса выбран "По умолчанию" - \$VALUE="superadmin". + 1. Пароль защиты: + 1. Чтение значения: + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_PASSWORD` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_PASSWORD` + 1. Установить значение: + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_PASSWORD=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_PASSWORD=$VALUE` +где \$VALUE - параметр, строковый. Если выбран параметр комбобокса "Свой" значение взять из поля "Пароль защиты". Если параметр комбобокса выбран "По умолчанию" - \$VALUE="ublinux". 1. Параметры, передаваемые ядру 1. через функции фронтенда передавать выбранный параметр в поле "Параметры командной строки" блока "Параметры, передаваемые ядру" 1. Параметры командной строки: 1. Чтение значения: - 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config CMDLINE` - 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config CMDLINE` + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_CMDLINE_LINUX` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_CMDLINE_LINUX` 1. Установить значение: - 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config CMDLINE=$VALUE` - 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config CMDLINE=$VALUE` + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_CMDLINE_LINUX=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_CMDLINE_LINUX=$VALUE` где \$VALUE - перечень параметров, полученных исходя из выбранных опций в блоке "Параметры, передаваемые ядру", разделённых пробелом. 1. Терминал для ввода 1. через функции фронтенда передавать выбранный параметр в поле "Параметры командной строки" блока "Терминал для ввода" 1. Параметры командной строки: 1. Чтение значения: - 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config XXXXXX` - 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config XXXXXX` + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_TERMINAL_INPUT` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_TERMINAL_INPUT` 1. Установить значение: - 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config XXXXXX=$VALUE` - 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config XXXXXX=$VALUE` + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_TERMINAL_INPUT=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_TERMINAL_INPUT=$VALUE` где \$VALUE - перечень параметров, полученных исходя из выбранных опций в блоке "Терминал для ввода", разделённых пробелом. 1. Терминал для вывода 1. через функции фронтенда передавать выбранный параметр в поле "Параметры командной строки" блока "Терминал для вывода" 1. Параметры командной строки: 1. Чтение значения: - 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config XXXXXX` - 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config XXXXXX` + 1. из локального конфигурационного файла: `/usr/bin/ubconfig --default --source system get config GRUB_TERMINAL_OUTPUT` + 1. из глобального конфигурационного файла: `/usr/bin/ubconfig --default --source global get config GRUB_TERMINAL_OUTPUT` 1. Установить значение: - 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config XXXXXX=$VALUE` - 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config XXXXXX=$VALUE` + 1. в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set config GRUB_TERMINAL_OUTPUT=$VALUE` + 1. в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set config GRUB_TERMINAL_OUTPUT=$VALUE` где \$VALUE - перечень параметров, полученных исходя из выбранных опций в блоке "Терминал для вывода", разделённых пробелом. 1. **ПРИБЛИЗИТЕЛЬНЫЙ МАКЕТ ПРИЛОЖЕНИЯ.**