// SPDX-License-Identifier: GPL-2.0 /* * linux/fs/ext2/xattr.c * * Copyright (C) 2001-2003 Andreas Gruenbacher <agruen@suse.de> * * Fix by Harrison Xing <harrison@mountainviewdata.com>. * Extended attributes for symlinks and special files added per * suggestion of Luka Renko <luka.renko@hermes.si>. * xattr consolidation Copyright (c) 2004 James Morris <jmorris@redhat.com>, * Red Hat Inc. *
*/
/* * Extended attributes are stored on disk blocks allocated outside of * any inode. The i_file_acl field is then made to point to this allocated * block. If all extended attributes of an inode are identical, these * inodes may share the same extended attribute block. Such situations * are automatically detected by keeping a cache of recent attribute block * numbers and hashes over the block's contents in memory. * * * Extended attribute block layout: * * +------------------+ * | header | * | entry 1 | | * | entry 2 | | growing downwards * | entry 3 | v * | four null bytes | * | . . . | * | value 1 | ^ * | value 3 | | growing upwards * | value 2 | | * +------------------+ * * The block header is followed by multiple entry descriptors. These entry * descriptors are variable in size, and aligned to EXT2_XATTR_PAD * byte boundaries. The entry descriptors are sorted by attribute name, * so that two extended attribute blocks can be compared efficiently. * * Attribute values are aligned to the end of the block, stored in * no specific order. They are also padded to EXT2_XATTR_PAD byte * boundaries. No additional gaps are left between them. * * Locking strategy * ---------------- * EXT2_I(inode)->i_file_acl is protected by EXT2_I(inode)->xattr_sem. * EA blocks are only changed if they are exclusive to an inode, so * holding xattr_sem also means that nothing but the EA block's reference * count will change. Multiple writers to an EA block are synchronized * by the bh lock. No more than a single bh lock is held at any time * to avoid deadlocks.
*/
cmp = name_index - entry->e_name_index; if (!cmp)
cmp = name_len - entry->e_name_len; if (!cmp)
cmp = memcmp(name, entry->e_name, name_len);
return cmp;
}
/* * ext2_xattr_get() * * Copy an extended attribute into the buffer * provided, or compute the buffer size required. * Buffer is NULL to compute the size of the buffer required. * * Returns a negative error number on failure, or the number of bytes * used / required on success.
*/ int
ext2_xattr_get(struct inode *inode, int name_index, constchar *name, void *buffer, size_t buffer_size)
{ struct buffer_head *bh = NULL; struct ext2_xattr_entry *entry;
size_t name_len, size; char *end; int error, not_found; struct mb_cache *ea_block_cache = EA_BLOCK_CACHE(inode);
/* * ext2_xattr_list() * * Copy a list of attribute names into the buffer * provided, or compute the buffer size required. * Buffer is NULL to compute the size of the buffer required. * * Returns a negative error number on failure, or the number of bytes * used / required on success.
*/ staticint
ext2_xattr_list(struct dentry *dentry, char *buffer, size_t buffer_size)
{ struct inode *inode = d_inode(dentry); struct buffer_head *bh = NULL; struct ext2_xattr_entry *entry; char *end;
size_t rest = buffer_size; int error; struct mb_cache *ea_block_cache = EA_BLOCK_CACHE(inode);
/* * If the EXT2_FEATURE_COMPAT_EXT_ATTR feature of this file system is * not set, set it.
*/ staticvoid ext2_xattr_update_super_block(struct super_block *sb)
{ if (EXT2_HAS_COMPAT_FEATURE(sb, EXT2_FEATURE_COMPAT_EXT_ATTR)) return;
/* * ext2_xattr_set() * * Create, replace or remove an extended attribute for this inode. Value * is NULL to remove an existing extended attribute, and non-NULL to * either replace an existing extended attribute, or create a new extended * attribute. The flags XATTR_REPLACE and XATTR_CREATE * specify that an extended attribute must exist and must not exist * previous to the call, respectively. * * Returns 0, or a negative error number on failure.
*/ int
ext2_xattr_set(struct inode *inode, int name_index, constchar *name, constvoid *value, size_t value_len, int flags)
{ struct super_block *sb = inode->i_sb; struct buffer_head *bh = NULL; struct ext2_xattr_header *header = NULL; struct ext2_xattr_entry *here = NULL, *last = NULL;
size_t name_len, free, min_offs = sb->s_blocksize; int not_found = 1, error; char *end;
/* * header -- Points either into bh, or to a temporarily * allocated buffer. * here -- The named entry found, or the place for inserting, within * the block pointed to by header. * last -- Points right after the last named entry within the block * pointed to by header. * min_offs -- The offset of the first value (values are aligned * towards the end of the block). * end -- Points right after the block pointed to by header.
*/
if (value == NULL)
value_len = 0; if (name == NULL) return -EINVAL;
name_len = strlen(name); if (name_len > 255 || value_len > sb->s_blocksize) return -ERANGE;
error = dquot_initialize(inode); if (error) return error;
down_write(&EXT2_I(inode)->xattr_sem); if (EXT2_I(inode)->i_file_acl) { /* The inode already has an extended attribute block. */
bh = sb_bread(sb, EXT2_I(inode)->i_file_acl);
error = -EIO; if (!bh) goto cleanup;
ea_bdebug(bh, "b_count=%d, refcount=%d",
atomic_read(&(bh->b_count)),
le32_to_cpu(HDR(bh)->h_refcount));
header = HDR(bh);
end = bh->b_data + bh->b_size; if (!ext2_xattr_header_valid(header)) {
bad_block:
ext2_error(sb, "ext2_xattr_set", "inode %ld: bad block %d", inode->i_ino,
EXT2_I(inode)->i_file_acl);
error = -EIO; goto cleanup;
} /* * Find the named attribute. If not found, 'here' will point * to entry where the new attribute should be inserted to * maintain sorting.
*/
last = FIRST_ENTRY(bh); while (!IS_LAST_ENTRY(last)) { if (!ext2_xattr_entry_valid(last, end, sb->s_blocksize)) goto bad_block; if (last->e_value_size) {
size_t offs = le16_to_cpu(last->e_value_offs); if (offs < min_offs)
min_offs = offs;
} if (not_found > 0) {
not_found = ext2_xattr_cmp_entry(name_index,
name_len,
name, last); if (not_found <= 0)
here = last;
}
last = EXT2_XATTR_NEXT(last);
} if (not_found > 0)
here = last;
/* Check whether we have enough space left. */
free = min_offs - ((char*)last - (char*)header) - sizeof(__u32);
} else { /* We will use a new extended attribute block. */
free = sb->s_blocksize - sizeof(struct ext2_xattr_header) - sizeof(__u32);
}
if (not_found) { /* Request to remove a nonexistent attribute? */
error = -ENODATA; if (flags & XATTR_REPLACE) goto cleanup;
error = 0; if (value == NULL) goto cleanup;
} else { /* Request to create an existing attribute? */
error = -EEXIST; if (flags & XATTR_CREATE) goto cleanup;
free += EXT2_XATTR_SIZE(le32_to_cpu(here->e_value_size));
free += EXT2_XATTR_LEN(name_len);
}
error = -ENOSPC; if (free < EXT2_XATTR_LEN(name_len) + EXT2_XATTR_SIZE(value_len)) goto cleanup;
/* Here we know that we can set the new attribute. */
if (size == EXT2_XATTR_SIZE(value_len)) { /* The old and the new value have the same
size. Just replace. */
here->e_value_size = cpu_to_le32(value_len);
memset(val + size - EXT2_XATTR_PAD, 0,
EXT2_XATTR_PAD); /* Clear pad bytes. */
memcpy(val, value, value_len); goto skip_replace;
}
/* Remove the old value. */
memmove(first_val + size, first_val, val - first_val);
memset(first_val, 0, size);
min_offs += size;
/* Adjust all value offsets. */
last = ENTRY(header+1); while (!IS_LAST_ENTRY(last)) {
size_t o = le16_to_cpu(last->e_value_offs); if (o < offs)
last->e_value_offs =
cpu_to_le16(o + size);
last = EXT2_XATTR_NEXT(last);
}
here->e_value_offs = 0;
} if (value == NULL) { /* Remove the old name. */
size_t size = EXT2_XATTR_LEN(name_len);
last = ENTRY((char *)last - size);
memmove(here, (char*)here + size,
(char*)last - (char*)here);
memset(last, 0, size);
}
}
if (value != NULL) { /* Insert the new value. */
here->e_value_size = cpu_to_le32(value_len); if (value_len) {
size_t size = EXT2_XATTR_SIZE(value_len); char *val = (char *)header + min_offs - size;
here->e_value_offs =
cpu_to_le16((char *)val - (char *)header);
memset(val + size - EXT2_XATTR_PAD, 0,
EXT2_XATTR_PAD); /* Clear the pad bytes. */
memcpy(val, value, value_len);
}
}
skip_replace: if (IS_LAST_ENTRY(ENTRY(header+1))) { /* This block is now empty. */ if (bh && header == HDR(bh))
unlock_buffer(bh); /* we were modifying in-place. */
error = ext2_xattr_set2(inode, bh, NULL);
} else {
ext2_xattr_rehash(header, here); if (bh && header == HDR(bh))
unlock_buffer(bh); /* we were modifying in-place. */
error = ext2_xattr_set2(inode, bh, header);
}
cleanup: if (!(bh && header == HDR(bh)))
kfree(header);
brelse(bh);
up_write(&EXT2_I(inode)->xattr_sem);
/* * This must happen under buffer lock to properly * serialize with ext2_xattr_set() reusing the block.
*/
oe = mb_cache_entry_delete_or_get(ea_block_cache, hash,
bh->b_blocknr); if (oe) { /* * Someone is trying to reuse the block. Wait * and retry.
*/
unlock_buffer(bh);
mb_cache_entry_wait_unused(oe);
mb_cache_entry_put(ea_block_cache, oe); goto retry_ref;
}
/* Free the old block. */
ea_bdebug(bh, "freeing");
ext2_free_blocks(inode, bh->b_blocknr, 1); /* We let our caller release bh, so we
* need to duplicate the buffer before. */
get_bh(bh);
bforget(bh);
unlock_buffer(bh);
} else { /* Decrement the refcount only. */
le32_add_cpu(&HDR(bh)->h_refcount, -1);
dquot_free_block(inode, 1);
mark_buffer_dirty(bh);
unlock_buffer(bh);
ea_bdebug(bh, "refcount now=%d",
le32_to_cpu(HDR(bh)->h_refcount)); if (IS_SYNC(inode))
sync_dirty_buffer(bh);
}
}
/* * Second half of ext2_xattr_set(): Update the file system.
*/ staticint
ext2_xattr_set2(struct inode *inode, struct buffer_head *old_bh, struct ext2_xattr_header *header)
{ struct super_block *sb = inode->i_sb; struct buffer_head *new_bh = NULL; int error; struct mb_cache *ea_block_cache = EA_BLOCK_CACHE(inode);
if (header) {
new_bh = ext2_xattr_cache_find(inode, header); if (new_bh) { /* We found an identical block in the cache. */ if (new_bh == old_bh) {
ea_bdebug(new_bh, "keeping this block");
} else { /* The old block is released after updating
the inode. */
ea_bdebug(new_bh, "reusing block");
error = dquot_alloc_block(inode, 1); if (error) {
unlock_buffer(new_bh); goto cleanup;
}
le32_add_cpu(&HDR(new_bh)->h_refcount, 1);
ea_bdebug(new_bh, "refcount now=%d",
le32_to_cpu(HDR(new_bh)->h_refcount));
}
unlock_buffer(new_bh);
} elseif (old_bh && header == HDR(old_bh)) { /* Keep this block. No need to lock the block as we
don't need to change the reference count. */
new_bh = old_bh;
get_bh(new_bh);
ext2_xattr_cache_insert(ea_block_cache, new_bh);
} else { /* We need to allocate a new block */
ext2_fsblk_t goal = ext2_group_first_block_no(sb,
EXT2_I(inode)->i_block_group); unsignedlong count = 1;
ext2_fsblk_t block = ext2_new_blocks(inode, goal,
&count, &error,
EXT2_ALLOC_NORESERVE); if (error) goto cleanup;
ea_idebug(inode, "creating block %lu", block);
ext2_xattr_update_super_block(sb);
}
mark_buffer_dirty(new_bh); if (IS_SYNC(inode)) {
sync_dirty_buffer(new_bh);
error = -EIO; if (buffer_req(new_bh) && !buffer_uptodate(new_bh)) goto cleanup;
}
}
/* Update the inode. */
EXT2_I(inode)->i_file_acl = new_bh ? new_bh->b_blocknr : 0;
inode_set_ctime_current(inode); if (IS_SYNC(inode)) {
error = sync_inode_metadata(inode, 1); /* In case sync failed due to ENOSPC the inode was actually * written (only some dirty data were not) so we just proceed
* as if nothing happened and cleanup the unused block */ if (error && error != -ENOSPC) { if (new_bh && new_bh != old_bh) {
dquot_free_block_nodirty(inode, 1);
mark_inode_dirty(inode);
} goto cleanup;
}
} else
mark_inode_dirty(inode);
error = 0; if (old_bh && old_bh != new_bh) { /* * If there was an old block and we are no longer using it, * release the old block.
*/
ext2_xattr_release_block(inode, old_bh);
}
cleanup:
brelse(new_bh);
return error;
}
/* * ext2_xattr_delete_inode() * * Free extended attribute resources associated with this inode. This * is called immediately before an inode is freed.
*/ void
ext2_xattr_delete_inode(struct inode *inode)
{ struct buffer_head *bh = NULL; struct ext2_sb_info *sbi = EXT2_SB(inode->i_sb);
/* * We are the only ones holding inode reference. The xattr_sem should * better be unlocked! We could as well just not acquire xattr_sem at * all but this makes the code more futureproof. OTOH we need trylock * here to avoid false-positive warning from lockdep about reclaim * circular dependency.
*/ if (WARN_ON_ONCE(!down_write_trylock(&EXT2_I(inode)->xattr_sem))) return; if (!EXT2_I(inode)->i_file_acl) goto cleanup;
if (!ext2_data_block_valid(sbi, EXT2_I(inode)->i_file_acl, 1)) {
ext2_error(inode->i_sb, "ext2_xattr_delete_inode", "inode %ld: xattr block %d is out of data blocks range",
inode->i_ino, EXT2_I(inode)->i_file_acl); goto cleanup;
}
/* * ext2_xattr_cache_insert() * * Create a new entry in the extended attribute cache, and insert * it unless such an entry is already in the cache. * * Returns 0, or a negative error number on failure.
*/ staticint
ext2_xattr_cache_insert(struct mb_cache *cache, struct buffer_head *bh)
{
__u32 hash = le32_to_cpu(HDR(bh)->h_hash); int error;
/* * ext2_xattr_cmp() * * Compare two extended attribute blocks for equality. * * Returns 0 if the blocks are equal, 1 if they differ, and * a negative error number on errors.
*/ staticint
ext2_xattr_cmp(struct ext2_xattr_header *header1, struct ext2_xattr_header *header2)
{ struct ext2_xattr_entry *entry1, *entry2;
/* * ext2_xattr_cache_find() * * Find an identical extended attribute block. * * Returns a locked buffer head to the block found, or NULL if such * a block was not found or an error occurred.
*/ staticstruct buffer_head *
ext2_xattr_cache_find(struct inode *inode, struct ext2_xattr_header *header)
{
__u32 hash = le32_to_cpu(header->h_hash); struct mb_cache_entry *ce; struct mb_cache *ea_block_cache = EA_BLOCK_CACHE(inode);
if (!header->h_hash) return NULL; /* never share */
ea_idebug(inode, "looking for cached blocks [%x]", (int)hash);
ce = mb_cache_entry_find_first(ea_block_cache, hash); while (ce) { struct buffer_head *bh;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.