1*0Sstevel@tonic-gate /*
2*0Sstevel@tonic-gate  * CDDL HEADER START
3*0Sstevel@tonic-gate  *
4*0Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate  * Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate  * (the "License").  You may not use this file except in compliance
7*0Sstevel@tonic-gate  * with the License.
8*0Sstevel@tonic-gate  *
9*0Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate  * See the License for the specific language governing permissions
12*0Sstevel@tonic-gate  * and limitations under the License.
13*0Sstevel@tonic-gate  *
14*0Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate  *
20*0Sstevel@tonic-gate  * CDDL HEADER END
21*0Sstevel@tonic-gate  */
22*0Sstevel@tonic-gate /*
23*0Sstevel@tonic-gate  * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
24*0Sstevel@tonic-gate  * Use is subject to license terms.
25*0Sstevel@tonic-gate  */
26*0Sstevel@tonic-gate 
27*0Sstevel@tonic-gate #ifndef	_MDESC_H_
28*0Sstevel@tonic-gate #define	_MDESC_H_
29*0Sstevel@tonic-gate 
30*0Sstevel@tonic-gate #pragma ident	"%Z%%M%	%I%	%E% SMI"
31*0Sstevel@tonic-gate 
32*0Sstevel@tonic-gate #ifdef __cplusplus
33*0Sstevel@tonic-gate extern "C" {
34*0Sstevel@tonic-gate #endif
35*0Sstevel@tonic-gate 
36*0Sstevel@tonic-gate 
37*0Sstevel@tonic-gate /*
38*0Sstevel@tonic-gate  * Each logical domain is detailed via a (Virtual) Machine Description
39*0Sstevel@tonic-gate  * available to each guest Operating System courtesy of a
40*0Sstevel@tonic-gate  * Hypervisor service.
41*0Sstevel@tonic-gate  */
42*0Sstevel@tonic-gate 
43*0Sstevel@tonic-gate 
44*0Sstevel@tonic-gate 
45*0Sstevel@tonic-gate #ifdef	_ASM
46*0Sstevel@tonic-gate #define	U8(_s)	_s
47*0Sstevel@tonic-gate #define	U16(_s)	_s
48*0Sstevel@tonic-gate #define	U32(_s)	_s
49*0Sstevel@tonic-gate #define	U64(_s)	_s
50*0Sstevel@tonic-gate #else
51*0Sstevel@tonic-gate #define	U8(_s)	((uint8_t)(_s))
52*0Sstevel@tonic-gate #define	U16(_s)	((uint16_t)(_s))
53*0Sstevel@tonic-gate #define	U32(_s)	((uint32_t)(_s))
54*0Sstevel@tonic-gate #define	U64(_s)	((uint64_t)(_s))
55*0Sstevel@tonic-gate #endif
56*0Sstevel@tonic-gate 
57*0Sstevel@tonic-gate 
58*0Sstevel@tonic-gate 
59*0Sstevel@tonic-gate 
60*0Sstevel@tonic-gate 
61*0Sstevel@tonic-gate 	/* the version this library understands */
62*0Sstevel@tonic-gate 
63*0Sstevel@tonic-gate #define	MD_HEADER_VERS_OFF	0x0
64*0Sstevel@tonic-gate #define	MD_HEADER_NODE_OFF	0x4
65*0Sstevel@tonic-gate #define	MD_HEADER_NAME_OFF	0x8
66*0Sstevel@tonic-gate #define	MD_HEADER_DATA_OFF	0xc
67*0Sstevel@tonic-gate 
68*0Sstevel@tonic-gate #define	MD_HEADER_SIZE	0x10
69*0Sstevel@tonic-gate 
70*0Sstevel@tonic-gate #define	MD_TRANSPORT_VERSION	U32(0x10000)
71*0Sstevel@tonic-gate 
72*0Sstevel@tonic-gate #define	MD_ELEMENT_SIZE	0x10
73*0Sstevel@tonic-gate 
74*0Sstevel@tonic-gate #define	MDE_ILLEGAL_IDX		U64(-1)
75*0Sstevel@tonic-gate 
76*0Sstevel@tonic-gate #define	MDET_LIST_END	U8(0x0)
77*0Sstevel@tonic-gate #define	MDET_NULL	U8(' ')
78*0Sstevel@tonic-gate #define	MDET_NODE	U8('N')
79*0Sstevel@tonic-gate #define	MDET_NODE_END	U8('E')
80*0Sstevel@tonic-gate #define	MDET_PROP_ARC	U8('a')
81*0Sstevel@tonic-gate #define	MDET_PROP_VAL	U8('v')
82*0Sstevel@tonic-gate #define	MDET_PROP_STR	U8('s')
83*0Sstevel@tonic-gate #define	MDET_PROP_DAT	U8('d')
84*0Sstevel@tonic-gate 
85*0Sstevel@tonic-gate 
86*0Sstevel@tonic-gate #ifndef _ASM	/* { */
87*0Sstevel@tonic-gate 
88*0Sstevel@tonic-gate typedef uint64_t mde_cookie_t;
89*0Sstevel@tonic-gate #define	MDE_INVAL_ELEM_COOKIE	((mde_cookie_t)-1)
90*0Sstevel@tonic-gate 
91*0Sstevel@tonic-gate typedef	uint32_t		mde_str_cookie_t;
92*0Sstevel@tonic-gate #define	MDE_INVAL_STR_COOKIE	((mde_str_cookie_t)-1)
93*0Sstevel@tonic-gate 
94*0Sstevel@tonic-gate 
95*0Sstevel@tonic-gate 	/* Opaque structure for handling in functions */
96*0Sstevel@tonic-gate typedef void * md_t;
97*0Sstevel@tonic-gate 
98*0Sstevel@tonic-gate 
99*0Sstevel@tonic-gate 
100*0Sstevel@tonic-gate 
101*0Sstevel@tonic-gate extern md_t		*md_init(void *);
102*0Sstevel@tonic-gate extern md_t		*md_init_intern(uint64_t *, void*(*)(size_t),
103*0Sstevel@tonic-gate 				void (*)(void*));
104*0Sstevel@tonic-gate 
105*0Sstevel@tonic-gate extern int		md_fini(md_t *);
106*0Sstevel@tonic-gate 
107*0Sstevel@tonic-gate extern int		md_node_count(md_t *);
108*0Sstevel@tonic-gate 
109*0Sstevel@tonic-gate extern mde_str_cookie_t md_find_name(md_t *, char *namep);
110*0Sstevel@tonic-gate 
111*0Sstevel@tonic-gate extern mde_cookie_t	md_root_node(md_t *);
112*0Sstevel@tonic-gate 
113*0Sstevel@tonic-gate extern int		md_scan_dag(md_t *,
114*0Sstevel@tonic-gate 				mde_cookie_t,
115*0Sstevel@tonic-gate 				mde_str_cookie_t,
116*0Sstevel@tonic-gate 				mde_str_cookie_t,
117*0Sstevel@tonic-gate 				mde_cookie_t *);
118*0Sstevel@tonic-gate 
119*0Sstevel@tonic-gate extern int		md_get_prop_val(md_t *,
120*0Sstevel@tonic-gate 				mde_cookie_t,
121*0Sstevel@tonic-gate 				char *,
122*0Sstevel@tonic-gate 				uint64_t *);
123*0Sstevel@tonic-gate 
124*0Sstevel@tonic-gate extern int		md_get_prop_str(md_t *,
125*0Sstevel@tonic-gate 				mde_cookie_t,
126*0Sstevel@tonic-gate 				char *,
127*0Sstevel@tonic-gate 				char **);
128*0Sstevel@tonic-gate 
129*0Sstevel@tonic-gate extern int		md_get_prop_data(md_t *,
130*0Sstevel@tonic-gate 				mde_cookie_t,
131*0Sstevel@tonic-gate 				char *,
132*0Sstevel@tonic-gate 				uint8_t **,
133*0Sstevel@tonic-gate 				int *);
134*0Sstevel@tonic-gate 
135*0Sstevel@tonic-gate 
136*0Sstevel@tonic-gate 
137*0Sstevel@tonic-gate #endif	/* } _ASM */
138*0Sstevel@tonic-gate 
139*0Sstevel@tonic-gate 
140*0Sstevel@tonic-gate 
141*0Sstevel@tonic-gate /*
142*0Sstevel@tonic-gate  * ioctl info for mdesc device
143*0Sstevel@tonic-gate  */
144*0Sstevel@tonic-gate 
145*0Sstevel@tonic-gate #define	MDESCIOC	('m' << 24 | 'd' << 16 | 'd' << 8)
146*0Sstevel@tonic-gate 
147*0Sstevel@tonic-gate #define	MDESCIOCGSZ	(MDESCIOC | 1)   /* Get quote buffer size */
148*0Sstevel@tonic-gate #define	MDESCIOCSSZ	(MDESCIOC | 2)   /* Set new quote buffer size */
149*0Sstevel@tonic-gate #define	MDESCIOCDISCARD	(MDESCIOC | 3)   /* Discard quotes and reset */
150*0Sstevel@tonic-gate 
151*0Sstevel@tonic-gate 
152*0Sstevel@tonic-gate #ifdef __cplusplus
153*0Sstevel@tonic-gate }
154*0Sstevel@tonic-gate #endif
155*0Sstevel@tonic-gate 
156*0Sstevel@tonic-gate #endif	/* _MDESC_H_ */
157