summaryrefslogtreecommitdiff
path: root/usr/src/uts/sun4v/sys/mdeg.h
blob: c8149afaa66e7d78d6203f4a34c9338f65a5b19b (plain)
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
119
120
/*
 * 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 2006 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#ifndef _MDEG_H
#define	_MDEG_H

#pragma ident	"%Z%%M%	%I%	%E% SMI"

/*
 * MD Event Generator (mdeg) interface.
 */

#ifdef __cplusplus
extern "C" {
#endif

#include <sys/mdesc.h>

/*
 * Specification of a node property.
 */
typedef struct {
	uint8_t		type;
	char		*namep;
	union {
		char		*strp;
		uint64_t	val;
	} _p;

} mdeg_prop_spec_t;

#define	ps_str	_p.strp
#define	ps_val	_p.val

/*
 * Specification of unique node in the MD. The array
 * of property name value pairs is used to determine
 * whether the node matches the specification.
 */
typedef struct {
	char			*namep;
	mdeg_prop_spec_t	*specp;
} mdeg_node_spec_t;

/*
 * Specification of a method to match nodes. The
 * array of properties are used to match two nodes
 * from different MDs. If the specified properties
 * match, the nodes are the same.
 */
typedef struct {
	char		*namep;
	md_prop_match_t	*matchp;
} mdeg_node_match_t;

/*
 * The result of the MD update as communicated
 * through the parameter to the registered callback.
 */
typedef struct {
	md_t		*mdp;
	mde_cookie_t	*mdep;
	uint_t		nelem;
} mdeg_diff_t;

/*
 * Results of the MD update for a specific registration
 */
typedef struct {
	mdeg_diff_t	added;
	mdeg_diff_t	removed;
	mdeg_diff_t	match_curr;
	mdeg_diff_t	match_prev;
} mdeg_result_t;

/*
 * Client Interface
 */

#define	MDEG_SUCCESS	0
#define	MDEG_FAILURE	1

typedef uint64_t mdeg_handle_t;

typedef int (*mdeg_cb_t)(void *cb_argp, mdeg_result_t *resp);

int mdeg_register(mdeg_node_spec_t *pspecp, mdeg_node_match_t *nmatchp,
    mdeg_cb_t cb, void *cb_argp, mdeg_handle_t *hdlp);

int mdeg_unregister(mdeg_handle_t hdl);


#ifdef __cplusplus
}
#endif

#endif /* _MDEG_H */