/contrib/bind9/bin/tools/named-journalprint.docbook

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 101 lines · 92 code · 9 blank · 0 comment · 0 complexity · ab5df29ca36d56961e935b8aa3b92691 MD5 · raw file

  1. <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  2. "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
  3. [<!ENTITY mdash "&#8212;">]>
  4. <!--
  5. - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")
  6. -
  7. - Permission to use, copy, modify, and/or distribute this software for any
  8. - purpose with or without fee is hereby granted, provided that the above
  9. - copyright notice and this permission notice appear in all copies.
  10. -
  11. - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  12. - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  13. - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  14. - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  15. - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  16. - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  17. - PERFORMANCE OF THIS SOFTWARE.
  18. -->
  19. <!-- $Id: named-journalprint.docbook,v 1.2 2009/12/04 21:59:23 marka Exp $ -->
  20. <refentry id="man.named-journalprint">
  21. <refentryinfo>
  22. <date>Feb 18, 2009</date>
  23. </refentryinfo>
  24. <refmeta>
  25. <refentrytitle><application>named-journalprint</application></refentrytitle>
  26. <manvolnum>8</manvolnum>
  27. <refmiscinfo>BIND9</refmiscinfo>
  28. </refmeta>
  29. <refnamediv>
  30. <refname><application>named-journalprint</application></refname>
  31. <refpurpose>print zone journal in human-readable form</refpurpose>
  32. </refnamediv>
  33. <docinfo>
  34. <copyright>
  35. <year>2009</year>
  36. <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
  37. </copyright>
  38. </docinfo>
  39. <refsynopsisdiv>
  40. <cmdsynopsis>
  41. <command>named-journalprint</command>
  42. <arg choice="req"><replaceable class="parameter">journal</replaceable></arg>
  43. </cmdsynopsis>
  44. </refsynopsisdiv>
  45. <refsect1>
  46. <title>DESCRIPTION</title>
  47. <para>
  48. <command>named-journalprint</command>
  49. prints the contents of a zone journal file in a human-readable
  50. form.
  51. </para>
  52. <para>
  53. Journal files are automatically created by <command>named</command>
  54. when changes are made to dynamic zones (e.g., by
  55. <command>nsupdate</command>). They record each addition
  56. or deletion of a resource record, in binary format, allowing the
  57. changes to be re-applied to the zone when the server is
  58. restarted after a shutdown or crash. By default, the name of
  59. the journal file is formed by appending the extension
  60. <filename>.jnl</filename> to the name of the corresponding
  61. zone file.
  62. </para>
  63. <para>
  64. <command>named-journalprint</command> converts the contents of a given
  65. journal file into a human-readable text format. Each line begins
  66. with "add" or "del", to indicate whether the record was added or
  67. deleted, and continues with the resource record in master-file
  68. format.
  69. </para>
  70. </refsect1>
  71. <refsect1>
  72. <title>SEE ALSO</title>
  73. <para>
  74. <citerefentry>
  75. <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
  76. </citerefentry>,
  77. <citerefentry>
  78. <refentrytitle>nsupdate</refentrytitle><manvolnum>8</manvolnum>
  79. </citerefentry>,
  80. <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
  81. </para>
  82. </refsect1>
  83. <refsect1>
  84. <title>AUTHOR</title>
  85. <para><corpauthor>Internet Systems Consortium</corpauthor>
  86. </para>
  87. </refsect1>
  88. </refentry><!--
  89. - Local variables:
  90. - mode: sgml
  91. - End:
  92. -->