.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__UCI" "7" "Feb 07, 2021" "6.9.4" "cdist"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
cdist\-type__uci \- Manage configuration values in UCI
.SH DESCRIPTION
.sp
This cdist type can be used to alter configuration options in OpenWrt\(aqs
Unified Configuration Interface (UCI) system.
.SH REQUIRED PARAMETERS
.INDENT 0.0
.TP
.B value
The value to be set. Can be used multiple times.
This parameter is ignored if \fB\-\-state\fP is \fBabsent\fP\&.
.sp
Due to the way cdist handles arguments, values \fBmust not\fP contain newline
characters.
.sp
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.
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B state
\fBpresent\fP or \fBabsent\fP, defaults to \fBpresent\fP\&.
.TP
.B type
If the type should generate an option or a list.
One of: \fBoption\fP or \fBlist\fP\&.
Defaults to auto\-detect based on the number of \fB\-\-value\fP parameters.
.UNINDENT
.SH BOOLEAN PARAMETERS
.sp
None.
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Set the system hostname
__uci system.@system[0].hostname \-\-value \(aqOpenWrt\(aq

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

# 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 \e
    \-\-value \(aq0.openwrt.pool.ntp.org\(aq \e
    \-\-value \(aq1.openwrt.pool.ntp.org\(aq \e
    \-\-value \(aq2.openwrt.pool.ntp.org\(aq \e
    \-\-value \(aq3.openwrt.pool.ntp.org\(aq
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
\fI\%https://openwrt.org/docs/guide\-user/base\-system/uci\fP
.UNINDENT
.SH AUTHORS
.sp
Dennis Camera <\fI\%dennis.camera@ssrq\-sds\-fds.ch\fP>
.SH COPYING
.sp
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.
.SH COPYRIGHT
ungleich GmbH 2020
.\" Generated by docutils manpage writer.
.