drivers/usb/gadget/udc/dummy_hcd.c

File Facts

System

Linux kernel

Corpus path

drivers/usb/gadget/udc/dummy_hcd.c

Extension

.c

Size

75255 bytes

Lines

2940

Domain

Driver Families

Bucket

drivers/usb

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/module.h
• linux/kernel.h
• linux/delay.h
• linux/ioport.h
• linux/slab.h
• linux/string_choices.h
• linux/errno.h
• linux/init.h
• linux/hrtimer.h
• linux/list.h
• linux/interrupt.h
• linux/platform_device.h
• linux/usb.h
• linux/usb/gadget.h
• linux/usb/hcd.h
• linux/scatterlist.h
• asm/byteorder.h
• linux/io.h
• asm/irq.h
• linux/unaligned.h

Detected Declarations

• struct dummy_hcd_module_parameters
• struct dummy_ep
• struct dummy_request
• struct urbp
• struct dummy_hcd
• struct dummy
• enum dummy_rh_state
• function nuke
• function stop_activity
• function set_link_state_by_speed
• function set_link_state
• function some
• function dummy_disable
• function dummy_free_request
• function fifo_complete
• function list_empty
• function dummy_dequeue
• function dummy_set_halt_and_wedge
• function dummy_set_halt
• function dummy_set_wedge
• function dummy_g_get_frame
• function dummy_wakeup
• function dummy_set_selfpowered
• function dummy_udc_update_ep0
• function dummy_pullup
• function dummy_udc_set_speed
• function dummy_udc_async_callbacks
• function synchronize_irq
• function function_show
• function device
• function dummy_udc_stop
• function init_dummy_udc_hw
• function dummy_udc_probe
• function dummy_udc_remove
• function dummy_udc_pm
• function dummy_udc_suspend
• function dummy_udc_resume
• function dummy_get_ep_idx
• function dummy_ep_stream_en
• function get_max_streams_for_pipe
• function set_max_streams_for_pipe
• function dummy_validate_stream
• function dummy_urb_enqueue
• function dummy_urb_dequeue
• function dummy_perform_transfer
• function transfer
• function periodic_bytes
• function handle_control_request

Annotated Snippet

module_init(dummy_hcd_init);

static void __exit dummy_hcd_cleanup(void)
{
	int i;

	for (i = 0; i < mod_data.num; i++) {
		struct dummy *dum;

		dum = *((void **)dev_get_platdata(&the_udc_pdev[i]->dev));

		platform_device_unregister(the_udc_pdev[i]);
		platform_device_unregister(the_hcd_pdev[i]);
		kfree(dum);
	}
	platform_driver_unregister(&dummy_udc_driver);
	platform_driver_unregister(&dummy_hcd_driver);
}
module_exit(dummy_hcd_cleanup);

Annotation

• Immediate include surface: `linux/module.h`, `linux/kernel.h`, `linux/delay.h`, `linux/ioport.h`, `linux/slab.h`, `linux/string_choices.h`, `linux/errno.h`, `linux/init.h`.
• Detected declarations: `struct dummy_hcd_module_parameters`, `struct dummy_ep`, `struct dummy_request`, `struct urbp`, `struct dummy_hcd`, `struct dummy`, `enum dummy_rh_state`, `function nuke`, `function stop_activity`, `function set_link_state_by_speed`.
• Atlas domain: Driver Families / drivers/usb.
• 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.