blob: fb616942e4c7f2ebdca8b7997498605a99a7e943 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 File: linux/posix_acl.h
3
4 (C) 2002 Andreas Gruenbacher, <a.gruenbacher@computer.org>
5*/
6
7
8#ifndef __LINUX_POSIX_ACL_H
9#define __LINUX_POSIX_ACL_H
10
Paul Gortmaker187f1882011-11-23 20:12:59 -050011#include <linux/bug.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070012#include <linux/slab.h>
Al Viro35678662011-08-02 21:32:13 -040013#include <linux/rcupdate.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070014
15#define ACL_UNDEFINED_ID (-1)
16
17/* a_type field in acl_user_posix_entry_t */
18#define ACL_TYPE_ACCESS (0x8000)
19#define ACL_TYPE_DEFAULT (0x4000)
20
21/* e_tag entry in struct posix_acl_entry */
22#define ACL_USER_OBJ (0x01)
23#define ACL_USER (0x02)
24#define ACL_GROUP_OBJ (0x04)
25#define ACL_GROUP (0x08)
26#define ACL_MASK (0x10)
27#define ACL_OTHER (0x20)
28
29/* permissions in the e_perm field */
30#define ACL_READ (0x04)
31#define ACL_WRITE (0x02)
32#define ACL_EXECUTE (0x01)
33//#define ACL_ADD (0x08)
34//#define ACL_DELETE (0x10)
35
36struct posix_acl_entry {
37 short e_tag;
38 unsigned short e_perm;
Eric W. Biederman2f6f0652012-02-07 18:52:57 -080039 union {
40 kuid_t e_uid;
41 kgid_t e_gid;
42#ifndef CONFIG_UIDGID_STRICT_TYPE_CHECKS
43 unsigned int e_id;
44#endif
45 };
Linus Torvalds1da177e2005-04-16 15:20:36 -070046};
47
48struct posix_acl {
Al Viro35678662011-08-02 21:32:13 -040049 union {
50 atomic_t a_refcount;
51 struct rcu_head a_rcu;
52 };
Linus Torvalds1da177e2005-04-16 15:20:36 -070053 unsigned int a_count;
54 struct posix_acl_entry a_entries[0];
55};
56
57#define FOREACH_ACL_ENTRY(pa, acl, pe) \
58 for(pa=(acl)->a_entries, pe=pa+(acl)->a_count; pa<pe; pa++)
59
60
61/*
62 * Duplicate an ACL handle.
63 */
64static inline struct posix_acl *
65posix_acl_dup(struct posix_acl *acl)
66{
67 if (acl)
68 atomic_inc(&acl->a_refcount);
69 return acl;
70}
71
72/*
73 * Free an ACL handle.
74 */
75static inline void
76posix_acl_release(struct posix_acl *acl)
77{
78 if (acl && atomic_dec_and_test(&acl->a_refcount))
Al Viro35678662011-08-02 21:32:13 -040079 kfree_rcu(acl, a_rcu);
Linus Torvalds1da177e2005-04-16 15:20:36 -070080}
81
82
83/* posix_acl.c */
84
Chuck Leverf61f6da2011-01-21 03:05:38 +000085extern void posix_acl_init(struct posix_acl *, int);
Al Virodd0fc662005-10-07 07:46:04 +010086extern struct posix_acl *posix_acl_alloc(int, gfp_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070087extern int posix_acl_valid(const struct posix_acl *);
88extern int posix_acl_permission(struct inode *, const struct posix_acl *, int);
Al Viro3a5fba12011-07-23 19:01:48 -040089extern struct posix_acl *posix_acl_from_mode(umode_t, gfp_t);
Al Virod6952122011-07-23 18:56:36 -040090extern int posix_acl_equiv_mode(const struct posix_acl *, umode_t *);
Al Virod3fb6122011-07-23 18:37:50 -040091extern int posix_acl_create(struct posix_acl **, gfp_t, umode_t *);
Al Viro86bc7042011-07-23 19:03:11 -040092extern int posix_acl_chmod(struct posix_acl **, gfp_t, umode_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070093
94extern struct posix_acl *get_posix_acl(struct inode *, int);
95extern int set_posix_acl(struct inode *, int, struct posix_acl *);
96
Andrew Morton0afaa122014-01-21 15:48:42 -080097struct posix_acl **acl_by_type(struct inode *inode, int type);
98struct posix_acl *get_cached_acl(struct inode *inode, int type);
99struct posix_acl *get_cached_acl_rcu(struct inode *inode, int type);
100void set_cached_acl(struct inode *inode, int type, struct posix_acl *acl);
101void forget_cached_acl(struct inode *inode, int type);
102void forget_all_cached_acls(struct inode *inode);
Al Viro72c04902009-06-24 16:58:48 -0400103
104static inline void cache_no_acl(struct inode *inode)
105{
106#ifdef CONFIG_FS_POSIX_ACL
107 inode->i_acl = NULL;
108 inode->i_default_acl = NULL;
109#endif
110}
111
Linus Torvalds1da177e2005-04-16 15:20:36 -0700112#endif /* __LINUX_POSIX_ACL_H */