1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 2017, Fedor Uporov 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #ifndef _FS_EXT2FS_EXT2_EXTARTTR_H_ 30 #define _FS_EXT2FS_EXT2_EXTARTTR_H_ 31 32 /* Linux xattr name indexes */ 33 #define EXT4_XATTR_INDEX_USER 1 34 #define EXT4_XATTR_INDEX_POSIX_ACL_ACCESS 2 35 #define EXT4_XATTR_INDEX_POSIX_ACL_DEFAULT 3 36 #define EXT4_XATTR_INDEX_TRUSTED 4 37 #define EXT4_XATTR_INDEX_LUSTRE 5 38 #define EXT4_XATTR_INDEX_SECURITY 6 39 #define EXT4_XATTR_INDEX_SYSTEM 7 40 #define EXT4_XATTR_INDEX_RICHACL 8 41 #define EXT4_XATTR_INDEX_ENCRYPTION 9 42 43 /* Magic value in attribute blocks */ 44 #define EXTATTR_MAGIC 0xEA020000 45 46 /* Max EA name length */ 47 #define EXT2_EXTATTR_NAMELEN_MAX 255 48 49 /* EA hash constants */ 50 #define EXT2_EXTATTR_NAME_HASH_SHIFT 5 51 #define EXT2_EXTATTR_VALUE_HASH_SHIFT 16 52 #define EXT2_EXTATTR_BLOCK_HASH_SHIFT 16 53 54 struct ext2fs_extattr_header { 55 int32_t h_magic; /* magic number for identification */ 56 int32_t h_refcount; /* reference count */ 57 int32_t h_blocks; /* number of disk blocks used */ 58 int32_t h_hash; /* hash value of all attributes */ 59 int32_t h_checksum; /* crc32c(uuid+id+xattrblock) */ 60 /* id = inum if refcount=1, blknum otherwise */ 61 uint32_t h_reserved[3]; /* zero right now */ 62 }; 63 64 struct ext2fs_extattr_dinode_header { 65 int32_t h_magic; /* magic number for identification */ 66 }; 67 68 struct ext2fs_extattr_entry { 69 uint8_t e_name_len; /* length of name */ 70 uint8_t e_name_index; /* attribute name index */ 71 uint16_t e_value_offs; /* offset in disk block of value */ 72 uint32_t e_value_block; /* disk block attribute is stored on (n/i) */ 73 uint32_t e_value_size; /* size of attribute value */ 74 uint32_t e_hash; /* hash value of name and value */ 75 char e_name[0]; /* attribute name */ 76 }; 77 78 #define EXT2_IFIRST(hdr) ((struct ext2fs_extattr_entry *)((hdr)+1)) 79 80 #define EXT2_HDR(bh) ((struct ext2fs_extattr_header *)((bh)->b_data)) 81 #define EXT2_ENTRY(ptr) ((struct ext2fs_extattr_entry *)(ptr)) 82 #define EXT2_FIRST_ENTRY(bh) EXT2_ENTRY(EXT2_HDR(bh)+1) 83 #define EXT2_IS_LAST_ENTRY(entry) (*(uint32_t *)(entry) == 0) 84 85 #define EXT2_EXTATTR_PAD_BITS 2 86 #define EXT2_EXTATTR_PAD (1<<EXT2_EXTATTR_PAD_BITS) 87 #define EXT2_EXTATTR_ROUND (EXT2_EXTATTR_PAD-1) 88 #define EXT2_EXTATTR_LEN(name_len) \ 89 (((name_len) + EXT2_EXTATTR_ROUND + \ 90 sizeof(struct ext2fs_extattr_entry)) & ~EXT2_EXTATTR_ROUND) 91 92 #define EXT2_EXTATTR_SIZE(size) \ 93 (((size) + EXT2_EXTATTR_ROUND) & ~EXT2_EXTATTR_ROUND) 94 95 #define EXT2_EXTATTR_NEXT(entry) \ 96 ( (struct ext2fs_extattr_entry *)( \ 97 (char *)(entry) + EXT2_EXTATTR_LEN((entry)->e_name_len)) ) 98 99 int ext2_extattr_inode_delete(struct inode *ip, int attrnamespace, 100 const char *name); 101 102 int ext2_extattr_block_delete(struct inode *ip, int attrnamespace, 103 const char *name); 104 105 int ext2_extattr_free(struct inode *ip); 106 int ext2_extattr_inode_list(struct inode *ip, int attrnamespace, 107 struct uio *uio, size_t *size); 108 109 int ext2_extattr_block_list(struct inode *ip, int attrnamespace, 110 struct uio *uio, size_t *size); 111 112 int ext2_extattr_inode_get(struct inode *ip, int attrnamespace, 113 const char *name, struct uio *uio, size_t *size); 114 115 int ext2_extattr_block_get(struct inode *ip, int attrnamespace, 116 const char *name, struct uio *uio, size_t *size); 117 118 int ext2_extattr_inode_set(struct inode *ip, int attrnamespace, 119 const char *name, struct uio *uio); 120 121 int ext2_extattr_block_set(struct inode *ip, int attrnamespace, 122 const char *name, struct uio *uio); 123 124 int ext2_extattr_valid_attrname(int attrnamespace, const char *attrname); 125 126 #endif /* !_FS_EXT2FS_EXT2_EXTARTTR_H_ */ 127