1NAMED-JOURNALPRINT(1) BIND 9 NAMED-JOURNALPRINT(1)
2
3
4
6 named-journalprint - print zone journal in human-readable form
7
9 named-journalprint [-c serial] [-dux] {journal}
10
12 named-journalprint scans the contents of a zone journal file, printing
13 it in a human-readable form, or, optionally, converting it to a differ‐
14 ent journal file format.
15
16 Journal files are automatically created by named when changes are made
17 to dynamic zones (e.g., by nsupdate). They record each addition or
18 deletion of a resource record, in binary format, allowing the changes
19 to be re-applied to the zone when the server is restarted after a shut‐
20 down or crash. By default, the name of the journal file is formed by
21 appending the extension .jnl to the name of the corresponding zone
22 file.
23
24 named-journalprint converts the contents of a given journal file into a
25 human-readable text format. Each line begins with add or del, to indi‐
26 cate whether the record was added or deleted, and continues with the
27 resource record in master-file format.
28
29 The -c (compact) option provides a mechanism to reduce the size of a
30 journal by removing (most/all) transactions prior to the specified se‐
31 rial number. Note: this option must not be used while named is running,
32 and can cause data loss if the zone file has not been updated to con‐
33 tain the data being removed from the journal. Use with extreme caution.
34
35 The -x option causes additional data about the journal file to be
36 printed at the beginning of the output and before each group of
37 changes.
38
39 The -u (upgrade) and -d (downgrade) options recreate the journal file
40 with a modified format version. The existing journal file is replaced.
41 -d writes out the journal in the format used by versions of BIND up to
42 9.16.11; -u writes it out in the format used by versions since 9.16.13.
43 (9.16.12 is omitted due to a journal-formatting bug in that release.)
44 Note that these options must not be used while named is running.
45
47 named(8), nsupdate(1), BIND 9 Administrator Reference Manual.
48
50 Internet Systems Consortium
51
53 2023, Internet Systems Consortium
54
55
56
57
589.18.20 NAMED-JOURNALPRINT(1)