cdist-type__uci - Man Page

Manage configuration values in UCI

Description

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

Required Parameters

value

The value to be set. Can be used multiple times. This parameter is ignored if --state is absent.

Due to the way cdist handles arguments, values must not contain newline characters.

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.

Optional Parameters

state

present or absent, defaults to present.

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.

Boolean Parameters

None.

Examples

# Set the system hostname
__uci system.@system[0].hostname --value 'OpenWrt'

# Set DHCP option 252: tell DHCP clients to not ask for proxy information.
__uci dhcp.lan.dhcp_option --type list --value '252,"\n"'

# 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 \
    --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

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.

Referenced By

cdist-type__uci_section(7).

Dec 21, 2020 6.9.4 cdist