Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022

named-journalprint (8)


named-journalprint - readable form


named-journalprint [-c serial] [-dux] {journal}


NAMED-JOURNALPRINT(8)               BIND 9               NAMED-JOURNALPRINT(8)

       named-journalprint - print zone journal in human-readable form

       named-journalprint [-c serial] [-dux] {journal}

       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

       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-

       The  -x  option  causes  additional  data  about the journal file to be
       printed at the beginning  of  the  output  and  before  each  group  of

       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.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | network/dns/bind         |
       |Stability      | Pass-through uncommitted |

       named(8), nsupdate(1), BIND 9 Administrator Reference Manual.

       Internet Systems Consortium

       2022, Internet Systems Consortium

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from

       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)