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 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _LOWLEVEL_IMPL_H 27 #define _LOWLEVEL_IMPL_H 28 29 #pragma ident "%Z%%M% %I% %E% SMI" 30 31 #include "libscf_impl.h" 32 33 #include <door.h> 34 #include <libuutil.h> 35 #include <limits.h> 36 #include <pthread.h> 37 #include <stddef.h> 38 39 #include "repcache_protocol.h" 40 41 #ifdef __cplusplus 42 extern "C" { 43 #endif 44 45 typedef struct scf_datael { 46 scf_handle_t *rd_handle; 47 uint32_t rd_entity; 48 uint32_t rd_type; 49 uint32_t rd_reset; 50 uu_list_node_t rd_node; 51 } scf_datael_t; 52 #define DATAEL_VALID 0x0001 53 54 /* 55 * Handle structure. 56 * 57 * Access to handles is serialized -- access to and modification of a handle 58 * and all of its children is protected by rh_lock. 59 * 60 * Different handles don't interfere with each other. 61 */ 62 struct scf_handle { 63 pthread_mutex_t rh_lock; 64 pthread_cond_t rh_cv; 65 66 uint32_t rh_nextiter; 67 uint32_t rh_nextentity; 68 uint32_t rh_nextchangeid; 69 70 int rh_doorfd; 71 int rh_doorfd_old; /* fd to close once rh_fd_users == 0 */ 72 door_id_t rh_doorid; 73 pid_t rh_doorpid; /* pid at bind time */ 74 75 uid_t rh_uid; 76 uint32_t rh_debug; 77 uint32_t rh_flags; /* HANDLE_*, below */ 78 uint32_t rh_fd_users; /* non-locked users of rh_doorfd */ 79 80 uu_list_t *rh_dataels; 81 uu_list_t *rh_iters; 82 long rh_entries; 83 long rh_values; 84 85 long rh_extrefs; /* user-created subhandle count */ 86 long rh_intrefs; /* handle-internal subhandle count */ 87 88 char rh_doorpath[PATH_MAX + 1]; 89 90 pthread_t rh_holder; /* thread using subhandles */ 91 uint32_t rh_hold_flags; /* which are in use */ 92 93 scf_iter_t *rh_iter; 94 scf_scope_t *rh_scope; 95 scf_service_t *rh_service; 96 scf_instance_t *rh_instance; 97 scf_snapshot_t *rh_snapshot; 98 scf_snaplevel_t *rh_snaplvl; 99 scf_propertygroup_t *rh_pg; 100 scf_property_t *rh_property; 101 scf_value_t *rh_value; 102 }; 103 #define HANDLE_DEAD 0x0001 104 #define HANDLE_UNREFED 0x0002 105 #define HANDLE_WRAPPED_ENTITY 0x0004 106 #define HANDLE_WRAPPED_ITER 0x0008 107 108 #define RH_HOLD_ITER 0x0001 109 #define RH_HOLD_SCOPE 0x0002 110 #define RH_HOLD_SERVICE 0x0004 111 #define RH_HOLD_INSTANCE 0x0008 112 #define RH_HOLD_SNAPSHOT 0x0010 113 #define RH_HOLD_SNAPLVL 0x0020 114 #define RH_HOLD_PG 0x0040 115 #define RH_HOLD_PROPERTY 0x0080 116 #define RH_HOLD_VALUE 0x0100 117 118 #define RH_HOLD_ALL 0x01ff 119 120 struct scf_scope { 121 scf_datael_t rd_d; 122 }; 123 124 struct scf_service { 125 scf_datael_t rd_d; 126 }; 127 128 struct scf_instance { 129 scf_datael_t rd_d; 130 }; 131 132 struct scf_snapshot { 133 scf_datael_t rd_d; 134 }; 135 136 /* 137 * note: be careful of adding more state here -- snaplevel_next() relies on 138 * the fact that the entityid is the only library-level state. 139 */ 140 struct scf_snaplevel { 141 scf_datael_t rd_d; 142 }; 143 144 struct scf_propertygroup { 145 scf_datael_t rd_d; 146 }; 147 148 struct scf_property { 149 scf_datael_t rd_d; 150 }; 151 152 struct scf_value { 153 scf_handle_t *value_handle; 154 scf_value_t *value_next; 155 scf_transaction_entry_t *value_tx; 156 157 rep_protocol_value_type_t value_type; 158 size_t value_size; /* only for opaque values */ 159 char value_value[REP_PROTOCOL_VALUE_LEN]; 160 }; 161 162 enum scf_entry_state { 163 ENTRY_STATE_INVALID, 164 ENTRY_STATE_IN_TX_ACTION 165 }; 166 struct scf_transaction_entry { 167 const char *entry_property; 168 scf_handle_t *entry_handle; 169 scf_transaction_t *entry_tx; 170 enum scf_entry_state entry_state; 171 uu_list_node_t entry_link; /* for property name list */ 172 173 scf_value_t *entry_head; 174 scf_value_t *entry_tail; /* for linked values */ 175 176 enum rep_protocol_transaction_action entry_action; 177 rep_protocol_value_type_t entry_type; 178 char entry_namebuf[REP_PROTOCOL_NAME_LEN]; 179 }; 180 181 enum scf_tx_state { 182 TRAN_STATE_NEW, 183 TRAN_STATE_SETUP, 184 TRAN_STATE_COMMITTED 185 }; 186 187 struct scf_transaction { 188 enum scf_tx_state tran_state; 189 scf_propertygroup_t tran_pg; 190 int tran_invalid; 191 uu_list_t *tran_props; 192 }; 193 194 struct scf_iter { 195 scf_handle_t *iter_handle; 196 int iter_type; 197 uint32_t iter_id; 198 uint32_t iter_sequence; 199 uu_list_node_t iter_node; 200 }; 201 202 #ifdef __cplusplus 203 } 204 #endif 205 206 #endif /* _LOWLEVEL_IMPL_H */ 207