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.
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.
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]
22 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
26 /* Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T */
27 /* All Rights Reserved */
30 * Portions of this source code were derived from Berkeley 4.3 BSD
31 * under license from the Regents of the University of California.
37 #include <sys/types.h>
44 * The credential is an opaque kernel private data structure defined in
48 typedef struct ucred cred_t;
50 #define CRED() curthread->td_ucred
51 #define kcred (thread0.td_ucred)
53 #define KUID_TO_SUID(x) (x)
54 #define KGID_TO_SGID(x) (x)
55 #define crgetuid(cred) ((cred)->cr_uid)
56 #define crgetruid(cred) ((cred)->cr_ruid)
57 #define crgetgid(cred) ((cred)->cr_gid)
58 #define crgetgroups(cred) ((cred)->cr_groups)
59 #define crgetngroups(cred) ((cred)->cr_ngroups)
60 #define crgetsid(cred, i) (NULL)
62 struct proc; /* cred.h is included in proc.h */
69 struct auditinfo_addr; /* cred.h is included in audit.h */
71 extern int ngroups_max;
73 * kcred is used when you need all privileges.
76 extern void cred_init(void);
77 extern void crfree(cred_t *);
78 extern cred_t *cralloc(void); /* all but ref uninitialized */
79 extern cred_t *cralloc_ksid(void); /* cralloc() + ksid alloc'ed */
80 extern cred_t *crget(void); /* initialized */
81 extern void crcopy_to(cred_t *, cred_t *);
82 extern cred_t *crdup(cred_t *);
83 extern void crdup_to(cred_t *, cred_t *);
84 extern cred_t *crgetcred(void);
85 extern void crset(struct proc *, cred_t *);
86 extern void crset_zone_privall(cred_t *);
87 extern int supgroupmember(gid_t, const cred_t *);
88 extern int hasprocperm(const cred_t *, const cred_t *);
89 extern int prochasprocperm(struct proc *, struct proc *, const cred_t *);
90 extern int crcmp(const cred_t *, const cred_t *);
91 extern cred_t *zone_kcred(void);
93 extern gid_t crgetrgid(const cred_t *);
94 extern gid_t crgetsgid(const cred_t *);
96 #define crgetzoneid(cr) ((cr)->cr_prison->pr_id)
97 extern projid_t crgetprojid(const cred_t *);
99 extern cred_t *crgetmapped(const cred_t *);
102 extern const struct auditinfo_addr *crgetauinfo(const cred_t *);
103 extern struct auditinfo_addr *crgetauinfo_modifiable(cred_t *);
105 extern uint_t crgetref(const cred_t *);
107 extern const gid_t *crgetggroups(const struct credgrp *);
111 * Sets real, effective and/or saved uid/gid;
112 * -1 argument accepted as "no change".
114 extern int crsetresuid(cred_t *, uid_t, uid_t, uid_t);
115 extern int crsetresgid(cred_t *, gid_t, gid_t, gid_t);
118 * Sets real, effective and saved uids/gids all to the same
119 * values. Both values must be non-negative and <= MAXUID
121 extern int crsetugid(cred_t *, uid_t, gid_t);
124 * Functions to handle the supplemental group list.
126 extern struct credgrp *crgrpcopyin(int, gid_t *);
127 extern void crgrprele(struct credgrp *);
128 extern void crsetcredgrp(cred_t *, struct credgrp *);
131 * Private interface for setting zone association of credential.
134 extern void crsetzone(cred_t *, struct zone *);
135 extern struct zone *crgetzone(const cred_t *);
138 * Private interface for setting project id in credential.
140 extern void crsetprojid(cred_t *, projid_t);
143 * Private interface for nfs.
145 extern cred_t *crnetadjust(cred_t *);
148 * Private interface for procfs.
150 extern void cred2prcred(const cred_t *, struct prcred *);
153 * Private interfaces for Rampart Trusted Solaris.
156 extern struct ts_label_s *crgetlabel(const cred_t *);
157 extern boolean_t crisremote(const cred_t *);
160 * Private interfaces for ephemeral uids.
162 #define VALID_UID(id, zn) \
163 ((id) <= MAXUID || valid_ephemeral_uid((zn), (id)))
165 #define VALID_GID(id, zn) \
166 ((id) <= MAXUID || valid_ephemeral_gid((zn), (id)))
168 extern boolean_t valid_ephemeral_uid(struct zone *, uid_t);
169 extern boolean_t valid_ephemeral_gid(struct zone *, gid_t);
171 extern int eph_uid_alloc(struct zone *, int, uid_t *, int);
172 extern int eph_gid_alloc(struct zone *, int, gid_t *, int);
174 extern void crsetsid(cred_t *, struct ksid *, int);
175 extern void crsetsidlist(cred_t *, struct ksidlist *);
177 extern struct ksidlist *crgetsidlist(const cred_t *);
179 extern int crsetpriv(cred_t *, ...);
181 extern struct credklpd *crgetcrklpd(const cred_t *);
182 extern void crsetcrklpd(cred_t *, struct credklpd *);
188 #endif /* _SYS_CRED_H */