libknot 3.3.11.dev0__tar.gz → 3.3.12.dev0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: libknot
3
- Version: 3.3.11.dev0
3
+ Version: 3.3.12.dev0
4
4
  Summary: Python bindings for libknot
5
5
  Home-page: https://gitlab.nic.cz/knot/knot-dns/-/tree/master/python/libknot
6
6
  Author: CZ.NIC, z.s.p.o.
@@ -121,8 +121,8 @@ cmd-name(SECTION_NAME:<i>section's purpouse</i>,
121
121
  [OPT_SECTION1, OPT_SECTION2], <i># Sections must be present together or not at all</i>
122
122
  [OPT_MASTER, [OPT_SLAVE]], <i># OPT_SLAVE may only appear if OPT_MASTER is present</i>
123
123
  SECTION_NAME2=<b>"option1"</b>|<b>"option2"</b>, <i># Either one or the other literal may be used</i>
124
- SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
125
- SECTION_NAME4={<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b>} <i># any subset of characters</i>
124
+ SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
125
+ SECTION_NAME4=<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b> <i># any subset of characters</i>
126
126
  )
127
127
  </pre>
128
128
 
@@ -130,65 +130,71 @@ The **`"B"`** flag always represents an option to execute in blocking mode.
130
130
 
131
131
  #### Server
132
132
 
133
- * `status([TYPE=`<b>`"cert-key"`</b>`|`<b>`"configure"`</b>`|`<b>`"version"`</b>`|`<b>`"workers"`</b>`])`
134
- * `stop()`
135
- * `reload()`
136
- * `stats([SECTION:`<i>`module`</i>`], [ITEM:`<i>`counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
133
+ * <pre>status([TYPE=<b>"cert-key"</b>|<b>"configure"</b>|<b>"version"</b>|<b>"workers"</b>])</pre>
134
+ * <pre>stop()</pre>
135
+ * <pre>reload()</pre>
136
+ * <pre>stats([SECTION:<i>module</i>], [ITEM:<i>counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
137
137
 
138
138
  #### Zone events
139
139
 
140
140
  `ZONE`: if none applies to all zones
141
141
 
142
- * `zone-status([ZONE], [FILTERS={`<b>`"rstefc"`</b>`}])`
142
+ * <pre>zone-status([ZONE], [FILTERS={<b>"rstefc"</b>}])</pre>
143
143
  + `FILTERS`: role `(r)`, serial `(s)`, transaction `(t)`, events `(e)`, freeze `(f)`, catalog `(c)`
144
- * `zone-reload([ZONE], [FLAGS=`<b>`"B"`</b>`,`<b>`"F"`</b><i>`:reload modules`</i>`])`
145
- * `zone-refresh([ZONE], [FLAGS=`<b>`"B"`</b>`])`
146
- * `zone-retransfer([ZONE], [FLAGS=`<b>`"B"`</b>`])`
147
- * `zone-notify([ZONE], [FLAGS=`<b>`"B"`</b>`])`
148
- * `zone-flush([ZONE], [FILTERS=`<b>`"d"`</b><i>`:specify output directory`</i>`, DATA:`<i>`output directory`</i>`], [FLAGS=`<b>`"B"`</b>`])`
149
- * `zone-backup([ZONE], [FILTERS={`<b>`"dzjtkocq"`</b>`}, [DATA:`<i>`if "d" filter present; output directory`</i>`]], [FLAGS=`<b>`"B"`</b>`])`
144
+ * <pre>zone-reload([ZONE], [FLAGS={<b>"B"</b>,<b>"F"</b><i>:reload modules</i>}])</pre>
145
+ * <pre>zone-refresh([ZONE], [FLAGS=<b>"B"</b>])</pre>
146
+ * <pre>zone-retransfer([ZONE], [FLAGS=<b>"B"</b>])</pre>
147
+ * <pre>zone-notify([ZONE], [FLAGS=<b>"B"</b>])</pre>
148
+ * <pre>zone-flush([ZONE], [FILTERS=<b>"d"</b>, DATA:<i>output directory</i>], [FLAGS=<b>"B"</b>])</pre>
149
+ * <pre>zone-backup([ZONE], [FILTERS={<b>"dzjtkocq"</b>}, [DATA:<i>output dir if "d" filter present</i>]], [FLAGS=<b>"B"</b>])</pre>
150
150
  + `FILTERS`
151
- - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
152
- - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
153
- * `zone-restore` <i>analogous to `zone-backup`</i>
154
- * `zone-sign([ZONE], [FLAGS=`<b>`"B"`</b>`])`
155
- * `zone-validate([ZONE], [FLAGS=`<b>`"B"`</b>`])`
156
- * `zone-keys-load([ZONE], [FLAGS=`<b>`"B"`</b>`])`
157
- * `zone-key-rollover([ZONE], TYPE=`<b>`"ksk"`</b>`|`<b>`"zsk"`</b>`, [FLAGS=`<b>`"B"`</b>`])`
158
- * `zone-ksk-submitted([ZONE], [FLAGS=`<b>`"B"`</b>`])`
159
- * `zone-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
160
- * `zone-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
161
- * `zone-xfr-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
162
- * `zone-xfr-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
151
+ - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
152
+ - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
153
+ * <pre>zone-restore <i>analogous to zone-backup</i></pre>
154
+ * <pre>zone-sign([ZONE], [FLAGS=<b>"B"</b>])</pre>
155
+ * <pre>zone-validate([ZONE], [FLAGS=<b>"B"</b>])</pre>
156
+ * <pre>zone-keys-load([ZONE], [FLAGS=<b>"B"</b>])</pre>
157
+ * <pre>zone-key-rollover([ZONE], TYPE=<b>"ksk"</b>|<b>"zsk"</b>, [FLAGS=<b>"B"</b>])</pre>
158
+ * <pre>zone-ksk-submitted([ZONE], [FLAGS=<b>"B"</b>])</pre>
159
+ * <pre>zone-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
160
+ * <pre>zone-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
161
+ * <pre>zone-xfr-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
162
+ * <pre>zone-xfr-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
163
163
 
164
164
  #### Zone editing
165
165
 
166
166
  Use `"@"` as `OWNER` if you want to denote `ZONE` itself as the owner.
167
167
 
168
- * `zone-read([ZONE`<i>`:if none read all`</i>`], [OWNER], [TYPE])`
169
- * `zone-begin(ZONE)`
170
- * `zone-commit(ZONE)`
171
- * `zone-abort(ZONE)`
172
- * `zone-diff(ZONE)`
173
- * `zone-get(ZONE, [OWNER], [TYPE])` <!-- TODO: test if OWNER and TYPE may be specified independently -->
174
- * `zone-set(ZONE, OWNER, [TTL], TYPE, DATA)`
175
- * `zone-unset(ZONE, OWNER, [TYPE, [DATA]])`
176
- * `zone-purge(ZONE, [FILTERS={`<b>`"o"`</b>`:orphan,`<b>`"c"`</b>`:catalog,`<b>`"e"`</b>`:expire,`<b>`"j"`</b>`:journal,`<b>`"k"`</b>`:kaspdb,`<b>`"t"`</b>`:timers,`<b>`"f"`</b>`:zonefile}], [FLAGS=`<b>`"B"`</b>`])`
177
- * `zone-stats(ZONE, [SECTION`<i>`:module`</i>`], [ITEM`<i>`:counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
168
+ * <pre>zone-read([ZONE<i>:if none read all</i>], [OWNER], [TYPE])</pre>
169
+ * <pre>zone-begin(ZONE)</pre>
170
+ * <pre>zone-commit(ZONE)</pre>
171
+ * <pre>zone-abort(ZONE)</pre>
172
+ * <pre>zone-diff(ZONE)</pre>
173
+ * <pre>zone-get(ZONE, [OWNER], [TYPE])</pre> <!-- TODO: test if OWNER and TYPE may be specified independently -->
174
+ * <pre>zone-set(ZONE, OWNER, [TTL], TYPE, DATA)</pre>
175
+ * <pre>zone-unset(ZONE, OWNER, [TYPE, [DATA]])</pre>
176
+ * <pre>zone-purge(ZONE, [FILTERS={<b>ocejktf</b>}], [FLAGS=<b>"B"</b>])</pre>
177
+ + `FILTERS`: orphan `(o)`, catalog `(c)`, expire `(e)`, journal `(j)`, kaspdb `(k)`, timers `(t)`, zonefile `(f)`
178
+ * <pre>zone-stats(ZONE, [SECTION<i>:module</i>], [ITEM<i>:counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
178
179
 
179
180
  #### Configuration
180
181
 
181
182
  optional list schema option ('s') in FILTERS <!-- TODO: k cemu to je? -->
182
183
 
183
- * `conf-list([SECTION, [ITEM], [ID]], [FILTERS=`<b>`"s"`</b>`])`
184
- * `conf-read([SECTION, [ITEM], [ID]])`
185
- * `conf-begin()`
186
- * `conf-commit()`
187
- * `conf-abort()`
188
- * `conf-diff([SECTION, [ITEM], [ID]])`
189
- * `conf-get([SECTION, [ITEM], [ID]])`
190
- * `conf-set(SECTION, ITEM, ID, [DATA], [FILTERS=`<b>`"s"`</b>`])`
191
- * `conf-unset([SECTION, [ITEM], [ID]], [DATA])`
184
+ For the following commands:<br/>
185
+ &middot; `SECTION` holds the configuration section name (eg. `template`)<br/>
186
+ &middot; `ID` holds the configuration id (eg. `default`)<br/>
187
+ &middot; `ITEM` holds the configuration item name (eg. `storage`)<br/>
188
+
189
+ * <pre>conf-list([SECTION, [ID], [ITEM]], [FILTERS=<b>"s"</b>])</pre>
190
+ * <pre>conf-read([SECTION, [ID], [ITEM]])</pre>
191
+ * <pre>conf-begin()</pre>
192
+ * <pre>conf-commit()</pre>
193
+ * <pre>conf-abort()</pre>
194
+ * <pre>conf-diff([SECTION, [ID], [ITEM]])</pre>
195
+ * <pre>conf-get([SECTION, [ID], [ITEM]])</pre>
196
+ * <pre>conf-set(SECTION, ID, ITEM, [DATA], [FILTERS=<b>"s"</b>])</pre>
197
+ * <pre>conf-unset([SECTION, [ID], [ITEM]], [DATA])</pre>
192
198
 
193
199
  ### Control examples<a id="control-examples"></a>
194
200
 
@@ -99,8 +99,8 @@ cmd-name(SECTION_NAME:<i>section's purpouse</i>,
99
99
  [OPT_SECTION1, OPT_SECTION2], <i># Sections must be present together or not at all</i>
100
100
  [OPT_MASTER, [OPT_SLAVE]], <i># OPT_SLAVE may only appear if OPT_MASTER is present</i>
101
101
  SECTION_NAME2=<b>"option1"</b>|<b>"option2"</b>, <i># Either one or the other literal may be used</i>
102
- SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
103
- SECTION_NAME4={<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b>} <i># any subset of characters</i>
102
+ SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
103
+ SECTION_NAME4=<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b> <i># any subset of characters</i>
104
104
  )
105
105
  </pre>
106
106
 
@@ -108,65 +108,71 @@ The **`"B"`** flag always represents an option to execute in blocking mode.
108
108
 
109
109
  #### Server
110
110
 
111
- * `status([TYPE=`<b>`"cert-key"`</b>`|`<b>`"configure"`</b>`|`<b>`"version"`</b>`|`<b>`"workers"`</b>`])`
112
- * `stop()`
113
- * `reload()`
114
- * `stats([SECTION:`<i>`module`</i>`], [ITEM:`<i>`counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
111
+ * <pre>status([TYPE=<b>"cert-key"</b>|<b>"configure"</b>|<b>"version"</b>|<b>"workers"</b>])</pre>
112
+ * <pre>stop()</pre>
113
+ * <pre>reload()</pre>
114
+ * <pre>stats([SECTION:<i>module</i>], [ITEM:<i>counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
115
115
 
116
116
  #### Zone events
117
117
 
118
118
  `ZONE`: if none applies to all zones
119
119
 
120
- * `zone-status([ZONE], [FILTERS={`<b>`"rstefc"`</b>`}])`
120
+ * <pre>zone-status([ZONE], [FILTERS={<b>"rstefc"</b>}])</pre>
121
121
  + `FILTERS`: role `(r)`, serial `(s)`, transaction `(t)`, events `(e)`, freeze `(f)`, catalog `(c)`
122
- * `zone-reload([ZONE], [FLAGS=`<b>`"B"`</b>`,`<b>`"F"`</b><i>`:reload modules`</i>`])`
123
- * `zone-refresh([ZONE], [FLAGS=`<b>`"B"`</b>`])`
124
- * `zone-retransfer([ZONE], [FLAGS=`<b>`"B"`</b>`])`
125
- * `zone-notify([ZONE], [FLAGS=`<b>`"B"`</b>`])`
126
- * `zone-flush([ZONE], [FILTERS=`<b>`"d"`</b><i>`:specify output directory`</i>`, DATA:`<i>`output directory`</i>`], [FLAGS=`<b>`"B"`</b>`])`
127
- * `zone-backup([ZONE], [FILTERS={`<b>`"dzjtkocq"`</b>`}, [DATA:`<i>`if "d" filter present; output directory`</i>`]], [FLAGS=`<b>`"B"`</b>`])`
122
+ * <pre>zone-reload([ZONE], [FLAGS={<b>"B"</b>,<b>"F"</b><i>:reload modules</i>}])</pre>
123
+ * <pre>zone-refresh([ZONE], [FLAGS=<b>"B"</b>])</pre>
124
+ * <pre>zone-retransfer([ZONE], [FLAGS=<b>"B"</b>])</pre>
125
+ * <pre>zone-notify([ZONE], [FLAGS=<b>"B"</b>])</pre>
126
+ * <pre>zone-flush([ZONE], [FILTERS=<b>"d"</b>, DATA:<i>output directory</i>], [FLAGS=<b>"B"</b>])</pre>
127
+ * <pre>zone-backup([ZONE], [FILTERS={<b>"dzjtkocq"</b>}, [DATA:<i>output dir if "d" filter present</i>]], [FLAGS=<b>"B"</b>])</pre>
128
128
  + `FILTERS`
129
- - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
130
- - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
131
- * `zone-restore` <i>analogous to `zone-backup`</i>
132
- * `zone-sign([ZONE], [FLAGS=`<b>`"B"`</b>`])`
133
- * `zone-validate([ZONE], [FLAGS=`<b>`"B"`</b>`])`
134
- * `zone-keys-load([ZONE], [FLAGS=`<b>`"B"`</b>`])`
135
- * `zone-key-rollover([ZONE], TYPE=`<b>`"ksk"`</b>`|`<b>`"zsk"`</b>`, [FLAGS=`<b>`"B"`</b>`])`
136
- * `zone-ksk-submitted([ZONE], [FLAGS=`<b>`"B"`</b>`])`
137
- * `zone-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
138
- * `zone-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
139
- * `zone-xfr-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
140
- * `zone-xfr-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
129
+ - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
130
+ - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
131
+ * <pre>zone-restore <i>analogous to zone-backup</i></pre>
132
+ * <pre>zone-sign([ZONE], [FLAGS=<b>"B"</b>])</pre>
133
+ * <pre>zone-validate([ZONE], [FLAGS=<b>"B"</b>])</pre>
134
+ * <pre>zone-keys-load([ZONE], [FLAGS=<b>"B"</b>])</pre>
135
+ * <pre>zone-key-rollover([ZONE], TYPE=<b>"ksk"</b>|<b>"zsk"</b>, [FLAGS=<b>"B"</b>])</pre>
136
+ * <pre>zone-ksk-submitted([ZONE], [FLAGS=<b>"B"</b>])</pre>
137
+ * <pre>zone-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
138
+ * <pre>zone-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
139
+ * <pre>zone-xfr-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
140
+ * <pre>zone-xfr-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
141
141
 
142
142
  #### Zone editing
143
143
 
144
144
  Use `"@"` as `OWNER` if you want to denote `ZONE` itself as the owner.
145
145
 
146
- * `zone-read([ZONE`<i>`:if none read all`</i>`], [OWNER], [TYPE])`
147
- * `zone-begin(ZONE)`
148
- * `zone-commit(ZONE)`
149
- * `zone-abort(ZONE)`
150
- * `zone-diff(ZONE)`
151
- * `zone-get(ZONE, [OWNER], [TYPE])` <!-- TODO: test if OWNER and TYPE may be specified independently -->
152
- * `zone-set(ZONE, OWNER, [TTL], TYPE, DATA)`
153
- * `zone-unset(ZONE, OWNER, [TYPE, [DATA]])`
154
- * `zone-purge(ZONE, [FILTERS={`<b>`"o"`</b>`:orphan,`<b>`"c"`</b>`:catalog,`<b>`"e"`</b>`:expire,`<b>`"j"`</b>`:journal,`<b>`"k"`</b>`:kaspdb,`<b>`"t"`</b>`:timers,`<b>`"f"`</b>`:zonefile}], [FLAGS=`<b>`"B"`</b>`])`
155
- * `zone-stats(ZONE, [SECTION`<i>`:module`</i>`], [ITEM`<i>`:counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
146
+ * <pre>zone-read([ZONE<i>:if none read all</i>], [OWNER], [TYPE])</pre>
147
+ * <pre>zone-begin(ZONE)</pre>
148
+ * <pre>zone-commit(ZONE)</pre>
149
+ * <pre>zone-abort(ZONE)</pre>
150
+ * <pre>zone-diff(ZONE)</pre>
151
+ * <pre>zone-get(ZONE, [OWNER], [TYPE])</pre> <!-- TODO: test if OWNER and TYPE may be specified independently -->
152
+ * <pre>zone-set(ZONE, OWNER, [TTL], TYPE, DATA)</pre>
153
+ * <pre>zone-unset(ZONE, OWNER, [TYPE, [DATA]])</pre>
154
+ * <pre>zone-purge(ZONE, [FILTERS={<b>ocejktf</b>}], [FLAGS=<b>"B"</b>])</pre>
155
+ + `FILTERS`: orphan `(o)`, catalog `(c)`, expire `(e)`, journal `(j)`, kaspdb `(k)`, timers `(t)`, zonefile `(f)`
156
+ * <pre>zone-stats(ZONE, [SECTION<i>:module</i>], [ITEM<i>:counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
156
157
 
157
158
  #### Configuration
158
159
 
159
160
  optional list schema option ('s') in FILTERS <!-- TODO: k cemu to je? -->
160
161
 
161
- * `conf-list([SECTION, [ITEM], [ID]], [FILTERS=`<b>`"s"`</b>`])`
162
- * `conf-read([SECTION, [ITEM], [ID]])`
163
- * `conf-begin()`
164
- * `conf-commit()`
165
- * `conf-abort()`
166
- * `conf-diff([SECTION, [ITEM], [ID]])`
167
- * `conf-get([SECTION, [ITEM], [ID]])`
168
- * `conf-set(SECTION, ITEM, ID, [DATA], [FILTERS=`<b>`"s"`</b>`])`
169
- * `conf-unset([SECTION, [ITEM], [ID]], [DATA])`
162
+ For the following commands:<br/>
163
+ &middot; `SECTION` holds the configuration section name (eg. `template`)<br/>
164
+ &middot; `ID` holds the configuration id (eg. `default`)<br/>
165
+ &middot; `ITEM` holds the configuration item name (eg. `storage`)<br/>
166
+
167
+ * <pre>conf-list([SECTION, [ID], [ITEM]], [FILTERS=<b>"s"</b>])</pre>
168
+ * <pre>conf-read([SECTION, [ID], [ITEM]])</pre>
169
+ * <pre>conf-begin()</pre>
170
+ * <pre>conf-commit()</pre>
171
+ * <pre>conf-abort()</pre>
172
+ * <pre>conf-diff([SECTION, [ID], [ITEM]])</pre>
173
+ * <pre>conf-get([SECTION, [ID], [ITEM]])</pre>
174
+ * <pre>conf-set(SECTION, ID, ITEM, [DATA], [FILTERS=<b>"s"</b>])</pre>
175
+ * <pre>conf-unset([SECTION, [ID], [ITEM]], [DATA])</pre>
170
176
 
171
177
  ### Control examples<a id="control-examples"></a>
172
178
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: libknot
3
- Version: 3.3.11.dev0
3
+ Version: 3.3.12.dev0
4
4
  Summary: Python bindings for libknot
5
5
  Home-page: https://gitlab.nic.cz/knot/knot-dns/-/tree/master/python/libknot
6
6
  Author: CZ.NIC, z.s.p.o.
@@ -121,8 +121,8 @@ cmd-name(SECTION_NAME:<i>section's purpouse</i>,
121
121
  [OPT_SECTION1, OPT_SECTION2], <i># Sections must be present together or not at all</i>
122
122
  [OPT_MASTER, [OPT_SLAVE]], <i># OPT_SLAVE may only appear if OPT_MASTER is present</i>
123
123
  SECTION_NAME2=<b>"option1"</b>|<b>"option2"</b>, <i># Either one or the other literal may be used</i>
124
- SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
125
- SECTION_NAME4={<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b>} <i># any subset of characters</i>
124
+ SECTION_NAME3={<b>"asdf"</b>}, <i># any subset of characters</i>
125
+ SECTION_NAME4=<b>"a"</b><i>:flag's purpouse</i>,<b>"s"</b>,<b>"d"</b>,<b>"f"</b> <i># any subset of characters</i>
126
126
  )
127
127
  </pre>
128
128
 
@@ -130,65 +130,71 @@ The **`"B"`** flag always represents an option to execute in blocking mode.
130
130
 
131
131
  #### Server
132
132
 
133
- * `status([TYPE=`<b>`"cert-key"`</b>`|`<b>`"configure"`</b>`|`<b>`"version"`</b>`|`<b>`"workers"`</b>`])`
134
- * `stop()`
135
- * `reload()`
136
- * `stats([SECTION:`<i>`module`</i>`], [ITEM:`<i>`counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
133
+ * <pre>status([TYPE=<b>"cert-key"</b>|<b>"configure"</b>|<b>"version"</b>|<b>"workers"</b>])</pre>
134
+ * <pre>stop()</pre>
135
+ * <pre>reload()</pre>
136
+ * <pre>stats([SECTION:<i>module</i>], [ITEM:<i>counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
137
137
 
138
138
  #### Zone events
139
139
 
140
140
  `ZONE`: if none applies to all zones
141
141
 
142
- * `zone-status([ZONE], [FILTERS={`<b>`"rstefc"`</b>`}])`
142
+ * <pre>zone-status([ZONE], [FILTERS={<b>"rstefc"</b>}])</pre>
143
143
  + `FILTERS`: role `(r)`, serial `(s)`, transaction `(t)`, events `(e)`, freeze `(f)`, catalog `(c)`
144
- * `zone-reload([ZONE], [FLAGS=`<b>`"B"`</b>`,`<b>`"F"`</b><i>`:reload modules`</i>`])`
145
- * `zone-refresh([ZONE], [FLAGS=`<b>`"B"`</b>`])`
146
- * `zone-retransfer([ZONE], [FLAGS=`<b>`"B"`</b>`])`
147
- * `zone-notify([ZONE], [FLAGS=`<b>`"B"`</b>`])`
148
- * `zone-flush([ZONE], [FILTERS=`<b>`"d"`</b><i>`:specify output directory`</i>`, DATA:`<i>`output directory`</i>`], [FLAGS=`<b>`"B"`</b>`])`
149
- * `zone-backup([ZONE], [FILTERS={`<b>`"dzjtkocq"`</b>`}, [DATA:`<i>`if "d" filter present; output directory`</i>`]], [FLAGS=`<b>`"B"`</b>`])`
144
+ * <pre>zone-reload([ZONE], [FLAGS={<b>"B"</b>,<b>"F"</b><i>:reload modules</i>}])</pre>
145
+ * <pre>zone-refresh([ZONE], [FLAGS=<b>"B"</b>])</pre>
146
+ * <pre>zone-retransfer([ZONE], [FLAGS=<b>"B"</b>])</pre>
147
+ * <pre>zone-notify([ZONE], [FLAGS=<b>"B"</b>])</pre>
148
+ * <pre>zone-flush([ZONE], [FILTERS=<b>"d"</b>, DATA:<i>output directory</i>], [FLAGS=<b>"B"</b>])</pre>
149
+ * <pre>zone-backup([ZONE], [FILTERS={<b>"dzjtkocq"</b>}, [DATA:<i>output dir if "d" filter present</i>]], [FLAGS=<b>"B"</b>])</pre>
150
150
  + `FILTERS`
151
- - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
152
- - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
153
- * `zone-restore` <i>analogous to `zone-backup`</i>
154
- * `zone-sign([ZONE], [FLAGS=`<b>`"B"`</b>`])`
155
- * `zone-validate([ZONE], [FLAGS=`<b>`"B"`</b>`])`
156
- * `zone-keys-load([ZONE], [FLAGS=`<b>`"B"`</b>`])`
157
- * `zone-key-rollover([ZONE], TYPE=`<b>`"ksk"`</b>`|`<b>`"zsk"`</b>`, [FLAGS=`<b>`"B"`</b>`])`
158
- * `zone-ksk-submitted([ZONE], [FLAGS=`<b>`"B"`</b>`])`
159
- * `zone-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
160
- * `zone-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
161
- * `zone-xfr-freeze([ZONE], [FLAGS=`<b>`"B"`</b>`])`
162
- * `zone-xfr-thaw([ZONE], [FLAGS=`<b>`"B"`</b>`])`
151
+ - zonefile `(z)`, journal `(j)`, timers `(t)`, kaspdb `(k)`, keysonly `(o)`, catalog `(c)`, quic `(q)`
152
+ - negative counterparts (eg. `nozonefile`) are symmetrical and capitalized
153
+ * <pre>zone-restore <i>analogous to zone-backup</i></pre>
154
+ * <pre>zone-sign([ZONE], [FLAGS=<b>"B"</b>])</pre>
155
+ * <pre>zone-validate([ZONE], [FLAGS=<b>"B"</b>])</pre>
156
+ * <pre>zone-keys-load([ZONE], [FLAGS=<b>"B"</b>])</pre>
157
+ * <pre>zone-key-rollover([ZONE], TYPE=<b>"ksk"</b>|<b>"zsk"</b>, [FLAGS=<b>"B"</b>])</pre>
158
+ * <pre>zone-ksk-submitted([ZONE], [FLAGS=<b>"B"</b>])</pre>
159
+ * <pre>zone-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
160
+ * <pre>zone-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
161
+ * <pre>zone-xfr-freeze([ZONE], [FLAGS=<b>"B"</b>])</pre>
162
+ * <pre>zone-xfr-thaw([ZONE], [FLAGS=<b>"B"</b>])</pre>
163
163
 
164
164
  #### Zone editing
165
165
 
166
166
  Use `"@"` as `OWNER` if you want to denote `ZONE` itself as the owner.
167
167
 
168
- * `zone-read([ZONE`<i>`:if none read all`</i>`], [OWNER], [TYPE])`
169
- * `zone-begin(ZONE)`
170
- * `zone-commit(ZONE)`
171
- * `zone-abort(ZONE)`
172
- * `zone-diff(ZONE)`
173
- * `zone-get(ZONE, [OWNER], [TYPE])` <!-- TODO: test if OWNER and TYPE may be specified independently -->
174
- * `zone-set(ZONE, OWNER, [TTL], TYPE, DATA)`
175
- * `zone-unset(ZONE, OWNER, [TYPE, [DATA]])`
176
- * `zone-purge(ZONE, [FILTERS={`<b>`"o"`</b>`:orphan,`<b>`"c"`</b>`:catalog,`<b>`"e"`</b>`:expire,`<b>`"j"`</b>`:journal,`<b>`"k"`</b>`:kaspdb,`<b>`"t"`</b>`:timers,`<b>`"f"`</b>`:zonefile}], [FLAGS=`<b>`"B"`</b>`])`
177
- * `zone-stats(ZONE, [SECTION`<i>`:module`</i>`], [ITEM`<i>`:counter`</i>`], [FLAGS=`<b>`"F"`</b>`:`<i>`include 0 counters`</i>`])`
168
+ * <pre>zone-read([ZONE<i>:if none read all</i>], [OWNER], [TYPE])</pre>
169
+ * <pre>zone-begin(ZONE)</pre>
170
+ * <pre>zone-commit(ZONE)</pre>
171
+ * <pre>zone-abort(ZONE)</pre>
172
+ * <pre>zone-diff(ZONE)</pre>
173
+ * <pre>zone-get(ZONE, [OWNER], [TYPE])</pre> <!-- TODO: test if OWNER and TYPE may be specified independently -->
174
+ * <pre>zone-set(ZONE, OWNER, [TTL], TYPE, DATA)</pre>
175
+ * <pre>zone-unset(ZONE, OWNER, [TYPE, [DATA]])</pre>
176
+ * <pre>zone-purge(ZONE, [FILTERS={<b>ocejktf</b>}], [FLAGS=<b>"B"</b>])</pre>
177
+ + `FILTERS`: orphan `(o)`, catalog `(c)`, expire `(e)`, journal `(j)`, kaspdb `(k)`, timers `(t)`, zonefile `(f)`
178
+ * <pre>zone-stats(ZONE, [SECTION<i>:module</i>], [ITEM<i>:counter</i>], [FLAGS=<b>"F"</b>:<i>include 0 counters</i>])</pre>
178
179
 
179
180
  #### Configuration
180
181
 
181
182
  optional list schema option ('s') in FILTERS <!-- TODO: k cemu to je? -->
182
183
 
183
- * `conf-list([SECTION, [ITEM], [ID]], [FILTERS=`<b>`"s"`</b>`])`
184
- * `conf-read([SECTION, [ITEM], [ID]])`
185
- * `conf-begin()`
186
- * `conf-commit()`
187
- * `conf-abort()`
188
- * `conf-diff([SECTION, [ITEM], [ID]])`
189
- * `conf-get([SECTION, [ITEM], [ID]])`
190
- * `conf-set(SECTION, ITEM, ID, [DATA], [FILTERS=`<b>`"s"`</b>`])`
191
- * `conf-unset([SECTION, [ITEM], [ID]], [DATA])`
184
+ For the following commands:<br/>
185
+ &middot; `SECTION` holds the configuration section name (eg. `template`)<br/>
186
+ &middot; `ID` holds the configuration id (eg. `default`)<br/>
187
+ &middot; `ITEM` holds the configuration item name (eg. `storage`)<br/>
188
+
189
+ * <pre>conf-list([SECTION, [ID], [ITEM]], [FILTERS=<b>"s"</b>])</pre>
190
+ * <pre>conf-read([SECTION, [ID], [ITEM]])</pre>
191
+ * <pre>conf-begin()</pre>
192
+ * <pre>conf-commit()</pre>
193
+ * <pre>conf-abort()</pre>
194
+ * <pre>conf-diff([SECTION, [ID], [ITEM]])</pre>
195
+ * <pre>conf-get([SECTION, [ID], [ITEM]])</pre>
196
+ * <pre>conf-set(SECTION, ID, ITEM, [DATA], [FILTERS=<b>"s"</b>])</pre>
197
+ * <pre>conf-unset([SECTION, [ID], [ITEM]], [DATA])</pre>
192
198
 
193
199
  ### Control examples<a id="control-examples"></a>
194
200
 
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "libknot"
7
- version = "3.3.11dev"
7
+ version = "3.3.12dev"
8
8
  description = "Python bindings for libknot"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.5"
@@ -7,7 +7,7 @@ if p.exists():
7
7
 
8
8
  setuptools.setup(
9
9
  name='libknot',
10
- version='3.3.11dev',
10
+ version='3.3.12dev',
11
11
  description='Python bindings for libknot',
12
12
  long_description=long_description,
13
13
  long_description_content_type="text/markdown",
File without changes