fs/jbd2/commit.c
Source file repositories/reference/linux-study-clean/fs/jbd2/commit.c
File Facts
- System
- Linux kernel
- Corpus path
fs/jbd2/commit.c- Extension
.c- Size
- 36243 bytes
- Lines
- 1187
- Domain
- Core OS
- Bucket
- VFS And Filesystem Core
- Inferred role
- Core OS: exported/initcall integration point
- Status
- integration 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.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- 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
linux/time.hlinux/fs.hlinux/jbd2.hlinux/errno.hlinux/slab.hlinux/mm.hlinux/pagemap.hlinux/jiffies.hlinux/crc32.hlinux/writeback.hlinux/backing-dev.hlinux/bio.hlinux/blkdev.hlinux/bitops.htrace/events/jbd2.h
Detected Declarations
function journal_end_buffer_io_syncfunction release_buffer_pagefunction jbd2_commit_block_csum_setfunction journal_submit_commit_recordfunction journal_wait_on_commit_recordfunction jbd2_submit_inode_datafunction jbd2_wait_inode_datafunction journal_submit_data_buffersfunction jbd2_journal_finish_inode_data_buffersfunction journal_finish_inode_data_buffersfunction jbd2_checksum_datafunction write_tag_blockfunction jbd2_block_tag_csum_setfunction jbd2_journal_commit_transactionfunction jbd2_journal_get_write_accessfunction jbd2_journal_get_undo_accessfunction __journal_remove_checkpointexport jbd2_submit_inode_dataexport jbd2_wait_inode_data
Annotated Snippet
if (journal->j_submit_inode_data_buffers) {
err = journal->j_submit_inode_data_buffers(jinode);
if (!ret)
ret = err;
}
spin_lock(&journal->j_list_lock);
J_ASSERT(jinode->i_transaction == commit_transaction);
WRITE_ONCE(jinode->i_flags,
jinode->i_flags & ~JI_COMMIT_RUNNING);
smp_mb();
wake_up_bit(&jinode->i_flags, __JI_COMMIT_RUNNING);
}
spin_unlock(&journal->j_list_lock);
return ret;
}
int jbd2_journal_finish_inode_data_buffers(struct jbd2_inode *jinode)
{
struct address_space *mapping = jinode->i_vfs_inode->i_mapping;
loff_t start_byte, end_byte;
if (!jbd2_jinode_get_dirty_range(jinode, &start_byte, &end_byte))
return 0;
return filemap_fdatawait_range_keep_errors(mapping,
start_byte, end_byte);
}
/*
* Wait for data submitted for writeout, refile inodes to proper
* transaction if needed.
*
*/
static int journal_finish_inode_data_buffers(journal_t *journal,
transaction_t *commit_transaction)
{
struct jbd2_inode *jinode, *next_i;
int err, ret = 0;
/* For locking, see the comment in journal_submit_data_buffers() */
spin_lock(&journal->j_list_lock);
list_for_each_entry(jinode, &commit_transaction->t_inode_list, i_list) {
if (!(jinode->i_flags & JI_WAIT_DATA))
continue;
WRITE_ONCE(jinode->i_flags, jinode->i_flags | JI_COMMIT_RUNNING);
spin_unlock(&journal->j_list_lock);
/* wait for the inode data buffers writeout. */
if (journal->j_finish_inode_data_buffers) {
err = journal->j_finish_inode_data_buffers(jinode);
if (!ret)
ret = err;
}
cond_resched();
spin_lock(&journal->j_list_lock);
WRITE_ONCE(jinode->i_flags, jinode->i_flags & ~JI_COMMIT_RUNNING);
smp_mb();
wake_up_bit(&jinode->i_flags, __JI_COMMIT_RUNNING);
}
/* Now refile inode to proper lists */
list_for_each_entry_safe(jinode, next_i,
&commit_transaction->t_inode_list, i_list) {
list_del(&jinode->i_list);
if (jinode->i_next_transaction) {
jinode->i_transaction = jinode->i_next_transaction;
jinode->i_next_transaction = NULL;
list_add(&jinode->i_list,
&jinode->i_transaction->t_inode_list);
} else {
jinode->i_transaction = NULL;
WRITE_ONCE(jinode->i_dirty_start_page, 0);
WRITE_ONCE(jinode->i_dirty_end_page, 0);
}
}
spin_unlock(&journal->j_list_lock);
return ret;
}
static __u32 jbd2_checksum_data(__u32 crc32_sum, struct buffer_head *bh)
{
char *addr;
__u32 checksum;
addr = kmap_local_folio(bh->b_folio, bh_offset(bh));
checksum = crc32_be(crc32_sum, addr, bh->b_size);
kunmap_local(addr);
return checksum;
}
Annotation
- Immediate include surface: `linux/time.h`, `linux/fs.h`, `linux/jbd2.h`, `linux/errno.h`, `linux/slab.h`, `linux/mm.h`, `linux/pagemap.h`, `linux/jiffies.h`.
- Detected declarations: `function journal_end_buffer_io_sync`, `function release_buffer_page`, `function jbd2_commit_block_csum_set`, `function journal_submit_commit_record`, `function journal_wait_on_commit_record`, `function jbd2_submit_inode_data`, `function jbd2_wait_inode_data`, `function journal_submit_data_buffers`, `function jbd2_journal_finish_inode_data_buffers`, `function journal_finish_inode_data_buffers`.
- Atlas domain: Core OS / VFS And Filesystem Core.
- Implementation status: integration 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.