1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2008 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _FMD_FMRI_H
#define _FMD_FMRI_H
#include <sys/types.h>
#include <sys/fm/protocol.h>
#include <libnvpair.h>
#include <errno.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* Fault Management Daemon FMRI Scheme Interfaces
*
* Note: The contents of this file are private to the implementation of the
* Solaris system and FMD subsystem and are subject to change at any time
* without notice. Applications and drivers using these interfaces will fail
* to run on future releases. These interfaces should not be used for any
* purpose until they are publicly documented for use outside of Sun.
*/
/*
* The following utility functions (in addition to libnvpair) are provided by
* fmd to facilitate the implementation of each FMRI scheme library.
*/
struct topo_hdl;
#ifndef MIN
#define MIN(x, y) ((x) < (y) ? (x) : (y))
#endif
#ifndef MAX
#define MAX(x, y) ((x) > (y) ? (x) : (y))
#endif
extern void *fmd_fmri_alloc(size_t);
extern void *fmd_fmri_zalloc(size_t);
extern void fmd_fmri_free(void *, size_t);
extern int fmd_fmri_set_errno(int);
extern void fmd_fmri_warn(const char *, ...);
extern char *fmd_fmri_auth2str(nvlist_t *);
extern char *fmd_fmri_strescape(const char *);
extern char *fmd_fmri_strdup(const char *);
extern void fmd_fmri_strfree(char *);
extern const char *fmd_fmri_get_rootdir(void);
extern const char *fmd_fmri_get_platform(void);
extern uint64_t fmd_fmri_get_drgen(void);
extern struct topo_hdl *fmd_fmri_topo_hold(int);
extern void fmd_fmri_topo_rele(struct topo_hdl *);
/*
* The following entry points are to be implemented by each scheme:
*/
extern int fmd_fmri_init(void);
extern void fmd_fmri_fini(void);
extern ssize_t fmd_fmri_nvl2str(nvlist_t *, char *, size_t);
extern int fmd_fmri_expand(nvlist_t *);
extern int fmd_fmri_present(nvlist_t *);
extern int fmd_fmri_replaced(nvlist_t *);
extern int fmd_fmri_service_state(nvlist_t *);
extern int fmd_fmri_unusable(nvlist_t *);
extern int fmd_fmri_retire(nvlist_t *);
extern int fmd_fmri_unretire(nvlist_t *);
extern int fmd_fmri_contains(nvlist_t *, nvlist_t *);
extern nvlist_t *fmd_fmri_translate(nvlist_t *, nvlist_t *);
#define FMD_OBJ_STATE_UNKNOWN 1
#define FMD_OBJ_STATE_STILL_PRESENT 2
#define FMD_OBJ_STATE_REPLACED 3
#define FMD_OBJ_STATE_NOT_PRESENT 4
#define FMD_SERVICE_STATE_UNKNOWN 0
#define FMD_SERVICE_STATE_OK 1
#define FMD_SERVICE_STATE_DEGRADED 2
#define FMD_SERVICE_STATE_UNUSABLE 3
#define FMD_SERVICE_STATE_DEGRADED_PENDING_RESET 4
#define FMD_SERVICE_STATE_UNUSABLE_PENDING_RESET 5
#define FMD_SERVICE_STATE_UNUSABLE_UNTIL_REPLACED 6
#define FMD_SERVICE_STATE_ISOLATE_PENDING 7
#ifdef __cplusplus
}
#endif
#endif /* _FMD_FMRI_H */
|