drivers/md/dm-cache-policy-smq.c

File Facts

System

Linux kernel

Corpus path

drivers/md/dm-cache-policy-smq.c

Extension

.c

Size

46128 bytes

Lines

1975

Domain

Driver Families

Bucket

drivers/md

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

• dm-cache-background-tracker.h
• dm-cache-policy-internal.h
• dm-cache-policy.h
• dm.h
• linux/hash.h
• linux/jiffies.h
• linux/module.h
• linux/mutex.h
• linux/vmalloc.h
• linux/math64.h

Detected Declarations

• struct entry
• struct entry_space
• struct ilist
• struct queue
• struct stats
• struct smq_hash_table
• struct entry_alloc
• struct smq_policy
• enum performance
• enum promote_result
• function safe_div
• function safe_mod
• function space_init
• function space_exit
• function to_index
• function l_init
• function l_empty
• function l_add_head
• function l_add_tail
• function l_add_before
• function l_del
• function q_init
• function q_size
• function q_push
• function q_push_front
• function q_push_before
• function q_del
• function q_set_targets_subrange_
• function q_set_targets
• function q_redistribute
• function q_requeue
• function stats_init
• function stats_reset
• function stats_level_accessed
• function stats_miss
• function stats_assess
• function h_init
• function h_exit
• function __h_insert
• function h_insert
• function __h_unlink
• function h_remove
• function init_allocator
• function init_entry
• function free_entry
• function allocator_empty
• function get_index
• function __update_writeback_sentinels

Annotated Snippet

module_init(smq_init);
module_exit(smq_exit);

MODULE_AUTHOR("Joe Thornber <dm-devel@lists.linux.dev>");
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("smq cache policy");

MODULE_ALIAS("dm-cache-default");
MODULE_ALIAS("dm-cache-mq");
MODULE_ALIAS("dm-cache-cleaner");

Annotation

• Immediate include surface: `dm-cache-background-tracker.h`, `dm-cache-policy-internal.h`, `dm-cache-policy.h`, `dm.h`, `linux/hash.h`, `linux/jiffies.h`, `linux/module.h`, `linux/mutex.h`.
• Detected declarations: `struct entry`, `struct entry_space`, `struct ilist`, `struct queue`, `struct stats`, `struct smq_hash_table`, `struct entry_alloc`, `struct smq_policy`, `enum performance`, `enum promote_result`.
• Atlas domain: Driver Families / drivers/md.
• 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.