drivers/macintosh/smu.c

File Facts

System

Linux kernel

Corpus path

drivers/macintosh/smu.c

Extension

.c

Size

31128 bytes

Lines

1333

Domain

Driver Families

Bucket

drivers/macintosh

Inferred role

Driver Families: operation-table or driver-model contract

Status

pattern 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.
• Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
• Touches user memory; correctness depends on fault-safe copying and privilege boundary handling.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• 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/types.h
• linux/kernel.h
• linux/device.h
• linux/dmapool.h
• linux/memblock.h
• linux/vmalloc.h
• linux/highmem.h
• linux/jiffies.h
• linux/interrupt.h
• linux/rtc.h
• linux/completion.h
• linux/miscdevice.h
• linux/delay.h
• linux/poll.h
• linux/mutex.h
• linux/of.h
• linux/of_address.h
• linux/of_irq.h
• linux/of_platform.h
• linux/platform_device.h
• linux/slab.h
• linux/sched/signal.h
• asm/byteorder.h
• asm/io.h
• asm/machdep.h
• asm/pmac_feature.h
• asm/smu.h
• asm/sections.h
• linux/uaccess.h

Detected Declarations

• struct smu_cmd_buf
• struct smu_device
• struct smu_private
• enum smu_file_mode
• function smu_start_cmd
• function smu_db_intr
• function smu_msg_intr
• function smu_queue_cmd
• function smu_queue_simple
• function smu_poll
• function smu_done_complete
• function smu_spinwait_cmd
• function bcd2hex
• function hex2bcd
• function smu_fill_set_rtc_cmd
• function smu_get_rtc_time
• function smu_set_rtc_time
• function smu_shutdown
• function smu_restart
• function smu_present
• function smu_init
• function smu_late_init
• function smu_expose_childs
• function smu_platform_probe
• function smu_init_sysfs
• function smu_i2c_complete_command
• function smu_i2c_retry
• function smu_i2c_low_completion
• function smu_queue_i2c
• function smu_read_datablock
• function smu_open
• function smu_user_cmd_done
• function smu_write
• function smu_read_command
• function smu_read_events
• function smu_read
• function smu_fpoll
• function smu_release
• function smu_device_init
• module init smu_late_init
• module init smu_init_sysfs
• module init smu_device_init
• export smu_queue_cmd
• export smu_queue_simple
• export smu_poll
• export smu_done_complete
• export smu_spinwait_cmd
• export smu_present

Annotated Snippet

static const struct file_operations smu_device_fops = {
	.read		= smu_read,
	.write		= smu_write,
	.poll		= smu_fpoll,
	.open		= smu_open,
	.release	= smu_release,
};

static struct miscdevice pmu_device = {
	MISC_DYNAMIC_MINOR, "smu", &smu_device_fops
};

static int smu_device_init(void)
{
	if (!smu)
		return -ENODEV;
	if (misc_register(&pmu_device) < 0)
		printk(KERN_ERR "via-pmu: cannot register misc device.\n");
	return 0;
}
device_initcall(smu_device_init);

Annotation

• Immediate include surface: `linux/types.h`, `linux/kernel.h`, `linux/device.h`, `linux/dmapool.h`, `linux/memblock.h`, `linux/vmalloc.h`, `linux/highmem.h`, `linux/jiffies.h`.
• Detected declarations: `struct smu_cmd_buf`, `struct smu_device`, `struct smu_private`, `enum smu_file_mode`, `function smu_start_cmd`, `function smu_db_intr`, `function smu_msg_intr`, `function smu_queue_cmd`, `function smu_queue_simple`, `function smu_poll`.
• Atlas domain: Driver Families / drivers/macintosh.
• Implementation status: pattern implementation candidate.
• This snippet crosses the user/kernel memory boundary; validate fault handling and access checks before translating the pattern.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

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.