Scroll to navigation

CDIST-TYPE__UCI_SECTION(7) cdist CDIST-TYPE__UCI_SECTION(7)

NAME

cdist-type__uci_section - Manage configuration sections in UCI

DESCRIPTION

This cdist type can be used to replace whole configuration sections in OpenWrt's Unified Configuration Interface (UCI) system. It can be thought of as syntactic sugar for cdist-type__uci(7), as this type will generate the required __uci objects to make the section contain exactly the options specified using --option.

Since many default UCI sections are unnamed, this type allows to find the matching section by one of its options using the --match parameter.

NOTE: Options already present on the target and not listed in --option or --list will be deleted.

REQUIRED PARAMETERS

None.

OPTIONAL PARAMETERS

An option that is part of a list and should be present in the section (as part of a list). Lists with multiple options can be expressed by using the same <option> repeatedly.

The value to this parameter is a <option>=<value> string.

<value> does not need special quoting for UCI. The only requirement is that the value is passed to the type as a single shell argument.

Allows to find a section to "replace" through one of its parameters.

The value to this parameter is a <option>=<value> string.

An option that should be present in the section. This parameter can be used multiple times to specify multiple options.

The value to this parameter is a <option>=<value> string.

<value> does not need special quoting for UCI. The only requirement is that the value is passed to the type as a single shell argument.

present or absent, defaults to present.
The type of the section in the format: <config>.<section-type>

BOOLEAN PARAMETERS

None.

EXAMPLES

# Configure the dropbear daemon
__uci_section dropbear --type dropbear.dropbear \

--match Port=22 --option Port=22 \
--option PasswordAuth=off \
--option RootPasswordAuth=off # Define a firewall zone comprised of lan and wlan networks __uci_section firewall.internal --type firewall.zone \
--option name='internal' \
--list network='lan' \
--list network='wlan' \
--option input='ACCEPT' \
--option output='ACCEPT' \
--option forward='ACCEPT' # Block SSH access from the guest network __uci_section firewall.block_ssh_from_guest --type firewall.rule \
--option name='Block-SSH-Access-from-Guest' \
--option src='guest' \
--option proto='tcp' \
--option dest_port='22' \
--option target='REJECT' # Configure a Wi-Fi access point __uci_section wireless.default_radio0 --type wireless.wifi-iface \
--option device='radio0' \
--option mode='ap' \
--option network='wlan' \
--option ssid='mywifi' \
--option encryption="psk2' \
--option key='hunter2'


SEE ALSO


AUTHORS

Dennis Camera <dennis.camera@ssrq-sds-fds.ch>

COPYING

Copyright (C) 2020 Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

COPYRIGHT

ungleich GmbH 2021

August 7, 2022 7.0.0