freebsd-skq/share/man/man5
avg e96b4170d0 add ability to set watchdog timeout for a shutdown
This change allows to specify a watchdog(9) timeout for a system
shutdown.  The timeout is activated when the watchdogd daemon is
stopped.  The idea is to a prevent any indefinite hang during late
stages of the shutdown.  The feature is implemented in rc.d/watchdogd,
it builds upon watchdogd -x option.

Note that the shutdown timeout is not actiavted when the watchdogd
service is individually stopped by an operator.  It is also not
activated for the 'shutdown' to the single-user mode.  In those cases it
is assumed that the operator knows what they are doing and they have
means to recover the system should it hang.

Significant subchanges and implementation details:
- the argument to rc.shutdown, completely unused before, is assigned to
  rc_shutdown variable that can be inspected by rc scripts
- init(8) passes "single" or "reboot" as the argument, this is not
  changed
- the argument is not mandatory and if it is not set then rc_shutdown is
  set to "unspecified"
- however, the default jail management scripts and jail configuration
  examples have been updated to pass "jail" to rc.shutdown, just in case
- the new timeout can be set via watchdogd_shutdown_timeout rc option
- for consistency, the regular timeout can now be set via
  watchdogd_timeout rc option
- watchdogd_shutdown_timeout and watchdogd_timeout override timeout
  specifications in watchdogd_flags
- existing configurations, where the new rc options are not set, should
  keep working as before

I am not particularly wed to any of the implementation specifics.
I am open to changing or removing any of them as long as the provided
functionality is the same (or very close) to the proposed one.
For example, I think it can be implemented without using watchdogd -x,
by means of watchdog(1) alone.  In that case there would be a small
window between stopping watchdogd and running watchdog, but I think that
that is acceptable.

Reviewed by:	bcr (man page changes)
MFC after:	5 weeks
Relnotes:	yes
Differential Revision: https://reviews.freebsd.org/D21221
2019-10-03 11:23:10 +00:00
..
a.out.5
acct.5 Commit the 64-bit inode project. 2017-05-23 09:29:05 +00:00
ar.5
autofs.5 Document autofs(6) sysctl variables. 2017-12-02 13:12:00 +00:00
bluetooth.device.conf.5
bluetooth.hosts.5
bluetooth.protocols.5
boot.config.5
cd9660.5 Update the spelling of my name 2019-04-22 17:52:46 +00:00
core.5 Adds signal number format to kern.corefile 2019-07-16 15:51:09 +00:00
devfs.5 Xr make_dev(9) from devfs(5). 2019-05-21 08:24:22 +00:00
devfs.conf.5 We don't really need two entries to describe how to deal with 2019-05-25 17:37:28 +00:00
devfs.rules.5
device.hints.5
dir.5 Add d_off support for multiple filesystems. 2018-11-14 14:18:35 +00:00
disktab.5
elf.5 elf.5: add readelf cross-reference 2018-06-15 16:14:42 +00:00
ethers.5
eui64.5
ext2fs.5 ext2fs.5: Update the manpage. 2018-12-30 19:44:50 +00:00
fbtab.5
fdescfs.5 Implement proper Linux /dev/fd and /proc/self/fd behavior by adding 2017-08-01 03:40:19 +00:00
forward.5 mailaddr(7): wave goodbye 2017-11-11 07:00:40 +00:00
freebsd-update.conf.5
fs.5
fstab.5 swap_pager.c reserves 2 blocks for a bsd label. Change that 2 to the 2019-08-15 02:30:44 +00:00
fusefs.5 fusefs: proofread man pages 2019-07-31 16:07:16 +00:00
group.5
hesiod.conf.5
hosts.5
hosts.equiv.5 Remove some more leftover rlogin man page xrefs 2019-08-13 15:41:36 +00:00
hosts.lpd.5
intro.5
libmap.conf.5
link.5
linprocfs.5
linsysfs.5
mailer.conf.5 Replace send-mail with the more standarized sendmail, we do not create 2017-12-27 06:23:50 +00:00
make.conf.5 Cross-reference style.Makefile(5) from make(1) and make.conf(5). 2018-09-27 12:20:32 +00:00
Makefile pkgbase: move man pages from runtime-manual to runtime 2019-07-19 15:12:20 +00:00
Makefile.depend
moduli.5
motd.5 motd: Generate from template to /var/run 2019-07-20 20:56:31 +00:00
mount.conf.5 Fix Xrs; they were pointing to the wrong section. 2017-05-28 18:09:49 +00:00
mqueuefs.5
msdosfs.5 msdosfs(5): Explain how to determine version of the FAT file system. 2018-09-27 12:08:53 +00:00
networks.5
nsmb.conf.5 nsmb.conf(5): Document the order of configuration loading 2018-11-02 10:18:56 +00:00
nsswitch.conf.5 Update nsswitch.conf(5) man page to make it clear additional sources 2018-11-11 00:57:13 +00:00
nullfs.5
passwd.5 - correct HISTORY section 2019-09-04 17:52:30 +00:00
pbm.5
periodic.conf.5 Chase rename of rwho script in r290252 2018-03-08 07:15:14 +00:00
pf.conf.5 Extend descriptions and comments about the need to create /etc/pf.conf. 2019-03-12 20:08:37 +00:00
pf.os.5
phones.5
portindex.5
portsnap.conf.5
procfs.5 Whack procctl(8) 2017-09-27 01:03:00 +00:00
protocols.5
quota.user.5
rc.conf.5 add ability to set watchdog timeout for a shutdown 2019-10-03 11:23:10 +00:00
rctl.conf.5
regdomain.5
remote.5
resolver.5 Allow the use of TCP instead of UDP for queries by setting options usevc 2018-08-16 13:18:40 +00:00
services.5
shells.5
src.conf.5 Regen src.conf(5) after r352927 (HTTPD option added) 2019-10-01 14:56:31 +00:00
stab.5 Tidy up mdoc formatting for "etc.)" at end of line 2017-03-19 01:24:18 +00:00
style.Makefile.5
style.mdoc.5 style.mdoc.5: Fix formatting issues 2019-03-10 20:58:59 +00:00
sysctl.conf.5 Mention the Linux compatibility layer instead of the Linux emulator in the BUGS section. 2018-07-21 19:09:29 +00:00
tmpfs.5 Remove "All rights reserved" from my files. 2018-05-10 06:41:08 +00:00