1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
24 *
25 * Copyright (c) 2016, Intel Corporation.
26 */
27
28#ifndef	_FMD_API_H
29#define	_FMD_API_H
30
31#include <sys/types.h>
32#include <sys/time.h>
33#include <time.h>
34#include <libnvpair.h>
35#include <stdarg.h>
36#include <umem.h>
37
38#ifdef	__cplusplus
39extern "C" {
40#endif
41
42/*
43 * Fault Management Daemon Client Interfaces
44 */
45
46#define	FMD_API_VERSION		5
47
48typedef struct fmd_hdl fmd_hdl_t;
49
50typedef struct fmd_timer {
51	timer_t		ft_tid;
52	void		*ft_arg;
53	fmd_hdl_t	*ft_hdl;
54} fmd_timer_t;
55
56#define	id_t	fmd_timer_t *
57
58
59typedef struct fmd_event {
60	hrtime_t	ev_hrt;		/* event time used by SERD engines */
61} fmd_event_t;
62
63typedef struct fmd_case {
64	char		ci_uuid[48];	/* uuid string for this case */
65	fmd_hdl_t	*ci_mod;	/* module that owns this case */
66	void		*ci_data;	/* data from fmd_case_setspecific() */
67	ushort_t	ci_state;	/* case state (see below) */
68	ushort_t	ci_flags;	/* case flags (see below) */
69	struct timeval	ci_tv;		/* time of original diagnosis */
70	void		*ci_bufptr;	/* case data serialization buffer */
71	size_t		ci_bufsiz;
72} fmd_case_t;
73
74
75#define	FMD_B_FALSE	0		/* false value for booleans as int */
76#define	FMD_B_TRUE	1		/* true value for booleans as int */
77
78
79#define	FMD_CASE_UNSOLVED	0	/* case is not yet solved (waiting) */
80#define	FMD_CASE_SOLVED		1	/* case is solved (suspects added) */
81#define	FMD_CASE_CLOSE_WAIT	2	/* case is executing fmdo_close() */
82#define	FMD_CASE_CLOSED		3	/* case is closed (reconfig done) */
83#define	FMD_CASE_REPAIRED	4	/* case is repaired */
84#define	FMD_CASE_RESOLVED	5	/* case is resolved (can be freed) */
85
86#define	FMD_CF_DIRTY		0x01	/* case is in need of checkpoint */
87#define	FMD_CF_SOLVED		0x02	/* case has been solved */
88#define	FMD_CF_ISOLATED		0x04	/* case has been isolated */
89#define	FMD_CF_REPAIRED		0x08	/* case has been repaired */
90#define	FMD_CF_RESOLVED		0x10	/* case has been resolved */
91
92
93#define	FMD_TYPE_BOOL	0		/* int */
94#define	FMD_TYPE_INT32	1		/* int32_t */
95#define	FMD_TYPE_UINT32	2		/* uint32_t */
96#define	FMD_TYPE_INT64	3		/* int64_t */
97#define	FMD_TYPE_UINT64	4		/* uint64_t */
98#define	FMD_TYPE_TIME	5		/* uint64_t */
99#define	FMD_TYPE_SIZE	6		/* uint64_t */
100
101typedef struct fmd_prop {
102	const char *fmdp_name;		/* property name */
103	uint_t fmdp_type;		/* property type (see above) */
104	const char *fmdp_defv;		/* default value */
105} fmd_prop_t;
106
107typedef struct fmd_stat {
108	char fmds_name[32];		/* statistic name */
109	uint_t fmds_type;		/* statistic type (see above) */
110	char fmds_desc[64];		/* statistic description */
111	union {
112		int bool;		/* FMD_TYPE_BOOL */
113		int32_t i32;		/* FMD_TYPE_INT32 */
114		uint32_t ui32;		/* FMD_TYPE_UINT32 */
115		int64_t i64;		/* FMD_TYPE_INT64 */
116		uint64_t ui64;		/* FMD_TYPE_UINT64 */
117	} fmds_value;
118} fmd_stat_t;
119
120typedef struct fmd_hdl_ops {
121	void (*fmdo_recv)(fmd_hdl_t *, fmd_event_t *, nvlist_t *, const char *);
122	void (*fmdo_timeout)(fmd_hdl_t *, id_t, void *);
123	void (*fmdo_close)(fmd_hdl_t *, fmd_case_t *);
124	void (*fmdo_stats)(fmd_hdl_t *);
125	void (*fmdo_gc)(fmd_hdl_t *);
126} fmd_hdl_ops_t;
127
128#define	FMD_SEND_SUCCESS	0	/* fmdo_send queued event */
129#define	FMD_SEND_FAILED		1	/* fmdo_send unrecoverable error */
130#define	FMD_SEND_RETRY		2	/* fmdo_send requests retry */
131
132typedef struct fmd_hdl_info {
133	const char *fmdi_desc;		/* fmd client description string */
134	const char *fmdi_vers;		/* fmd client version string */
135	const fmd_hdl_ops_t *fmdi_ops;	/* ops vector for client */
136	const fmd_prop_t *fmdi_props;	/* array of configuration props */
137} fmd_hdl_info_t;
138
139extern int fmd_hdl_register(fmd_hdl_t *, int, const fmd_hdl_info_t *);
140extern void fmd_hdl_unregister(fmd_hdl_t *);
141
142extern void fmd_hdl_setspecific(fmd_hdl_t *, void *);
143extern void *fmd_hdl_getspecific(fmd_hdl_t *);
144
145#define	FMD_SLEEP	UMEM_NOFAIL
146
147extern void *fmd_hdl_alloc(fmd_hdl_t *, size_t, int);
148extern void *fmd_hdl_zalloc(fmd_hdl_t *, size_t, int);
149extern void fmd_hdl_free(fmd_hdl_t *, void *, size_t);
150
151extern char *fmd_hdl_strdup(fmd_hdl_t *, const char *, int);
152extern void fmd_hdl_strfree(fmd_hdl_t *, char *);
153
154extern void fmd_hdl_vdebug(fmd_hdl_t *, const char *, va_list);
155extern void fmd_hdl_debug(fmd_hdl_t *, const char *, ...);
156
157extern int32_t fmd_prop_get_int32(fmd_hdl_t *, const char *);
158extern int64_t fmd_prop_get_int64(fmd_hdl_t *, const char *);
159
160#define	FMD_STAT_NOALLOC	0x0	/* fmd should use caller's memory */
161#define	FMD_STAT_ALLOC		0x1	/* fmd should allocate stats memory */
162
163extern fmd_stat_t *fmd_stat_create(fmd_hdl_t *, uint_t, uint_t, fmd_stat_t *);
164extern void fmd_stat_destroy(fmd_hdl_t *, uint_t, fmd_stat_t *);
165extern void fmd_stat_setstr(fmd_hdl_t *, fmd_stat_t *, const char *);
166
167extern fmd_case_t *fmd_case_open(fmd_hdl_t *, void *);
168extern void fmd_case_reset(fmd_hdl_t *, fmd_case_t *);
169extern void fmd_case_solve(fmd_hdl_t *, fmd_case_t *);
170extern void fmd_case_close(fmd_hdl_t *, fmd_case_t *);
171
172extern const char *fmd_case_uuid(fmd_hdl_t *, fmd_case_t *);
173extern fmd_case_t *fmd_case_uulookup(fmd_hdl_t *, const char *);
174extern void fmd_case_uuclose(fmd_hdl_t *, const char *);
175extern int fmd_case_uuclosed(fmd_hdl_t *, const char *);
176extern int fmd_case_uuisresolved(fmd_hdl_t *, const char *);
177extern void fmd_case_uuresolved(fmd_hdl_t *, const char *);
178
179extern int fmd_case_solved(fmd_hdl_t *, fmd_case_t *);
180extern int fmd_case_closed(fmd_hdl_t *, fmd_case_t *);
181
182extern void fmd_case_add_ereport(fmd_hdl_t *, fmd_case_t *, fmd_event_t *);
183extern void fmd_case_add_serd(fmd_hdl_t *, fmd_case_t *, const char *);
184extern void fmd_case_add_suspect(fmd_hdl_t *, fmd_case_t *, nvlist_t *);
185
186extern void fmd_case_setspecific(fmd_hdl_t *, fmd_case_t *, void *);
187extern void *fmd_case_getspecific(fmd_hdl_t *, fmd_case_t *);
188
189extern fmd_case_t *fmd_case_next(fmd_hdl_t *, fmd_case_t *);
190extern fmd_case_t *fmd_case_prev(fmd_hdl_t *, fmd_case_t *);
191
192extern void fmd_buf_create(fmd_hdl_t *, fmd_case_t *, const char *, size_t);
193extern void fmd_buf_destroy(fmd_hdl_t *, fmd_case_t *, const char *);
194extern void fmd_buf_read(fmd_hdl_t *, fmd_case_t *,
195    const char *, void *, size_t);
196extern void fmd_buf_write(fmd_hdl_t *, fmd_case_t *,
197    const char *, const void *, size_t);
198extern size_t fmd_buf_size(fmd_hdl_t *, fmd_case_t *, const char *);
199
200extern void fmd_serd_create(fmd_hdl_t *, const char *, uint_t, hrtime_t);
201extern void fmd_serd_destroy(fmd_hdl_t *, const char *);
202extern int fmd_serd_exists(fmd_hdl_t *, const char *);
203extern void fmd_serd_reset(fmd_hdl_t *, const char *);
204extern int fmd_serd_record(fmd_hdl_t *, const char *, fmd_event_t *);
205extern int fmd_serd_fired(fmd_hdl_t *, const char *);
206extern int fmd_serd_empty(fmd_hdl_t *, const char *);
207
208extern id_t fmd_timer_install(fmd_hdl_t *, void *, fmd_event_t *, hrtime_t);
209extern void fmd_timer_remove(fmd_hdl_t *, id_t);
210
211extern nvlist_t *fmd_nvl_create_fault(fmd_hdl_t *,
212    const char *, uint8_t, nvlist_t *, nvlist_t *, nvlist_t *);
213
214extern int fmd_nvl_class_match(fmd_hdl_t *, nvlist_t *, const char *);
215
216#define	FMD_HAS_FAULT_FRU	0
217#define	FMD_HAS_FAULT_ASRU	1
218#define	FMD_HAS_FAULT_RESOURCE	2
219
220extern void fmd_repair_fru(fmd_hdl_t *, const char *);
221extern int fmd_repair_asru(fmd_hdl_t *, const char *);
222
223extern nvlist_t *fmd_nvl_alloc(fmd_hdl_t *, int);
224extern nvlist_t *fmd_nvl_dup(fmd_hdl_t *, nvlist_t *, int);
225
226/*
227 * ZED Specific Interfaces
228 */
229
230extern fmd_hdl_t *fmd_module_hdl(const char *);
231extern boolean_t fmd_module_initialized(fmd_hdl_t *);
232extern void fmd_module_recv(fmd_hdl_t *, nvlist_t *, const char *);
233
234/* ZFS FMA Retire Agent */
235extern void _zfs_retire_init(fmd_hdl_t *);
236extern void _zfs_retire_fini(fmd_hdl_t *);
237
238/* ZFS FMA Diagnosis Engine */
239extern void _zfs_diagnosis_init(fmd_hdl_t *);
240extern void _zfs_diagnosis_fini(fmd_hdl_t *);
241
242#ifdef	__cplusplus
243}
244#endif
245
246#endif	/* _FMD_API_H */
247