arch/powerpc/platforms/pseries/papr_scm.c

File Facts

System

Linux kernel

Corpus path

arch/powerpc/platforms/pseries/papr_scm.c

Extension

.c

Size

40236 bytes

Lines

1544

Domain

Architecture Layer

Bucket

arch/powerpc

Inferred role

Architecture Layer: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.

• CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
• 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/of.h
• linux/kernel.h
• linux/module.h
• linux/ioport.h
• linux/seq_file.h
• linux/slab.h
• linux/sysfs.h
• linux/ndctl.h
• linux/sched.h
• linux/libnvdimm.h
• linux/platform_device.h
• linux/delay.h
• linux/seq_buf.h
• linux/nd.h
• asm/plpar_wrappers.h
• uapi/linux/papr_pdsm.h
• linux/papr_scm.h
• asm/mce.h
• linux/unaligned.h
• linux/perf_event.h

Detected Declarations

• struct papr_scm_perf_stat
• struct papr_scm_perf_stats
• struct papr_scm_priv
• struct pdsm_cmd_desc
• function papr_scm_pmem_flush
• function drc_pmem_bind
• function drc_pmem_unbind
• function drc_pmem_query_n_bind
• function them
• function papr_scm_pmu_get_value
• function papr_scm_pmu_event_init
• function papr_scm_pmu_add
• function papr_scm_pmu_read
• function papr_scm_pmu_del
• function papr_scm_pmu_register
• function papr_scm_pmu_register
• function drc_pmem_query_health
• function papr_scm_meta_get
• function papr_scm_meta_set
• function is_cmd_valid
• function papr_pdsm_fuel_gauge
• function papr_pdsm_dsc
• function papr_pdsm_health
• function papr_pdsm_smart_inject
• function papr_scm_service_pdsm
• function papr_scm_ndctl
• function health_bitmap_inject_show
• function perf_stats_show
• function flags_show
• function dirty_shutdown_show
• function papr_nd_attribute_visible
• function papr_scm_nvdimm_init
• function papr_scm_add_badblock
• function handle_mce_ue
• function papr_scm_probe
• function papr_scm_remove
• function papr_scm_init
• function papr_scm_exit
• module init papr_scm_init

Annotated Snippet

module_init(papr_scm_init);

static void __exit papr_scm_exit(void)
{
	mce_unregister_notifier(&mce_ue_nb);
	platform_driver_unregister(&papr_scm_driver);
}
module_exit(papr_scm_exit);

MODULE_DEVICE_TABLE(of, papr_scm_match);
MODULE_DESCRIPTION("PAPR Storage Class Memory interface driver");
MODULE_LICENSE("GPL");
MODULE_AUTHOR("IBM Corporation");

Annotation

• Immediate include surface: `linux/of.h`, `linux/kernel.h`, `linux/module.h`, `linux/ioport.h`, `linux/seq_file.h`, `linux/slab.h`, `linux/sysfs.h`, `linux/ndctl.h`.
• Detected declarations: `struct papr_scm_perf_stat`, `struct papr_scm_perf_stats`, `struct papr_scm_priv`, `struct pdsm_cmd_desc`, `function papr_scm_pmem_flush`, `function drc_pmem_bind`, `function drc_pmem_unbind`, `function drc_pmem_query_n_bind`, `function them`, `function papr_scm_pmu_get_value`.
• Atlas domain: Architecture Layer / arch/powerpc.
• 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.