fs/xfs/xfs_rmap_item.c
Source file repositories/reference/linux-study-clean/fs/xfs/xfs_rmap_item.c
File Facts
- System
- Linux kernel
- Corpus path
fs/xfs/xfs_rmap_item.c- Extension
.c- Size
- 23692 bytes
- Lines
- 892
- Domain
- Core OS
- Bucket
- VFS And Filesystem Core
- Inferred role
- Core OS: implementation source
- Status
- source implementation candidate
Why This File Exists
Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
xfs_platform.hxfs_fs.hxfs_format.hxfs_log_format.hxfs_trans_resv.hxfs_bit.hxfs_shared.hxfs_mount.hxfs_defer.hxfs_trans.hxfs_trans_priv.hxfs_rmap_item.hxfs_log.hxfs_rmap.hxfs_error.hxfs_log_priv.hxfs_log_recover.hxfs_ag.hxfs_btree.hxfs_trace.hxfs_rtgroup.h
Detected Declarations
function xfs_rui_item_freefunction xfs_rui_releasefunction xfs_rui_item_sizefunction xfs_rui_log_spacefunction xfs_rui_item_formatfunction xfs_rui_item_unpinfunction xfs_rui_item_releasefunction xfs_rui_initfunction xfs_rud_item_sizefunction xfs_rud_log_spacefunction xfs_rud_item_formatfunction xfs_rud_item_releasefunction xfs_rud_item_intentfunction xfs_rui_item_isrtfunction xfs_rmap_update_diff_itemsfunction xfs_rmap_update_log_itemfunction __xfs_rmap_update_create_intentfunction xfs_rmap_update_create_intentfunction xfs_rud_type_from_ruifunction xfs_rmap_update_create_donefunction xfs_rmap_defer_addfunction xfs_rmap_update_cancel_itemfunction xfs_rmap_update_finish_itemfunction xfs_rmap_finish_one_cleanupfunction xfs_rmap_update_abort_intentfunction xfs_rui_validate_mapfunction xfs_rui_recover_workfunction xfs_rmap_recover_workfunction xfs_rmap_relog_intentfunction xfs_rtrmap_update_create_intentfunction xfs_rtrmap_finish_one_cleanupfunction xfs_rui_item_matchfunction xfs_rui_copy_formatfunction xlog_recover_rui_commit_pass2function xlog_recover_rtrui_commit_pass2function xlog_recover_rtrui_commit_pass2function xlog_recover_rud_commit_pass2function xlog_recover_rtrud_commit_pass2
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0+
/*
* Copyright (C) 2016 Oracle. All Rights Reserved.
* Author: Darrick J. Wong <darrick.wong@oracle.com>
*/
#include "xfs_platform.h"
#include "xfs_fs.h"
#include "xfs_format.h"
#include "xfs_log_format.h"
#include "xfs_trans_resv.h"
#include "xfs_bit.h"
#include "xfs_shared.h"
#include "xfs_mount.h"
#include "xfs_defer.h"
#include "xfs_trans.h"
#include "xfs_trans_priv.h"
#include "xfs_rmap_item.h"
#include "xfs_log.h"
#include "xfs_rmap.h"
#include "xfs_error.h"
#include "xfs_log_priv.h"
#include "xfs_log_recover.h"
#include "xfs_ag.h"
#include "xfs_btree.h"
#include "xfs_trace.h"
#include "xfs_rtgroup.h"
struct kmem_cache *xfs_rui_cache;
struct kmem_cache *xfs_rud_cache;
static const struct xfs_item_ops xfs_rui_item_ops;
static inline struct xfs_rui_log_item *RUI_ITEM(struct xfs_log_item *lip)
{
return container_of(lip, struct xfs_rui_log_item, rui_item);
}
STATIC void
xfs_rui_item_free(
struct xfs_rui_log_item *ruip)
{
kvfree(ruip->rui_item.li_lv_shadow);
if (ruip->rui_format.rui_nextents > XFS_RUI_MAX_FAST_EXTENTS)
kfree(ruip);
else
kmem_cache_free(xfs_rui_cache, ruip);
}
/*
* Freeing the RUI requires that we remove it from the AIL if it has already
* been placed there. However, the RUI may not yet have been placed in the AIL
* when called by xfs_rui_release() from RUD processing due to the ordering of
* committed vs unpin operations in bulk insert operations. Hence the reference
* count to ensure only the last caller frees the RUI.
*/
STATIC void
xfs_rui_release(
struct xfs_rui_log_item *ruip)
{
ASSERT(atomic_read(&ruip->rui_refcount) > 0);
if (!atomic_dec_and_test(&ruip->rui_refcount))
return;
xfs_trans_ail_delete(&ruip->rui_item, 0);
xfs_rui_item_free(ruip);
}
STATIC void
xfs_rui_item_size(
struct xfs_log_item *lip,
int *nvecs,
int *nbytes)
{
struct xfs_rui_log_item *ruip = RUI_ITEM(lip);
*nvecs += 1;
*nbytes += xfs_rui_log_format_sizeof(ruip->rui_format.rui_nextents);
}
unsigned int xfs_rui_log_space(unsigned int nr)
{
return xlog_item_space(1, xfs_rui_log_format_sizeof(nr));
}
/*
* This is called to fill in the vector of log iovecs for the
* given rui log item. We use only 1 iovec, and we point that
* at the rui_log_format structure embedded in the rui item.
* It is at this point that we assert that all of the extent
* slots in the rui item have been filled.
Annotation
- Immediate include surface: `xfs_platform.h`, `xfs_fs.h`, `xfs_format.h`, `xfs_log_format.h`, `xfs_trans_resv.h`, `xfs_bit.h`, `xfs_shared.h`, `xfs_mount.h`.
- Detected declarations: `function xfs_rui_item_free`, `function xfs_rui_release`, `function xfs_rui_item_size`, `function xfs_rui_log_space`, `function xfs_rui_item_format`, `function xfs_rui_item_unpin`, `function xfs_rui_item_release`, `function xfs_rui_init`, `function xfs_rud_item_size`, `function xfs_rud_log_space`.
- Atlas domain: Core OS / VFS And Filesystem Core.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.