Блокировки модулей связи#

1. Блокируемые модули связи#

  • Wi-Fi

  • Bluetooth

  • Мобильные данные (мобильная сеть)

  • NFC

  • GPS

  • Камера

  • Микрофон

2. Файл конфигураций#

/etc/astra-mobile/astra-mobile-switchs.ini

Владелец: root

Группа: root

Права доступа: rw-r–r–

Структура#

Секция: General#

BluetoothBloking - Параметр, хранящий признак блокировки Bluetooth. По умолчанию false;

WifiBloking - Параметр, хранящий признак блокировки Wifi. По умолчанию false;

CellularBloking - Параметр, хранящий признак блокировки Cellular. По умолчанию false;

GpsBloking - Параметр, хранящий признак блокировки Gps. По умолчанию false;

NfcBloking - Параметр, хранящий признак блокировки Nfc. По умолчанию false;

CameraBloking - Параметр, хранящий признак блокировки камер. По умолчанию false;

MicrophoneBloking - Параметр, хранящий признак блокировки микрофонов. По умолчанию false.

Секция Service#

LiveTime - Параметр, хранящий время жизни сервиса (в секундах). По умолчанию 15.

3. DBus service#

Данный сервис реализует всю логику работы блокировки модулей связи.

DBus объект: ru.astralinux.communication-switchs

Путь: /CommunicationSwitchs

Интерфейс: ru.astralinux.communication.switchs

Методы#

applayControl - Метод применит текущие настройки блокировки модулей связи

Принимаемые параметры: - Возвращаемое значение: - Права использования: все пользователи

Переключатели блокировок#

Каждому переключателю соответствует свой путь и интерфейс управления:

Wi-Fi#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/WiFi

Интерфейс: ru.astralinux.communication.switchs.wifi

Bluetooth#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/Bluetooth

Интерфейс: ru.astralinux.communication.switchs.bluetooth

Мобильные данные#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/Cellular

Интерфейс: ru.astralinux.communication.switchs.cellular

NFC#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/NFC

Интерфейс: ru.astralinux.communication.switchs.nfc

GPS#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/GPS

Интерфейс: ru.astralinux.communication.switchs.gps

Камера#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/Camera

Интерфейс: ru.astralinux.communication.switchs.camera

Микрофон#

DBus объект: (см. пункт DBus service)

Путь: /CommunicationSwitchs/Microphone

Интерфейс: ru.astralinux.communication.switchs.microphone

Интерфейс переключателей блокировок#

Переключатели блокировок представлены объектами с идентичным интерфейсом:

Методы#

setBlocking - Установит статус блокировки модуля

Принимаемые параметры: boolean (b) inBlockingStatus

Возвращаемое значение: boolean (b)

Права использования: только root

Свойства#

available - Вернёт признак того, что блокировка модуля поддерживается на данном железе

Тип: boolean (b)

Права использования: все пользователи (только чтение)

blocking - Вернёт статус блокировки модуля

Тип: boolean (b)

Права использования: все пользователи (только чтение)

Сигналы#

blockingChanged - Сигнал об изменении статуса блокировки

Параметры: boolean (b) newBlocking

4. Используемые скрипты#

Вспомогательные#

Расположение: /usr/sbin

switch_constants - Библиотека глобальных объявлений блокировок модулей связи

switch-dbus-functions - Библиотека, реализующая функционал работы с DBus

switch_functions - Библиотека, реализующая функционал блокировок

switch_module - Базовый скрипт блокировки

console_colors - Библиотека, описывающая цвета текста терминала

super_user_check - Библиотека, реализующая проверку прав пользователя

errors_func - Библиотека, реализующая функции работы с ошибками

Основные#

Расположение: /usr/sbin

switch_wifi_modul - Скрипт блокировки Wi-Fi

Требования:

Права root;

switch_bluetooth_module - Скрипт блокировки Bluetooth

Требования:

Права root;

switch_cellular_module - Скрипт блокировки мобильных данных

Требования:

Права root;

switch_nfc_module - Скрипт блокировки NFC

Требования:

Права root;

switch_gps_module - Скрипт блокировки GPS

Требования:

Права root;

switch_camera_module - Скрипт блокировки камер

Требования:

Права root;

switch_microphone_module - Скрипт блокировки микрофонов

Требования:

Права root;

5. Общий консольный интерфейс блокировок модулей связи#

Обозначения#

{NAME} - Имя модуля связи (например для Wi-Fi switch_{NAME}_module будет switch_wifi_module)

Проверка существования модуля#

# switch_{NAME}_module exists

Вернёт признак того что блокировка модуля поддерживается на данном железе: [STATUS]: Module {NAME} available.

или не поддерживается:

[STATUS]: Module {NAME} not available.

Проверка статуса блокировки#

# switch_{NAME}_module status

Вернёт текущий статус блокировки модуля:

Не заблокирован:

[STATUS]: Module {NAME} isn’t bloked.

Заблокирован:

[STATUS]: Module {NAME} is bloked.

Блокировка модуля#

# switch_{NAME}_module off

Заблокирует модуль связи если он существует:

[PROCESS]: The {NAME} module is being blocked…

[STATUS]: Module {NAME} is bloked.

Разблокировка модуля#

# switch_{NAME}_module on

Разблокирует модуль связи если он был заблокирован:

[PROCESS]: The {NAME} module is being unblocked…

[STATUS]: Module {NAME} isn’t bloked.