1.. 2 Copyright (C) Internet Systems Consortium, Inc. ("ISC") 3 4 This Source Code Form is subject to the terms of the Mozilla Public 5 License, v. 2.0. If a copy of the MPL was not distributed with this 6 file, you can obtain one at https://mozilla.org/MPL/2.0/. 7 8 See the COPYRIGHT file distributed with this work for additional 9 information regarding copyright ownership. 10 11.. 12 Copyright (C) Internet Systems Consortium, Inc. ("ISC") 13 14 This Source Code Form is subject to the terms of the Mozilla Public 15 License, v. 2.0. If a copy of the MPL was not distributed with this 16 file, You can obtain one at http://mozilla.org/MPL/2.0/. 17 18 See the COPYRIGHT file distributed with this work for additional 19 information regarding copyright ownership. 20 21 22.. highlight: console 23 24.. _man_named-journalprint: 25 26named-journalprint - print zone journal in human-readable form 27-------------------------------------------------------------- 28 29Synopsis 30~~~~~~~~ 31 32:program:`named-journalprint` [-c serial] [**-dux**] {journal} 33 34Description 35~~~~~~~~~~~ 36 37``named-journalprint`` scans the contents of a zone journal file, 38printing it in a human-readable form, or, optionally, converting it 39to a different journal file format. 40 41Journal files are automatically created by ``named`` when changes are 42made to dynamic zones (e.g., by ``nsupdate``). They record each addition 43or deletion of a resource record, in binary format, allowing the changes 44to be re-applied to the zone when the server is restarted after a 45shutdown or crash. By default, the name of the journal file is formed by 46appending the extension ``.jnl`` to the name of the corresponding zone 47file. 48 49``named-journalprint`` converts the contents of a given journal file 50into a human-readable text format. Each line begins with ``add`` or ``del``, 51to indicate whether the record was added or deleted, and continues with 52the resource record in master-file format. 53 54The ``-c`` (compact) option provides a mechanism to reduce the size of 55a journal by removing (most/all) transactions prior to the specified 56serial number. Note: this option *must not* be used while ``named`` is 57running, and can cause data loss if the zone file has not been updated 58to contain the data being removed from the journal. Use with extreme caution. 59 60The ``-x`` option causes additional data about the journal file to be 61printed at the beginning of the output and before each group of changes. 62 63The ``-u`` (upgrade) and ``-d`` (downgrade) options recreate the journal 64file with a modified format version. The existing journal file is 65replaced. ``-d`` writes out the journal in the format used by 66versions of BIND up to 9.16.11; ``-u`` writes it out in the format used 67by versions since 9.16.13. (9.16.12 is omitted due to a journal-formatting 68bug in that release.) Note that these options *must not* be used while 69``named`` is running. 70 71See Also 72~~~~~~~~ 73 74:manpage:`named(8)`, :manpage:`nsupdate(1)`, BIND 9 Administrator Reference Manual. 75