xref: /linux/security/selinux/include/security.h (revision cc4589ebfae6f8dbb5cf880a0a67eedab3416492)
1 /*
2  * Security server interface.
3  *
4  * Author : Stephen Smalley, <sds@epoch.ncsc.mil>
5  *
6  */
7 
8 #ifndef _SELINUX_SECURITY_H_
9 #define _SELINUX_SECURITY_H_
10 
11 #include <linux/magic.h>
12 #include "flask.h"
13 
14 #define SECSID_NULL			0x00000000 /* unspecified SID */
15 #define SECSID_WILD			0xffffffff /* wildcard SID */
16 #define SECCLASS_NULL			0x0000 /* no class */
17 
18 /* Identify specific policy version changes */
19 #define POLICYDB_VERSION_BASE		15
20 #define POLICYDB_VERSION_BOOL		16
21 #define POLICYDB_VERSION_IPV6		17
22 #define POLICYDB_VERSION_NLCLASS	18
23 #define POLICYDB_VERSION_VALIDATETRANS	19
24 #define POLICYDB_VERSION_MLS		19
25 #define POLICYDB_VERSION_AVTAB		20
26 #define POLICYDB_VERSION_RANGETRANS	21
27 #define POLICYDB_VERSION_POLCAP		22
28 #define POLICYDB_VERSION_PERMISSIVE	23
29 #define POLICYDB_VERSION_BOUNDARY	24
30 
31 /* Range of policy versions we understand*/
32 #define POLICYDB_VERSION_MIN   POLICYDB_VERSION_BASE
33 #ifdef CONFIG_SECURITY_SELINUX_POLICYDB_VERSION_MAX
34 #define POLICYDB_VERSION_MAX	CONFIG_SECURITY_SELINUX_POLICYDB_VERSION_MAX_VALUE
35 #else
36 #define POLICYDB_VERSION_MAX	POLICYDB_VERSION_BOUNDARY
37 #endif
38 
39 /* Mask for just the mount related flags */
40 #define SE_MNTMASK	0x0f
41 /* Super block security struct flags for mount options */
42 #define CONTEXT_MNT	0x01
43 #define FSCONTEXT_MNT	0x02
44 #define ROOTCONTEXT_MNT	0x04
45 #define DEFCONTEXT_MNT	0x08
46 /* Non-mount related flags */
47 #define SE_SBINITIALIZED	0x10
48 #define SE_SBPROC		0x20
49 #define SE_SBLABELSUPP	0x40
50 
51 #define CONTEXT_STR	"context="
52 #define FSCONTEXT_STR	"fscontext="
53 #define ROOTCONTEXT_STR	"rootcontext="
54 #define DEFCONTEXT_STR	"defcontext="
55 #define LABELSUPP_STR "seclabel"
56 
57 struct netlbl_lsm_secattr;
58 
59 extern int selinux_enabled;
60 
61 /* Policy capabilities */
62 enum {
63 	POLICYDB_CAPABILITY_NETPEER,
64 	POLICYDB_CAPABILITY_OPENPERM,
65 	__POLICYDB_CAPABILITY_MAX
66 };
67 #define POLICYDB_CAPABILITY_MAX (__POLICYDB_CAPABILITY_MAX - 1)
68 
69 extern int selinux_policycap_netpeer;
70 extern int selinux_policycap_openperm;
71 
72 /*
73  * type_datum properties
74  * available at the kernel policy version >= POLICYDB_VERSION_BOUNDARY
75  */
76 #define TYPEDATUM_PROPERTY_PRIMARY	0x0001
77 #define TYPEDATUM_PROPERTY_ATTRIBUTE	0x0002
78 
79 /* limitation of boundary depth  */
80 #define POLICYDB_BOUNDS_MAXDEPTH	4
81 
82 int security_mls_enabled(void);
83 
84 int security_load_policy(void *data, size_t len);
85 
86 int security_policycap_supported(unsigned int req_cap);
87 
88 #define SEL_VEC_MAX 32
89 struct av_decision {
90 	u32 allowed;
91 	u32 auditallow;
92 	u32 auditdeny;
93 	u32 seqno;
94 	u32 flags;
95 };
96 
97 /* definitions of av_decision.flags */
98 #define AVD_FLAGS_PERMISSIVE	0x0001
99 
100 void security_compute_av(u32 ssid, u32 tsid,
101 			 u16 tclass, struct av_decision *avd);
102 
103 void security_compute_av_user(u32 ssid, u32 tsid,
104 			     u16 tclass, struct av_decision *avd);
105 
106 int security_transition_sid(u32 ssid, u32 tsid,
107 			    u16 tclass, u32 *out_sid);
108 
109 int security_transition_sid_user(u32 ssid, u32 tsid,
110 				 u16 tclass, u32 *out_sid);
111 
112 int security_member_sid(u32 ssid, u32 tsid,
113 	u16 tclass, u32 *out_sid);
114 
115 int security_change_sid(u32 ssid, u32 tsid,
116 	u16 tclass, u32 *out_sid);
117 
118 int security_sid_to_context(u32 sid, char **scontext,
119 	u32 *scontext_len);
120 
121 int security_sid_to_context_force(u32 sid, char **scontext, u32 *scontext_len);
122 
123 int security_context_to_sid(const char *scontext, u32 scontext_len,
124 	u32 *out_sid);
125 
126 int security_context_to_sid_default(const char *scontext, u32 scontext_len,
127 				    u32 *out_sid, u32 def_sid, gfp_t gfp_flags);
128 
129 int security_context_to_sid_force(const char *scontext, u32 scontext_len,
130 				  u32 *sid);
131 
132 int security_get_user_sids(u32 callsid, char *username,
133 			   u32 **sids, u32 *nel);
134 
135 int security_port_sid(u8 protocol, u16 port, u32 *out_sid);
136 
137 int security_netif_sid(char *name, u32 *if_sid);
138 
139 int security_node_sid(u16 domain, void *addr, u32 addrlen,
140 	u32 *out_sid);
141 
142 int security_validate_transition(u32 oldsid, u32 newsid, u32 tasksid,
143 				 u16 tclass);
144 
145 int security_bounded_transition(u32 oldsid, u32 newsid);
146 
147 int security_sid_mls_copy(u32 sid, u32 mls_sid, u32 *new_sid);
148 
149 int security_net_peersid_resolve(u32 nlbl_sid, u32 nlbl_type,
150 				 u32 xfrm_sid,
151 				 u32 *peer_sid);
152 
153 int security_get_classes(char ***classes, int *nclasses);
154 int security_get_permissions(char *class, char ***perms, int *nperms);
155 int security_get_reject_unknown(void);
156 int security_get_allow_unknown(void);
157 
158 #define SECURITY_FS_USE_XATTR		1 /* use xattr */
159 #define SECURITY_FS_USE_TRANS		2 /* use transition SIDs, e.g. devpts/tmpfs */
160 #define SECURITY_FS_USE_TASK		3 /* use task SIDs, e.g. pipefs/sockfs */
161 #define SECURITY_FS_USE_GENFS		4 /* use the genfs support */
162 #define SECURITY_FS_USE_NONE		5 /* no labeling support */
163 #define SECURITY_FS_USE_MNTPOINT	6 /* use mountpoint labeling */
164 
165 int security_fs_use(const char *fstype, unsigned int *behavior,
166 	u32 *sid);
167 
168 int security_genfs_sid(const char *fstype, char *name, u16 sclass,
169 	u32 *sid);
170 
171 #ifdef CONFIG_NETLABEL
172 int security_netlbl_secattr_to_sid(struct netlbl_lsm_secattr *secattr,
173 				   u32 *sid);
174 
175 int security_netlbl_sid_to_secattr(u32 sid,
176 				   struct netlbl_lsm_secattr *secattr);
177 #else
178 static inline int security_netlbl_secattr_to_sid(
179 					    struct netlbl_lsm_secattr *secattr,
180 					    u32 *sid)
181 {
182 	return -EIDRM;
183 }
184 
185 static inline int security_netlbl_sid_to_secattr(u32 sid,
186 					   struct netlbl_lsm_secattr *secattr)
187 {
188 	return -ENOENT;
189 }
190 #endif /* CONFIG_NETLABEL */
191 
192 const char *security_get_initial_sid_context(u32 sid);
193 
194 #endif /* _SELINUX_SECURITY_H_ */
195 
196