watchdog.h revision 272461
1/*- 2 * Copyright (c) 2003 Poul-Henning Kamp 3 * Copyright (c) 2013 iXsystems.com, 4 * author: Alfred Perlstein <alfred@freebsd.org> 5 * 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27 * SUCH DAMAGE. 28 * 29 * $FreeBSD: releng/10.1/sys/sys/watchdog.h 247405 2013-02-27 19:03:31Z alfred $ 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#endif 114 115#endif /* _SYS_WATCHDOG_H */ 116