From: Ted Lemon <source@isc.org>
Date: Thu, 22 Feb 2001 07:52:54 +0000 (+0000)
Subject: Document -tf and -play.
X-Git-Tag: V3-BETA-2-PATCH-18~6
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=51fe0cce6a8b6c9f1a6b8cfcaed17271d678e22a;p=thirdparty%2Fdhcp.git

Document -tf and -play.
---

diff --git a/server/dhcpd.8 b/server/dhcpd.8
index a74a662f7..4e2b5b1d6 100644
--- a/server/dhcpd.8
+++ b/server/dhcpd.8
@@ -47,6 +47,14 @@ dhcpd - Dynamic Host Configuration Protocol Server
 .I lease-file
 ]
 [
+.B -tf
+.I trace-output-file
+]
+[
+.B -play
+.I trace-playback-file
+]
+[
 .I if0
 [
 .I ...ifN
@@ -190,6 +198,21 @@ automatically before installing it.
 The
 .B -T
 flag can be used to test the lease database file in a similar way.
+.PP
+The \fB-tf\fR and \fB-play\fR options allow you to specify a file into
+which the entire startup state of the server and all the transactions
+it processes are either logged or played back from.  This can be
+useful in submitting bug reports - if you are getting a core dump
+every so often, you can start the server with the \fB-tf\fR option and
+then, when the server dumps core, the trace file will contain all the
+transactions that led up to it dumping core, so that the problem can
+be easily debugged with \fB-play\fR.
+.PP
+The \fB-play\fR option must be specified with an alternate lease file,
+using the \fB-lf\fR switch, so that the DHCP server doesn't wipe out
+your existing lease file with its test data.  The DHCP server will
+refuse to operate in playback mode unless you specify an alternate
+lease file.
 .SH CONFIGURATION
 The syntax of the dhcpd.conf(5) file is discussed seperately.   This
 section should be used as an overview of the configuration process,