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 /* 23 * Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved. 24 */ 25 26 #ifndef _SYS_BRAND_H 27 #define _SYS_BRAND_H 28 29 #ifdef __cplusplus 30 extern "C" { 31 #endif 32 33 #include <sys/proc.h> 34 #include <sys/exec.h> 35 #include <sys/modctl.h> 36 #include <sys/types.h> 37 38 /* 39 * All Brands supported by this kernel must use BRAND_VER_1. 40 */ 41 #define BRAND_VER_1 1 42 43 /* 44 * sub-commands to brandsys. 45 * 1 - 128 are for common commands 46 * 128+ are available for brand-specific commands. 47 */ 48 #define B_REGISTER 1 49 #define B_TTYMODES 2 50 #define B_ELFDATA 3 51 #define B_EXEC_NATIVE 4 52 #define B_EXEC_BRAND 5 53 #define B_TRUSS_POINT 6 54 55 /* 56 * Structure used by zoneadmd to communicate the name of a brand and the 57 * supporting brand module into the kernel. 58 */ 59 struct brand_attr { 60 char ba_brandname[MAXNAMELEN]; 61 char ba_modname[MAXPATHLEN]; 62 }; 63 64 /* What we call the native brand. */ 65 #define NATIVE_BRAND_NAME "native" 66 67 /* What we call the labeled brand. */ 68 #define LABELED_BRAND_NAME "labeled" 69 70 /* 71 * Aux vector containing lddata pointer of brand library linkmap. 72 * Used by common {brand}_librtld_db. 73 */ 74 #define AT_SUN_BRAND_COMMON_LDDATA AT_SUN_BRAND_AUX1 75 76 /* 77 * Information needed by the brand library to launch an executable. 78 */ 79 typedef struct brand_elf_data { 80 ulong_t sed_phdr; 81 ulong_t sed_phent; 82 ulong_t sed_phnum; 83 ulong_t sed_entry; 84 ulong_t sed_base; 85 ulong_t sed_ldentry; 86 ulong_t sed_lddata; 87 } brand_elf_data_t; 88 89 /* 90 * Common structure used to register a branded processes 91 */ 92 typedef struct brand_proc_reg { 93 uint_t sbr_version; /* version number */ 94 caddr_t sbr_handler; /* base address of handler */ 95 } brand_proc_reg_t; 96 97 #ifdef _KERNEL 98 99 struct proc; 100 struct uarg; 101 struct brand_mach_ops; 102 struct intpdata; 103 struct execa; 104 105 struct brand_ops { 106 void (*b_init_brand_data)(zone_t *); 107 void (*b_free_brand_data)(zone_t *); 108 int (*b_brandsys)(int, int64_t *, uintptr_t, uintptr_t, uintptr_t, 109 uintptr_t, uintptr_t, uintptr_t); 110 void (*b_setbrand)(struct proc *); 111 int (*b_getattr)(zone_t *, int, void *, size_t *); 112 int (*b_setattr)(zone_t *, int, void *, size_t); 113 void (*b_copy_procdata)(struct proc *, struct proc *); 114 void (*b_proc_exit)(struct proc *, klwp_t *); 115 void (*b_exec)(); 116 void (*b_lwp_setrval)(klwp_t *, int, int); 117 int (*b_initlwp)(klwp_t *); 118 void (*b_forklwp)(klwp_t *, klwp_t *); 119 void (*b_freelwp)(klwp_t *); 120 void (*b_lwpexit)(klwp_t *); 121 int (*b_elfexec)(struct vnode *vp, struct execa *uap, 122 struct uarg *args, struct intpdata *idata, int level, 123 long *execsz, int setid, caddr_t exec_file, 124 struct cred *cred, int brand_action); 125 void (*b_sigset_native_to_brand)(sigset_t *); 126 void (*b_sigset_brand_to_native)(sigset_t *); 127 int b_nsig; 128 }; 129 130 /* 131 * The b_version field must always be the first entry in this struct. 132 */ 133 typedef struct brand { 134 int b_version; 135 char *b_name; 136 struct brand_ops *b_ops; 137 struct brand_mach_ops *b_machops; 138 } brand_t; 139 140 extern brand_t native_brand; 141 142 /* 143 * Convenience macros 144 */ 145 #define lwptolwpbrand(l) ((l)->lwp_brand) 146 #define ttolwpbrand(t) (lwptolwpbrand(ttolwp(t))) 147 #define PROC_IS_BRANDED(p) ((p)->p_brand != &native_brand) 148 #define ZONE_IS_BRANDED(z) ((z)->zone_brand != &native_brand) 149 #define BROP(p) ((p)->p_brand->b_ops) 150 #define ZBROP(z) ((z)->zone_brand->b_ops) 151 #define BRMOP(p) ((p)->p_brand->b_machops) 152 #define SIGSET_NATIVE_TO_BRAND(sigset) \ 153 if (PROC_IS_BRANDED(curproc) && \ 154 BROP(curproc)->b_sigset_native_to_brand) \ 155 BROP(curproc)->b_sigset_native_to_brand(sigset) 156 #define SIGSET_BRAND_TO_NATIVE(sigset) \ 157 if (PROC_IS_BRANDED(curproc) && \ 158 BROP(curproc)->b_sigset_brand_to_native) \ 159 BROP(curproc)->b_sigset_brand_to_native(sigset) 160 161 extern void brand_init(); 162 extern int brand_register(brand_t *); 163 extern int brand_unregister(brand_t *); 164 extern brand_t *brand_register_zone(struct brand_attr *); 165 extern brand_t *brand_find_name(char *); 166 extern void brand_unregister_zone(brand_t *); 167 extern int brand_zone_count(brand_t *); 168 extern void brand_setbrand(proc_t *); 169 extern void brand_clearbrand(proc_t *, boolean_t); 170 171 /* 172 * The following functions can be shared among kernel brand modules which 173 * implement Solaris-derived brands, all of which need to do similar tasks to 174 * manage the brand. 175 */ 176 extern int brand_solaris_cmd(int, uintptr_t, uintptr_t, uintptr_t, 177 struct brand *, int); 178 extern void brand_solaris_copy_procdata(proc_t *, proc_t *, 179 struct brand *); 180 extern int brand_solaris_elfexec(vnode_t *, execa_t *, uarg_t *, 181 intpdata_t *, int, long *, int, caddr_t, cred_t *, int, 182 struct brand *, char *, char *, char *, char *, char *); 183 extern void brand_solaris_exec(struct brand *); 184 extern int brand_solaris_fini(char **, struct modlinkage *, 185 struct brand *); 186 extern void brand_solaris_forklwp(klwp_t *, klwp_t *, struct brand *); 187 extern void brand_solaris_freelwp(klwp_t *, struct brand *); 188 extern int brand_solaris_initlwp(klwp_t *, struct brand *); 189 extern void brand_solaris_lwpexit(klwp_t *, struct brand *); 190 extern void brand_solaris_proc_exit(struct proc *, klwp_t *, 191 struct brand *); 192 extern void brand_solaris_setbrand(proc_t *, struct brand *); 193 194 #if defined(_SYSCALL32) 195 typedef struct brand_elf_data32 { 196 uint32_t sed_phdr; 197 uint32_t sed_phent; 198 uint32_t sed_phnum; 199 uint32_t sed_entry; 200 uint32_t sed_base; 201 uint32_t sed_ldentry; 202 uint32_t sed_lddata; 203 } brand_elf_data32_t; 204 205 typedef struct brand_common_reg32 { 206 uint32_t sbr_version; /* version number */ 207 caddr32_t sbr_handler; /* base address of handler */ 208 } brand_common_reg32_t; 209 #endif /* _SYSCALL32 */ 210 211 /* 212 * Common information associated with all branded processes 213 */ 214 typedef struct brand_proc_data { 215 caddr_t spd_handler; /* address of user-space handler */ 216 brand_elf_data_t spd_elf_data; /* common ELF data for branded app. */ 217 } brand_proc_data_t; 218 219 #define BRAND_NATIVE_DIR "/.SUNWnative/" 220 #define BRAND_NATIVE_LINKER32 BRAND_NATIVE_DIR "lib/ld.so.1" 221 #define BRAND_NATIVE_LINKER64 BRAND_NATIVE_DIR "lib/64/ld.so.1" 222 223 #endif /* _KERNEL */ 224 225 #ifdef __cplusplus 226 } 227 #endif 228 229 #endif /* _SYS_BRAND_H */ 230