Home | History | Annotate | Download | only in sys
      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	"@(#)sid.h	1.4	08/01/04 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