6a2daddf5b
Commit bdb777b2a2 updated the man pages
to contents produced using:
- Sphinx 4.0.2
- sphinx-rtd-theme 0.5.2
- docutils 0.17.1
However, sphinx-rtd-theme 0.5.2 is incompatible with versions 0.17+ of
the docutils package. This problem was addressed in the Docker image
used for building man pages by downgrading the docutils package to
version 0.16.
Regenerate the man pages again, this time using:
- Sphinx 4.0.2
- sphinx-rtd-theme 0.5.2
- docutils 0.16
This is necessary to prevent the "docs" GitLab CI job from failing.
80 lines
3.0 KiB
Plaintext
80 lines
3.0 KiB
Plaintext
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "NAMED-JOURNALPRINT" "1" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
|
|
.SH NAME
|
|
named-journalprint \- print zone journal in human-readable form
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.SH SYNOPSIS
|
|
.sp
|
|
\fBnamed\-journalprint\fP [\-c serial] [\fB\-dux\fP] {journal}
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBnamed\-journalprint\fP scans the contents of a zone journal file,
|
|
printing it in a human\-readable form, or, optionally, converting it
|
|
to a different journal file format.
|
|
.sp
|
|
Journal files are automatically created by \fBnamed\fP when changes are
|
|
made to dynamic zones (e.g., by \fBnsupdate\fP). They record each addition
|
|
or deletion of a resource record, in binary format, allowing the changes
|
|
to be re\-applied to the zone when the server is restarted after a
|
|
shutdown or crash. By default, the name of the journal file is formed by
|
|
appending the extension \fB\&.jnl\fP to the name of the corresponding zone
|
|
file.
|
|
.sp
|
|
\fBnamed\-journalprint\fP converts the contents of a given journal file
|
|
into a human\-readable text format. Each line begins with \fBadd\fP or \fBdel\fP,
|
|
to indicate whether the record was added or deleted, and continues with
|
|
the resource record in master\-file format.
|
|
.sp
|
|
The \fB\-c\fP (compact) option provides a mechanism to reduce the size of
|
|
a journal by removing (most/all) transactions prior to the specified
|
|
serial number. Note: this option \fImust not\fP be used while \fBnamed\fP is
|
|
running, and can cause data loss if the zone file has not been updated
|
|
to contain the data being removed from the journal. Use with extreme caution.
|
|
.sp
|
|
The \fB\-x\fP option causes additional data about the journal file to be
|
|
printed at the beginning of the output and before each group of changes.
|
|
.sp
|
|
The \fB\-u\fP (upgrade) and \fB\-d\fP (downgrade) options recreate the journal
|
|
file with a modified format version. The existing journal file is
|
|
replaced. \fB\-d\fP writes out the journal in the format used by
|
|
versions of BIND up to 9.16.11; \fB\-u\fP writes it out in the format used
|
|
by versions since 9.16.13. (9.16.12 is omitted due to a journal\-formatting
|
|
bug in that release.) Note that these options \fImust not\fP be used while
|
|
\fBnamed\fP is running.
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fBnamed(8)\fP, \fBnsupdate(1)\fP, BIND 9 Administrator Reference Manual.
|
|
.SH AUTHOR
|
|
Internet Systems Consortium
|
|
.SH COPYRIGHT
|
|
2021, Internet Systems Consortium
|
|
.\" Generated by docutils manpage writer.
|
|
.
|