smack.h 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370
  1. /*
  2. * Copyright (C) 2007 Casey Schaufler <casey@schaufler-ca.com>
  3. *
  4. * This program is free software; you can redistribute it and/or modify
  5. * it under the terms of the GNU General Public License as published by
  6. * the Free Software Foundation, version 2.
  7. *
  8. * Author:
  9. * Casey Schaufler <casey@schaufler-ca.com>
  10. *
  11. */
  12. #ifndef _SECURITY_SMACK_H
  13. #define _SECURITY_SMACK_H
  14. #include <linux/capability.h>
  15. #include <linux/spinlock.h>
  16. #include <linux/security.h>
  17. #include <linux/in.h>
  18. #include <net/netlabel.h>
  19. #include <linux/list.h>
  20. #include <linux/rculist.h>
  21. #include <linux/lsm_audit.h>
  22. /*
  23. * Why 23? CIPSO is constrained to 30, so a 32 byte buffer is
  24. * bigger than can be used, and 24 is the next lower multiple
  25. * of 8, and there are too many issues if there isn't space set
  26. * aside for the terminating null byte.
  27. */
  28. #define SMK_MAXLEN 23
  29. #define SMK_LABELLEN (SMK_MAXLEN+1)
  30. struct superblock_smack {
  31. char *smk_root;
  32. char *smk_floor;
  33. char *smk_hat;
  34. char *smk_default;
  35. int smk_initialized;
  36. spinlock_t smk_sblock; /* for initialization */
  37. };
  38. struct socket_smack {
  39. char *smk_out; /* outbound label */
  40. char *smk_in; /* inbound label */
  41. char smk_packet[SMK_LABELLEN]; /* TCP peer label */
  42. };
  43. /*
  44. * Inode smack data
  45. */
  46. struct inode_smack {
  47. char *smk_inode; /* label of the fso */
  48. char *smk_task; /* label of the task */
  49. char *smk_mmap; /* label of the mmap domain */
  50. struct mutex smk_lock; /* initialization lock */
  51. int smk_flags; /* smack inode flags */
  52. };
  53. struct task_smack {
  54. char *smk_task; /* label for access control */
  55. char *smk_forked; /* label when forked */
  56. struct list_head smk_rules; /* per task access rules */
  57. struct mutex smk_rules_lock; /* lock for the rules */
  58. };
  59. #define SMK_INODE_INSTANT 0x01 /* inode is instantiated */
  60. #define SMK_INODE_TRANSMUTE 0x02 /* directory is transmuting */
  61. /*
  62. * A label access rule.
  63. */
  64. struct smack_rule {
  65. struct list_head list;
  66. char *smk_subject;
  67. char *smk_object;
  68. int smk_access;
  69. };
  70. /*
  71. * An entry in the table mapping smack values to
  72. * CIPSO level/category-set values.
  73. */
  74. struct smack_cipso {
  75. int smk_level;
  76. char smk_catset[SMK_LABELLEN];
  77. };
  78. /*
  79. * An entry in the table identifying hosts.
  80. */
  81. struct smk_netlbladdr {
  82. struct list_head list;
  83. struct sockaddr_in smk_host; /* network address */
  84. struct in_addr smk_mask; /* network mask */
  85. char *smk_label; /* label */
  86. };
  87. /*
  88. * This is the repository for labels seen so that it is
  89. * not necessary to keep allocating tiny chuncks of memory
  90. * and so that they can be shared.
  91. *
  92. * Labels are never modified in place. Anytime a label
  93. * is imported (e.g. xattrset on a file) the list is checked
  94. * for it and it is added if it doesn't exist. The address
  95. * is passed out in either case. Entries are added, but
  96. * never deleted.
  97. *
  98. * Since labels are hanging around anyway it doesn't
  99. * hurt to maintain a secid for those awkward situations
  100. * where kernel components that ought to use LSM independent
  101. * interfaces don't. The secid should go away when all of
  102. * these components have been repaired.
  103. *
  104. * If there is a cipso value associated with the label it
  105. * gets stored here, too. This will most likely be rare as
  106. * the cipso direct mapping in used internally.
  107. */
  108. struct smack_known {
  109. struct list_head list;
  110. char smk_known[SMK_LABELLEN];
  111. u32 smk_secid;
  112. struct smack_cipso *smk_cipso;
  113. spinlock_t smk_cipsolock; /* for changing cipso map */
  114. };
  115. /*
  116. * Mount options
  117. */
  118. #define SMK_FSDEFAULT "smackfsdef="
  119. #define SMK_FSFLOOR "smackfsfloor="
  120. #define SMK_FSHAT "smackfshat="
  121. #define SMK_FSROOT "smackfsroot="
  122. #define SMACK_CIPSO_OPTION "-CIPSO"
  123. /*
  124. * How communications on this socket are treated.
  125. * Usually it's determined by the underlying netlabel code
  126. * but there are certain cases, including single label hosts
  127. * and potentially single label interfaces for which the
  128. * treatment can not be known in advance.
  129. *
  130. * The possibility of additional labeling schemes being
  131. * introduced in the future exists as well.
  132. */
  133. #define SMACK_UNLABELED_SOCKET 0
  134. #define SMACK_CIPSO_SOCKET 1
  135. /*
  136. * smackfs magic number
  137. * smackfs macic number
  138. */
  139. #define SMACK_MAGIC 0x43415d53 /* "SMAC" */
  140. /*
  141. * CIPSO defaults.
  142. */
  143. #define SMACK_CIPSO_DOI_DEFAULT 3 /* Historical */
  144. #define SMACK_CIPSO_DOI_INVALID -1 /* Not a DOI */
  145. #define SMACK_CIPSO_DIRECT_DEFAULT 250 /* Arbitrary */
  146. #define SMACK_CIPSO_MAXCATVAL 63 /* Bigger gets harder */
  147. #define SMACK_CIPSO_MAXLEVEL 255 /* CIPSO 2.2 standard */
  148. #define SMACK_CIPSO_MAXCATNUM 239 /* CIPSO 2.2 standard */
  149. /*
  150. * Flag for transmute access
  151. */
  152. #define MAY_TRANSMUTE 64
  153. /*
  154. * Just to make the common cases easier to deal with
  155. */
  156. #define MAY_ANYREAD (MAY_READ | MAY_EXEC)
  157. #define MAY_READWRITE (MAY_READ | MAY_WRITE)
  158. #define MAY_NOT 0
  159. /*
  160. * Number of access types used by Smack (rwxa)
  161. */
  162. #define SMK_NUM_ACCESS_TYPE 4
  163. /*
  164. * Smack audit data; is empty if CONFIG_AUDIT not set
  165. * to save some stack
  166. */
  167. struct smk_audit_info {
  168. #ifdef CONFIG_AUDIT
  169. struct common_audit_data a;
  170. #endif
  171. };
  172. /*
  173. * These functions are in smack_lsm.c
  174. */
  175. struct inode_smack *new_inode_smack(char *);
  176. /*
  177. * These functions are in smack_access.c
  178. */
  179. int smk_access_entry(char *, char *, struct list_head *);
  180. int smk_access(char *, char *, int, struct smk_audit_info *);
  181. int smk_curacc(char *, u32, struct smk_audit_info *);
  182. int smack_to_cipso(const char *, struct smack_cipso *);
  183. void smack_from_cipso(u32, char *, char *);
  184. char *smack_from_secid(const u32);
  185. char *smk_import(const char *, int);
  186. struct smack_known *smk_import_entry(const char *, int);
  187. u32 smack_to_secid(const char *);
  188. /*
  189. * Shared data.
  190. */
  191. extern int smack_cipso_direct;
  192. extern char *smack_net_ambient;
  193. extern char *smack_onlycap;
  194. extern const char *smack_cipso_option;
  195. extern struct smack_known smack_known_floor;
  196. extern struct smack_known smack_known_hat;
  197. extern struct smack_known smack_known_huh;
  198. extern struct smack_known smack_known_invalid;
  199. extern struct smack_known smack_known_star;
  200. extern struct smack_known smack_known_web;
  201. extern struct list_head smack_known_list;
  202. extern struct list_head smack_rule_list;
  203. extern struct list_head smk_netlbladdr_list;
  204. extern struct security_operations smack_ops;
  205. /*
  206. * Stricly for CIPSO level manipulation.
  207. * Set the category bit number in a smack label sized buffer.
  208. */
  209. static inline void smack_catset_bit(int cat, char *catsetp)
  210. {
  211. if (cat > SMK_LABELLEN * 8)
  212. return;
  213. catsetp[(cat - 1) / 8] |= 0x80 >> ((cat - 1) % 8);
  214. }
  215. /*
  216. * Is the directory transmuting?
  217. */
  218. static inline int smk_inode_transmutable(const struct inode *isp)
  219. {
  220. struct inode_smack *sip = isp->i_security;
  221. return (sip->smk_flags & SMK_INODE_TRANSMUTE) != 0;
  222. }
  223. /*
  224. * Present a pointer to the smack label in an inode blob.
  225. */
  226. static inline char *smk_of_inode(const struct inode *isp)
  227. {
  228. struct inode_smack *sip = isp->i_security;
  229. return sip->smk_inode;
  230. }
  231. /*
  232. * Present a pointer to the smack label in an task blob.
  233. */
  234. static inline char *smk_of_task(const struct task_smack *tsp)
  235. {
  236. return tsp->smk_task;
  237. }
  238. /*
  239. * Present a pointer to the forked smack label in an task blob.
  240. */
  241. static inline char *smk_of_forked(const struct task_smack *tsp)
  242. {
  243. return tsp->smk_forked;
  244. }
  245. /*
  246. * Present a pointer to the smack label in the current task blob.
  247. */
  248. static inline char *smk_of_current(void)
  249. {
  250. return smk_of_task(current_security());
  251. }
  252. /*
  253. * logging functions
  254. */
  255. #define SMACK_AUDIT_DENIED 0x1
  256. #define SMACK_AUDIT_ACCEPT 0x2
  257. extern int log_policy;
  258. void smack_log(char *subject_label, char *object_label,
  259. int request,
  260. int result, struct smk_audit_info *auditdata);
  261. #ifdef CONFIG_AUDIT
  262. /*
  263. * some inline functions to set up audit data
  264. * they do nothing if CONFIG_AUDIT is not set
  265. *
  266. */
  267. static inline void smk_ad_init(struct smk_audit_info *a, const char *func,
  268. char type)
  269. {
  270. memset(a, 0, sizeof(*a));
  271. a->a.type = type;
  272. a->a.smack_audit_data.function = func;
  273. }
  274. static inline void smk_ad_setfield_u_tsk(struct smk_audit_info *a,
  275. struct task_struct *t)
  276. {
  277. a->a.u.tsk = t;
  278. }
  279. static inline void smk_ad_setfield_u_fs_path_dentry(struct smk_audit_info *a,
  280. struct dentry *d)
  281. {
  282. a->a.u.dentry = d;
  283. }
  284. static inline void smk_ad_setfield_u_fs_inode(struct smk_audit_info *a,
  285. struct inode *i)
  286. {
  287. a->a.u.inode = i;
  288. }
  289. static inline void smk_ad_setfield_u_fs_path(struct smk_audit_info *a,
  290. struct path p)
  291. {
  292. a->a.u.path = p;
  293. }
  294. static inline void smk_ad_setfield_u_net_sk(struct smk_audit_info *a,
  295. struct sock *sk)
  296. {
  297. a->a.u.net.sk = sk;
  298. }
  299. #else /* no AUDIT */
  300. static inline void smk_ad_init(struct smk_audit_info *a, const char *func,
  301. char type)
  302. {
  303. }
  304. static inline void smk_ad_setfield_u_tsk(struct smk_audit_info *a,
  305. struct task_struct *t)
  306. {
  307. }
  308. static inline void smk_ad_setfield_u_fs_path_dentry(struct smk_audit_info *a,
  309. struct dentry *d)
  310. {
  311. }
  312. static inline void smk_ad_setfield_u_fs_path_mnt(struct smk_audit_info *a,
  313. struct vfsmount *m)
  314. {
  315. }
  316. static inline void smk_ad_setfield_u_fs_inode(struct smk_audit_info *a,
  317. struct inode *i)
  318. {
  319. }
  320. static inline void smk_ad_setfield_u_fs_path(struct smk_audit_info *a,
  321. struct path p)
  322. {
  323. }
  324. static inline void smk_ad_setfield_u_net_sk(struct smk_audit_info *a,
  325. struct sock *sk)
  326. {
  327. }
  328. #endif
  329. #endif /* _SECURITY_SMACK_H */