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 2008 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 #ifndef _SYS_SID_H 28 #define _SYS_SID_H 29 30 #pragma ident "%Z%%M% %I% %E% SMI" 31 32 #include <sys/types.h> 33 #include <sys/avl.h> 34 #ifdef _KERNEL 35 #include <sys/zone.h> 36 #endif 37 38 /* 39 * Kernel SID data structure and functions. 40 */ 41 #ifdef __cplusplus 42 extern "C" { 43 #endif 44 45 /* sidsys subcodes */ 46 #define SIDSYS_ALLOC_IDS 0 47 /* Flags for ALLOC_IDS */ 48 #define SID_EXTEND_RANGE 0 49 #define SID_NEW_RANGE 1 50 51 #define SIDSYS_IDMAP_REG 1 52 #define SIDSYS_IDMAP_UNREG 2 53 54 #define SIDSYS_SID2ID 0 55 #define SIDSYS_ID2SID 1 56 57 #ifdef _KERNEL 58 #define KSIDLIST_MEM(n) (sizeof (ksidlist_t) + ((n) - 1) * sizeof (ksid_t)) 59 60 /* Domains are stored in AVL trees so we can share them among SIDs */ 61 typedef struct ksiddomain { 62 uint_t kd_ref; 63 uint_t kd_len; 64 char *kd_name; /* Domain part of SID */ 65 avl_node_t kd_link; 66 } ksiddomain_t; 67 68 typedef struct ksid { 69 uid_t ks_id; /* Cache of (ephemeral) uid */ 70 uint32_t ks_rid; /* Rid part of the name */ 71 uint32_t ks_attr; /* Attribute */ 72 ksiddomain_t *ks_domain; /* Domain descsriptor */ 73 } ksid_t; 74 75 typedef enum ksid_index { 76 KSID_USER, 77 KSID_GROUP, 78 KSID_OWNER, 79 KSID_COUNT /* Must be last */ 80 } ksid_index_t; 81 82 /* 83 * As no memory may be allocated for credentials while holding p_crlock, 84 * all sub data structures need to be ref counted. 85 */ 86 87 typedef struct ksidlist { 88 uint_t ksl_ref; 89 uint_t ksl_nsid; 90 uint_t ksl_neid; /* Number of ids which are ephemeral */ 91 ksid_t ksl_sids[1]; /* Allocate ksl_nsid times */ 92 } ksidlist_t; 93 94 typedef struct credsid { 95 uint_t kr_ref; /* Reference count */ 96 ksid_t kr_sidx[KSID_COUNT]; /* User, group, default owner */ 97 ksidlist_t *kr_sidlist; /* List of SIDS */ 98 } credsid_t; 99 100 const char *ksid_getdomain(ksid_t *); 101 uint_t ksid_getrid(ksid_t *); 102 103 int ksid_lookupbyuid(zone_t *, uid_t, ksid_t *); 104 int ksid_lookupbygid(zone_t *, gid_t, ksid_t *); 105 void ksid_rele(ksid_t *); 106 107 credsid_t *kcrsid_alloc(void); 108 109 credsid_t *kcrsid_setsid(credsid_t *, ksid_t *, ksid_index_t); 110 credsid_t *kcrsid_setsidlist(credsid_t *, ksidlist_t *); 111 112 void kcrsid_rele(credsid_t *); 113 void kcrsid_hold(credsid_t *); 114 void kcrsidcopy_to(const credsid_t *okcr, credsid_t *nkcr); 115 116 void ksiddomain_rele(ksiddomain_t *); 117 void ksiddomain_hold(ksiddomain_t *); 118 void ksidlist_rele(ksidlist_t *); 119 void ksidlist_hold(ksidlist_t *); 120 121 ksiddomain_t *ksid_lookupdomain(const char *); 122 123 ksidlist_t *kcrsid_gidstosids(zone_t *, int, gid_t *); 124 125 #else 126 127 int allocids(int, int, uid_t *, int, gid_t *); 128 int idmap_reg(int); 129 int idmap_unreg(int); 130 131 #endif /* _KERNEL */ 132 133 #ifdef __cplusplus 134 } 135 #endif 136 137 #endif /* _SYS_SID_H */ 138