Система UCI

Сокращение UCI значит Unified Configuration Interface и направлен на централизованную настройку OpenWrt. Настройка должна быть простой, понятной и документированной.

Многие программы имеют собственный конфигурационный файл, например /etc/network/interfaces или /etc/exports или /etc/dnsmasq.conf /etc/samba/samba.conf и иногда они используют несколько отличающуюся структуру синтаксиса. В OpenWRT вам не нужно мучиться с ними, мы только заменяем файлы настроек UCI!

Вам не нужно перезагружать свою систему для изменения настроек! Перейдите по ссылке command.line.utility:,чтобы знать как это делается. И, пожалуйста, не забывайте, что некоторые демоны уже имеются в системе, но по умолчанию они отключены! К примеру, демон cron отключён по умолчанию, следовательно, редактирование crontab не даст результата. Вам необходимо либо запустить демона при помощи /etc/init.d/cron start или включить его /etc/init.d/cron enable. Вы можете disable(отключить), stop(остановить) и restart(перезапустить) большинство демонов. Возможно документация по notuci.config поможет вам.

Централизованная конфигурация OpenWrt находится в нескольких файлах, расположенных в каталоге /etc/config/. Каждый файл относится к части системы, который он настраивает. Вы можете редактировать файлы конфигурации в текстовом редакторе или с помощью утилиты командной строки uci, или через различные интерфейсы программирования (например, Shell, Lua и C).

Конфигурационные файлы uci обычно содержат одно или более конфигурационных определений, которые также называются секциями, в которых содержатся одна или более опций определений, определяющих фактические значения.

Ниже приведен пример простого конфигурационного файла:

package 'example'

config 'example' 'test'
        option   'string'      'some value'
        option   'boolean'     '1'
        list     'collection'  'first item'
        list     'collection'  'second item'

• Утверждение config 'example' 'test' определяет начало секции с типом example и именем test. Секция также может быть анонимной с указанием только типа, без имени секции. Тип необходим для программ обработки для принятия решения о том, как интерпретировать входящие в секцию опции.

• Строки option 'string' 'some value' и option 'boolean' '1' определяют простые значения внутри секции. Заметьте, что синтаксически нет разницы между текстовыми и булевскими опциями. По соглашению, булевские опции могут иметь одно из значений '0', 'no', 'off' или 'false' для определения значения 'ложь' или '1' , 'yes', 'on' или 'true' для определения значения 'истина'.

• В строках начинающихся с дескриптора list определены опции с множественными значениями. Все определения list, которые используют одинаковое имя (collection в нашем примере), будут объединены в один список значений в том порядке, в котором они были в конфигурационном файле.

• Наличие отступов в строчках с определениями option и list является соглашением для улучшения читаемости конфигурационного файла, но синтаксически не обязательно.

Обычно Вам не требуется заключать идентификаторы или значения в кавычки. Кавычки требуются только если заключаемое в них значение содержит символы пробела или табуляции. Также вполне допустимо использовать двойные кавычки (“) вместо одинарных (') при вводе конфигурационных опций.

Все приведенные ниже примеры являются синтаксически корректными в uci:

• option example value
• option 'example' value
• option example “value”
• option “example” 'value'
• option 'example' “value”

В противовес, следующий пример синтаксически неверен:

• option 'example” “value' (несбалансированность кавычек)
• option example some value with space (кавычки отсутствуют вокруг значения)

Важно знать, что идентификаторы UCI и имена конфигурационных файлов могут содержать только символы a-z, 0-9 и _. Значения опций могут содержать любые символы (пока они в кавычках).

Использование awk и grep для парсинга конфигурационных файлов OpenWrt является избыточным, неумным и неэффективным. Вместо этого используйте утилиту uci для получения того что Вам нужно.

Ниже приведено описание, а также некоторые полезные примеры использования этой мощной утилиты. Запомните, друзья не позволяют друзьям парсить собственные конфигурационные файлы!

Когда есть несколько правил, следующих одно за другим, uci использует для них ссылки похожие на адресацию в массивах. Если есть 8-мь серверов NTP, uci позволит Вам ссылаться на их секции как timeserver.@timeserver[0] для первого сервера или timeserver.@timeserver[7] для последнего. Вы также можете использовать отрицательные индексы, как например timeserver.@timeserver[-1]. ”-1“ означает “последний”, ”-2“ предпоследний, и т.д. Это оказывается очень удобно, когда добавляются новые правила к концу списка. См. пример ниже.

root@OpenWrt:/lib/config# uci

Usage: uci [<options>] <command> [<arguments>]

Commands:
	batch
	export     [<config>]
	import     [<config>]
	changes    [<config>]
	commit     [<config>]
	add        <config> <section-type>
	add_list   <config>.<section>.<option>=<string>
	show       [<config>[.<section>[.<option>]]]
	get        <config>.<section>[.<option>]
	set        <config>.<section>[.<option>]=<value>
	delete     <config>[.<section[.<option>]]
	rename     <config>.<section>[.<option>]=<name>
	revert     <config>[.<section>[.<option>]]

Options:
	-c <path>  установка пути поиска конфигурационных файлов (по умолчанию: /etc/config)
	-d <str>   установка разделителя для значений списка в uci show
	-f <file>  использовать для ввода информации содержимое файла <file> вместо стандартного потока stdin
	-m         при импорте, объединение данных в уже существующий пакет
	-n         имя не именованной секции при экспорте (по умолчанию)
	-N         не присваивать имени не именованным секциям
	-p <path>  добавить путь поиска файлов измененной конфигурации
	-P <path>  добавить путь поиска файлов измененной конфигурации и использовать его по умолчанию
	-q         тихий режим (не печатаются сообщения об ошибках)
	-s         строгий режим (останавливаться на ошибках парсинга, используется по умолчанию)
	-S         отключить строгий режим
	-X         не использовать расширенный синтаксис для 'show'

После изменения порта, который слушает сервер uhttpd, с 80 на 8080 в файле /etc/config/uhttpd, сохраним изменения. Затем выполним

И затем

Все сделано. Перезагрузка не требуется.

Рассмотрим следующий пример конфигурационного файла:

В соответствующих группах адресация эквивалентна:

Это хороший пример, демонстрирующий добавление правила для перенаправления TCP SSH порта и синтаксис отрицательной адресации (-1), используемый в uci (пер. - в данном случае, используется ссылка на последнее добавленное правило).

• Backfire

  uci -P/var/state get network.wan.ipaddr

• Trunk (not really uci)

  . /lib/functions/network.sh; network_get_ipaddr ip wan; echo $ip

 uci get wireless.@wifi-iface[-1].ssid

• https://forum.openwrt.org/viewtopic.php?id=15243