drivers/firmware/google/gsmi.c

File Facts

System

Linux kernel

Corpus path

drivers/firmware/google/gsmi.c

Extension

.c

Size

29158 bytes

Lines

1097

Domain

Driver Families

Bucket

drivers/firmware

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/kernel.h
• linux/init.h
• linux/types.h
• linux/device.h
• linux/platform_device.h
• linux/errno.h
• linux/string.h
• linux/spinlock.h
• linux/dma-mapping.h
• linux/fs.h
• linux/slab.h
• linux/panic_notifier.h
• linux/ioctl.h
• linux/acpi.h
• linux/io.h
• linux/uaccess.h
• linux/dmi.h
• linux/kdebug.h
• linux/reboot.h
• linux/efi.h
• linux/module.h
• linux/ucs2_string.h
• linux/suspend.h

Detected Declarations

• struct gsmi_buf
• struct gsmi_nvram_var_param
• struct gsmi_get_next_var_param
• struct gsmi_set_eventlog_param
• struct gsmi_log_entry_type_1
• function gsmi_buf_free
• function func
• function gsmi_get_variable
• function gsmi_get_next_variable
• function gsmi_set_variable
• function eventlog_write
• function gsmi_clear_eventlog_store
• function gsmi_clear_config_store
• function gsmi_shutdown_reason
• function gsmi_reboot_callback
• function gsmi_die_callback
• function gsmi_panic_callback
• function hash_64
• function hash_oem_table_id
• function gsmi_system_valid
• function gsmi_log_s0ix_info
• function gsmi_log_s0ix_suspend
• function gsmi_log_s0ix_resume
• function gsmi_platform_driver_probe
• function gsmi_init
• function gsmi_exit
• module init gsmi_init

Annotated Snippet

module_init(gsmi_init);
module_exit(gsmi_exit);

MODULE_AUTHOR("Google, Inc.");
MODULE_DESCRIPTION("EFI SMI interface for Google platforms");
MODULE_LICENSE("GPL");

Annotation

• Immediate include surface: `linux/kernel.h`, `linux/init.h`, `linux/types.h`, `linux/device.h`, `linux/platform_device.h`, `linux/errno.h`, `linux/string.h`, `linux/spinlock.h`.
• Detected declarations: `struct gsmi_buf`, `struct gsmi_nvram_var_param`, `struct gsmi_get_next_var_param`, `struct gsmi_set_eventlog_param`, `struct gsmi_log_entry_type_1`, `function gsmi_buf_free`, `function func`, `function gsmi_get_variable`, `function gsmi_get_next_variable`, `function gsmi_set_variable`.
• Atlas domain: Driver Families / drivers/firmware.
• 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.