1/*-
2 * SPDX-License-Identifier: BSD-2-Clause
3 *
4 * Copyright (c) 2003 Poul-Henning Kamp
5 * Copyright (c) 2013 iXsystems.com,
6 *                    author: Alfred Perlstein <alfred@freebsd.org>
7 *
8 * All rights reserved.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 *    notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 *    notice, this list of conditions and the following disclaimer in the
17 *    documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * SUCH DAMAGE.
30 */
31#ifndef _SYS_WATCHDOG_H
32#define	_SYS_WATCHDOG_H
33
34#include <sys/ioccom.h>
35
36#define	_PATH_WATCHDOG	"fido"
37
38#define WDIOCPATPAT	_IOW('W', 42, u_int)	/* pat the watchdog */
39#define WDIOC_SETTIMEOUT    _IOW('W', 43, int)	/* set/reset the timer */
40#define WDIOC_GETTIMEOUT    _IOR('W', 44, int)	/* get total timeout */
41#define WDIOC_GETTIMELEFT   _IOR('W', 45, int)	/* get time left */
42#define WDIOC_GETPRETIMEOUT _IOR('W', 46, int)	/* get the pre-timeout */
43#define WDIOC_SETPRETIMEOUT _IOW('W', 47, int)	/* set the pre-timeout */
44/* set the action when a pre-timeout occurs see: WD_SOFT_* */
45#define WDIOC_SETPRETIMEOUTACT _IOW('W', 48, int)
46
47/* use software watchdog instead of hardware */
48#define WDIOC_SETSOFT	_IOW('W', 49, int)
49#define WDIOC_SETSOFTTIMEOUTACT	_IOW('W', 50, int)
50
51#define WD_ACTIVE	0x8000000
52	/*
53	 * Watchdog reset, timeout set to value in WD_INTERVAL field.
54	 * The kernel will arm the watchdog and unless the userland
55	 * program calls WDIOCPATPAT again before the timer expires
56	 * the system will reinitialize.
57	 */
58
59#define WD_PASSIVE	0x0400000
60	/*
61	 * Set the watchdog in passive mode.
62	 * The kernel will chose an appropriate timeout duration and
63	 * periodically reset the timer provided everything looks all
64	 * right to the kernel.
65 	 */
66
67#define WD_LASTVAL	0x0200000
68	/*
69	 * Use the already last used timeout value.
70	 * The kernel will use as timeout the last valid timeout provided.
71 	 */
72
73#define WD_INTERVAL	0x00000ff
74	/*
75	 * Mask for duration bits.
76	 * The watchdog will have a nominal patience of 2^N * nanoseconds.
77	 * Example:  N == 30 gives a patience of 2^30 nanoseconds ~= 1 second.
78	 * NB: Expect variance in the +/- 10-20% range.
79	 */
80
81/* Handy macros for humans not used to power of two nanoseconds */
82#define WD_TO_NEVER	0
83#define WD_TO_1MS	20
84#define WD_TO_125MS	27
85#define WD_TO_250MS	28
86#define WD_TO_500MS	29
87#define WD_TO_1SEC	30
88#define WD_TO_2SEC	31
89#define WD_TO_4SEC	32
90#define WD_TO_8SEC	33
91#define WD_TO_16SEC	34
92#define WD_TO_32SEC	35
93#define WD_TO_64SEC	36
94#define WD_TO_128SEC	37
95
96/* action on pre-timeout trigger */
97#define	WD_SOFT_PANIC	0x01	/* panic */
98#define	WD_SOFT_DDB	0x02	/* enter debugger */
99#define	WD_SOFT_LOG	0x04	/* log(9) */
100#define	WD_SOFT_PRINTF	0x08	/* printf(9) */
101#define WD_SOFT_MASK	0x0f	/* all of the above */
102
103#ifdef _KERNEL
104
105#include <sys/_eventhandler.h>
106
107typedef void (*watchdog_fn)(void *, u_int, int *);
108
109EVENTHANDLER_DECLARE(watchdog_list, watchdog_fn);
110
111u_int	wdog_kern_last_timeout(void);
112int	wdog_kern_pat(u_int utim);
113
114/*
115 * The following function pointer is used to attach a software watchdog
116 * if no hardware watchdog has been attached, and if the software module
117 * has initialized the function pointer.
118 */
119
120extern void (*wdog_software_attach)(void);
121#endif
122
123#endif /* _SYS_WATCHDOG_H */
124