Merge pull request 'final change in project ubl-settings-datetime' (#15) from miramax166/design-ubl-settings-apps:master into master

Reviewed-on: #15

ubl-settings-bootloader/README.md

@@ -61,33 +61,36 @@
 		- комбобокс с вариантами выбора ОС для загрузки
 		- чекбокс "Последний выбор станет выбором загрузки по умолчанию"
 	    1. Параметры, передаваемые ядру
-				- чекбокс "quiet (Загрузка без текстовых сообщений)"
+		- Таблица со скроллбаром. Заголовок: столбец "Активно" чекбоксы (на активацию опции), столбец "Опция", столбец "Значение". Содержимое:
-				- чекбокс "splash (Показывать окно приветствия)"
+		    - чекбокс, quiet, Загрузка без текстовых сообщений
-				- чекбокс "noplymouth (Отключить Plymouth)"
+		    - чекбокс, splash, Показывать окно приветствия
-				- чекбокс "acpi=off (Отключить ACPI)"
+		    - чекбокс, noplymouth, Отключить Plymouth
-				- чекбокс "noapic (Отключить APIC)"
+		    - чекбокс, acpi=off, Отключить ACPI
-				- чекбокс "nolapic (Отключить локальный APIC)"
+		    - чекбокс, noapic, Отключить APIC
-				- чекбокс "single (Режим одного пользователя)"
+		    - чекбокс, nolapic, Отключить локальный APIC
-				- чекбокс "nomodeset (Отключить выбор и загрузку ядром драйверов видео)"
+		    - чекбокс, single, Режим одного пользователя
-				- чекбокс "i915.enable_dc=0 (Отключить управление питанием графического процессора)"
+		    - чекбокс, nomodeset, Отключить выбор и загрузку ядром драйверов видео
-				- чекбокс "ahci.mobile_lpm_policy=1 (Максимальная производительность, управление питанием)"
+		    - чекбокс, i915.enable_dc=0, Отключить управление питанием графического процессора
-				- чекбокс "snd-intel-dspcfg.dsp_driver=1 (Принудительный выбор драйвера звукового устройства от Intel)"
+		    - чекбокс, ahci.mobile_lpm_policy=1, Максимальная производительность, управление питанием
-				- чекбокс "intel_idle.max_cstate=1 (Предотвращает переход процессора в состояние глубокого сна)"
+		    - чекбокс, snd-intel-dspcfg.dsp_driver=1, Принудительный выбор драйвера звукового устройства от Intel
-				- чекбокс "intel_idle.max_cstate=4 (Устраняет мерцание дисплея ноутбука на процессорах Ultra Voltage)"
+		    - чекбокс, intel_idle.max_cstate=1, Предотвращает переход процессора в состояние глубокого сна
+		    - чекбокс, intel_idle.max_cstate=4, Устраняет мерцание дисплея ноутбука на процессорах Ultra Voltage
 		- поле ввода с лэйблом "Параметры командной строки:"
 	    1. Терминал для ввода
-				- чекбокс "console (PC BIOS & консоль EFI)"
+		- Таблица со скроллбаром. Заголовок: столбец "Активно" чекбоксы (на активацию опции), столбец "Опция", столбец "Значение". Содержимое:
-				- чекбокс "serial (Последовательный терминал)"
+		- чекбокс, console, PC BIOS & консоль EFI
-				- чекбокс "ofconsole (Консоль Open Firmware)"
+		- чекбокс serial, Последовательный терминал
-				- чекбокс "at_keyboard (Клавиатура PC AT (Coreboot))"
+		- чекбокс, ofconsole, Консоль Open Firmware
-				- чекбокс "usb_keyboard (Клавиатура USB Keyboard (протокол HID Boot))"
+		- чекбокс, at_keyboard, Клавиатура PC AT (Coreboot)
+		- чекбокс, usb_keyboard, Клавиатура USB Keyboard (протокол HID Boot)
 		- поле ввода с лэйблом "Параметры командной строки:"
 	    1. Терминал для вывода
-				- чекбокс "console (PC BIOS & консоль EFI)"
+		- Таблица со скроллбаром. Заголовок: столбец "Активно" чекбоксы (на активацию опции), столбец "Опция", столбец "Значение". Содержимое:
-				- чекбокс "serial (Последовательный терминал)"
+		- чекбокс, console, PC BIOS & консоль EFI
-				- чекбокс "ofconsole (Консоль Open Firmware)"
+		- чекбокс, serial, Последовательный терминал
-				- чекбокс "gfxterm (Вывод в графическом режиме)"
+		- чекбокс, ofconsole, Консоль Open Firmware
-				- чекбокс "vga_text (Текстовый вывод VGA (Coreboot))"
+		- чекбокс, gfxterm, Вывод в графическом режиме
+		- чекбокс, vga_text, Текстовый вывод VGA (Coreboot)
 		- поле ввода с лэйблом "Параметры командной строки:"
 1. **КОМАНДЫ**
     1. Меню загрузки

ubl-settings-datetime/README.md

@@ -45,18 +45,18 @@
 	1. Type: Application
 	1. Exec: ubl-settings-datetime
 	1. Categories: X-UBL-SettingsManager;X-UBL-SystemSettings
-    3. Главное окно:
+    1. Главное окно:
 	1. Требования к внешнему виду:
 	    - Адаптивный (резиновый) дизайн.
 	    - Минимальный размер окна до прекращения масштабирования 800 на 600 пикселей.
 	    - Шапка в стиле приложений GTK3 с содержимым:
-                - Кнопка с выпадающим списком "Загрузить" -> ("Загрузить глобально")
+		- Кнопка с выпадающим списком "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию")
 		- Заголовок окна, название приложения
-                - Кнопка с выпадающим списком "Сохранить" -> ("Сохранить глобально, Сохранить локально")
+		- Кнопка с выпадающим списком "Сохранить" -> ("Сохранить глобальную конфигурацию, Сохранить локальную конфигурацию")
 		- Кнопка с иконкой с выпадающим списком -> "Справка, О приложении"
 		- Стандартные элементы окна, кнопки "Свернуть, Минимизировать/На весь экран, Закрыть"
 	    - В верхней части крупный логотип утилиты, с права от него краткое описание утилиты. Фон заполнен изображением.
-            - Срока уведомления, представляющая собой полосу с инфографикой и элементом для закрытия/скрытия строки уведомлений.
+	    - Срока уведомления, представляющая собой полосу с инфографикой строки уведомлений.
 	    - Рабочая область.
 	1. Требования к "Рабочей области". Выводятся группы настроек запуска:
 	    1. Блок с заголовком "Текущие дата и время"
@@ -70,7 +70,7 @@
 		- кнопка "Синхронизировать". Синхронизация выставленных даты и времени с часами и датой системы. Неактивно, если выбраны значения "По умолчанию, DHCP, Вручную" чекбокса в блоке "Синхронизация через NTP".
 		- кнопка "Синхронизировать аппаратное время". Синхронизация даты и времени с временем BIOS рабочей станции.
 	    1. Блок с заголовком "Синхронизация через NTP"
-                - комбобокс с вариантами выбора сервера: "Остановлено, По умолчанию, DHCP, Вручную". При выборе "По умолчанию", второе поле для ввода вручную становится заблокированным для манипуляций - текст введённого поля серый. Содержание поля - ответ полученный на запрос "ubconfig --source=default get NTPSERVERS\_DEFAULT". При выборе "По умолчанию» в конфиг файл передаются значения: "NTPSERVERS=default".
+		- комбобокс с вариантами выбора сервера: "Остановлено, По умолчанию, DHCP, Вручную". При выборе "По умолчанию", второе поле для ввода вручную становится заблокированным для манипуляций - текст введённого поля серый. При выборе "По умолчанию" в конфигурационный файл передаются значения: "NTPSERVERS=default".
 		- поле ввода для ручного указания серверов. Неактивно, если выбраны значения "Отключено, Остановлено, По умолчанию, DHCP" комбобокса в блоке "Синхронизация через NTP". 
 	    1. Блок с заголовком "Часовой пояс".
 		- лейбл "Синхронизация аппаратного времени:"
@@ -82,12 +82,13 @@
 		- лейбл "Зона:".
 		- комбобокс. Перечень городов с поправкой на часовой пояс. Например, "(UTC +06) Омск". Перечень регионов, локализация стандартными средствами.
 1. **ОСОБЕННОСТИ**
-    1. Кнопка с выпадающим списком "Загрузить" -> ("Загрузить глобально"). При нажатии на кнопку происходит загрузка текущей конфигурации в системе через скрипт ubconfig (команда get local). При выборе подпункта - загрузка конфигурации из файла настроек ОС ublinux.ini (команда get global).
+    1. При загрузке утилиты по умолчанию загружаются данные из локального конфигурационного файла (выполняются команды блоков "Чтение значений: из локального конфигурационного файла").
-    1. Кнопка с выпадающим списком "Сохранить" -> ("Сохранить глобально, Сохранить локально"). При нажатии сохраняет текущие настройки через скрипт ubconfig (команда set local) и в конфигурационный файл настроек ОС ublinux.ini (команда  set global). При выборе подпунктов "Сохранить глобально, Сохранить локально" происходит отдельное сохранение настроек. 
+    1. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через polkit.
+    1. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"), загрузка конфигурации из файла настроек ОС ublinux.ini (выполняются команды блоков "Чтение значений: из глобального конфигурационного файла").
+    1. Кнопка "Сохранить" -> ("Cохранить конфигурацию, Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию"). Сохраняет текущие настройки через скрипт ubconfig (выполняются команды блоков "Установить значение: в локальный конфигурационный файл") и в конфигурационный файл настроек ОС ublinux.ini (выполняются команды блоков "Установить значение: в глобальный конфигурационный файл"). При выборе пунктов "Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию" происходит отдельное сохранение настроек.
     1. Строка уведомлений. Цвет в зависимости от сигнала:
-	- зелёный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы. 
+	- песочный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы. 
-	- жёлтый, пиктограмма "Восклицательный знак", сообщения о несохранённых изменениях.
+	- красный, пиктограмма "Восклицательный знак", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы.
-	- красный, пиктограмма "Крест", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы.
     1. Окно с выводом информации о программе:
 	- Заголовок окна по локализованному названию утилиты
 	- Версия берётся из main.cpp глобальной переменной в исходника: UBAPP_VERSION
@@ -95,33 +96,57 @@
 	    - Иконка приложения
 	    - Название утилиты
 	    - Версия программы
-	- Название утилиты локализованное
+	    - Название утилиты, локализованное
 	    - Ссылка "Домашняя страница проекта" на https://ublinux.ru/ 
 	    - Copyright (c) 2023 - UBSoft Software LLC
 1. **КОМАНДЫ**
-    1. Задать время: `date +%T -s "h:m:sec"` (кнопка "Синхронизировать")
+    1. Текущие дата и время
-    1. Задать дату: `date +%Y%m%d -s "2000:06:14"` (кнопка "Синхронизировать")
+	- Чтение значения:
-    1. Синхронизировать аппаратное время: `hwclock --systohc` (кнопка "Синхронизировать аппаратное время")
+	    - через средства функции на языке Си
-    1. Проверка запущенных процессов синхронизации, например, `pidof -q systemd-timesyncd ntpd chronyd`. 
+	- Установить значение:
-    1. Остановка сервисов:
+	    - счётчики часы и минуты: `date +%T -s "h:m:sec"` (кнопка "Синхронизировать")
-        1. `SEL_SERVICE=\"systemd-timesyncd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service;`
+	    - дата: `date +%Y%m%d -s "2000:06:14"` (кнопка "Синхронизировать")
-        `SEL_SERVICE=\"ntpd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE};`
+	- Синхронизировать аппаратное время:
-      `SEL_SERVICE=\"ntpdate\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE};`
+	- Установить значение: `hwclock --systohc` (кнопка "Синхронизировать аппаратное время")
-      `SEL_SERVICE=\"chronyd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE};`
+    1. Синхронизация через NTP
-      `SEL_SERVICE=\"openntpd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ntpd;`
+	- Чтение значения: 
-      `SEL_SERVICE=\"ptp4l\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE};`
+	    - из локального конфигурационного файла: `/usr/bin/ubconfig --source system get network NTPSERVERS`
-      `SEL_SERVICE=\"phc2sys\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE}`
+	    - из глобального конфигурационного файла: `/usr/bin/ubconfig --source global get network NTPSERVERS`
-    1. Установка часового пояса: `ln -s /usr/share/zoneinfo/ && ln -s /usr/share/zoneinfo/REGION/ZONE` (комбобокс "Регион", "Зона")
+	- Установить значение:
-    1. Команды записи в конфигурационный файл:
+	    - "Остановлено" 
-        1. Получить статус синхронизации NTP: `/usr/bin/ubconfig get network NTPSERVERS`
+	    в локальный конфигурационный файл:  `/usr/bin/ubconfig --target system set network NTPSERVERS=stop`
-        1. Задать значение NTPSERVERS:
+	    в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=stop`
-            1. Если выбран по умолчанию: `/usr/bin/ubconfig set network NTPSERVERS=default`
+	    - "По умолчанию"
-            1. Если выбран dhcp: `/usr/bin/ubconfig set network NTPSERVERS=dhcp`
+	    в локальный конфигурационный файл:  `/usr/bin/ubconfig --target system set network NTPSERVERS=default`
-            1. Если выбран вручную: `/usr/bin/ubconfig set network NTPSERVERS=АДРЕСА ИЗ ПОЛЯ`
+	    в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=default`
-        1. Получить текущую временную зону: `/usr/bin/ubconfig get clock ZONE`
+	    - "DHCP"
-        1. Задать временную зону: `/usr/bin/ubconfig set clock ZONE=REGION/ZONE`
+	    в локальный конфигурационный файл:  `/usr/bin/ubconfig --target system set network NTPSERVERS=dhcp`
-        1. Отключить синхронизацию NTP: `/usr/bin/ubconfig remove network NTPSERVERS`
+	    в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=dhcp`
-
+	    - "Вручную"
+	    в локальный конфигурационный файл:  `/usr/bin/ubconfig --target system set network NTPSERVERS=$VALUE`
+	    в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=$VALUE`
+	    где $VALUE - перечень серверов, полученных из поля в блоке "Синхронизация через NTP", разделённых "," или ";".
+	- Проверка запущенных процессов синхронизации (systemd-timesyncd, ntpd, chronyd) 										и остановка этих сервисов сервисов, осуществляется выполнением команды	`/usr/bin/ubconfig remove network NTPSERVERS` при выборе опции "Остановлено" из 	выпадающего списка блока "Синхронизация через NTP"
+    1. Часовой пояс
+	- Синхронизация аппаратного времени:
+	    - Чтение значений:
+		- из локального конфигурационного файла: `/usr/bin/ubconfig --source system get clock HWCLOCK_SYNC`
+		- из глобального конфигурационного файла: `/usr/bin/ubconfig --source global get clock HWCLOCK_SYNC`
+	    - Установить значение:
+		- "Локальное время"
+		в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set clock HWCLOCK_SYNC=localtime` 
+		в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set clock HWCLOCK_SYNC=localtime`
+		- "Время по UTC"
+		в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set clock HWCLOCK_SYNC=utc` 
+		в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set clock HWCLOCK_SYNC=utc`
+	-  Комбобокс "Регион", "Зона":
+	    - Чтение значений:
+		- из локального конфигурационного файла: `/usr/bin/ubconfig --source system get clock ZONE`
+		- из глобального конфигурационного файла: `/usr/bin/ubconfig --source global get clock ZONE`
+	    - Установить значение:
+		- в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set clock ZONE=$VALUE`
+		- в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set clock ZONE=$VALUE`
+		где $VALUE - сложение срок-значений из комбобокса "Регион" и "Зона" через символ "/", например "Asia/Omsk".
 1. **ПРИБЛИЗИТЕЛЬНЫЙ МАКЕТ ПРИЛОЖЕНИЯ.**
     1. Главное окно