... | ... | @@ -13,7 +13,7 @@ For easier understanding of what is and what is not supported, the commands are |
|
|
|
|
|
Often there are many ways that certain things can be achieved. Where appropriate, the text below explains the rationale that led to specific design choices.
|
|
|
|
|
|
This document refers to sections, tables, and chapters of the Kea User's Guide. The Kea User's Guide is available from the main Kea webpage ([https://kea.isc.org/docs/kea-guide.html stable] and [https://jenkins.isc.org/job/Kea_doc/guide/kea-guide.html development]). Commands that are implemented in released versions are documented in the Kea User's Guide.
|
|
|
This document refers to sections, tables, and chapters of the Kea User's Guide. The Kea User's Guide is available from the main Kea webpage ([https://kea.readthedocs.io/ stable] and [https://kea.readthedocs.io/en/latest/ development]). Commands that are implemented in released versions are documented in the Kea User's Guide.
|
|
|
|
|
|
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [https://tools.ietf.org/html/rfc2119 RFC2119].
|
|
|
|
... | ... | @@ -334,7 +334,7 @@ Option definitions allow defining standard options, custom options, vendor space |
|
|
|
|
|
Kea allow option specification on a global and per-subnet level. Both can be manipulated using the same command. There will be an optional parameter, subnet-id. If it's not specified, the code applies to the global level. If there is a subnet-id specified, the change applies to the specific subnet. The same rule applies to all commands related to options.
|
|
|
|
|
|
```add-option4``` and ```add-option6``` add new DHCPv4 or DHCPv6 option values. It is expected that only options that have definitions can be specified. This requires either the option to be standard or to have a custom definition. See [https://git.kea.isc.org/~tester/kea/guide/kea-guide.html#dhcp4-std-options Table 7.1] in Section 7.2.8 and [https://git.kea.isc.org/~tester/kea/guide/kea-guide.html#dhcp6-std-options Table 8.1] in Section 8.2.8 of the Kea User's Guide for a list of currently defined standard options. This command would generally expect parameters as specified in Section 8.2.8, i.e. one of option-name or option-code being mandatory, option-space being optional with the default option space being "dhcp4" or "dhcp6" depending on which command was called, csv-format to be true. Option-data is mandatory for options that have any fields (most options have, except empty and container options).
|
|
|
```add-option4``` and ```add-option6``` add new DHCPv4 or DHCPv6 option values. It is expected that only options that have definitions can be specified. This requires either the option to be standard or to have a custom definition. See [the DHCPv4 table](https://kea.readthedocs.io/en/latest/arm/dhcp4-srv.html#dhcp4-std-options-list) and [the DHCPv6 table](https://kea.readthedocs.io/en/latest/arm/dhcp6-srv.html#dhcp6-std-options-list) in the Kea User's Guide for a list of currently defined standard options. This command would generally expect parameters as specified in Section 8.2.8, i.e. one of option-name or option-code being mandatory, option-space being optional with the default option space being "dhcp4" or "dhcp6" depending on which command was called, csv-format to be true. Option-data is mandatory for options that have any fields (most options have, except empty and container options).
|
|
|
|
|
|
```set-options4``` and ```set-options6``` set all option values for a given scope. If the subnet-id is not specified, the options are set globally. If there is a subnet-id specified, the option values will be set only for a given subnet. Input parameters are sanity-checked the same way as described for ```add-optionX``` with the additional check against subnet-id having proper values.
|
|
|
|
... | ... | |