jahway603
/
libreCMC
forknuté z libreCMC/libreCMC


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
    <title>Reference</title>
    <link rel="stylesheet" href="../luadoc.css" type="text/css" />
	<!--meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/-->
</head>

<body>
<div id="container">

<div id="product">
	<div id="product_logo"></div>
	<div id="product_name"><big><b></b></big></div>
	<div id="product_description"></div>
</div> <!-- id="product" -->

<div id="main">

<div id="navigation">


<h1>LuaDoc</h1>
<ul>
	
	<li><a href="../index.html">Index</a></li>
	
</ul>


<!-- Module list -->

<h1>Modules</h1>
<ul>

	<li>
		<a href="../modules/luci.dispatcher.html">luci.dispatcher</a>
	</li>

	<li>
		<a href="../modules/luci.http.html">luci.http</a>
	</li>

	<li>
		<a href="../modules/luci.http.conditionals.html">luci.http.conditionals</a>
	</li>

	<li>
		<a href="../modules/luci.http.date.html">luci.http.date</a>
	</li>

	<li>
		<a href="../modules/luci.http.mime.html">luci.http.mime</a>
	</li>

	<li>
		<a href="../modules/luci.i18n.html">luci.i18n</a>
	</li>

	<li>
		<a href="../modules/luci.ip.html">luci.ip</a>
	</li>

	<li>
		<a href="../modules/luci.ip.cidr.html">luci.ip.cidr</a>
	</li>

	<li>
		<a href="../modules/luci.json.html">luci.json</a>
	</li>

	<li>
		<a href="../modules/luci.jsonc.html">luci.jsonc</a>
	</li>

	<li>
		<a href="../modules/luci.jsonc.parser.html">luci.jsonc.parser</a>
	</li>

	<li>
		<a href="../modules/luci.model.ipkg.html">luci.model.ipkg</a>
	</li>

	<li><strong>luci.model.uci</strong></li>
	
	<li>
		<a href="../modules/luci.rpcc.html">luci.rpcc</a>
	</li>

	<li>
		<a href="../modules/luci.rpcc.ruci.html">luci.rpcc.ruci</a>
	</li>

	<li>
		<a href="../modules/luci.sys.html">luci.sys</a>
	</li>

	<li>
		<a href="../modules/luci.sys.init.html">luci.sys.init</a>
	</li>

	<li>
		<a href="../modules/luci.sys.iptparser.html">luci.sys.iptparser</a>
	</li>

	<li>
		<a href="../modules/luci.sys.net.html">luci.sys.net</a>
	</li>

	<li>
		<a href="../modules/luci.sys.process.html">luci.sys.process</a>
	</li>

	<li>
		<a href="../modules/luci.sys.user.html">luci.sys.user</a>
	</li>

	<li>
		<a href="../modules/luci.sys.wifi.html">luci.sys.wifi</a>
	</li>

	<li>
		<a href="../modules/luci.util.html">luci.util</a>
	</li>

	<li>
		<a href="../modules/luci.xml.html">luci.xml</a>
	</li>

	<li>
		<a href="../modules/nixio.html">nixio</a>
	</li>

	<li>
		<a href="../modules/nixio.CHANGELOG.html">nixio.CHANGELOG</a>
	</li>

	<li>
		<a href="../modules/nixio.CryptoHash.html">nixio.CryptoHash</a>
	</li>

	<li>
		<a href="../modules/nixio.File.html">nixio.File</a>
	</li>

	<li>
		<a href="../modules/nixio.README.html">nixio.README</a>
	</li>

	<li>
		<a href="../modules/nixio.Socket.html">nixio.Socket</a>
	</li>

	<li>
		<a href="../modules/nixio.TLSContext.html">nixio.TLSContext</a>
	</li>

	<li>
		<a href="../modules/nixio.TLSSocket.html">nixio.TLSSocket</a>
	</li>

	<li>
		<a href="../modules/nixio.UnifiedIO.html">nixio.UnifiedIO</a>
	</li>

	<li>
		<a href="../modules/nixio.bin.html">nixio.bin</a>
	</li>

	<li>
		<a href="../modules/nixio.bit.html">nixio.bit</a>
	</li>

	<li>
		<a href="../modules/nixio.crypto.html">nixio.crypto</a>
	</li>

	<li>
		<a href="../modules/nixio.fs.html">nixio.fs</a>
	</li>

</ul>


<!-- File list -->


</div><!-- id="navigation" -->

<div id="content">

<h1>Object Instance <code>luci.model.uci</code></h1>

<p></p>


<h2>Functions</h2>
<table class="function_list">

	<tr>
	<td class="name" nowrap><a href="#Cursor.add">Cursor:add</a>&nbsp;(config, type)</td>
	<td class="summary">
 
Add an anonymous section.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.apply">Cursor:apply</a>&nbsp;(rollback)</td>
	<td class="summary">
 
Applies UCI configuration changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.changes">Cursor:changes</a>&nbsp;(config)</td>
	<td class="summary">
 
Get a table of saved but uncommitted changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.commit">Cursor:commit</a>&nbsp;(config)</td>
	<td class="summary">
 
Commit saved changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.confirm">Cursor:confirm</a>&nbsp;()</td>
	<td class="summary">
 
Confirms UCI apply process.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.delete">Cursor:delete</a>&nbsp;(config, section, option)</td>
	<td class="summary">
 
Deletes a section or an option.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.delete_all">Cursor:delete_all</a>&nbsp;(config, type, comparator)</td>
	<td class="summary">
 
Delete all sections of a given type that match certain criteria.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.foreach">Cursor:foreach</a>&nbsp;(config, type, callback)</td>
	<td class="summary">
 
Call a function for every section of a certain type.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get">Cursor:get</a>&nbsp;(config, section, option)</td>
	<td class="summary">
 
Get a section type or an option 
 </td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_all">Cursor:get_all</a>&nbsp;(config, section)</td>
	<td class="summary">
 
Get all sections of a config or all values of a section.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_bool">Cursor:get_bool</a>&nbsp;(config, section, option)</td>
	<td class="summary">
 
Get a boolean option and return it's value as true or false.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_confdir">Cursor:get_confdir</a>&nbsp;()</td>
	<td class="summary">
 
Get the configuration directory.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_first">Cursor:get_first</a>&nbsp;(config, type, option, default)</td>
	<td class="summary">
 
Get the given option from the first section with the given type.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_list">Cursor:get_list</a>&nbsp;(config, section, option)</td>
	<td class="summary">
 
Get an option or list and return values as table.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_savedir">Cursor:get_savedir</a>&nbsp;()</td>
	<td class="summary">
 
Get the directory for uncomitted changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.get_session_id">Cursor:get_session_id</a>&nbsp;()</td>
	<td class="summary">
 
Get the effective session ID.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.load">Cursor:load</a>&nbsp;(config)</td>
	<td class="summary">
 
Manually load a config.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.revert">Cursor:revert</a>&nbsp;(config)</td>
	<td class="summary">
 
Revert saved but uncommitted changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.rollback">Cursor:rollback</a>&nbsp;()</td>
	<td class="summary">
 
Cancels UCI apply process.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.rollback_pending">Cursor:rollback_pending</a>&nbsp;()</td>
	<td class="summary">
 
Checks whether a pending rollback is scheduled.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.save">Cursor:save</a>&nbsp;(config)</td>
	<td class="summary">
 
Saves changes made to a config to make them committable.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.section">Cursor:section</a>&nbsp;(config, type, name, values)</td>
	<td class="summary">
 
Create a new section and initialize it with data.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.set">Cursor:set</a>&nbsp;(config, section, option, value)</td>
	<td class="summary">
 
Set a value or create a named section.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.set_confdir">Cursor:set_confdir</a>&nbsp;(directory)</td>
	<td class="summary">
 
Set the configuration directory.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.set_list">Cursor:set_list</a>&nbsp;(config, section, option, value)</td>
	<td class="summary">
 
Set given values as list.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.set_savedir">Cursor:set_savedir</a>&nbsp;(directory)</td>
	<td class="summary">
 
Set the directory for uncommitted changes.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.set_session_id">Cursor:set_session_id</a>&nbsp;(id)</td>
	<td class="summary">
 
Set the effective session ID.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.substate">Cursor:substate</a>&nbsp;()</td>
	<td class="summary">
 
Create a sub-state of this cursor.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.tset">Cursor:tset</a>&nbsp;(config, section, values)</td>
	<td class="summary">
 
Updated the data of a section using data from a table.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#Cursor.unload">Cursor:unload</a>&nbsp;(config)</td>
	<td class="summary">
 
Discard changes made to a config.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#cursor">cursor</a>&nbsp;()</td>
	<td class="summary">
 
Create a new UCI-Cursor.</td>
	</tr>

	<tr>
	<td class="name" nowrap><a href="#cursor_state">cursor_state</a>&nbsp;()</td>
	<td class="summary">
 
Create a new Cursor initialized to the state directory.</td>
	</tr>

</table>


<br/>
<br/>


<h2><a name="functions"></a>Functions</h2>
<dl class="function">


<dt><a name="Cursor.add"></a><strong>Cursor:add</strong>&nbsp;(config, type)</dt>
<dd>

 
Add an anonymous section. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  type: UCI section type
	</li>
	
</ul>


<h3>Return value:</h3>
Name of created section


</dd>


<dt><a name="Cursor.apply"></a><strong>Cursor:apply</strong>&nbsp;(rollback)</dt>
<dd>

 
Applies UCI configuration changes. 
 
If the rollback parameter is set to true, the apply function will invoke the 
rollback mechanism which causes the configuration to be automatically reverted 
if no confirm() call occurs within a certain timeout. 
 
The current default timeout is 30s and can be increased using the 
"luci.apply.timeout" uci configuration key. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  rollback: Enable rollback mechanism
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.changes"></a><strong>Cursor:changes</strong>&nbsp;(config)</dt>
<dd>

 
Get a table of saved but uncommitted changes. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Table of changes


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.save">
		Cursor:save
	</a>
	
</ul>

</dd>


<dt><a name="Cursor.commit"></a><strong>Cursor:commit</strong>&nbsp;(config)</dt>
<dd>

 
Commit saved changes. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.revert">
		Cursor:revert
	</a>
	
	<li><a href="#Cursor.save">
		Cursor:save
	</a>
	
</ul>

</dd>


<dt><a name="Cursor.confirm"></a><strong>Cursor:confirm</strong>&nbsp;()</dt>
<dd>

 
Confirms UCI apply process. 
 
If a previous UCI apply with rollback has been invoked using apply(true), 
this function confirms the process and cancels the pending rollback timer. 
 
If no apply with rollback session is active, the function has no effect and 
returns with a "No data" error. 


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.delete"></a><strong>Cursor:delete</strong>&nbsp;(config, section, option)</dt>
<dd>

 
Deletes a section or an option. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option (optional)
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.delete_all"></a><strong>Cursor:delete_all</strong>&nbsp;(config, type, comparator)</dt>
<dd>

 
Delete all sections of a given type that match certain criteria. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  type: UCI section type
	</li>
	
	<li>
	  comparator: Function that will be called for each section and returns 
					a boolean whether to delete the current section (optional)
	</li>
	
</ul>


</dd>


<dt><a name="Cursor.foreach"></a><strong>Cursor:foreach</strong>&nbsp;(config, type, callback)</dt>
<dd>

 
Call a function for every section of a certain type. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  type: UCI section type
	</li>
	
	<li>
	  callback: Function to be called
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.get"></a><strong>Cursor:get</strong>&nbsp;(config, section, option)</dt>
<dd>

 
Get a section type or an option 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option (optional)
	</li>
	
</ul>


<h3>Return value:</h3>
UCI value


</dd>


<dt><a name="Cursor.get_all"></a><strong>Cursor:get_all</strong>&nbsp;(config, section)</dt>
<dd>

 
Get all sections of a config or all values of a section. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name (optional)
	</li>
	
</ul>


<h3>Return value:</h3>
Table of UCI sections or table of UCI values


</dd>


<dt><a name="Cursor.get_bool"></a><strong>Cursor:get_bool</strong>&nbsp;(config, section, option)</dt>
<dd>

 
Get a boolean option and return it's value as true or false. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean


</dd>


<dt><a name="Cursor.get_confdir"></a><strong>Cursor:get_confdir</strong>&nbsp;()</dt>
<dd>

 
Get the configuration directory. 


<h3>Return value:</h3>
Configuration directory


</dd>


<dt><a name="Cursor.get_first"></a><strong>Cursor:get_first</strong>&nbsp;(config, type, option, default)</dt>
<dd>

 
Get the given option from the first section with the given type. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  type: UCI section type
	</li>
	
	<li>
	  option: UCI option (optional)
	</li>
	
	<li>
	  default: Default value (optional)
	</li>
	
</ul>


<h3>Return value:</h3>
UCI value


</dd>


<dt><a name="Cursor.get_list"></a><strong>Cursor:get_list</strong>&nbsp;(config, section, option)</dt>
<dd>

 
Get an option or list and return values as table. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option
	</li>
	
</ul>


<h3>Return value:</h3>
table.  	If the option was not found, you will simply get an empty 
					table.


</dd>


<dt><a name="Cursor.get_savedir"></a><strong>Cursor:get_savedir</strong>&nbsp;()</dt>
<dd>

 
Get the directory for uncomitted changes. 


<h3>Return value:</h3>
Save directory


</dd>


<dt><a name="Cursor.get_session_id"></a><strong>Cursor:get_session_id</strong>&nbsp;()</dt>
<dd>

 
Get the effective session ID. 


<h3>Return value:</h3>
String containing the session ID


</dd>


<dt><a name="Cursor.load"></a><strong>Cursor:load</strong>&nbsp;(config)</dt>
<dd>

 
Manually load a config. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.save">
		Cursor:save
	</a>
	
	<li><a href="#Cursor.unload">
		Cursor:unload
	</a>
	
</ul>

</dd>


<dt><a name="Cursor.revert"></a><strong>Cursor:revert</strong>&nbsp;(config)</dt>
<dd>

 
Revert saved but uncommitted changes. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.commit">
		Cursor:commit
	</a>
	
	<li><a href="#Cursor.save">
		Cursor:save
	</a>
	
</ul>

</dd>


<dt><a name="Cursor.rollback"></a><strong>Cursor:rollback</strong>&nbsp;()</dt>
<dd>

 
Cancels UCI apply process. 
 
If a previous UCI apply with rollback has been invoked using apply(true), 
this function cancels the process and rolls back the configuration to the 
pre-apply state. 
 
If no apply with rollback session is active, the function has no effect and 
returns with a "No data" error. 


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.rollback_pending"></a><strong>Cursor:rollback_pending</strong>&nbsp;()</dt>
<dd>

 
Checks whether a pending rollback is scheduled. 
 
If a previous UCI apply with rollback has been invoked using apply(true), 
and has not been confirmed or rolled back yet, this function returns true 
and the remaining time until rollback in seconds. If no rollback is pending, 
the function returns false. On error, the function returns false and an 
additional string describing the error. 


<h3>Return values:</h3>
<ol>
	
	<li>Boolean whether rollback is pending
	
	<li>Remaining time in seconds
	
</ol>


</dd>


<dt><a name="Cursor.save"></a><strong>Cursor:save</strong>&nbsp;(config)</dt>
<dd>

 
Saves changes made to a config to make them committable. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.load">
		Cursor:load
	</a>
	
	<li><a href="#Cursor.unload">
		Cursor:unload
	</a>
	
</ul>

</dd>


<dt><a name="Cursor.section"></a><strong>Cursor:section</strong>&nbsp;(config, type, name, values)</dt>
<dd>

 
Create a new section and initialize it with data. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  type: UCI section type
	</li>
	
	<li>
	  name: UCI section name (optional)
	</li>
	
	<li>
	  values: Table of key - value pairs to initialize the section with
	</li>
	
</ul>


<h3>Return value:</h3>
Name of created section


</dd>


<dt><a name="Cursor.set"></a><strong>Cursor:set</strong>&nbsp;(config, section, option, value)</dt>
<dd>

 
Set a value or create a named section. 
 
When invoked with three arguments <code>config</code>, <code>sectionname</code>, <code>sectiontype</code>, 
then a named section of the given type is created. 
 
When invoked with four arguments <code>config</code>, <code>sectionname</code>, <code>optionname</code> and 
<code>optionvalue</code> then the value of the specified option is set to the given value. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option or UCI section type
	</li>
	
	<li>
	  value: UCI value or nothing if you want to create a section
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.set_confdir"></a><strong>Cursor:set_confdir</strong>&nbsp;(directory)</dt>
<dd>

 
Set the configuration directory. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  directory: UCI configuration directory
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.set_list"></a><strong>Cursor:set_list</strong>&nbsp;(config, section, option, value)</dt>
<dd>

 
Set given values as list. Setting a list option to an empty list 
has the same effect as deleting the option. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name
	</li>
	
	<li>
	  option: UCI option
	</li>
	
	<li>
	  value: Value or table. Non-table values will be set as single 
					item UCI list.
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.set_savedir"></a><strong>Cursor:set_savedir</strong>&nbsp;(directory)</dt>
<dd>

 
Set the directory for uncommitted changes. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  directory: UCI changes directory
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.set_session_id"></a><strong>Cursor:set_session_id</strong>&nbsp;(id)</dt>
<dd>

 
Set the effective session ID. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  id: String containing the session ID to set
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


</dd>


<dt><a name="Cursor.substate"></a><strong>Cursor:substate</strong>&nbsp;()</dt>
<dd>

 
Create a sub-state of this cursor. 
 
The sub-state is tied to the parent cursor, means it the parent unloads or 
loads configs, the sub state will do so as well. 


<h3>Return value:</h3>
UCI state cursor tied to the parent cursor


</dd>


<dt><a name="Cursor.tset"></a><strong>Cursor:tset</strong>&nbsp;(config, section, values)</dt>
<dd>

 
Updated the data of a section using data from a table. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
	<li>
	  section: UCI section name (optional)
	</li>
	
	<li>
	  values: Table of key - value pairs to update the section with
	</li>
	
</ul>


</dd>


<dt><a name="Cursor.unload"></a><strong>Cursor:unload</strong>&nbsp;(config)</dt>
<dd>

 
Discard changes made to a config. 


<h3>Parameters</h3>
<ul>
	
	<li>
	  config: UCI config
	</li>
	
</ul>


<h3>Return value:</h3>
Boolean whether operation succeeded


<h3>See also:</h3>
<ul>
	
	<li><a href="#Cursor.load">
		Cursor:load
	</a>
	
	<li><a href="#Cursor.save">
		Cursor:save
	</a>
	
</ul>

</dd>


<dt><a name="cursor"></a><strong>cursor</strong>&nbsp;()</dt>
<dd>

 
Create a new UCI-Cursor. 


<h3>Return value:</h3>
UCI-Cursor


</dd>


<dt><a name="cursor_state"></a><strong>cursor_state</strong>&nbsp;()</dt>
<dd>

 
Create a new Cursor initialized to the state directory. 


<h3>Return value:</h3>
UCI cursor


</dd>


</dl>


</div> <!-- id="content" -->

</div> <!-- id="main" -->

<div id="about">
	<p><a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" /></a></p>
</div> <!-- id="about" -->

</div> <!-- id="container" -->
</body>
</html>