sys/fs/ext2fs/ext2_extattr.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
   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
  57 struct ext2fs_extattr_header {
  58         int32_t h_magic;        /* magic number for identification */
  59         int32_t h_refcount;     /* reference count */
  60         int32_t h_blocks;       /* number of disk blocks used */
  61         int32_t h_hash;         /* hash value of all attributes */
  62         int32_t h_checksum;     /* crc32c(uuid+id+xattrblock) */
  63                                 /* id = inum if refcount=1, blknum otherwise */
  64         uint32_t h_reserved[3]; /* zero right now */
  65 };
  66
  67 struct ext2fs_extattr_dinode_header {
  68         int32_t h_magic;        /* magic number for identification */
  69 };
  70
  71 struct ext2fs_extattr_entry {
  72         uint8_t e_name_len;             /* length of name */
  73         uint8_t e_name_index;           /* attribute name index */
  74         uint16_t        e_value_offs;   /* offset in disk block of value */
  75         uint32_t        e_value_block;  /* disk block attribute is stored on (n/i) */
  76         uint32_t        e_value_size;   /* size of attribute value */
  77         uint32_t        e_hash;         /* hash value of name and value */
  78         char    e_name[0];              /* attribute name */
  79 };
  80
  81 #define EXT2_IFIRST(hdr) ((struct ext2fs_extattr_entry *)((hdr)+1))
  82
  83 #define EXT2_HDR(bh) ((struct ext2fs_extattr_header *)((bh)->b_data))
  84 #define EXT2_ENTRY(ptr) ((struct ext2fs_extattr_entry *)(ptr))
  85 #define EXT2_FIRST_ENTRY(bh) EXT2_ENTRY(EXT2_HDR(bh)+1)
  86 #define EXT2_IS_LAST_ENTRY(entry) (*(uint32_t *)(entry) == 0)
  87
  88 #define EXT2_EXTATTR_PAD_BITS           2
  89 #define EXT2_EXTATTR_PAD                (1<<EXT2_EXTATTR_PAD_BITS)
  90 #define EXT2_EXTATTR_ROUND              (EXT2_EXTATTR_PAD-1)
  91 #define EXT2_EXTATTR_LEN(name_len) \
  92         (((name_len) + EXT2_EXTATTR_ROUND + \
  93             sizeof(struct ext2fs_extattr_entry)) & ~EXT2_EXTATTR_ROUND)
  94
  95 #define EXT2_EXTATTR_SIZE(size) \
  96     (((size) + EXT2_EXTATTR_ROUND) & ~EXT2_EXTATTR_ROUND)
  97
  98 #define EXT2_EXTATTR_NEXT(entry) \
  99         ( (struct ext2fs_extattr_entry *)( \
 100             (char *)(entry) + EXT2_EXTATTR_LEN((entry)->e_name_len)) )
 101
 102 int ext2_extattr_inode_delete(struct inode *ip, int attrnamespace,
 103     const char *name);
 104
 105 int ext2_extattr_block_delete(struct inode *ip, int attrnamespace,
 106     const char *name);
 107
 108 int ext2_extattr_free(struct inode *ip);
 109 int ext2_extattr_inode_list(struct inode *ip, int attrnamespace,
 110     struct uio *uio, size_t *size);
 111
 112 int ext2_extattr_block_list(struct inode *ip, int attrnamespace,
 113     struct uio *uio, size_t *size);
 114
 115 int ext2_extattr_inode_get(struct inode *ip, int attrnamespace,
 116     const char *name, struct uio *uio, size_t *size);
 117
 118 int ext2_extattr_block_get(struct inode *ip, int attrnamespace,
 119     const char *name, struct uio *uio, size_t *size);
 120
 121 int ext2_extattr_inode_set(struct inode *ip, int attrnamespace,
 122     const char *name, struct uio *uio);
 123
 124 int ext2_extattr_block_set(struct inode *ip, int attrnamespace,
 125     const char *name, struct uio *uio);
 126
 127 int ext2_extattr_valid_attrname(int attrnamespace, const char *attrname);
 128
 129 #endif  /* !_FS_EXT2FS_EXT2_EXTARTTR_H_ */