From 6f0136d5246debbe1cdc44a896a84b80377f0856 Mon Sep 17 00:00:00 2001 From: MiraMaX166 Date: Wed, 1 Mar 2023 18:29:03 +0600 Subject: [PATCH] fix readme in project ubl-settings-datetime --- ubl-settings-datetime/README.md | 84 +++++++++++++++++++++------------ 1 file changed, 54 insertions(+), 30 deletions(-) diff --git a/ubl-settings-datetime/README.md b/ubl-settings-datetime/README.md index 81f59a9..59f7e93 100644 --- a/ubl-settings-datetime/README.md +++ b/ubl-settings-datetime/README.md @@ -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,10 +82,10 @@ - лейбл "Зона:". - комбобокс. Перечень городов с поправкой на часовой пояс. Например, "(UTC +06) Омск". Перечень регионов, локализация стандартными средствами. 1. **ОСОБЕННОСТИ** - 1. При загрузке утилиты по умолчанию загружаются данные из локального конфигурационного файла. - 1. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через pcexec. - 1. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (команда get local), загрузка конфигурации из файла настроек ОС ublinux.ini (команда get global). - 1. Кнопка "Сохранить" -> ("Cохранить конфигурацию, Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию"). Сохраняет текущие настройки через скрипт ubconfig (команда set local) и в конфигурационный файл настроек ОС ublinux.ini (команда set global). При выборе пунктов "Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию" происходит отдельное сохранение настроек. + 1. При загрузке утилиты по умолчанию загружаются данные из локального конфигурационного файла (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"). + 1. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через polkit. + 1. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"), загрузка конфигурации из файла настроек ОС ublinux.ini (выполняются команды блоков "Чтение значений: из глобального конфигурационного файла"). + 1. Кнопка "Сохранить" -> ("Cохранить конфигурацию, Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию"). Сохраняет текущие настройки через скрипт ubconfig (выполняются команды блоков "Установить значение: в локальный конфигурационный файл") и в конфигурационный файл настроек ОС ublinux.ini (выполняются команды блоков "Установить значение: в глобальный конфигурационный файл"). При выборе пунктов "Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию" происходит отдельное сохранение настроек. 1. Строка уведомлений. Цвет в зависимости от сигнала: - песочный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы. - красный, пиктограмма "Восклицательный знак", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы. @@ -96,34 +96,58 @@ - Иконка приложения - Название утилиты - Версия программы - - Название утилиты локализованное + - Название утилиты, локализованное - Ссылка "Домашняя страница проекта" на https://ublinux.ru/ - Copyright (c) 2023 - UBSoft Software LLC 1. **КОМАНДЫ** - 1. Задать время: `date +%T -s "h:m:sec"` (кнопка "Синхронизировать") - 1. Задать дату: `date +%Y%m%d -s "2000:06:14"` (кнопка "Синхронизировать") - 1. Синхронизировать аппаратное время: `hwclock --systohc` (кнопка "Синхронизировать аппаратное время") - 1. Проверка запущенных процессов синхронизации, например, `pidof -q systemd-timesyncd ntpd chronyd`. - 1. Остановка сервисов: - 1. `SEL_SERVICE=\"systemd-timesyncd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service;` - `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};` - `SEL_SERVICE=\"chronyd\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE};` - `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};` - `SEL_SERVICE=\"phc2sys\"; systemctl --quiet is-active ${SEL_SERVICE}.service &>/dev/null && systemctl stop ${SEL_SERVICE}.service || pkill -9 ${SEL_SERVICE}` - 1. Установка часового пояса: `ln -s /usr/share/zoneinfo/ && ln -s /usr/share/zoneinfo/REGION/ZONE` (комбобокс "Регион", "Зона") - 1. Команды записи в конфигурационный файл: - 1. Получить статус синхронизации NTP: `/usr/bin/ubconfig get network NTPSERVERS` - 1. Задать значение NTPSERVERS: - - Если выбран по умолчанию: `/usr/bin/ubconfig set network NTPSERVERS=default` - - Если выбран dhcp: `/usr/bin/ubconfig set network NTPSERVERS=dhcp` - - Если выбран вручную: `/usr/bin/ubconfig set network NTPSERVERS=АДРЕСА ИЗ ПОЛЯ` - 1. Получить текущую временную зону: `/usr/bin/ubconfig get clock ZONE` - 1. Задать временную зону: `/usr/bin/ubconfig set clock ZONE=REGION/ZONE` - 1. Отключить синхронизацию NTP: `/usr/bin/ubconfig remove network NTPSERVERS` - -7. **ПРИБЛИЗИТЕЛЬНЫЙ МАКЕТ ПРИЛОЖЕНИЯ.** + 1. Текущие дата и время + - Чтение значения: + - через средства функции на языке Си + - Установить значение: + - счётчики часы и минуты: `date +%T -s "h:m:sec"` (кнопка "Синхронизировать") + - дата: `date +%Y%m%d -s "2000:06:14"` (кнопка "Синхронизировать") + - Синхронизировать аппаратное время: + - Установить значение: `hwclock --systohc` (кнопка "Синхронизировать аппаратное время") + 1. Синхронизация через NTP + - Чтение значения: + - из локального конфигурационного файла: `/usr/bin/ubconfig --source system get network NTPSERVERS` + - из глобального конфигурационного файла: `/usr/bin/ubconfig --source global get network NTPSERVERS` + - Установить значение: + - "Остановлено" + в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set network NTPSERVERS=stop` + в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=stop` + - "По умолчанию" + в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set network NTPSERVERS=default` + в глобальный конфигурационный файл: `/usr/bin/ubconfig --target global set network NTPSERVERS=default` + - "DHCP" + в локальный конфигурационный файл: `/usr/bin/ubconfig --target system set network NTPSERVERS=dhcp` + в глобальный конфигурационный файл: `/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. Главное окно ![](https://gitea.ublinux.ru/miramax166/design-ubl-settings-apps/raw/branch/master/ubl-settings-datetime/pic/01%28ru_RU%29.png)