xref: /linux/fs/ext2/xattr.h (revision 7a2508e1b657cfc7e1371550f88c7a7bc4288f32)
11da177e4SLinus Torvalds /*
21da177e4SLinus Torvalds   File: linux/ext2_xattr.h
31da177e4SLinus Torvalds 
41da177e4SLinus Torvalds   On-disk format of extended attributes for the ext2 filesystem.
51da177e4SLinus Torvalds 
61da177e4SLinus Torvalds   (C) 2001 Andreas Gruenbacher, <a.gruenbacher@computer.org>
71da177e4SLinus Torvalds */
81da177e4SLinus Torvalds 
91da177e4SLinus Torvalds #include <linux/init.h>
101da177e4SLinus Torvalds #include <linux/xattr.h>
111da177e4SLinus Torvalds 
121da177e4SLinus Torvalds /* Magic value in attribute blocks */
131da177e4SLinus Torvalds #define EXT2_XATTR_MAGIC		0xEA020000
141da177e4SLinus Torvalds 
151da177e4SLinus Torvalds /* Maximum number of references to one attribute block */
161da177e4SLinus Torvalds #define EXT2_XATTR_REFCOUNT_MAX		1024
171da177e4SLinus Torvalds 
181da177e4SLinus Torvalds /* Name indexes */
191da177e4SLinus Torvalds #define EXT2_XATTR_INDEX_USER			1
201da177e4SLinus Torvalds #define EXT2_XATTR_INDEX_POSIX_ACL_ACCESS	2
211da177e4SLinus Torvalds #define EXT2_XATTR_INDEX_POSIX_ACL_DEFAULT	3
221da177e4SLinus Torvalds #define EXT2_XATTR_INDEX_TRUSTED		4
231da177e4SLinus Torvalds #define	EXT2_XATTR_INDEX_LUSTRE			5
241da177e4SLinus Torvalds #define EXT2_XATTR_INDEX_SECURITY	        6
251da177e4SLinus Torvalds 
261da177e4SLinus Torvalds struct ext2_xattr_header {
271da177e4SLinus Torvalds 	__le32	h_magic;	/* magic number for identification */
281da177e4SLinus Torvalds 	__le32	h_refcount;	/* reference count */
291da177e4SLinus Torvalds 	__le32	h_blocks;	/* number of disk blocks used */
301da177e4SLinus Torvalds 	__le32	h_hash;		/* hash value of all attributes */
311da177e4SLinus Torvalds 	__u32	h_reserved[4];	/* zero right now */
321da177e4SLinus Torvalds };
331da177e4SLinus Torvalds 
341da177e4SLinus Torvalds struct ext2_xattr_entry {
351da177e4SLinus Torvalds 	__u8	e_name_len;	/* length of name */
361da177e4SLinus Torvalds 	__u8	e_name_index;	/* attribute name index */
371da177e4SLinus Torvalds 	__le16	e_value_offs;	/* offset in disk block of value */
381da177e4SLinus Torvalds 	__le32	e_value_block;	/* disk block attribute is stored on (n/i) */
391da177e4SLinus Torvalds 	__le32	e_value_size;	/* size of attribute value */
401da177e4SLinus Torvalds 	__le32	e_hash;		/* hash value of name and value */
411da177e4SLinus Torvalds 	char	e_name[0];	/* attribute name */
421da177e4SLinus Torvalds };
431da177e4SLinus Torvalds 
441da177e4SLinus Torvalds #define EXT2_XATTR_PAD_BITS		2
451da177e4SLinus Torvalds #define EXT2_XATTR_PAD		(1<<EXT2_XATTR_PAD_BITS)
461da177e4SLinus Torvalds #define EXT2_XATTR_ROUND		(EXT2_XATTR_PAD-1)
471da177e4SLinus Torvalds #define EXT2_XATTR_LEN(name_len) \
481da177e4SLinus Torvalds 	(((name_len) + EXT2_XATTR_ROUND + \
491da177e4SLinus Torvalds 	sizeof(struct ext2_xattr_entry)) & ~EXT2_XATTR_ROUND)
501da177e4SLinus Torvalds #define EXT2_XATTR_NEXT(entry) \
511da177e4SLinus Torvalds 	( (struct ext2_xattr_entry *)( \
521da177e4SLinus Torvalds 	  (char *)(entry) + EXT2_XATTR_LEN((entry)->e_name_len)) )
531da177e4SLinus Torvalds #define EXT2_XATTR_SIZE(size) \
541da177e4SLinus Torvalds 	(((size) + EXT2_XATTR_ROUND) & ~EXT2_XATTR_ROUND)
551da177e4SLinus Torvalds 
56*7a2508e1SJan Kara struct mb_cache;
57be0726d3SJan Kara 
581da177e4SLinus Torvalds # ifdef CONFIG_EXT2_FS_XATTR
591da177e4SLinus Torvalds 
60749c72efSStephen Hemminger extern const struct xattr_handler ext2_xattr_user_handler;
61749c72efSStephen Hemminger extern const struct xattr_handler ext2_xattr_trusted_handler;
62749c72efSStephen Hemminger extern const struct xattr_handler ext2_xattr_security_handler;
631da177e4SLinus Torvalds 
641da177e4SLinus Torvalds extern ssize_t ext2_listxattr(struct dentry *, char *, size_t);
651da177e4SLinus Torvalds 
661da177e4SLinus Torvalds extern int ext2_xattr_get(struct inode *, int, const char *, void *, size_t);
671da177e4SLinus Torvalds extern int ext2_xattr_set(struct inode *, int, const char *, const void *, size_t, int);
681da177e4SLinus Torvalds 
691da177e4SLinus Torvalds extern void ext2_xattr_delete_inode(struct inode *);
701da177e4SLinus Torvalds 
71*7a2508e1SJan Kara extern struct mb_cache *ext2_xattr_create_cache(void);
72*7a2508e1SJan Kara extern void ext2_xattr_destroy_cache(struct mb_cache *cache);
731da177e4SLinus Torvalds 
74749c72efSStephen Hemminger extern const struct xattr_handler *ext2_xattr_handlers[];
751da177e4SLinus Torvalds 
761da177e4SLinus Torvalds # else  /* CONFIG_EXT2_FS_XATTR */
771da177e4SLinus Torvalds 
781da177e4SLinus Torvalds static inline int
791da177e4SLinus Torvalds ext2_xattr_get(struct inode *inode, int name_index,
801da177e4SLinus Torvalds 	       const char *name, void *buffer, size_t size)
811da177e4SLinus Torvalds {
821da177e4SLinus Torvalds 	return -EOPNOTSUPP;
831da177e4SLinus Torvalds }
841da177e4SLinus Torvalds 
851da177e4SLinus Torvalds static inline int
861da177e4SLinus Torvalds ext2_xattr_set(struct inode *inode, int name_index, const char *name,
871da177e4SLinus Torvalds 	       const void *value, size_t size, int flags)
881da177e4SLinus Torvalds {
891da177e4SLinus Torvalds 	return -EOPNOTSUPP;
901da177e4SLinus Torvalds }
911da177e4SLinus Torvalds 
921da177e4SLinus Torvalds static inline void
931da177e4SLinus Torvalds ext2_xattr_delete_inode(struct inode *inode)
941da177e4SLinus Torvalds {
951da177e4SLinus Torvalds }
961da177e4SLinus Torvalds 
97*7a2508e1SJan Kara static inline void ext2_xattr_destroy_cache(struct mb_cache *cache)
981da177e4SLinus Torvalds {
991da177e4SLinus Torvalds }
1001da177e4SLinus Torvalds 
1011da177e4SLinus Torvalds #define ext2_xattr_handlers NULL
1021da177e4SLinus Torvalds 
1031da177e4SLinus Torvalds # endif  /* CONFIG_EXT2_FS_XATTR */
1041da177e4SLinus Torvalds 
10510f47e6aSStephen Smalley #ifdef CONFIG_EXT2_FS_SECURITY
1062a7dba39SEric Paris extern int ext2_init_security(struct inode *inode, struct inode *dir,
1072a7dba39SEric Paris 			      const struct qstr *qstr);
10810f47e6aSStephen Smalley #else
1092a7dba39SEric Paris static inline int ext2_init_security(struct inode *inode, struct inode *dir,
1102a7dba39SEric Paris 				     const struct qstr *qstr)
11110f47e6aSStephen Smalley {
11210f47e6aSStephen Smalley 	return 0;
11310f47e6aSStephen Smalley }
11410f47e6aSStephen Smalley #endif
115