named-journalprint - readable form
named-journalprint [-c serial] [-dux] {journal}
NAMED-JOURNALPRINT(8) BIND 9 NAMED-JOURNALPRINT(8)
NAME
named-journalprint - print zone journal in human-readable form
SYNOPSIS
named-journalprint [-c serial] [-dux] {journal}
DESCRIPTION
named-journalprint scans the contents of a zone journal file, printing
it in a human-readable form, or, optionally, converting it to a differ-
ent journal file format.
Journal files are automatically created by named when changes are made
to dynamic zones (e.g., by nsupdate). 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 shut-
down or crash. By default, the name of the journal file is formed by
appending the extension .jnl to the name of the corresponding zone
file.
named-journalprint converts the contents of a given journal file into a
human-readable text format. Each line begins with add or del, to indi-
cate whether the record was added or deleted, and continues with the
resource record in master-file format.
The -c (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 must not be used while named is run-
ning, 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 cau-
tion.
The -x option causes additional data about the journal file to be
printed at the beginning of the output and before each group of
changes.
The -u (upgrade) and -d (downgrade) options recreate the journal file
with a modified format version. The existing journal file is replaced.
-d writes out the journal in the format used by versions of BIND up to
9.16.11; -u 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 must not be used while named is running.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | network/dns/bind |
+---------------+--------------------------+
|Stability | Pass-through uncommitted |
+---------------+--------------------------+
SEE ALSO
named(8), nsupdate(1), BIND 9 Administrator Reference Manual.
AUTHOR
Internet Systems Consortium
COPYRIGHT
2022, Internet Systems Consortium
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
http://ftp.isc.org/isc/bind9/9.16.29/bind-9.16.29.tar.xz.
Further information about this software can be found on the open source
community website at http://www.isc.org/software/bind/.
9.16.29 2022-05-10 NAMED-JOURNALPRINT(8)