Commit 459535bf authored by Ales Mrazek's avatar Ales Mrazek

common-model documentation

parent 2fcf010b
Pipeline #40618 passed with stages
in 56 seconds
......@@ -39,13 +39,17 @@ There is no ``group-name`` option for Unbound to set.
.. code-block:: python
DataModel: "server": {
"user-name": "username",
"group-name": "group"
}
# DataModel:
"server": {
"user-name": "username",
"group-name": "group"
}
KnotResolver: user('username','group') # Conversion: no conversion
Unbound: username: "username" # Conversion: no conversion
# KnotResolver:
user('username','group') # Conversion: no conversion
# Unbound:
username: "username" # Conversion: no conversion
network:
......@@ -53,36 +57,69 @@ network:
resolver:
^^^^^^^^^
**stub-zones**:
**stub-zones:**
.. code-block:: python
# DataModel:
"stub-zones": [
{
"domain": "stub.example.com",
"nameserver": "192.0.2.1",
"port": 53 # Default: 53
}
]
# KnotResolver:
STUB('192.0.2.1@53') # Conversion: 'nameserver' + port -> nameserver@port'
# Unbound:
stub-zone:
name: "stub.example.com" # Conversion: no conversion
stub-addr: "192.0.2.1@53" # Conversion: 'nameserver' + port -> nameserver@port'
Knot Resolver ``STUB(ip)`` configuration only accepts IP addresses. In common configuration option
``"nameserver"`` can be Name or IP address. If ``"nameserver"`` option is Name, ``gethostbyname`` method from
module ``socket`` is used to ask for IP address of this Name. For Unbound is used ``stub-host:`` configuration function insted of ``stub-addr:``
**options:**
.. code-block:: python
DataModel: "stub-zones": [
{
"domain": "stub.example.com",
"nameserver": "192.0.2.1",
"port": 53 # Default: 53
}
]
# DataModel:
"options": {
"glue-checking": "strict" | "normal" | "permissive",
}
# KnotResolver:
mode('strict' | 'normal' | 'permissive') # Conversion: no conversion
KnotResolver: STUB('192.0.2.1@53') # Conversion: 'nameserver' + port -> nameserver@port'
Unbound: stub-zone:
name: "stub.example.com" # Conversion: no conversion
stub-addr: "192.0.2.1@53" # Conversion: 'nameserver' + port -> nameserver@port'
# Unbound:
harden-glue: yes | no # Conversion: "strict" -> yes
# "normal" | "permissive" -> no
This setting is taken directly from the Knot resolver.
So there is no conversion to the Knot Resolver configuration.
Unbound has only two options for ``glue-checking``.
logging
^^^^^^^
**verbosity**:
**verbosity:**
.. code-block:: python
DataModel: "verbosity": 0-5 # Default: 1
# DataModel:
"logging": {
"verbosity": 0-5 # Default: 1
}
# KnotResolver:
verbosity: 0-5 # Conversion: no conversion
KnotResolver: verbosity: 0-5 # Conversion: no conversion
Unbound: verbose(true/false) # Conversion: 0 -> false 1-5 -> true
# Unbound:
verbose(true | false) # Conversion: 0 -> false
# 1-5 -> true
dnssec:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment