summaryrefslogtreecommitdiffstats
path: root/doc/man_kjournalprint.rst
blob: 0753ae3083ed5f2d475ed8a97f2b2f1369ab77a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
.. highlight:: console

``kjournalprint`` – Knot DNS journal print utility
==================================================

Synopsis
--------

:program:`kjournalprint` [*config_option* *config_argument*] [*option*...] *zone_name*

:program:`kjournalprint` [*config_option* *config_argument*] **-z**

Description
-----------

The program prints zone history stored in a journal database. As default,
changes are colored for terminal.

Config options
..............

**-c**, **--config** *file*
  Use a textual configuration file (default is :file:`@config_dir@/knot.conf`).

**-C**, **--confdb** *directory*
  Use a binary configuration database directory (default is :file:`@storage_dir@/confdb`).
  The default configuration database, if exists, has a preference to the default
  configuration file.

**-D**, **--dir** *path*
  Use specified journal database path and default configuration.

Options
.......

**-z**, **--zone-list**
  Instead of reading the journal, display the list of zones in the DB.

**-l**, **--limit** *limit*
  Limits the number of displayed changes.

**-s**, **--serial** *soa*
  Start at a specific SOA serial.

**-H**, **--check**
  Enable additional journal semantic checks during printing.

**-d**, **--debug**
  Debug mode brief output.

**-x**, **--mono**
  Don't generate colorized output.

**-n**, **--no-color**
  An alias for **-x**. Use of this option is deprecated, it will be removed in the future.

**-X**, **--color**
  Force colorized output.

**-h**, **--help**
  Print the program help.

**-V**, **--version**
  Print the program version.

Parameters
..........

*zone_name*
  A name of the zone to print the history for.

Exit values
-----------

Exit status of 0 means successful operation. Any other exit status indicates
an error.

Examples
--------

Last (most recent) 5 changes without colors::

  $ kjournalprint -nl 5 /var/lib/knot/journal example.com.

See Also
--------

:manpage:`knotd(8)`, :manpage:`knot.conf(5)`.