drivers/s390/cio/cmf.c

File Facts

System

Linux kernel

Corpus path

drivers/s390/cio/cmf.c

Extension

.c

Size

32358 bytes

Lines

1304

Domain

Driver Families

Bucket

drivers/s390

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/memblock.h
• linux/device.h
• linux/init.h
• linux/list.h
• linux/export.h
• linux/moduleparam.h
• linux/slab.h
• linux/timex.h
• asm/ccwdev.h
• asm/cio.h
• asm/cmb.h
• asm/div64.h
• cio.h
• css.h
• device.h
• ioasm.h
• chsc.h

Detected Declarations

• struct cmb_operations
• struct cmb_data
• struct set_schib_struct
• struct copy_block_struct
• struct cmb_area
• struct cmb
• struct cmbe
• enum cmb_index
• enum cmb_format
• function time_to_nsec
• function time_to_avg_nsec
• function cmf_activate
• function set_schib
• function set_schib_wait
• function retry_set_schib
• function cmf_copy_block
• function cmf_cmb_copy_wait
• function cmf_retry_copy_block
• function cmf_generic_reset
• function alloc_cmb_single
• function alloc_cmb
• function free_cmb
• function set_cmb
• function __cmb_utilization
• function read_cmb
• function readall_cmb
• function reset_cmb
• function cmf_enabled
• function alloc_cmbe
• function free_cmbe
• function set_cmbe
• function read_cmbe
• function readall_cmbe
• function reset_cmbe
• function cmb_show_attr
• function cmb_show_avg_sample_interval
• function cmb_show_avg_utilization
• function cmb_enable_show
• function cmb_enable_store
• function enable_cmf
• function __disable_cmf
• function disable_cmf
• function cmf_read
• function cmf_readall
• function cmf_reenable
• function cmf_reactivate
• function init_cmbe
• function init_cmf

Annotated Snippet

device_initcall(init_cmf);

EXPORT_SYMBOL_GPL(enable_cmf);
EXPORT_SYMBOL_GPL(disable_cmf);
EXPORT_SYMBOL_GPL(cmf_read);
EXPORT_SYMBOL_GPL(cmf_readall);

Annotation

• Immediate include surface: `linux/memblock.h`, `linux/device.h`, `linux/init.h`, `linux/list.h`, `linux/export.h`, `linux/moduleparam.h`, `linux/slab.h`, `linux/timex.h`.
• Detected declarations: `struct cmb_operations`, `struct cmb_data`, `struct set_schib_struct`, `struct copy_block_struct`, `struct cmb_area`, `struct cmb`, `struct cmbe`, `enum cmb_index`, `enum cmb_format`, `function time_to_nsec`.
• Atlas domain: Driver Families / drivers/s390.
• 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.