1CDIST-TYPE__UCI(7)                   cdist                  CDIST-TYPE__UCI(7)
2
3
4

NAME

6       cdist-type__uci - Manage configuration values in UCI
7

DESCRIPTION

9       This cdist type can be used to alter configuration options in OpenWrt's
10       Unified Configuration Interface (UCI) system.
11

REQUIRED PARAMETERS

13       value  The value to be set. Can be used multiple times.  This parameter
14              is ignored if --state is absent.
15
16              Due  to the way cdist handles arguments, values must not contain
17              newline characters.
18
19              Values do not need special quoting for UCI. The only requirement
20              is  that the value is passed to the type as a single shell argu‐
21              ment.
22

OPTIONAL PARAMETERS

24       state  present or absent, defaults to present.
25
26       type   If the type should generate an option or a list.  One of: option
27              or list.  Defaults to auto-detect based on the number of --value
28              parameters.
29

BOOLEAN PARAMETERS

31       None.
32

EXAMPLES

34          # Set the system hostname
35          __uci system.@system[0].hostname --value 'OpenWrt'
36
37          # Set DHCP option 252: tell DHCP clients to not ask for proxy information.
38          __uci dhcp.lan.dhcp_option --type list --value '252,"\n"'
39
40          # Enable NTP and NTPd (each is applied individually)
41          __uci system.ntp.enabled --value 1
42          __uci system.ntp.enable_server --value 1
43          __uci system.ntp.server --type list \
44              --value '0.openwrt.pool.ntp.org' \
45              --value '1.openwrt.pool.ntp.org' \
46              --value '2.openwrt.pool.ntp.org' \
47              --value '3.openwrt.pool.ntp.org'
48

SEE ALSO

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

AUTHORS

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

COPYING

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

62       ungleich GmbH 2021
63
64
65
66
677.0.0                            Jul 31, 2022               CDIST-TYPE__UCI(7)
Impressum