drivers/nvdimm/btt.c

File Facts

System

Linux kernel

Corpus path

drivers/nvdimm/btt.c

Extension

.c

Size

43626 bytes

Lines

1729

Domain

Driver Families

Bucket

drivers/nvdimm

Inferred role

Driver Families: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• 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/highmem.h
• linux/debugfs.h
• linux/blkdev.h
• linux/blk-integrity.h
• linux/pagemap.h
• linux/module.h
• linux/device.h
• linux/mutex.h
• linux/hdreg.h
• linux/sizes.h
• linux/ndctl.h
• linux/fs.h
• linux/nd.h
• linux/backing-dev.h
• linux/cleanup.h
• btt.h
• nd.h

Detected Declarations

• enum log_ent_request
• function adjust_initial_offset
• function arena_read_bytes
• function arena_write_bytes
• function btt_info_write
• function btt_info_read
• function __btt_map_write
• function btt_map_write
• function btt_map_read
• function btt_log_group_read
• function arena_debugfs_init
• function btt_debugfs_init
• function list_for_each_entry
• function log_seq
• function btt_log_get_old
• function desired
• function __btt_log_write
• function btt_flog_write
• function btt_map_init
• function btt_log_init
• function to_namespace_offset
• function arena_clear_freelist_error
• function btt_freelist_init
• function ent_is_padding
• function state
• function btt_rtt_init
• function btt_maplocks_init
• function free_arenas
• function list_for_each_entry_safe
• function parse_arena_meta
• function discover_arenas
• function create_arenas
• function btt_arena_write_layout
• function btt_meta_init
• function btt_meta_size
• function lba_to_arena
• function list_for_each_entry
• function following
• function unlock_map
• function btt_data_read
• function btt_data_write
• function zero_fill_data
• function btt_rw_integrity
• function btt_rw_integrity
• function btt_read_pg
• function btt_is_badblock
• function btt_write_pg
• function btt_do_bvec

Annotated Snippet

module_init(nd_btt_init);
module_exit(nd_btt_exit);

Annotation

• Immediate include surface: `linux/highmem.h`, `linux/debugfs.h`, `linux/blkdev.h`, `linux/blk-integrity.h`, `linux/pagemap.h`, `linux/module.h`, `linux/device.h`, `linux/mutex.h`.
• Detected declarations: `enum log_ent_request`, `function adjust_initial_offset`, `function arena_read_bytes`, `function arena_write_bytes`, `function btt_info_write`, `function btt_info_read`, `function __btt_map_write`, `function btt_map_write`, `function btt_map_read`, `function btt_log_group_read`.
• Atlas domain: Driver Families / drivers/nvdimm.
• 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.