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

       list   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.

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

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

       option 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.

       state  present or absent, defaults to present.

       type   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

       • https://openwrt.org/docs/guide-user/base-system/uci

       • cdist-type__uci(7)

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