Document -tf and -play.

diff --git a/server/dhcpd.8 b/server/dhcpd.8
index a74a662f793cf459fd21a3aadf1f60c5775f820b..4e2b5b1d68e51e81311b11528a596c38591d6e62 100644 (file)
--- 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,