drivers/s390/net/ism_drv.c

File Facts

System

Linux kernel

Corpus path

drivers/s390/net/ism_drv.c

Extension

.c

Size

15590 bytes

Lines

721

Domain

Driver Families

Bucket

drivers/s390

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.
• 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/export.h
• linux/module.h
• linux/types.h
• linux/interrupt.h
• linux/device.h
• linux/err.h
• linux/ctype.h
• linux/processor.h
• ism.h

Detected Declarations

• function ism_cmd
• function ism_cmd_simple
• function query_info
• function register_sba
• function register_ieq
• function unregister_sba
• function unregister_ieq
• function ism_read_local_gid
• function ism_query_rgid
• function ism_max_dmbs
• function ism_free_dmb
• function ism_alloc_dmb
• function ism_register_dmb
• function ism_unregister_dmb
• function ism_add_vlan_id
• function ism_del_vlan_id
• function ism_signal_ieq
• function max_bytes
• function ism_move
• function ism_get_chid
• function ism_match_event_type
• function ism_match_event_subtype
• function ism_handle_event
• function ism_handle_irq
• function ism_dev_init
• function ism_dev_exit
• function ism_probe
• function ism_remove
• function ism_init
• function ism_exit
• module init ism_init

Annotated Snippet

static struct pci_driver ism_driver = {
	.name	  = DRV_NAME,
	.id_table = ism_device_table,
	.probe	  = ism_probe,
	.remove	  = ism_remove,
};

static int __init ism_init(void)
{
	int ret;

	ism_debug_info = debug_register("ism", 2, 1, 16);
	if (!ism_debug_info)
		return -ENODEV;

	debug_register_view(ism_debug_info, &debug_hex_ascii_view);
	ret = pci_register_driver(&ism_driver);
	if (ret)
		debug_unregister(ism_debug_info);

	return ret;
}

static void __exit ism_exit(void)
{
	pci_unregister_driver(&ism_driver);
	debug_unregister(ism_debug_info);
}

module_init(ism_init);
module_exit(ism_exit);

Annotation

• Immediate include surface: `linux/export.h`, `linux/module.h`, `linux/types.h`, `linux/interrupt.h`, `linux/device.h`, `linux/err.h`, `linux/ctype.h`, `linux/processor.h`.
• Detected declarations: `function ism_cmd`, `function ism_cmd_simple`, `function query_info`, `function register_sba`, `function register_ieq`, `function unregister_sba`, `function unregister_ieq`, `function ism_read_local_gid`, `function ism_query_rgid`, `function ism_max_dmbs`.
• Atlas domain: Driver Families / drivers/s390.
• Implementation status: pattern implementation candidate.
• 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.