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 * $FreeBSD$ 29 */ 30 31 #ifndef _FS_EXT2FS_EXT2_EXTARTTR_H_ 32 #define _FS_EXT2FS_EXT2_EXTARTTR_H_ 33 34 /* Linux xattr name indexes */ 35 #define EXT4_XATTR_INDEX_USER 1 36 #define EXT4_XATTR_INDEX_POSIX_ACL_ACCESS 2 37 #define EXT4_XATTR_INDEX_POSIX_ACL_DEFAULT 3 38 #define EXT4_XATTR_INDEX_TRUSTED 4 39 #define EXT4_XATTR_INDEX_LUSTRE 5 40 #define EXT4_XATTR_INDEX_SECURITY 6 41 #define EXT4_XATTR_INDEX_SYSTEM 7 42 #define EXT4_XATTR_INDEX_RICHACL 8 43 #define EXT4_XATTR_INDEX_ENCRYPTION 9 44 45 /* Magic value in attribute blocks */ 46 #define EXTATTR_MAGIC 0xEA020000 47 48 /* Max EA name length */ 49 #define EXT2_EXTATTR_NAMELEN_MAX 255 50 51 /* EA hash constants */ 52 #define EXT2_EXTATTR_NAME_HASH_SHIFT 5 53 #define EXT2_EXTATTR_VALUE_HASH_SHIFT 16 54 #define EXT2_EXTATTR_BLOCK_HASH_SHIFT 16 55 56 struct ext2fs_extattr_header { 57 int32_t h_magic; /* magic number for identification */ 58 int32_t h_refcount; /* reference count */ 59 int32_t h_blocks; /* number of disk blocks used */ 60 int32_t h_hash; /* hash value of all attributes */ 61 int32_t h_checksum; /* crc32c(uuid+id+xattrblock) */ 62 /* id = inum if refcount=1, blknum otherwise */ 63 uint32_t h_reserved[3]; /* zero right now */ 64 }; 65 66 struct ext2fs_extattr_dinode_header { 67 int32_t h_magic; /* magic number for identification */ 68 }; 69 70 struct ext2fs_extattr_entry { 71 uint8_t e_name_len; /* length of name */ 72 uint8_t e_name_index; /* attribute name index */ 73 uint16_t e_value_offs; /* offset in disk block of value */ 74 uint32_t e_value_block; /* disk block attribute is stored on (n/i) */ 75 uint32_t e_value_size; /* size of attribute value */ 76 uint32_t e_hash; /* hash value of name and value */ 77 char e_name[0]; /* attribute name */ 78 }; 79 80 #define EXT2_IFIRST(hdr) ((struct ext2fs_extattr_entry *)((hdr)+1)) 81 82 #define EXT2_HDR(bh) ((struct ext2fs_extattr_header *)((bh)->b_data)) 83 #define EXT2_ENTRY(ptr) ((struct ext2fs_extattr_entry *)(ptr)) 84 #define EXT2_FIRST_ENTRY(bh) EXT2_ENTRY(EXT2_HDR(bh)+1) 85 #define EXT2_IS_LAST_ENTRY(entry) (*(uint32_t *)(entry) == 0) 86 87 #define EXT2_EXTATTR_PAD_BITS 2 88 #define EXT2_EXTATTR_PAD (1<<EXT2_EXTATTR_PAD_BITS) 89 #define EXT2_EXTATTR_ROUND (EXT2_EXTATTR_PAD-1) 90 #define EXT2_EXTATTR_LEN(name_len) \ 91 (((name_len) + EXT2_EXTATTR_ROUND + \ 92 sizeof(struct ext2fs_extattr_entry)) & ~EXT2_EXTATTR_ROUND) 93 94 #define EXT2_EXTATTR_SIZE(size) \ 95 (((size) + EXT2_EXTATTR_ROUND) & ~EXT2_EXTATTR_ROUND) 96 97 #define EXT2_EXTATTR_NEXT(entry) \ 98 ( (struct ext2fs_extattr_entry *)( \ 99 (char *)(entry) + EXT2_EXTATTR_LEN((entry)->e_name_len)) ) 100 101 int ext2_extattr_inode_delete(struct inode *ip, int attrnamespace, 102 const char *name); 103 104 int ext2_extattr_block_delete(struct inode *ip, int attrnamespace, 105 const char *name); 106 107 int ext2_extattr_free(struct inode *ip); 108 int ext2_extattr_inode_list(struct inode *ip, int attrnamespace, 109 struct uio *uio, size_t *size); 110 111 int ext2_extattr_block_list(struct inode *ip, int attrnamespace, 112 struct uio *uio, size_t *size); 113 114 int ext2_extattr_inode_get(struct inode *ip, int attrnamespace, 115 const char *name, struct uio *uio, size_t *size); 116 117 int ext2_extattr_block_get(struct inode *ip, int attrnamespace, 118 const char *name, struct uio *uio, size_t *size); 119 120 int ext2_extattr_inode_set(struct inode *ip, int attrnamespace, 121 const char *name, struct uio *uio); 122 123 int ext2_extattr_block_set(struct inode *ip, int attrnamespace, 124 const char *name, struct uio *uio); 125 126 int ext2_extattr_valid_attrname(int attrnamespace, const char *attrname); 127 128 #endif /* !_FS_EXT2FS_EXT2_EXTARTTR_H_ */ 129