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