/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* bos72Q src/bos/kernel/sys/watchdog.h 1.8.1.2                           */
/*                                                                        */
/* Licensed Materials - Property of IBM                                   */
/*                                                                        */
/* COPYRIGHT International Business Machines Corp. 1988,2019              */
/* All Rights Reserved                                                    */
/*                                                                        */
/* US Government Users Restricted Rights - Use, duplication or            */
/* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.      */
/*                                                                        */
/* IBM_PROLOG_END_TAG                                                     */
/* @(#)73       1.8.1.2  src/bos/kernel/sys/watchdog.h, sysproc, bos72Q, q2019_13A4 2/6/19 00:40:39 */
/*
 *   COMPONENT_NAME: SYSPROC
 *
 *   FUNCTIONS: w_start
 *              w_stop
 *
 *
 *   ORIGINS: 27, 83
 *
 *
 *   (C) COPYRIGHT International Business Machines Corp. 1988,1993
 *   All Rights Reserved
 *   Licensed Materials - Property of IBM
 *   US Government Users Restricted Rights - Use, duplication or
 *   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
 */

#ifndef _H_WATCHDOG
#define _H_WATCHDOG
#include <sys/kerrno.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * The following is the watchdog timer structure.
 *
 * This structure should be initialize prior to calling w_init.
 * The next and prev fields should be set to NULL. The func and
 * restart fields set to the appropriate value. The count field
 * should be set to 0.
 */
struct watchdog {
	struct watchdog	*next;		/* next watchdog timer */
	struct watchdog	*prev;		/* previous watchdog timer */
#if defined(__64BIT_KERNEL) || defined(__FULL_PROTO)
	void		(*func)(struct watchdog *);	/* completion handler */
#else /* __64BIT_KERNEL || __FULL_PROTO */
	void		(*func)();	/* completion handler */
#endif /* __64BIT_KERNEL || __FULL_PROTO */
	ulong		count;		/* time remaining */
	ulong		restart;	/* restart time */
};


/*
 * The following are the services exported by the kernel to manage
 * watchdog timers.
 */
int w_init(struct watchdog *);          /* define watchdog timer */
/*
 * returns 0 if OK,
 *         1 if watchdog queue in use, try later
 */

int w_clear(struct watchdog *);          /* remove watchdog timer */
/*
 * returns 0 if OK,
 *         1 if watchdog queue in use, try later
 */

void w_start(struct watchdog *);          /* restart watchdog timer */

void w_stop(struct watchdog *);           /* stop watchdog timer    */

/*
 * attributes for watchdog timers
 */
#define WD_ATTR_MOVE_OK 0x1

kerrno_t w_setattr(struct watchdog *w, char attr); /* set attrs     */

/*
 * The following service is only called by the system timer and is not
 * exported to kernel extensions.
 */

void watchdog();			/* process watchdog timers */

#ifdef __cplusplus
}
#endif

#endif /* _H_WATCHDOG */