Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
Sebastian Schrader
Kea
Commits
1d293e72
Commit
1d293e72
authored
Aug 06, 2014
by
Tomek Mrugalski
🛰
Browse files
[3468] "true", "false" => true, false
parent
14ce7e33
Changes
2
Hide whitespace changes
Inline
Side-by-side
doc/guide/dhcp4-srv.xml
View file @
1d293e72
...
...
@@ -89,7 +89,7 @@
# Next we specify the type of lease database
"lease-database": {
"type": "memfile",
"persist":
"
true
"
,
"persist": true,
"name": "/var/kea/dhcp4.leases"
},
...
...
@@ -250,7 +250,7 @@ url="http://jsonviewer.stack.hu/"/>.
"Dhcp4": {
"lease-database": {
<userinput>
"type": "memfile"
</userinput>
,
<userinput>
"persist":
"
true
"
</userinput>
,
<userinput>
"persist": true
</userinput>
,
<userinput>
"name": "/tmp/kea-leases4.csv"
</userinput>
}
...
...
...
@@ -260,12 +260,12 @@ url="http://jsonviewer.stack.hu/"/>.
</para>
<para>
The "persist" parameter controls whether the leases are written to disk.
It is strongly recommended that this parameter is set to
"true" at all times
during the normal operation of the server. (Not writing leases to disk will
mean that if a server is restarted (e.g. after a power failure), it will not
know what addresses have been assigned. As a result, it may hand ou
t addresses
to new clients that are
already in use.)
</para>
It is strongly recommended that this parameter is set to
<command>
true
</command>
at all times during the normal operation of the
server. (Not writing leases to disk will mean that if a server is restarted
(e.g. after a power failure), it will not know wha
t addresses
have been
assigned. As a result, it may hand out addresses
to new clients that are
already in use.)
</para>
</section>
<section
id=
"database-configuration4"
>
...
...
@@ -474,7 +474,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "domain-name-servers",
"code": 6,
"space": "dhcp4",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "192.0.2.1, 192.0.2.2"
</userinput>
},
...
...
...
@@ -512,7 +512,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "domain-name-servers",
"code": 6,
"space": "dhcp4",
"csv-format":
"
false
"
,
"csv-format": false,
"data": "C0 00 03 01 C0 00 03 02"
</userinput>
},
...
...
...
@@ -544,7 +544,7 @@ temporarily override a list of interface names and listen on all interfaces.
"name": "domain-name-servers",
"code": 6,
"space: "dhcp4",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "192.0.2.3"
},
...
...
...
@@ -768,7 +768,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "foo",
"code": 222,
"type": "uint32",
"array":
"
false
"
,
"array": false,
"record-types": "",
"space": "dhcp4",
"encapsulate": ""
</userinput>
...
...
@@ -777,17 +777,18 @@ temporarily override a list of interface names and listen on all interfaces.
...
}
</screen>
The "false" value of the
<command>
array
</command>
parameter determines that the option
does NOT comprise an array of "uint32" values but rather a single value.
Two other parameters have been left blank:
<command>
record-types
</command>
and
<command>
encapsulate
</command>
.
The former specifies the comma separated list of option data fields if the
option comprises a record of data fields. This should
be non-empty if the
<command>
type
</command>
is set to "record". Otherwise it must be left
blank. The latter parameter specifies the name of the option space being
encapsulated by the particular option. If the particular option does not
encapsulate any option space it should be left blank.
Note that the above set of comments define the format of the new option and do not
set its values.
The
<command>
false
</command>
value of the
<command>
array
</command>
parameter determines that the option does NOT comprise an array of
"uint32" values but rather a single value. Two other parameters have been
left blank:
<command>
record-types
</command>
and
<command>
encapsulate
</command>
. The former specifies the comma separated
list of option data fields if the option comprises a record of data
fields. This should be non-empty if the
<command>
type
</command>
is set to
"record". Otherwise it must be left blank. The latter parameter specifies
the name of the option space being encapsulated by the particular
option. If the particular option does not encapsulate any option space it
should be left blank. Note that the above set of comments define the
format of the new option and do not set its values.
</para>
<note>
<para>
...
...
@@ -808,7 +809,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
name "foo",
"code": 222,
"space": "dhcp4",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "12345"
</userinput>
}, ...
],
...
...
@@ -832,7 +833,7 @@ temporarily override a list of interface names and listen on all interfaces.
"code": 223,
"space": "dhcp4",
"type": "record",
"array":
"
false
"
,
"array": false,
"record-types": "ipv4-address, uint16, boolean, string",
"encapsulate": ""
</userinput>
}, ...
...
...
@@ -853,25 +854,25 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "bar",
"space": "dhcp4",
"code": 223,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "192.0.2.100, 123, true, Hello World"
</userinput>
}
],
...
}
</screen>
<command>
csv-format
</command>
is set "true" to indicate that the
<command>
data
</command>
field comprises a command-separated
list of values. The values in the
<command>
data
</command>
must correspond to the types set in
the
<command>
record-types
</command>
field of the option definition.
<command>
csv-format
</command>
is set
<command>
true
</command>
to indicate
that the
<command>
data
</command>
field comprises a command-separated list
of values. The values in the
<command>
data
</command>
must correspond to
the types set in the
<command>
record-types
</command>
field of the option
definition.
</para>
<note>
<para>
It is recommended that boolean values are specified using "true" and "false"
strings. This helps to prevent errors when typing multiple comma separated
values, as it make it easier to identify the type of the value being typed,
and compare it with the order of data fields. Nevertheless, it is possible
to use integer values: "1" and "0", instead of "true" and "false".
If other integer value are used, the configuration is rejected.
</para>
<para>
In general case, boolean values are specified as
<command>
true
</command>
or
<command>
false
</command>
, without quotes. Some specific boolean parameters may
accept also
<command>
"true"
</command>
,
<command>
"false"
</command>
,
<command>
0
</command>
,
<command>
1
</command>
,
<command>
"0"
</command>
and
<command>
"1"
</command>
. Future Kea versions will accept all those values
for all boolean parameters.
</para>
</note>
</section>
...
...
@@ -897,7 +898,7 @@ temporarily override a list of interface names and listen on all interfaces.
"code": 1,
"space": "vendor-encapsulated-options-space",
"type": "record",
"array":
"
false
"
,
"array": false,
"record-types": "ipv4-address, uint16, string",
"encapsulates": ""
</userinput>
}
...
...
@@ -914,7 +915,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "foo"
"space": "vendor-encapsulated-options-space",
"code": 1,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "192.0.2.3, 123, Hello World"
</userinput>
}
],
...
...
@@ -929,7 +930,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "vendor-encapsulated-options"
"space": "dhcp4",
"code": 43,
"csv-format":
"
false
"
,
"csv-format": false,
"data": ""
</userinput>
}
],
...
...
@@ -977,7 +978,7 @@ temporarily override a list of interface names and listen on all interfaces.
"space": "isc",
"type": "ipv4-address".
"record-types": "",
"array":
"
false
"
,
"array": false,
"encapsulate ""
},
{
...
...
@@ -986,7 +987,7 @@ temporarily override a list of interface names and listen on all interfaces.
"space": "isc",
"type": "string",
"record-types": "",
"array":
"
false
"
"array": false
"encapsulate": ""
</userinput>
}
],
...
...
@@ -1007,7 +1008,7 @@ temporarily override a list of interface names and listen on all interfaces.
"code": 222,
"space": "dhcp4",
"type": "empty",
"array":
"
false
"
,
"array": false,
"record-types": "",
"encapsulate": "isc"
</userinput>
}
...
...
@@ -1028,21 +1029,21 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "subopt1",
"space": "isc",
"code": 1,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "192.0.2.3"
</userinput>
},
}
<userinput>
"name": "subopt2",
"space": "isc",
"code": 2,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "Hello world"
</userinput>
},
{
<userinput>
"name": "container",
"space": "dhcp4",
"code": 222,
"csv-format":
"
true
"
,
"csv-format": true,
"data": ""
</userinput>
}
],
...
...
@@ -1090,7 +1091,7 @@ temporarily override a list of interface names and listen on all interfaces.
"name": "domain-name-servers",
"code": 6,
"data": "192.0.2.200,192.0.2.201",
"csv-format":
"
true
"
,
"csv-format": true,
"space": "dhcp4"
} ]
}
...
...
@@ -1237,7 +1238,7 @@ temporarily override a list of interface names and listen on all interfaces.
<screen>
"Dhcp4": {
"dhcp-ddns": {
<userinput>
"enable-updates":
"
true
"
,
<userinput>
"enable-updates": true,
"server-ip": "127.0.0.1",
"server-port": 53001,
"sender-ip": "",
...
...
@@ -1245,9 +1246,9 @@ temporarily override a list of interface names and listen on all interfaces.
"max-queue-size": 1024,
"ncr-protocol": "UDP",
"ncr-format": "JSON",
"override-no-update":
"
false
"
,
"override-client-update":
"
false
"
,
"replace-client-name":
"
false
"
,
"override-no-update": false,
"override-client-update": false,
"replace-client-name": false,
"generated-prefix": "myhost",
"qualifying-suffix": "example.com"
</userinput>
},
...
...
@@ -1436,7 +1437,7 @@ temporarily override a list of interface names and listen on all interfaces.
<screen>
"Dhcp4": {
"dhcp-ddns": {
<userinput>
"override-client-update":
"
true
"
</userinput>
,
<userinput>
"override-client-update": true
</userinput>
,
...
},
...
...
...
@@ -1456,7 +1457,7 @@ temporarily override a list of interface names and listen on all interfaces.
<screen>
"Dhcp4": {
"dhcp-ddns": {
<userinput>
"override-no-update":
"
true
"
</userinput>
,
<userinput>
"override-no-update": true
</userinput>
,
...
},
...
...
...
@@ -1508,7 +1509,7 @@ temporarily override a list of interface names and listen on all interfaces.
<screen>
"Dhcp4": {
"dhcp-ddns": {
<userinput>
"replace-client-name":
"
true
"
</userinput>
,
<userinput>
"replace-client-name": true
</userinput>
,
...
},
...
...
...
@@ -1612,7 +1613,7 @@ temporarily override a list of interface names and listen on all interfaces.
<screen>
"Dhcp4": {
<userinput>
"echo-client-id":
"
false
"
</userinput>
,
<userinput>
"echo-client-id": false
</userinput>
,
...
}
</screen>
...
...
doc/guide/dhcp6-srv.xml
View file @
1d293e72
...
...
@@ -90,7 +90,7 @@
# Next we specify the type of lease database
"lease-database": {
"type": "memfile",
"persist":
"
true
"
,
"persist": true,
"name": "/var/kea/dhcp6.leases"
},
...
...
@@ -259,7 +259,7 @@ JSON validator is available at <ulink url="http://jsonviewer.stack.hu/"/>.
"Dhcp6": {
"lease-database": {
<userinput>
"type": "memfile"
</userinput>
,
<userinput>
"persist":
"
true
"
</userinput>
,
<userinput>
"persist": true
</userinput>
,
<userinput>
"name": "/tmp/kea-leases6.csv"
</userinput>
}
...
...
...
@@ -269,7 +269,7 @@ JSON validator is available at <ulink url="http://jsonviewer.stack.hu/"/>.
</para>
<para>
The "persist" parameter controls whether the leases are written to disk.
It is strongly recommended that this parameter is set to
"
true
"
at all times
It is strongly recommended that this parameter is set to true at all times
during the normal operation of the server. (Not writing leases to disk will
mean that if a server is restarted (e.g. after a power failure), it will not
know what addresses have been assigned. As a result, it may hand out addresses
...
...
@@ -568,7 +568,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "dns-servers",
"code": 23,
"space": "dhcp6",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "2001:db8::cafe, 2001:db8::babe"
</userinput>
},
...
...
...
@@ -608,7 +608,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "dns-servers",
"code": 23,
"space": "dhcp6",
"csv-format":
"
false
"
,
"csv-format": false,
"data": "2001 0DB8 0001 0000 0000 0000 0000 CAFE
2001 0DB8 0001 0000 0000 0000 0000 BABE"
</userinput>
},
...
...
@@ -647,7 +647,7 @@ temporarily override a list of interface names and listen on all interfaces.
"name": "dns-servers",
"code": 23,
"space: "dhcp6",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "2001:db8:1::3"
},
...
...
...
@@ -783,7 +783,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "foo",
"code": 100,
"type": "uint32",
"array":
"
false
"
,
"array": false,
"record-types": "",
"space": "dhcp6",
"encapsulate": ""
</userinput>
...
...
@@ -814,7 +814,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
name "foo",
"code": 100,
"space": "dhcp6",
"csv-format":
"
true
"
,
"csv-format": true,
"data": "12345"
</userinput>
}, ...
],
...
...
@@ -840,7 +840,7 @@ temporarily override a list of interface names and listen on all interfaces.
"code": 101,
"space": "dhcp6",
"type": "record",
"array":
"
false
"
,
"array": false,
"record-types": "ipv4-address, uint16, boolean, string",
"encapsulate": ""
</userinput>
}, ...
...
...
@@ -861,27 +861,28 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "bar",
"space": "dhcp6",
"code": 101,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "2001:db8:1::10, 123, false, Hello World"
</userinput>
}
],
...
}
</screen>
"csv-format" is set "true" to indicate that the "data" field comprises a command-separated
list of values. The values in the "data" must correspond to the types set in
<command>
csv-format
</command>
is set
<command>
true
</command>
to indicate
that the
<command>
data
</command>
field comprises a command-separated list
of values. The values in the "data" must correspond to the types set in
the "record-types" field of the option definition.
</para>
<note>
<para>
It is recommended that boolean values are specified using "true" and "false"
strings. This helps to prevent errors when typing multiple comma separated
values, as it make it easier to identify the type of the value being typed,
and compare it with the order of data fields. Nevertheless, it is possible
to use integer values: "1" and "0", instead of "true" and "false"
accordingly. If other integer value is specified, the configuration is
rejected.
</para>
<para>
In general case, boolean values are specified as
<command>
true
</command>
or
<command>
false
</command>
, without quotes. Some specific boolean parameters may
accept also
<command>
"true"
</command>
,
<command>
"false"
</command>
,
<command>
0
</command>
,
<command>
1
</command>
,
<command>
"0"
</command>
and
<command>
"1"
</command>
. Future Kea versions will accept all those values
for all boolean parameters.
</para>
</note>
</section>
<section
id=
"dhcp6-vendor-opts"
>
...
...
@@ -905,7 +906,7 @@ temporarily override a list of interface names and listen on all interfaces.
"code": 1,
"space": "vendor-encapsulated-options-space",
"type": "record",
"array":
"
false
"
,
"array": false,
"record-types": "ipv6-address, uint16, string",
"encapsulates": ""
</userinput>
}
...
...
@@ -922,7 +923,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "foo"
"space": "vendor-encapsulated-options-space",
"code": 1,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "2001:db8:1::10, 123, Hello World"
</userinput>
},
...
...
...
@@ -939,7 +940,7 @@ temporarily override a list of interface names and listen on all interfaces.
<userinput>
"name": "vendor-encapsulated-options"
"space": "dhcp6",
"code": 17,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "12345"
</userinput>
}
],
...
...
@@ -975,7 +976,7 @@ temporarily override a list of interface names and listen on all interfaces.
"space": "isc",
"type": "ipv6-address".
"record-types": "",
"array":
"
false
"
,
"array": false,
"encapsulate ""
},
{
...
...
@@ -984,7 +985,7 @@ temporarily override a list of interface names and listen on all interfaces.
"space": "isc",
"type": "string",
"record-types": "",
"array":
"
false
"
"array": false
"encapsulate": ""
</userinput>
}
],
...
...
@@ -1005,7 +1006,7 @@ should include options from the isc option space:
"code": 102,
"space": "dhcp6",
"type": "empty",
"array":
"
false
"
,
"array": false,
"record-types": "",
"encapsulate": "isc"
</userinput>
}
...
...
@@ -1027,21 +1028,21 @@ should include options from the isc option space:
<userinput>
"name": "subopt1",
"space": "isc",
"code": 1,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "2001:db8::abcd"
</userinput>
},
}
<userinput>
"name": "subopt2",
"space": "isc",
"code": 2,
"csv-format":
"
true
"
,
"csv-format": true,
"data": "Hello world"
</userinput>
},
{
<userinput>
"name": "container",
"space": "dhcp6",
"code": 102,
"csv-format":
"
true
"
,
"csv-format": true,
"data": ""
</userinput>
}
],
...
...
@@ -1283,7 +1284,7 @@ should include options from the isc option space:
<screen>
"Dhcp6": {
"dhcp-ddns": {
<userinput>
"enable-updates":
"
true
"
,
<userinput>
"enable-updates": true,
"server-ip": "127.0.0.1",
"server-port": 53001,
"sender-ip": "",
...
...
@@ -1291,9 +1292,9 @@ should include options from the isc option space:
"max-queue-size": 1024,
"ncr-protocol": "UDP",
"ncr-format": "JSON",
"override-no-update":
"
false
"
,
"override-client-update":
"
false
"
,
"replace-client-name":
"
false
"
,
"override-no-update": false,
"override-client-update": false,
"replace-client-name": false,
"generated-prefix": "myhost",
"qualifying-suffix": "example.com"
</userinput>
},
...
...
@@ -1485,7 +1486,7 @@ should include options from the isc option space:
<screen>
"Dhcp6": {
"dhcp-ddns": {
<userinput>
"override-client-update":
"
true
"
</userinput>
,
<userinput>
"override-client-update": true
</userinput>
,
...
},
...
...
...
@@ -1505,7 +1506,7 @@ should include options from the isc option space:
<screen>
"Dhcp6": {
"dhcp-ddns": {
<userinput>
"override-no-update":
"
true
"
</userinput>
,
<userinput>
"override-no-update": true
</userinput>
,
...
},
...
...
...
@@ -1550,7 +1551,7 @@ should include options from the isc option space:
<screen>
"Dhcp6": {
"dhcp-ddns": {
<userinput>
"replace-client-name":
"
true
"
</userinput>
,
<userinput>
"replace-client-name": true
</userinput>
,
...
},
...
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment