summaryrefslogtreecommitdiffstats
path: root/usr.sbin/watchdogd
diff options
context:
space:
mode:
authorjoel <joel@FreeBSD.org>2013-07-28 06:15:25 +0000
committerjoel <joel@FreeBSD.org>2013-07-28 06:15:25 +0000
commit526b0b7d6d59be2676a5c7357a22b3306be6ba2c (patch)
tree8cc68898ab0daf9c11256e4318a365597ab70727 /usr.sbin/watchdogd
parent0aadc82afbae4dbc41da86cd4f9b2ceb8ddcb17d (diff)
downloadFreeBSD-src-526b0b7d6d59be2676a5c7357a22b3306be6ba2c.zip
FreeBSD-src-526b0b7d6d59be2676a5c7357a22b3306be6ba2c.tar.gz
mdoc and language improvements.
Diffstat (limited to 'usr.sbin/watchdogd')
-rw-r--r--usr.sbin/watchdogd/watchdogd.843
1 files changed, 29 insertions, 14 deletions
diff --git a/usr.sbin/watchdogd/watchdogd.8 b/usr.sbin/watchdogd/watchdogd.8
index 9fdec96..6176a20 100644
--- a/usr.sbin/watchdogd/watchdogd.8
+++ b/usr.sbin/watchdogd/watchdogd.8
@@ -115,7 +115,7 @@ will terminate.
The
.Nm
utility recognizes the following runtime options:
-.Bl -tag -width ".Fl -softtimeout-action Ar action "
+.Bl -tag -width 30m
.It Fl I Ar file
Write the process ID of the
.Nm
@@ -204,16 +204,23 @@ and the kernel
.Xr log 4
device for
.Xr syslog 8 .
+.Sh FILES
+.Bl -tag -width ".Pa /var/run/watchdogd.pid" -compact
+.It Pa /var/run/watchdogd.pid
+.El
.Sh EXAMPLES
.Ss Debugging watchdogd and/or your watchdog script.
+This is a useful recipe for debugging
+.Nm
+and your watchdog script.
.Pp
-This is a useful recipe for debugging watchdogd and your watchdog
-script.
-.Pp
-(Note that ^C works oddly because watchdogd calls system(3) so the
+(Note that ^C works oddly because
+.Nm
+calls
+.Xr system 3
+so the
first ^C will terminate the "sleep" command.)
.Pp
-.Pp
Explanation of options used:
.Bl -enum -offset indent -compact
.It
@@ -224,17 +231,29 @@ Set the watchdog to trip at 30 seconds. (-t 30)
Use of a softtimeout:
.Bl -enum -offset indent -compact -nested
.It
-Use a softtimeout (don't arm the hardware watchdog) (--softtimeout)
+Use a softtimeout (do not arm the hardware watchdog).
+(--softtimeout)
.It
-Set the softtimeout action to do both kernel printf(9) and log(9) when it trips. (--softtimeout-action log,printf)
+Set the softtimeout action to do both kernel
+.Xr printf 9
+and
+.Xr log 9
+when it trips.
+(--softtimeout-action log,printf)
.El
.It
Use of a pre-timeout:
.Bl -enum -offset indent -compact -nested
.It
-Set a pre-timeout of 15 seconds (this will later trigger a panic/dump) (--pretimeout 15)
+Set a pre-timeout of 15 seconds (this will later trigger a panic/dump).
+(--pretimeout 15)
.It
-Set the action to also kernel printf(9) and log(9) when it trips. (--pretimeout-action log,printf)
+Set the action to also kernel
+.Xr printf 9
+and
+.Xr log 9
+when it trips.
+(--pretimeout-action log,printf)
.El
.It
Use of a script:
@@ -279,10 +298,6 @@ watchdogd -t 120 \\
--pretimeout 60 --pretimeout-action log,printf,panic \\
-e '/path/to/your/script 60' -w -T 15
.Ed
-.Sh FILES
-.Bl -tag -width ".Pa /var/run/watchdogd.pid" -compact
-.It Pa /var/run/watchdogd.pid
-.El
.Sh SEE ALSO
.Xr watchdog 4 ,
.Xr watchdog 8 ,
OpenPOWER on IntegriCloud