ext2文件系统源代码之xattr.h

﹏ヽ暗。殇╰゛Y 2022-07-29 10:45 209阅读 0赞

今天我们开始看ext2文件系统里的另一个重要的东西，就是扩展文件属性，我们首先看它的头文件定义xattr.h

/*
      File: linux/ext2_xattr.h
    
    
      On-disk format of extended attributes for the ext2 filesystem.
    
    
      (C) 2001 Andreas Gruenbacher, <a.gruenbacher@computer.org>
    */
    
    
    #include <linux/init.h>
    #include <linux/xattr.h>
    
    
    /* 扩展属性的魔数值 */
    #define EXT2_XATTR_MAGIC		0xEA020000
    
    
    /* 每一个文件属性块的最大引用数目 */
    #define EXT2_XATTR_REFCOUNT_MAX		1024
    
    
    /* 名称索引 */
    #define EXT2_XATTR_INDEX_USER			1
    #define EXT2_XATTR_INDEX_POSIX_ACL_ACCESS	2
    #define EXT2_XATTR_INDEX_POSIX_ACL_DEFAULT	3
    #define EXT2_XATTR_INDEX_TRUSTED		4
    #define	EXT2_XATTR_INDEX_LUSTRE			5
    #define EXT2_XATTR_INDEX_SECURITY	        6
    /*扩展属性头部*/
    struct ext2_xattr_header {
    	__le32	h_magic;	/* 扩展属性标识码，就是上边定义的EXT2_XATTR_MAGIC */
    	__le32	h_refcount;	/* 这个属性块被引用的次数 */
    	__le32	h_blocks;	/* 扩展属性使用的块数 */
    	__le32	h_hash;		/* 所有属性的hash值*/
    	__u32	h_reserved[4];	/* 保留字段 */
    };
    /*扩展属性入口项结构体*/
    struct ext2_xattr_entry {
    	__u8	e_name_len;	/* 属性名长度 */
    	__u8	e_name_index;	/* 属性名索引 */
    	__le16	e_value_offs;	/* 属性值在文件里的偏移量 */
    	__le32	e_value_block;	/* 保存值得块号 */
    	__le32	e_value_size;	/* 属性值长度 */
    	__le32	e_hash;		/* 属性名和值得hash值 */
    	char	e_name[0];	/* 属性名 */
    };
    
    
    /*xattr是按照四字节对齐的*/
    #define EXT2_XATTR_PAD_BITS		2
    #define EXT2_XATTR_PAD		(1<<EXT2_XATTR_PAD_BITS)
    #define EXT2_XATTR_ROUND		(EXT2_XATTR_PAD-1)
    /*名称长度给定情况下，扩展属性入口项结构体按照4字节对齐后的大小*/
    #define EXT2_XATTR_LEN(name_len) \
    	(((name_len) + EXT2_XATTR_ROUND + \
    	sizeof(struct ext2_xattr_entry)) & ~EXT2_XATTR_ROUND)
    /*得到当前入口项的下一个项*/
    #define EXT2_XATTR_NEXT(entry) \
    	( (struct ext2_xattr_entry *)( \
    	  (char *)(entry) + EXT2_XATTR_LEN((entry)->e_name_len)) )
    /*由当前的入口项实际大小按照4字节对齐后得到的存储大小*/
    #define EXT2_XATTR_SIZE(size) \
    	(((size) + EXT2_XATTR_ROUND) & ~EXT2_XATTR_ROUND)
    /*扩展属性结构体*/
    # ifdef CONFIG_EXT2_FS_XATTR
    
    
    extern struct xattr_handler ext2_xattr_user_handler;
    extern struct xattr_handler ext2_xattr_trusted_handler;
    extern struct xattr_handler ext2_xattr_acl_access_handler;
    extern struct xattr_handler ext2_xattr_acl_default_handler;
    extern struct xattr_handler ext2_xattr_security_handler;
    
    
    extern ssize_t ext2_listxattr(struct dentry *, char *, size_t);
    
    
    extern int ext2_xattr_get(struct inode *, int, const char *, void *, size_t);
    extern int ext2_xattr_set(struct inode *, int, const char *, const void *, size_t, int);
    
    
    extern void ext2_xattr_delete_inode(struct inode *);
    extern void ext2_xattr_put_super(struct super_block *);
    
    
    extern int init_ext2_xattr(void);
    extern void exit_ext2_xattr(void);
    
    
    extern struct xattr_handler *ext2_xattr_handlers[];
    
    
    # else  /* CONFIG_EXT2_FS_XATTR */
    /*如果没有配置这个宏，就返回操作不被支持*/
    static inline int
    ext2_xattr_get(struct inode *inode, int name_index,
    	       const char *name, void *buffer, size_t size)
    {
    	return -EOPNOTSUPP;
    }
    
    
    static inline int
    ext2_xattr_set(struct inode *inode, int name_index, const char *name,
    	       const void *value, size_t size, int flags)
    {
    	return -EOPNOTSUPP;
    }
    
    
    static inline void
    ext2_xattr_delete_inode(struct inode *inode)
    {
    }
    
    
    static inline void
    ext2_xattr_put_super(struct super_block *sb)
    {
    }
    
    
    static inline int
    init_ext2_xattr(void)
    {
    	return 0;
    }
    
    
    static inline void
    exit_ext2_xattr(void)
    {
    }
    
    
    #define ext2_xattr_handlers NULL
    
    
    # endif  /* CONFIG_EXT2_FS_XATTR */
    
    
    #ifdef CONFIG_EXT2_FS_SECURITY
    extern int ext2_init_security(struct inode *inode, struct inode *dir);
    #else
    static inline int ext2_init_security(struct inode *inode, struct inode *dir)
    {
    	return 0;
    }
    #endif