"option-data": [
{
// Boolean flag indicating if the given option is always
- // send in response or only when requested. The default
+ // sent in response or only when requested. The default
// value of false indicates that it is only sent when
// requested.
"always-send": false,
"name": "domain-name-servers",
// Boolean flag indicating if the given option is never
- // send in response. The default value of false indicates
+ // sent in response. The default value of false indicates
// that it is sent when it should. When true the option
// is not sent despite of any other setting, i.e. it is
// a final flag.
"name": "routers",
// Boolean flag indicating if the given option is never
- // send in response.
+ // sent in response.
"never-send": false,
// Option space. The default value "dhcp4" designates the
"option-data": [
{
// Boolean flag indicating if the given option is always
- // send in response or only when requested. The default
+ // sent in response or only when requested. The default
// value of false indicates that it is only sent when
// requested.
"always-send": false,
"name": "domain-name-servers",
// Boolean flag indicating if the given option is never
- // send in response. The default value of false indicates
+ // sent in response. The default value of false indicates
// that it is sent when it should. When true the option
// is not sent despite of any other setting, i.e. it is
// a final flag.
"name": "routers",
// Boolean flag indicating if the given option is never
- // send in response.
+ // sent in response.
"never-send": false,
// Option space. The default value "dhcp4" designates the
"option-data": [
{
// Boolean flag indicating if the given option is always
- // send in response or only when requested. The default
+ // sent in response or only when requested. The default
// value of false indicates that it is only sent when
// requested.
"always-send": false,
"name": "dns-servers",
// Boolean flag indicating if the given option is never
- // send in response. The default value of false indicates
+ // sent in response. The default value of false indicates
// that it is sent when it should. When true the option
// is not sent despite of any other setting, i.e. it is
// a final flag.
"name": "preference",
// Boolean flag indicating if the given option is never
- // send in response.
+ // sent in response.
"never-send": false,
// Option space. The default value "dhcp6" designates the
"option-data": [
{
// Boolean flag indicating if the given option is always
- // send in response or only when requested. The default
+ // sent in response or only when requested. The default
// value of false indicates that it is only sent when
// requested.
"always-send": false,
"name": "dns-servers",
// Boolean flag indicating if the given option is never
- // send in response. The default value of false indicates
+ // sent in response. The default value of false indicates
// that it is sent when it should. When true the option
// is not sent despite of any other setting, i.e. it is
// a final flag.
"name": "preference",
// Boolean flag indicating if the given option is never
- // send in response.
+ // sent in response.
"never-send": false,
// Option space. The default value "dhcp6" designates the
}
-The ``domain-name-servers`` option is always added to responses (the
-always-send is "sticky"), but the value is the subnet one when the client
-is localized in the subnet.
+In the example above, the ``domain-name-servers`` option respects the global
+``always-send`` flag and is always added to responses, but for subnet
+``192.0.3.0/24``, the value is taken from the subnet-level option data
+specification.
At the opposite of ``always-send`` if the ``never-send`` flag is set to
``true`` for a particular option the server does not add it to the response.
The effect is the same as if the client removed the option code in the
-Parameter Request List option Option (or its equivalent for vendor options):
+Parameter Request List option (or its equivalent for vendor options):
::
...
}
-The ``domain-name-servers`` option is never added to responses (the
-never-send is "sticky" too). The ``never-send`` is as the precedence
-over ``always-send`` so if both are true the option is not added.
+In the example above, ``domain-name-servers`` option is never added to
+responses on subnet ``192.0.3.0/24``. ``never-send`` has precedence over
+``always-send`` so if both are true the option is not added.
.. note::
}
-The ``dns-servers`` option is always added to responses (the always-send is
-"sticky"), but the value is the subnet one when the client is localized
-in the subnet.
+In the example above, the ``dns-servers`` option respects the global
+``always-send`` flag and is always added to responses, but for subnet
+``2001:db8:1::/64``, the value is taken from the subnet-level option data
+specification.
At the opposite of ``always-send`` if the ``never-send`` flag is set to
``true`` for a particular option the server does not add it to the response.
...
}
-The ``dns-server`` option is never added to responses (the never-send is
-"sticky" too). The ``never-send`` is as the precedence over ``always-send``
-so if both are true the option is not added.
+In the example above, the ``dns-server`` option is never added to responses
+on subnet ``2001:db8:1::/64``. ``never-send`` has precedence over
+``always-send`` so if both are true the option is not added.
.. note::
option_data_csv_format: CSV_FORMAT COLON BOOLEAN {
ctx.unique("csv-format", ctx.loc2pos(@1));
- ElementPtr space(new BoolElement($3, ctx.loc2pos(@3)));
- ctx.stack_.back()->set("csv-format", space);
+ ElementPtr csv(new BoolElement($3, ctx.loc2pos(@3)));
+ ctx.stack_.back()->set("csv-format", csv);
};
option_data_always_send: ALWAYS_SEND COLON BOOLEAN {
option_data_never_send: NEVER_SEND COLON BOOLEAN {
ctx.unique("never-send", ctx.loc2pos(@1));
- ElementPtr persist(new BoolElement($3, ctx.loc2pos(@3)));
- ctx.stack_.back()->set("never-send", persist);
+ ElementPtr cancel(new BoolElement($3, ctx.loc2pos(@3)));
+ ctx.stack_.back()->set("never-send", cancel);
};
// ---- pools ------------------------------------