1/* -*- mode: c; c-basic-offset: 8; -*-
2 * vim: noexpandtab sw=8 ts=8 sts=0:
3 *
4 * heartbeat.h
5 *
6 * Function prototypes
7 *
8 * Copyright (C) 2004 Oracle.  All rights reserved.
9 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public
12 * License as published by the Free Software Foundation; either
13 * version 2 of the License, or (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18 * General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public
21 * License along with this program; if not, write to the
22 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 * Boston, MA 021110-1307, USA.
24 *
25 */
26
27#ifndef R2CLUSTER_HEARTBEAT_H
28#define R2CLUSTER_HEARTBEAT_H
29
30#define R2HB_REGION_TIMEOUT_MS		2000
31
32#define R2HB_MAX_REGION_NAME_LEN	32
33
34/* number of changes to be seen as live */
35#define R2HB_LIVE_THRESHOLD	   2
36/* number of equal samples to be seen as dead */
37extern unsigned int r2hb_dead_threshold;
38#define R2HB_DEFAULT_DEAD_THRESHOLD	   31
39/* Otherwise MAX_WRITE_TIMEOUT will be zero... */
40#define R2HB_MIN_DEAD_THRESHOLD	  2
41#define R2HB_MAX_WRITE_TIMEOUT_MS \
42	(R2HB_REGION_TIMEOUT_MS * (r2hb_dead_threshold - 1))
43
44#define R2HB_CB_MAGIC		0x51d1e4ec
45
46/* callback stuff */
47enum r2hb_callback_type {
48	R2HB_NODE_DOWN_CB = 0,
49	R2HB_NODE_UP_CB,
50	R2HB_NUM_CB
51};
52
53struct r2nm_node;
54typedef void (r2hb_cb_func)(struct r2nm_node *, int, void *);
55
56struct r2hb_callback_func {
57	u32			hc_magic;
58	struct list_head	hc_item;
59	r2hb_cb_func		*hc_func;
60	void			*hc_data;
61	int			hc_priority;
62	enum r2hb_callback_type hc_type;
63};
64
65struct config_group *r2hb_alloc_hb_set(void);
66void r2hb_free_hb_set(struct config_group *group);
67
68void r2hb_setup_callback(struct r2hb_callback_func *hc,
69			 enum r2hb_callback_type type,
70			 r2hb_cb_func *func,
71			 void *data,
72			 int priority);
73int r2hb_register_callback(const char *region_uuid,
74			   struct r2hb_callback_func *hc);
75void r2hb_unregister_callback(const char *region_uuid,
76			      struct r2hb_callback_func *hc);
77void r2hb_fill_node_map(unsigned long *map,
78			unsigned bytes);
79void r2hb_exit(void);
80int r2hb_init(void);
81int r2hb_check_node_heartbeating_from_callback(u8 node_num);
82void r2hb_stop_all_regions(void);
83int r2hb_get_all_regions(char *region_uuids, u8 numregions);
84int r2hb_global_heartbeat_active(void);
85void r2hb_manual_set_node_heartbeating(int);
86
87#endif /* R2CLUSTER_HEARTBEAT_H */
88