documentation:configuration:uci
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
documentation:configuration:uci [2015/05/11 18:08] admin [UCI] |
documentation:configuration:uci [2018/05/24 09:05] (current) |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| The //__U__nified __C__onfig __S__ystem// is the central pivot when it comes the routers configuration settings. | The //__U__nified __C__onfig __S__ystem// is the central pivot when it comes the routers configuration settings. | ||
| - | All maintained configuration files are storen in ///etc/config/// and can either be edited with an usual text-editor or by using the //uci// command-line interface. | + | All maintained configuration files are stored in ///etc/config/// and can either be edited with a text-editor or by using the //uci// command-line interface. \\ |
| + | After altering the routers configuration files, affected system services needs to be restarted. | ||
| ===== Configuration Files ===== | ===== Configuration Files ===== | ||
| Line 10: | Line 11: | ||
| [[documentation:configuration:config_files|Configuration Files]] | [[documentation:configuration:config_files|Configuration Files]] | ||
| - | ===== File Syntax ===== | + | ===== File Syntax / Basic principle ===== |
| Usually the configuration files or //'packages'// consists of various blocks, so called //'sections'//. | Usually the configuration files or //'packages'// consists of various blocks, so called //'sections'//. | ||
| Each section starts with the //'config'//-statement and can imply multiple settings. | Each section starts with the //'config'//-statement and can imply multiple settings. | ||
| - | Below is an simple example of such an block: | + | Below is an simple example of such a section block: |
| <code> | <code> | ||
| Line 29: | Line 30: | ||
| Followed by two //'option'//-statements which defines simple values. Each option needs a name and a value. | Followed by two //'option'//-statements which defines simple values. Each option needs a name and a value. | ||
| - | Finally the section ends with two //'list'//-statements. Lists are special options which can combine multiple list-entries to one singe object. | + | Finally the example section ends with two //'list'//-statements. Lists are special options which can combine multiple list-entries to one singe object. |
| Like //options//, each list needs a name. If several list-statements with the same name are present in one section, each entry will be added to the list. | Like //options//, each list needs a name. If several list-statements with the same name are present in one section, each entry will be added to the list. | ||
| - | In our example a single list named 'collection' will be generated with the entries 'first item' and 'second item'. | + | In our example, a single list named 'collection' will be generated, containing the entries 'first item' and 'second item'. |
| Line 39: | Line 40: | ||
| Usage | Usage | ||
| - | root@OpenWrt:/lib/config# uci | + | # uci |
| Usage: uci [<options>] <command> [<arguments>] | Usage: uci [<options>] <command> [<arguments>] | ||
| Line 72: | Line 73: | ||
| -X do not use extended syntax on 'show' | -X do not use extended syntax on 'show' | ||
| </code> | </code> | ||
| + | |||
| + | If you want to look up your changes use the following command: | ||
| + | <code> | ||
| + | uci changes | ||
| + | </code> | ||
| + | |||
| + | In case you alter the UCI configuration using the command-line interface, the config needs to be written to the configuration files by commiting them using: | ||
| + | <code> | ||
| + | uci commit | ||
| + | </code> | ||
| + | before any service restarts will take effect of the configuration | ||
documentation/configuration/uci.1431367710.txt.gz · Last modified: 2018/05/24 09:05 (external edit)
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
