From: David VaĊĦek Date: Tue, 23 May 2023 14:41:50 +0000 (+0200) Subject: doc/knotc: document QUIC filters in "zone-backup" and "zone-restore" X-Git-Tag: v3.4.dev~112^2~8 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=403bcf21061139c42e620d402e98b5f85f40fa85;p=thirdparty%2Fknot-dns.git doc/knotc: document QUIC filters in "zone-backup" and "zone-restore" --- diff --git a/doc/man/knotc.8in b/doc/man/knotc.8in index fa65005275..55704e5420 100644 --- a/doc/man/knotc.8in +++ b/doc/man/knotc.8in @@ -155,16 +155,17 @@ blocking mode) to a zone file in the specified directory. See \fBzone\-backup\fP [\fIzone\fP\&...] \fB+backupdir\fP \fIdirectory\fP [\fIfilter\fP\&...] Trigger a zone data and metadata backup to a specified directory. Available filters are \fB+zonefile\fP, \fB+journal\fP, \fB+timers\fP, \fB+kaspdb\fP, -\fB+catalog\fP, and their negative counterparts \fB+nozonefile\fP, \fB+nojournal\fP, -\fB+notimers\fP, \fB+nokaspdb\fP, and \fB+nocatalog\fP\&. With these filters set, -zone contents, zone\(aqs journal, zone related timers, zone related data in the -KASP database together with keys, and zone\(aqs catalog, respectively, are backed up, +\fB+catalog\fP, \fB+quic\fP, and their negative counterparts \fB+nozonefile\fP, +\fB+nojournal\fP, \fB+notimers\fP, \fB+nokaspdb\fP, \fB+nocatalog\fP, and \fB+noquic\fP\&. +With these filters set, zone contents, zone\(aqs journal, zone\-related timers, +zone\-related data in the KASP database together with keys, zone\(aqs catalog, +and the server QUIC key and certificate, respectively, are backed up, or omitted from the backup. By default, filters \fB+zonefile\fP, \fB+timers\fP, -\fB+kaspdb\fP, \fB+catalog\fP, and \fB+nojournal\fP are set. Setting a filter -for an item doesn\(aqt change default settings for other items. If zone flushing -is disabled, original zone file is backed up instead of writing out zone -contents to a file. See \fI\%Notes\fP below about the directory -permissions. (#) +\fB+kaspdb\fP, \fB+catalog\fP, \fB+nojournal\fP, and \fB+noquic\fP are set. Setting +a filter for an item doesn\(aqt change default settings for other items. +If zone flushing is disabled, the original zone file is backed up instead of +writing out zone contents to a file. See \fI\%Notes\fP below about +the directory permissions. (#) .TP \fBzone\-restore\fP [\fIzone\fP\&...] \fB+backupdir\fP \fIdirectory\fP [\fIfilter\fP\&...] Trigger a zone data and metadata restore from a specified backup directory. diff --git a/doc/man_knotc.rst b/doc/man_knotc.rst index 7708e3d6dd..d9daa87f24 100644 --- a/doc/man_knotc.rst +++ b/doc/man_knotc.rst @@ -132,16 +132,17 @@ Actions **zone-backup** [*zone*...] **+backupdir** *directory* [*filter*...] Trigger a zone data and metadata backup to a specified directory. Available filters are **+zonefile**, **+journal**, **+timers**, **+kaspdb**, - **+catalog**, and their negative counterparts **+nozonefile**, **+nojournal**, - **+notimers**, **+nokaspdb**, and **+nocatalog**. With these filters set, - zone contents, zone's journal, zone related timers, zone related data in the - KASP database together with keys, and zone's catalog, respectively, are backed up, + **+catalog**, **+quic**, and their negative counterparts **+nozonefile**, + **+nojournal**, **+notimers**, **+nokaspdb**, **+nocatalog**, and **+noquic**. + With these filters set, zone contents, zone's journal, zone-related timers, + zone-related data in the KASP database together with keys, zone's catalog, + and the server QUIC key and certificate, respectively, are backed up, or omitted from the backup. By default, filters **+zonefile**, **+timers**, - **+kaspdb**, **+catalog**, and **+nojournal** are set. Setting a filter - for an item doesn't change default settings for other items. If zone flushing - is disabled, original zone file is backed up instead of writing out zone - contents to a file. See :ref:`Notes` below about the directory - permissions. (#) + **+kaspdb**, **+catalog**, **+nojournal**, and **+noquic** are set. Setting + a filter for an item doesn't change default settings for other items. + If zone flushing is disabled, the original zone file is backed up instead of + writing out zone contents to a file. See :ref:`Notes` below about + the directory permissions. (#) **zone-restore** [*zone*...] **+backupdir** *directory* [*filter*...] Trigger a zone data and metadata restore from a specified backup directory.