blob: d5d3d741f02866008c47754f0e586515b1610ce3 [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;
Eric W. Biederman2f6f0652012-02-07 18:52:57 -080042 };
Linus Torvalds1da177e2005-04-16 15:20:36 -070043};
44
45struct posix_acl {
Jeff Layton6d4e56c2016-07-11 09:10:06 -040046 atomic_t a_refcount;
47 struct rcu_head a_rcu;
Linus Torvalds1da177e2005-04-16 15:20:36 -070048 unsigned int a_count;
49 struct posix_acl_entry a_entries[0];
50};
51
52#define FOREACH_ACL_ENTRY(pa, acl, pe) \
53 for(pa=(acl)->a_entries, pe=pa+(acl)->a_count; pa<pe; pa++)
54
55
56/*
57 * Duplicate an ACL handle.
58 */
59static inline struct posix_acl *
60posix_acl_dup(struct posix_acl *acl)
61{
62 if (acl)
63 atomic_inc(&acl->a_refcount);
64 return acl;
65}
66
67/*
68 * Free an ACL handle.
69 */
70static inline void
71posix_acl_release(struct posix_acl *acl)
72{
73 if (acl && atomic_dec_and_test(&acl->a_refcount))
Al Viro35678662011-08-02 21:32:13 -040074 kfree_rcu(acl, a_rcu);
Linus Torvalds1da177e2005-04-16 15:20:36 -070075}
76
77
78/* posix_acl.c */
79
Chuck Leverf61f6da2011-01-21 03:05:38 +000080extern void posix_acl_init(struct posix_acl *, int);
Al Virodd0fc662005-10-07 07:46:04 +010081extern struct posix_acl *posix_acl_alloc(int, gfp_t);
Eric W. Biederman0d4d7172016-06-27 16:04:06 -050082extern int posix_acl_valid(struct user_namespace *, const struct posix_acl *);
Linus Torvalds1da177e2005-04-16 15:20:36 -070083extern int posix_acl_permission(struct inode *, const struct posix_acl *, int);
Al Viro3a5fba12011-07-23 19:01:48 -040084extern struct posix_acl *posix_acl_from_mode(umode_t, gfp_t);
Al Virod6952122011-07-23 18:56:36 -040085extern int posix_acl_equiv_mode(const struct posix_acl *, umode_t *);
Christoph Hellwig37bc1532013-12-20 05:16:42 -080086extern int __posix_acl_create(struct posix_acl **, gfp_t, umode_t *);
Christoph Hellwig5bf32582013-12-20 05:16:41 -080087extern int __posix_acl_chmod(struct posix_acl **, gfp_t, umode_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070088
89extern struct posix_acl *get_posix_acl(struct inode *, int);
90extern int set_posix_acl(struct inode *, int, struct posix_acl *);
91
Markus Trippelsdorf641cf4a2009-06-24 22:28:52 +020092#ifdef CONFIG_FS_POSIX_ACL
Christoph Hellwig37bc1532013-12-20 05:16:42 -080093extern int posix_acl_chmod(struct inode *, umode_t);
94extern int posix_acl_create(struct inode *, umode_t *, struct posix_acl **,
95 struct posix_acl **);
Christoph Hellwig5bf32582013-12-20 05:16:41 -080096
Christoph Hellwigfeda8212013-12-20 05:16:54 -080097extern int simple_set_acl(struct inode *, struct posix_acl *, int);
98extern int simple_acl_create(struct inode *, struct inode *);
99
Andrew Morton0afaa122014-01-21 15:48:42 -0800100struct posix_acl *get_cached_acl(struct inode *inode, int type);
101struct posix_acl *get_cached_acl_rcu(struct inode *inode, int type);
102void set_cached_acl(struct inode *inode, int type, struct posix_acl *acl);
103void forget_cached_acl(struct inode *inode, int type);
104void forget_all_cached_acls(struct inode *inode);
Al Viro72c04902009-06-24 16:58:48 -0400105
106static inline void cache_no_acl(struct inode *inode)
107{
Al Viro72c04902009-06-24 16:58:48 -0400108 inode->i_acl = NULL;
109 inode->i_default_acl = NULL;
Al Viro72c04902009-06-24 16:58:48 -0400110}
Christoph Hellwig5bf32582013-12-20 05:16:41 -0800111#else
Christoph Hellwig37bc1532013-12-20 05:16:42 -0800112static inline int posix_acl_chmod(struct inode *inode, umode_t mode)
Christoph Hellwig5bf32582013-12-20 05:16:41 -0800113{
114 return 0;
115}
116
Christoph Hellwigfeda8212013-12-20 05:16:54 -0800117#define simple_set_acl NULL
118
119static inline int simple_acl_create(struct inode *dir, struct inode *inode)
120{
121 return 0;
122}
Christoph Hellwig5bf32582013-12-20 05:16:41 -0800123static inline void cache_no_acl(struct inode *inode)
124{
125}
Christoph Hellwig37bc1532013-12-20 05:16:42 -0800126
127static inline int posix_acl_create(struct inode *inode, umode_t *mode,
128 struct posix_acl **default_acl, struct posix_acl **acl)
129{
130 *default_acl = *acl = NULL;
131 return 0;
132}
Christoph Hellwig013cdf12013-12-20 05:16:53 -0800133
134static inline void forget_all_cached_acls(struct inode *inode)
135{
136}
Christoph Hellwig5bf32582013-12-20 05:16:41 -0800137#endif /* CONFIG_FS_POSIX_ACL */
Al Viro72c04902009-06-24 16:58:48 -0400138
Christoph Hellwig2982baa2013-12-20 05:16:38 -0800139struct posix_acl *get_acl(struct inode *inode, int type);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700140
141#endif /* __LINUX_POSIX_ACL_H */