17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 51ae08745Sheppo * Common Development and Distribution License (the "License"). 61ae08745Sheppo * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 211ae08745Sheppo 227c478bd9Sstevel@tonic-gate /* 23*908f1e13Ssd77468 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 247c478bd9Sstevel@tonic-gate * Use is subject to license terms. 257c478bd9Sstevel@tonic-gate */ 267c478bd9Sstevel@tonic-gate 277c478bd9Sstevel@tonic-gate #ifndef _MDESC_H_ 287c478bd9Sstevel@tonic-gate #define _MDESC_H_ 297c478bd9Sstevel@tonic-gate 306dfee483Stsien #include <sys/types.h> 316dfee483Stsien 327c478bd9Sstevel@tonic-gate #ifdef __cplusplus 337c478bd9Sstevel@tonic-gate extern "C" { 347c478bd9Sstevel@tonic-gate #endif 357c478bd9Sstevel@tonic-gate 367c478bd9Sstevel@tonic-gate 377c478bd9Sstevel@tonic-gate /* 387c478bd9Sstevel@tonic-gate * Each logical domain is detailed via a (Virtual) Machine Description 397c478bd9Sstevel@tonic-gate * available to each guest Operating System courtesy of a 407c478bd9Sstevel@tonic-gate * Hypervisor service. 417c478bd9Sstevel@tonic-gate */ 427c478bd9Sstevel@tonic-gate 437c478bd9Sstevel@tonic-gate 447c478bd9Sstevel@tonic-gate 457c478bd9Sstevel@tonic-gate #ifdef _ASM 467c478bd9Sstevel@tonic-gate #define U8(_s) _s 477c478bd9Sstevel@tonic-gate #define U16(_s) _s 487c478bd9Sstevel@tonic-gate #define U32(_s) _s 497c478bd9Sstevel@tonic-gate #define U64(_s) _s 507c478bd9Sstevel@tonic-gate #else 517c478bd9Sstevel@tonic-gate #define U8(_s) ((uint8_t)(_s)) 527c478bd9Sstevel@tonic-gate #define U16(_s) ((uint16_t)(_s)) 537c478bd9Sstevel@tonic-gate #define U32(_s) ((uint32_t)(_s)) 547c478bd9Sstevel@tonic-gate #define U64(_s) ((uint64_t)(_s)) 557c478bd9Sstevel@tonic-gate #endif 567c478bd9Sstevel@tonic-gate 577c478bd9Sstevel@tonic-gate 587c478bd9Sstevel@tonic-gate 597c478bd9Sstevel@tonic-gate 607c478bd9Sstevel@tonic-gate 617c478bd9Sstevel@tonic-gate /* the version this library understands */ 627c478bd9Sstevel@tonic-gate 637c478bd9Sstevel@tonic-gate #define MD_HEADER_VERS_OFF 0x0 647c478bd9Sstevel@tonic-gate #define MD_HEADER_NODE_OFF 0x4 657c478bd9Sstevel@tonic-gate #define MD_HEADER_NAME_OFF 0x8 667c478bd9Sstevel@tonic-gate #define MD_HEADER_DATA_OFF 0xc 677c478bd9Sstevel@tonic-gate 687c478bd9Sstevel@tonic-gate #define MD_HEADER_SIZE 0x10 697c478bd9Sstevel@tonic-gate 707c478bd9Sstevel@tonic-gate #define MD_TRANSPORT_VERSION U32(0x10000) 717c478bd9Sstevel@tonic-gate 727c478bd9Sstevel@tonic-gate #define MD_ELEMENT_SIZE 0x10 737c478bd9Sstevel@tonic-gate 747c478bd9Sstevel@tonic-gate #define MDE_ILLEGAL_IDX U64(-1) 757c478bd9Sstevel@tonic-gate 767c478bd9Sstevel@tonic-gate #define MDET_LIST_END U8(0x0) 777c478bd9Sstevel@tonic-gate #define MDET_NULL U8(' ') 787c478bd9Sstevel@tonic-gate #define MDET_NODE U8('N') 797c478bd9Sstevel@tonic-gate #define MDET_NODE_END U8('E') 807c478bd9Sstevel@tonic-gate #define MDET_PROP_ARC U8('a') 817c478bd9Sstevel@tonic-gate #define MDET_PROP_VAL U8('v') 827c478bd9Sstevel@tonic-gate #define MDET_PROP_STR U8('s') 837c478bd9Sstevel@tonic-gate #define MDET_PROP_DAT U8('d') 847c478bd9Sstevel@tonic-gate 857c478bd9Sstevel@tonic-gate 867c478bd9Sstevel@tonic-gate #ifndef _ASM /* { */ 877c478bd9Sstevel@tonic-gate 881ae08745Sheppo /* 891ae08745Sheppo * Opaque handles for use in external interfaces 901ae08745Sheppo */ 911ae08745Sheppo 921ae08745Sheppo typedef void *md_t; 931ae08745Sheppo 947c478bd9Sstevel@tonic-gate typedef uint64_t mde_cookie_t; 957c478bd9Sstevel@tonic-gate #define MDE_INVAL_ELEM_COOKIE ((mde_cookie_t)-1) 967c478bd9Sstevel@tonic-gate 977c478bd9Sstevel@tonic-gate typedef uint32_t mde_str_cookie_t; 987c478bd9Sstevel@tonic-gate #define MDE_INVAL_STR_COOKIE ((mde_str_cookie_t)-1) 997c478bd9Sstevel@tonic-gate 1001ae08745Sheppo typedef uint64_t md_diff_cookie_t; 1011ae08745Sheppo #define MD_INVAL_DIFF_COOKIE ((md_diff_cookie_t)-1) 1027c478bd9Sstevel@tonic-gate 1031ae08745Sheppo #define MDESC_INVAL_GEN (0) 1041ae08745Sheppo 1051ae08745Sheppo /* 1061ae08745Sheppo * External structure for MD diff interface 1071ae08745Sheppo */ 1081ae08745Sheppo typedef struct { 1091ae08745Sheppo uint8_t type; /* property type */ 1101ae08745Sheppo char *namep; /* property name */ 1111ae08745Sheppo } md_prop_match_t; 1127c478bd9Sstevel@tonic-gate 1137c478bd9Sstevel@tonic-gate 1141ae08745Sheppo /* 115*908f1e13Ssd77468 * Walk callback function return codes 116*908f1e13Ssd77468 */ 117*908f1e13Ssd77468 #define MDE_WALK_ERROR -1 /* Terminate walk with error */ 118*908f1e13Ssd77468 #define MDE_WALK_NEXT 0 /* Continue to next node */ 119*908f1e13Ssd77468 #define MDE_WALK_DONE 1 /* Terminate walk with success */ 120*908f1e13Ssd77468 121*908f1e13Ssd77468 /* 122*908f1e13Ssd77468 * The function prototype for a walker callback function. 123*908f1e13Ssd77468 * The machine description session, parent node, current node, 124*908f1e13Ssd77468 * and private data are given to the callback. 125*908f1e13Ssd77468 * 126*908f1e13Ssd77468 * The parent node is given to the callback to provide context 127*908f1e13Ssd77468 * on how the walker arrived at this location. While the node 128*908f1e13Ssd77468 * may have many parents, it will be visited only once, this 129*908f1e13Ssd77468 * provides context on how the walker arrived at the node. 130*908f1e13Ssd77468 * 131*908f1e13Ssd77468 * Input Description 132*908f1e13Ssd77468 * ------------------- ---------------------------------------- 133*908f1e13Ssd77468 * md_t * Pointer to md session 134*908f1e13Ssd77468 * mde_cookie_t Index of parent node to provide context 135*908f1e13Ssd77468 * mde_cookie_t The current node in the walk 136*908f1e13Ssd77468 * void * Private data for the walking function 137*908f1e13Ssd77468 */ 138*908f1e13Ssd77468 typedef int md_walk_fn_t(md_t *, mde_cookie_t, mde_cookie_t, void *); 139*908f1e13Ssd77468 140*908f1e13Ssd77468 141*908f1e13Ssd77468 /* 1421ae08745Sheppo * External Interface 1431ae08745Sheppo */ 1447c478bd9Sstevel@tonic-gate 1451ae08745Sheppo extern md_t *md_init_intern(uint64_t *, 1461ae08745Sheppo void *(*allocp)(size_t), 1471ae08745Sheppo void (*freep)(void *, size_t)); 1487c478bd9Sstevel@tonic-gate 1497c478bd9Sstevel@tonic-gate extern int md_fini(md_t *); 1507c478bd9Sstevel@tonic-gate 1517c478bd9Sstevel@tonic-gate extern int md_node_count(md_t *); 1527c478bd9Sstevel@tonic-gate 1537c478bd9Sstevel@tonic-gate extern mde_str_cookie_t md_find_name(md_t *, char *namep); 1547c478bd9Sstevel@tonic-gate 1557c478bd9Sstevel@tonic-gate extern mde_cookie_t md_root_node(md_t *); 1567c478bd9Sstevel@tonic-gate 1571ae08745Sheppo extern uint64_t md_get_gen(md_t *); 1581ae08745Sheppo 1591ae08745Sheppo extern size_t md_get_bin_size(md_t *); 1601ae08745Sheppo 1617c478bd9Sstevel@tonic-gate extern int md_scan_dag(md_t *, 1627c478bd9Sstevel@tonic-gate mde_cookie_t, 1637c478bd9Sstevel@tonic-gate mde_str_cookie_t, 1647c478bd9Sstevel@tonic-gate mde_str_cookie_t, 1657c478bd9Sstevel@tonic-gate mde_cookie_t *); 1667c478bd9Sstevel@tonic-gate 167*908f1e13Ssd77468 extern int md_walk_dag(md_t *, 168*908f1e13Ssd77468 mde_cookie_t, 169*908f1e13Ssd77468 mde_str_cookie_t, 170*908f1e13Ssd77468 mde_str_cookie_t, 171*908f1e13Ssd77468 md_walk_fn_t, 172*908f1e13Ssd77468 void *); 173*908f1e13Ssd77468 1747c478bd9Sstevel@tonic-gate extern int md_get_prop_val(md_t *, 1757c478bd9Sstevel@tonic-gate mde_cookie_t, 1767c478bd9Sstevel@tonic-gate char *, 1777c478bd9Sstevel@tonic-gate uint64_t *); 1787c478bd9Sstevel@tonic-gate 1797c478bd9Sstevel@tonic-gate extern int md_get_prop_str(md_t *, 1807c478bd9Sstevel@tonic-gate mde_cookie_t, 1817c478bd9Sstevel@tonic-gate char *, 1827c478bd9Sstevel@tonic-gate char **); 1837c478bd9Sstevel@tonic-gate 1847c478bd9Sstevel@tonic-gate extern int md_get_prop_data(md_t *, 1857c478bd9Sstevel@tonic-gate mde_cookie_t, 1867c478bd9Sstevel@tonic-gate char *, 1877c478bd9Sstevel@tonic-gate uint8_t **, 1887c478bd9Sstevel@tonic-gate int *); 1897c478bd9Sstevel@tonic-gate 190*908f1e13Ssd77468 extern int md_get_prop_arcs(md_t *, 191*908f1e13Ssd77468 mde_cookie_t, 192*908f1e13Ssd77468 char *, 193*908f1e13Ssd77468 mde_cookie_t *, 194*908f1e13Ssd77468 size_t); 195*908f1e13Ssd77468 196*908f1e13Ssd77468 1971ae08745Sheppo extern md_diff_cookie_t md_diff_init(md_t *, 1981ae08745Sheppo mde_cookie_t, 1991ae08745Sheppo md_t *, 2001ae08745Sheppo mde_cookie_t, 2011ae08745Sheppo char *, 2021ae08745Sheppo md_prop_match_t *); 2031ae08745Sheppo 2041ae08745Sheppo extern int md_diff_added(md_diff_cookie_t, 2051ae08745Sheppo mde_cookie_t **); 2061ae08745Sheppo 2071ae08745Sheppo extern int md_diff_removed(md_diff_cookie_t, 2081ae08745Sheppo mde_cookie_t **); 2091ae08745Sheppo 2101ae08745Sheppo extern int md_diff_matched(md_diff_cookie_t, 2111ae08745Sheppo mde_cookie_t **, 2121ae08745Sheppo mde_cookie_t **); 2131ae08745Sheppo 2141ae08745Sheppo extern int md_diff_fini(md_diff_cookie_t); 2157c478bd9Sstevel@tonic-gate 2167c478bd9Sstevel@tonic-gate 2177c478bd9Sstevel@tonic-gate #endif /* } _ASM */ 2187c478bd9Sstevel@tonic-gate 2197c478bd9Sstevel@tonic-gate 2207c478bd9Sstevel@tonic-gate 2217c478bd9Sstevel@tonic-gate /* 2227c478bd9Sstevel@tonic-gate * ioctl info for mdesc device 2237c478bd9Sstevel@tonic-gate */ 2247c478bd9Sstevel@tonic-gate 2257c478bd9Sstevel@tonic-gate #define MDESCIOC ('m' << 24 | 'd' << 16 | 'd' << 8) 2267c478bd9Sstevel@tonic-gate 2277c478bd9Sstevel@tonic-gate #define MDESCIOCGSZ (MDESCIOC | 1) /* Get quote buffer size */ 2287c478bd9Sstevel@tonic-gate #define MDESCIOCSSZ (MDESCIOC | 2) /* Set new quote buffer size */ 2297c478bd9Sstevel@tonic-gate #define MDESCIOCDISCARD (MDESCIOC | 3) /* Discard quotes and reset */ 2307c478bd9Sstevel@tonic-gate 2317c478bd9Sstevel@tonic-gate #ifdef __cplusplus 2327c478bd9Sstevel@tonic-gate } 2337c478bd9Sstevel@tonic-gate #endif 2347c478bd9Sstevel@tonic-gate 2357c478bd9Sstevel@tonic-gate #endif /* _MDESC_H_ */ 236