-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
============================================================================= FreeBSD-EN-26:28.watchdog Errata Notice
The FreeBSD Project
Topic: Spurious watchdog resets during upgrade
Category: core
Module: watchdog
Announced: 2026-11-17
Affects: FreeBSD 15.1
Corrected: 2026-07-21 20:23:29 UTC (stable/15, 15.1-STABLE)
2026-11-17 17:07:27 UTC (releng/15.1, 15.1-RELEASE-p7)
For general information regarding FreeBSD Errata Notices and Security Advisories, including descriptions of the fields above, security
branches, and the following sections, please visit <URL:
https://security.FreeBSD.org/>.
I. Background
The watchdog(4) facility allows a hardware or software watchdog timer to
reset the system if it stops responding. The watchdogd(8) daemon
periodically resets the timer to indicate that the system is healthy.
FreeBSD 15 modified the watchdog(4) ioctl interface, and retains the
previous interface for compatibility with programs compiled for
FreeBSD 14.
II. Problem Description
The compatibility interface converted the requested timeout using a
32-bit shift, which overflowed for timeouts of two seconds or more. As a result, the watchdog timer was armed with a much shorter timeout than requested. On 32-bit platforms, a related error caused the timeout
recorded for these requests to be computed incorrectly.
III. Impact
When a system with watchdogd(8) enabled is upgraded from FreeBSD 14, the watchdog may repeatedly reset the system after the new kernel is booted
but before the new userland is installed. Other FreeBSD 14 binaries which configure the watchdog are similarly affected.
IV. Workaround
When upgrading from FreeBSD 14, disable watchdogd(8) before booting the
new kernel, and re-enable it once the new userland has been installed:
# sysrc watchdogd_enable=NO
Systems which do not run FreeBSD 14 binaries that configure the watchdog
are not affected.
V. Solution
Upgrade your system to a supported FreeBSD stable or release / security
branch (releng) dated after the correction date, and reboot the system.
Perform one of the following:
1) To update your system installed from base system packages:
Systems running a 15.0-RELEASE or later version of FreeBSD on the amd64 or arm64 platforms, which were installed using base system packages, can be updated via the pkg(8) utility:
# pkg upgrade -r FreeBSD-base
# shutdown -r +10min "Rebooting for an erratum fix"
2) To update your system installed from binary distribution sets:
Systems running a RELEASE version of FreeBSD on the amd64 or arm64 platforms which were not installed using base system packages can be updated via the freebsd-update(8) utility:
# freebsd-update fetch
# freebsd-update install
# shutdown -r +10min "Rebooting for an erratum fix"
3) To update your system via a source code patch:
The following patches have been verified to apply to the applicable
FreeBSD release branches.
a) Download the relevant patch from the location below, and verify the
detached PGP signature using your PGP utility.
# fetch
https://security.FreeBSD.org/patches/EN-26:28/watchdog.patch
# fetch
https://security.FreeBSD.org/patches/EN-26:28/watchdog.patch.asc
# gpg --verify watchdog.patch.asc
b) Apply the patch. Execute the following commands as root:
# cd /usr/src
# patch -E -p0 < /path/to/patch
c) Recompile your kernel as described in <URL:
https://www.FreeBSD.org/handbook/kernelconfig.html> and reboot the
system.
VI. Correction details
This issue is corrected as of the corresponding Git commit hash in the following stable and release branches:
Branch/path Hash Revision
- ------------------------------------------------------------------------- stable/15/ ced89d9c04d4 stable/15-n284501 releng/15.1/ 3e2a209fbc6b releng/15.1-n283644
- -------------------------------------------------------------------------
Run the following command to see which files were modified by a
particular commit:
# git show --stat <commit hash>
Or visit the following URL, replacing NNNNNN with the hash:
<URL:
https://cgit.freebsd.org/src/commit/?id=NNNNNN>
To determine the commit count in a working tree (for comparison against
nNNNNNN in the table above), run:
# git rev-list --count --first-parent HEAD
VII. References
<URL:
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=292616>
The latest revision of this advisory is available at <URL:
https://security.FreeBSD.org/advisories/FreeBSD-EN-26:28.watchdog.asc> -----BEGIN PGP SIGNATURE-----
iQJPBAEBCgA5FiEEthUnfoEIffdcgYM7bljekB8AGu8FAmr82hMbFIAAAAAABAAO bWFudTIsMi41KzEuMTIsMCwzAAoJEG5Y3pAfABrvfC8P/21osp/FefUwhhLIXaUE E7c1jVfVLMVqQ63CHwm2CCFXeGzdkNnRTKKhwoRwly9XSeONJnMFvKKgPj+FA3OG 8VppnyhZTUCPS+y0VN9A9nyCi7uygbzO+CU6ftzxQOzZ1YiuUOsOMjT4ZKjYYZ6h 3gprMyh6enx2Nq3GQG2fdQPkVBdHJNEUtsdFOqKSYFrhGkteHlbCuxxaIa+QMGqZ 43Mgiv81SZXwH30LSQ+cTYO8JsdDi+9ZpGsvqVa4msopoyLgPz8gqRXSbahVoiX3 3zqoR0Q/1c06+Wq6HXDmYAJ8Lk19+lzD3AvYOP8fDQlg8I+GpvMqC5nT9fRSXVmR fgtP/6ZBTLsDoN08yxE3ZxI+42kgonX+y5Ksp8F/wP2HBFIQrGyUG3yNp8JG0yE/ uKMnrJkDWLs38JuzG+63XkXbE1PZBvqbm/c7Tp5xcAdPtDx/dsngHCRvIBCrlPij RxCh29hHvVOclXoId/9rTgywQdWNPf1ipL1uxgL+jzDiWSruKqBOBinpgb86bWmb 1GWEM/tHVFIusX6VZIrFTKFDjyKvebq1BEOrLi/Kpd/2mbx7Yr//QPoXtGPA3ZP/ 1vTQ9WZXjFjAJ6MfSGLbwxeWrEL5LPyvnCa45iOpG9hYbISRd2mHBdHbULLJQP10 GjAEiH8/kAfQa3qG9CsoBwE5
=0bnN
-----END PGP SIGNATURE-----
--- PyGate Linux v1.5.19
* Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)