sys/cddl/contrib/opensolaris/uts/common/sys/cred.h

   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 2006 Sun Microsystems, Inc.  All rights reserved.
  23  * Use is subject to license terms.
  24  */
  25
  26 /*      Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T     */
  27 /*        All Rights Reserved   */
  28
  29 /*
  30  * Portions of this source code were derived from Berkeley 4.3 BSD
  31  * under license from the Regents of the University of California.
  32  */
  33
  34 #ifndef _SYS_CRED_H
  35 #define _SYS_CRED_H
  36
  37 #pragma ident   "%Z%%M% %I%     %E% SMI"
  38
  39 #include <sys/types.h>
  40
  41 #ifdef  __cplusplus
  42 extern "C" {
  43 #endif
  44
  45 /*
  46  * The credential is an opaque kernel private data structure defined in
  47  * <sys/cred_impl.h>.
  48  */
  49
  50 typedef struct cred cred_t;
  51
  52 #ifdef _KERNEL
  53
  54 #define CRED()          curthread->t_cred
  55
  56 struct proc;                            /* cred.h is included in proc.h */
  57 struct prcred;
  58
  59 struct auditinfo_addr;                  /* cred.h is included in audit.h */
  60
  61 extern int ngroups_max;
  62 /*
  63  * kcred is used when you need all privileges.
  64  */
  65 extern struct cred *kcred;
  66
  67 extern void cred_init(void);
  68 extern void crhold(cred_t *);
  69 extern void crfree(cred_t *);
  70 extern cred_t *cralloc(void);           /* all but ref uninitialized */
  71 extern cred_t *crget(void);             /* initialized */
  72 extern cred_t *crcopy(cred_t *);
  73 extern void crcopy_to(cred_t *, cred_t *);
  74 extern cred_t *crdup(cred_t *);
  75 extern void crdup_to(cred_t *, cred_t *);
  76 extern cred_t *crgetcred(void);
  77 extern void crset(struct proc *, cred_t *);
  78 extern int groupmember(gid_t, const cred_t *);
  79 extern int supgroupmember(gid_t, const cred_t *);
  80 extern int hasprocperm(const cred_t *, const cred_t *);
  81 extern int prochasprocperm(struct proc *, struct proc *, const cred_t *);
  82 extern int crcmp(const cred_t *, const cred_t *);
  83 extern cred_t *zone_kcred(void);
  84
  85 extern uid_t crgetuid(const cred_t *);
  86 extern uid_t crgetruid(const cred_t *);
  87 extern uid_t crgetsuid(const cred_t *);
  88 extern gid_t crgetgid(const cred_t *);
  89 extern gid_t crgetrgid(const cred_t *);
  90 extern gid_t crgetsgid(const cred_t *);
  91 extern zoneid_t crgetzoneid(const cred_t *);
  92 extern projid_t crgetprojid(const cred_t *);
  93
  94
  95 extern const struct auditinfo_addr *crgetauinfo(const cred_t *);
  96 extern struct auditinfo_addr *crgetauinfo_modifiable(cred_t *);
  97
  98 extern uint_t crgetref(const cred_t *);
  99
 100 extern const gid_t *crgetgroups(const cred_t *);
 101
 102 extern int crgetngroups(const cred_t *);
 103
 104 /*
 105  * Sets real, effective and/or saved uid/gid;
 106  * -1 argument accepted as "no change".
 107  */
 108 extern int crsetresuid(cred_t *, uid_t, uid_t, uid_t);
 109 extern int crsetresgid(cred_t *, gid_t, gid_t, gid_t);
 110
 111 /*
 112  * Sets real, effective and saved uids/gids all to the same
 113  * values.  Both values must be non-negative and <= MAXUID
 114  */
 115 extern int crsetugid(cred_t *, uid_t, gid_t);
 116
 117 extern int crsetgroups(cred_t *, int, gid_t *);
 118
 119 /*
 120  * Private interface for setting zone association of credential.
 121  */
 122 struct zone;
 123 extern void crsetzone(cred_t *, struct zone *);
 124 extern struct zone *crgetzone(const cred_t *);
 125
 126 /*
 127  * Private interface for setting project id in credential.
 128  */
 129 extern void crsetprojid(cred_t *, projid_t);
 130
 131 /*
 132  * Private interface for nfs.
 133  */
 134 extern cred_t *crnetadjust(cred_t *);
 135
 136 /*
 137  * Private interface for procfs.
 138  */
 139 extern void cred2prcred(const cred_t *, struct prcred *);
 140
 141 /*
 142  * Private interfaces for Rampart Trusted Solaris.
 143  */
 144 struct ts_label_s;
 145 extern struct ts_label_s *crgetlabel(const cred_t *);
 146 extern boolean_t crisremote(const cred_t *);
 147
 148 #endif  /* _KERNEL */
 149
 150 #ifdef  __cplusplus
 151 }
 152 #endif
 153
 154 #endif  /* _SYS_CRED_H */