Skip to content
Snippets Groups Projects
Commit 4fc38ff1 authored by Daniel Salzman's avatar Daniel Salzman
Browse files

doc: unify configuration option references

parent 911bfd45
No related branches found
No related tags found
No related merge requests found
Pipeline #49200 passed with warnings
......@@ -276,7 +276,7 @@ causing freeze pending. Because of it the blocking mode is used to ensure
the operation was finished. Then the zone can be flushed to a file.
Now the zone file can be safely modified (e.g. using a text editor).
If "`zonefile-load: difference-no-serial`" is not set, it's also necessary to
If :ref:`zone_zonefile-load` is not set to `difference-no-serial`, it's also necessary to
**increase SOA serial** in this step to keep consistency. Finally, we can load the
modified zone file and if successful, thaw the zone::
......@@ -298,7 +298,7 @@ are not taken into account here – they are planned after the zone is loaded
If the zone file exists and is not excluded by the configuration, it is first loaded
and according to its SOA serial number relevant journal changesets are applied.
If this is a zone reload and we have "`zonefile-load: difference`", the difference
If this is a zone reload and we have :ref:`zone_zonefile-load` set to `difference`, the difference
between old and new contents is computed and stored into the journal like an update.
The zone file should be either unchaged since last load or changed with incremented
SOA serial. In the case of a decreased SOA serial, the load is interrupted with
......@@ -307,7 +307,7 @@ an error; if unchanged, it is increased by the server.
If the procedure described above succeeds without errors, the resulting zone contents are (after potential DNSSEC signing)
used as the new zone.
The option "`journal-content: all`" lets the server, beside better performance, to keep
The option :ref:`zone_journal-content` set to `all` lets the server, beside better performance, to keep
track of the zone contents also across server restarts. It makes the cold start
effectively work like a zone reload with the old contents loaded from the journal
(unless this is the very first start with the zone not yet saved into the journal).
......@@ -392,7 +392,8 @@ Zonefileless setup::
Zone contents are stored just in the journal. The zone is updated by DDNS,
zone transfer, or via the control interface. The user might have filled the
zone contents initially from a zone file by setting "zonefile-load: whole" temporarily.
zone contents initially from a zone file by setting :ref:`zone_zonefile-load` to
`whole` temporarily.
It's also a good setup for slaves. Anyway, it's recommended to carefully tune
the journal-size-related options to avoid surprises of journal getting full.
......@@ -413,8 +414,8 @@ The zone file's SOA serial must be properly set to a number which is higher than
current SOA serial in the zone (not in the zone file) if manually updated!
.. NOTE::
In the case of "zonefile-load: difference-no-serial", the SOA serial is
handled by the server automatically during server reload.
In the case of :ref:`zone_zonefile-load` is set to `difference-no-serial`,
the SOA serial is handled by the server automatically during server reload.
.. _DNSSEC Key states:
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment