2020-06-03 11:05:40 +00:00
|
|
|
cdist-type__uci(7)
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
2020-10-24 08:01:49 +00:00
|
|
|
cdist-type__uci - Manage configuration values in UCI
|
2020-06-03 11:05:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
2020-10-24 08:01:49 +00:00
|
|
|
This cdist type can be used to alter configuration options in OpenWrt's
|
|
|
|
|
Unified Configuration Interface (UCI) system.
|
2020-06-03 11:05:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
|
-------------------
|
|
|
|
|
value
|
|
|
|
|
The value to be set. Can be used multiple times.
|
2020-10-24 08:01:49 +00:00
|
|
|
This parameter is ignored if ``--state`` is ``absent``.
|
2020-06-03 11:05:40 +00:00
|
|
|
|
|
|
|
|
Due to the way cdist handles arguments, values **must not** contain newline
|
|
|
|
|
characters.
|
|
|
|
|
|
2020-10-24 19:18:22 +00:00
|
|
|
Values do not need special quoting for UCI. The only requirement is that the
|
|
|
|
|
value is passed to the type as a single shell argument.
|
2020-06-03 11:05:40 +00:00
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
|
-------------------
|
|
|
|
|
state
|
2020-10-24 08:01:49 +00:00
|
|
|
``present`` or ``absent``, defaults to ``present``.
|
2020-10-24 10:57:40 +00:00
|
|
|
type
|
|
|
|
|
If the type should generate an option or a list.
|
|
|
|
|
One of: ``option`` or ``list``.
|
|
|
|
|
Defaults to auto-detect based on the number of ``--value`` parameters.
|
2020-06-03 11:05:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
|
------------------
|
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
|
|
# Set the system hostname
|
|
|
|
|
__uci system.@system[0].hostname --value 'OpenWrt'
|
|
|
|
|
|
2020-10-24 10:57:40 +00:00
|
|
|
# Set DHCP option 252: tell DHCP clients to not ask for proxy information.
|
|
|
|
|
__uci dhcp.lan.dhcp_option --type list --value '252,"\n"'
|
|
|
|
|
|
2020-10-25 10:13:06 +00:00
|
|
|
# Enable NTP and NTPd (each is applied individually)
|
|
|
|
|
__uci system.ntp.enabled --value 1
|
|
|
|
|
__uci system.ntp.enable_server --value 1
|
|
|
|
|
__uci system.ntp.server --type list \
|
2020-06-03 11:05:40 +00:00
|
|
|
--value '0.openwrt.pool.ntp.org' \
|
|
|
|
|
--value '1.openwrt.pool.ntp.org' \
|
|
|
|
|
--value '2.openwrt.pool.ntp.org' \
|
|
|
|
|
--value '3.openwrt.pool.ntp.org'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
- https://openwrt.org/docs/guide-user/base-system/uci
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
