journalprint.docbook revision ca42dcc0686fefd3db202edab80e5adb09d6add5
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews [<!ENTITY mdash "—">]>
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Permission to use, copy, modify, and/or distribute this software for any
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - purpose with or without fee is hereby granted, provided that the above
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!-- $Id: journalprint.docbook,v 1.2 2009/03/02 03:53:30 each Exp $ -->
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refentryinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refentryinfo>
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater <refentrytitle><application>journalprint</application></refentrytitle>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refname><application>journalprint</application></refname>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <refpurpose>print zone journal in human-readable form</refpurpose>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refnamediv>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <refsynopsisdiv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <cmdsynopsis>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg choice="req"><replaceable class="parameter">journal</replaceable></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </cmdsynopsis>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsynopsisdiv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt prints the contents of a zone journal file in a human-readable
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Journal files are automatically created by <command>named</command>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User when changes are made to dynamic zones (e.g., by
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>nsupdate</command>). They record each addition
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews or deletion of a resource record, in binary format, allowing the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User changes to be re-applied to the zone when the server is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt restarted after a shutdown or crash. By default, the name of
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews the journal file is formed by appending the extension
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <filename>.jnl</filename> to the name of the corresponding
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <command>journalprint</command> converts the contents of a given
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt journal file into a human-readable text format. Each line begins
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews with "add" or "del", to indicate whether the record was added or
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews deleted, and continues with the resource record in master-file
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <citerefentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </citerefentry>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <citerefentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refentrytitle>nsupdate</refentrytitle><manvolnum>8</manvolnum>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </citerefentry>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para><corpauthor>Internet Systems Consortium</corpauthor>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User - Local variables: