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 2009 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _LIBMLSVC_H 27 #define _LIBMLSVC_H 28 29 #include <uuid/uuid.h> 30 #include <sys/param.h> 31 #include <sys/types.h> 32 #include <sys/uio.h> 33 #include <sys/ksynch.h> 34 #include <stdio.h> 35 #include <string.h> 36 #include <netdb.h> 37 #include <libuutil.h> 38 #include <smbsrv/wintypes.h> 39 #include <smbsrv/hash_table.h> 40 #include <smbsrv/smb_token.h> 41 #include <smbsrv/smb_privilege.h> 42 #include <smbsrv/smb_share.h> 43 #include <smbsrv/smb_xdr.h> 44 #include <smbsrv/libsmb.h> 45 #include <smbsrv/libsmbrdr.h> 46 #include <smbsrv/libmlrpc.h> 47 #include <smbsrv/ndl/lsarpc.ndl> 48 49 #ifdef __cplusplus 50 extern "C" { 51 #endif 52 53 extern uint32_t mlsvc_lookup_name(char *, smb_sid_t **, uint16_t *); 54 extern uint32_t mlsvc_lookup_sid(smb_sid_t *, char **); 55 56 /* 57 * SMB domain API to discover a domain controller and obtain domain 58 * information. 59 */ 60 61 extern boolean_t smb_locate_dc(char *, char *, smb_domain_t *); 62 extern boolean_t smb_domain_getinfo(smb_domain_t *); 63 64 65 extern void dssetup_clear_domain_info(void); 66 extern int mlsvc_init(void); 67 extern void mlsvc_fini(void); 68 extern DWORD mlsvc_netlogon(char *, char *); 69 extern DWORD mlsvc_join(smb_domain_t *, char *, char *); 70 71 72 /* 73 * The maximum number of domains (NT limit). 74 */ 75 #define MLSVC_DOMAIN_MAX 32 76 77 /* 78 * Status code returned from enumeration RPCs to indicate 79 * that the server has no more data. Normally returned at 80 * severity level ERROR_SEVERITY_WARNING. 81 */ 82 #define MLSVC_NO_MORE_DATA 0x1A 83 84 #define MLSVC_ANON_USER "IPC$" 85 86 char *mlsvc_ipc_name(int ipc_type, char *username); 87 88 /* 89 * Passthrough negotiation and authentication interface. 90 * 91 * NT supports two forms of password: a Lanman (case-insensitive) 92 * password and an NT (case-sensitive) password. If either of the 93 * passwords is not available its pointer and length should be set 94 * to zero. The session key and vc number are required to validate 95 * the encrypted passwords. 96 */ 97 98 void mlsvc_nt_password_hash(char *result, char *password); 99 int mlsvc_encrypt_nt_password(char *password, char *key, int keylen, char *out, 100 int outmax); 101 102 #define SMB_AUTOHOME_FILE "smbautohome" 103 #define SMB_AUTOHOME_PATH "/etc" 104 105 typedef struct smb_autohome { 106 struct smb_autohome *ah_next; 107 uint32_t ah_hits; 108 time_t ah_timestamp; 109 char *ah_name; /* User account name */ 110 char *ah_path; /* Home directory path */ 111 char *ah_container; /* ADS container distinguished name */ 112 } smb_autohome_t; 113 114 extern void smb_autohome_add(const char *); 115 extern void smb_autohome_remove(const char *); 116 117 /* 118 * A local unique id (LUID) is an opaque id used by servers to identify 119 * local resources, such as privileges. A client will use lookup 120 * functions to translate the LUID to a more general, machine independent 121 * form; such as a string. 122 */ 123 typedef struct ms_luid { 124 uint32_t low_part; 125 uint32_t high_part; 126 } ms_luid_t; 127 128 /* 129 * Information about a server as reported by NetServerGetInfo. 130 * The SV_PLATFORM and SV_TYPE definitions are in srvsvc.ndl. 131 */ 132 typedef struct srvsvc_server_info { 133 uint32_t sv_platform_id; 134 char *sv_name; 135 uint32_t sv_version_major; 136 uint32_t sv_version_minor; 137 uint32_t sv_type; 138 char *sv_comment; 139 } srvsvc_server_info_t; 140 141 int srvsvc_net_server_getinfo(char *, char *, srvsvc_server_info_t *); 142 143 /* 144 * A client_t is created while binding a client connection to hold the 145 * context for calls made using that connection. 146 * 147 * Handles are RPC call specific and we use an inheritance mechanism to 148 * ensure that each handle has a pointer to the client_t. When the top 149 * level (bind) handle is released, we close the connection. 150 */ 151 typedef struct mlsvc_handle { 152 ndr_hdid_t handle; 153 ndr_client_t *clnt; 154 int remote_os; 155 srvsvc_server_info_t svinfo; 156 } mlsvc_handle_t; 157 158 int ndr_rpc_bind(mlsvc_handle_t *, char *, char *, char *, const char *); 159 void ndr_rpc_unbind(mlsvc_handle_t *); 160 int ndr_rpc_call(mlsvc_handle_t *, int, void *); 161 void ndr_rpc_server_setinfo(mlsvc_handle_t *, const srvsvc_server_info_t *); 162 void ndr_rpc_server_getinfo(mlsvc_handle_t *, srvsvc_server_info_t *); 163 int ndr_rpc_server_os(mlsvc_handle_t *); 164 void *ndr_rpc_malloc(mlsvc_handle_t *, size_t); 165 ndr_heap_t *ndr_rpc_get_heap(mlsvc_handle_t *); 166 void ndr_rpc_release(mlsvc_handle_t *); 167 boolean_t ndr_is_null_handle(mlsvc_handle_t *); 168 boolean_t ndr_is_bind_handle(mlsvc_handle_t *); 169 void ndr_inherit_handle(mlsvc_handle_t *, mlsvc_handle_t *); 170 void ndr_rpc_status(mlsvc_handle_t *, int, uint32_t); 171 172 /* SVCCTL service */ 173 /* 174 * Calculate the wide-char equivalent string length required to 175 * store a string - including the terminating null wide-char. 176 */ 177 #define SVCCTL_WNSTRLEN(S) ((strlen((S)) + 1) * sizeof (mts_wchar_t)) 178 179 /* An AVL-storable node representing each service in the SCM database. */ 180 typedef struct svcctl_svc_node { 181 uu_avl_node_t sn_node; 182 char *sn_name; /* Service Name (Key) */ 183 char *sn_fmri; /* Display Name (FMRI) */ 184 char *sn_desc; /* Description */ 185 char *sn_state; /* State */ 186 } svcctl_svc_node_t; 187 188 /* This structure provides context for each svcctl_s_OpenManager call. */ 189 typedef struct svcctl_manager_context { 190 scf_handle_t *mc_scf_hdl; /* SCF handle */ 191 scf_propertygroup_t *mc_scf_gpg; /* Property group */ 192 scf_property_t *mc_scf_gprop; /* Property */ 193 scf_value_t *mc_scf_gval; /* Value */ 194 uint32_t mc_scf_numsvcs; /* Number of SMF services */ 195 ssize_t mc_scf_max_fmri_len; /* Max FMRI length */ 196 ssize_t mc_scf_max_value_len; /* Max Value length */ 197 uint32_t mc_bytes_needed; /* Number of bytes needed */ 198 uu_avl_pool_t *mc_svcs_pool; /* AVL pool */ 199 uu_avl_t *mc_svcs; /* AVL tree of SMF services */ 200 } svcctl_manager_context_t; 201 202 /* This structure provides context for each svcctl_s_OpenService call. */ 203 typedef struct svcctl_service_context { 204 ndr_hdid_t *sc_mgrid; /* Manager ID */ 205 char *sc_svcname; /* Service Name */ 206 } svcctl_service_context_t; 207 208 typedef enum { 209 SVCCTL_MANAGER_CONTEXT = 0, 210 SVCCTL_SERVICE_CONTEXT 211 } svcctl_context_type_t; 212 213 /* This structure provides abstraction for service and manager context call. */ 214 typedef struct svcctl_context { 215 svcctl_context_type_t c_type; 216 union { 217 svcctl_manager_context_t *uc_mgr; 218 svcctl_service_context_t *uc_svc; 219 void *uc_cp; 220 } c_ctx; 221 } svcctl_context_t; 222 223 /* Service Control Manager (SCM) functions */ 224 void svcctl_init(void); 225 void svcctl_fini(void); 226 int svcctl_scm_init(svcctl_manager_context_t *); 227 void svcctl_scm_fini(svcctl_manager_context_t *); 228 int svcctl_scm_scf_handle_init(svcctl_manager_context_t *); 229 void svcctl_scm_scf_handle_fini(svcctl_manager_context_t *); 230 int svcctl_scm_refresh(svcctl_manager_context_t *); 231 uint32_t svcctl_scm_enum_services(svcctl_manager_context_t *, uint8_t *, 232 size_t, uint32_t *, boolean_t); 233 uint32_t svcctl_scm_validate_service(svcctl_manager_context_t *, char *); 234 svcctl_svc_node_t *svcctl_scm_find_service(svcctl_manager_context_t *, char *); 235 uint32_t svcctl_scm_map_status(const char *); 236 237 /* LOGR service */ 238 #define LOGR_APPLICATION_LOG "Application" 239 #define LOGR_SECURITY_LOG "Security" 240 #define LOGR_SYSTEM_LOG "System" 241 #define LOGR_NMSGMASK 1023 242 #define LOGR_MAXMSGLEN 800 243 244 typedef struct logr_entry { 245 struct timeval le_timestamp; /* Time of log entry */ 246 int le_pri; /* Message priority */ 247 char le_hostname[MAXHOSTNAMELEN]; /* Log hostname */ 248 char le_msg[LOGR_MAXMSGLEN]; /* Log message text */ 249 } logr_entry_t; 250 251 typedef struct logr_info { 252 logr_entry_t li_entry[LOGR_NMSGMASK+1]; /* Array of log entry */ 253 int li_idx; /* Index */ 254 } logr_info_t; 255 256 typedef struct logr_read_data { 257 int rd_tot_recnum; /* Total no. of record read */ 258 int rd_last_sentrec; /* Last sentence read */ 259 char rd_first_read; /* First sentence read */ 260 logr_info_t *rd_log; /* Log information read */ 261 } logr_read_data_t; 262 263 /* This structure provides the context for eventlog calls from clients. */ 264 typedef struct logr_context { 265 logr_read_data_t *lc_cached_read_data; 266 char *lc_source_name; 267 } logr_context_t; 268 269 void logr_init(void); 270 void logr_fini(void); 271 boolean_t logr_is_supported(char *); 272 int logr_get_snapshot(logr_context_t *); 273 274 #ifdef __cplusplus 275 } 276 #endif 277 278 #endif /* _LIBMLSVC_H */ 279