xref: /titanic_41/usr/src/lib/fm/libfmd_adm/common/fmd_adm.h (revision 25c6ff4b77fcddf4097ce78a8277275ca603b46c)
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 2008 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_FMD_ADM_H
28 #define	_FMD_ADM_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
31 
32 #include <fm/fmd_api.h>
33 
34 #ifdef	__cplusplus
35 extern "C" {
36 #endif
37 
38 /*
39  * Fault Management Daemon Administrative Interfaces
40  *
41  * Note: The contents of this file are private to the implementation of the
42  * Solaris system and FMD subsystem and are subject to change at any time
43  * without notice.  Applications and drivers using these interfaces will fail
44  * to run on future releases.  These interfaces should not be used for any
45  * purpose until they are publicly documented for use outside of Sun.
46  */
47 
48 #define	FMD_ADM_VERSION	1		/* library ABI interface version */
49 #define	FMD_ADM_PROGRAM	0		/* connect library to system fmd */
50 
51 typedef struct fmd_adm fmd_adm_t;
52 
53 extern fmd_adm_t *fmd_adm_open(const char *, uint32_t, int);
54 extern void fmd_adm_close(fmd_adm_t *);
55 extern const char *fmd_adm_errmsg(fmd_adm_t *);
56 
57 typedef struct fmd_adm_stats {
58 	fmd_stat_t *ams_buf;		/* statistics data array */
59 	uint_t ams_len;			/* length of data array */
60 } fmd_adm_stats_t;
61 
62 extern int fmd_adm_stats_read(fmd_adm_t *, const char *, fmd_adm_stats_t *);
63 extern int fmd_adm_stats_free(fmd_adm_t *, fmd_adm_stats_t *);
64 
65 typedef struct fmd_adm_modinfo {
66 	const char *ami_name;		/* string name of module */
67 	const char *ami_desc;		/* module description */
68 	const char *ami_vers;		/* module version */
69 	uint_t ami_flags;		/* flags (see below) */
70 } fmd_adm_modinfo_t;
71 
72 #define	FMD_ADM_MOD_FAILED	0x1	/* module has failed */
73 
74 typedef int fmd_adm_module_f(const fmd_adm_modinfo_t *, void *);
75 
76 extern int fmd_adm_module_iter(fmd_adm_t *, fmd_adm_module_f *, void *);
77 extern int fmd_adm_module_load(fmd_adm_t *, const char *);
78 extern int fmd_adm_module_unload(fmd_adm_t *, const char *);
79 extern int fmd_adm_module_reset(fmd_adm_t *, const char *);
80 extern int fmd_adm_module_stats(fmd_adm_t *, const char *, fmd_adm_stats_t *);
81 extern int fmd_adm_module_gc(fmd_adm_t *, const char *);
82 
83 typedef struct fmd_adm_rsrcinfo {
84 	const char *ari_fmri;		/* fmri name of resource */
85 	const char *ari_uuid;		/* uuid name of resource */
86 	const char *ari_case;		/* uuid of case associated w/ state */
87 	uint_t ari_flags;		/* flags (see below) */
88 } fmd_adm_rsrcinfo_t;
89 
90 #define	FMD_ADM_RSRC_FAULTY	0x1	/* resource is faulty */
91 #define	FMD_ADM_RSRC_UNUSABLE	0x2	/* resource is unusable */
92 #define	FMD_ADM_RSRC_INVISIBLE	0x4	/* resource is not directly visible */
93 
94 typedef struct fmd_adm_caseinfo {
95 	const char *aci_uuid;
96 	const char *aci_code;
97 	const char *aci_url;
98 	nvlist_t *aci_event;
99 } fmd_adm_caseinfo_t;
100 
101 typedef int fmd_adm_rsrc_f(const fmd_adm_rsrcinfo_t *, void *);
102 typedef int fmd_adm_case_f(const fmd_adm_caseinfo_t *, void *);
103 
104 extern int fmd_adm_rsrc_count(fmd_adm_t *, int, uint32_t *);
105 extern int fmd_adm_rsrc_iter(fmd_adm_t *, int, fmd_adm_rsrc_f *, void *);
106 extern int fmd_adm_rsrc_flush(fmd_adm_t *, const char *);
107 extern int fmd_adm_rsrc_repaired(fmd_adm_t *, const char *);
108 extern int fmd_adm_rsrc_replaced(fmd_adm_t *, const char *);
109 extern int fmd_adm_rsrc_acquit(fmd_adm_t *, const char *, const char *);
110 extern int fmd_adm_case_repair(fmd_adm_t *, const char *);
111 extern int fmd_adm_case_acquit(fmd_adm_t *, const char *);
112 extern int fmd_adm_case_iter(fmd_adm_t *, const char *, fmd_adm_case_f *,
113     void *);
114 
115 typedef struct fmd_adm_serdinfo {
116 	const char *asi_name;		/* name of serd engine */
117 	uint64_t asi_delta;		/* nsecs from oldest event to now */
118 	uint64_t asi_n;			/* N parameter (event count) */
119 	uint64_t asi_t;			/* T parameter (nanoseconds) */
120 	uint_t asi_count;		/* number of events in engine */
121 	uint_t asi_flags;		/* flags (see below) */
122 } fmd_adm_serdinfo_t;
123 
124 #define	FMD_ADM_SERD_FIRED	0x1	/* serd engine has fired */
125 
126 typedef int fmd_adm_serd_f(const fmd_adm_serdinfo_t *, void *);
127 
128 extern int fmd_adm_serd_iter(fmd_adm_t *, const char *,
129     fmd_adm_serd_f *, void *);
130 extern int fmd_adm_serd_reset(fmd_adm_t *, const char *, const char *);
131 
132 typedef int fmd_adm_xprt_f(id_t, void *);
133 
134 extern int fmd_adm_xprt_iter(fmd_adm_t *, fmd_adm_xprt_f *, void *);
135 extern int fmd_adm_xprt_stats(fmd_adm_t *, id_t, fmd_adm_stats_t *);
136 
137 extern int fmd_adm_log_rotate(fmd_adm_t *, const char *);
138 
139 #ifdef	__cplusplus
140 }
141 #endif
142 
143 #endif	/* _FMD_ADM_H */
144