drivers/media/v4l2-core/v4l2-async.c

File Facts

System

Linux kernel

Corpus path

drivers/media/v4l2-core/v4l2-async.c

Extension

.c

Size

24418 bytes

Lines

994

Domain

Driver Families

Bucket

drivers/media

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/debugfs.h
• linux/device.h
• linux/err.h
• linux/i2c.h
• linux/list.h
• linux/mm.h
• linux/module.h
• linux/mutex.h
• linux/of.h
• linux/platform_device.h
• linux/seq_file.h
• linux/slab.h
• linux/types.h
• media/v4l2-async.h
• media/v4l2-device.h
• media/v4l2-fwnode.h
• media/v4l2-subdev.h
• v4l2-subdev-priv.h

Detected Declarations

• function Copyright
• function v4l2_async_nf_call_unbind
• function v4l2_async_nf_call_complete
• function v4l2_async_nf_call_destroy
• function match_i2c
• function match_fwnode_one
• function match_fwnode
• function list_for_each_entry
• function v4l2_async_find_match
• function list_for_each_entry
• function v4l2_async_match_equal
• function v4l2_async_find_subdev_notifier
• function v4l2_async_nf_find_v4l2_dev
• function v4l2_async_nf_can_complete
• function list_for_each_entry
• function v4l2_async_nf_try_complete
• function v4l2_async_create_ancillary_links
• function v4l2_async_match_notify
• function v4l2_async_nf_try_subdev_notifier
• function v4l2_async_nf_try_all_subdevs
• function v4l2_async_unbind_subdev_one
• function v4l2_async_nf_unbind_all_subdevs
• function list_for_each_entry_safe
• function v4l2_async_nf_has_async_match_entry
• function v4l2_async_nf_has_async_match
• function list_for_each_entry
• function v4l2_async_nf_match_valid
• function v4l2_async_nf_init
• function v4l2_async_subdev_nf_init
• function __v4l2_async_nf_register
• function list_for_each_entry
• function v4l2_async_nf_register
• function __v4l2_async_nf_unregister
• function v4l2_async_nf_unregister
• function __v4l2_async_nf_cleanup
• function list_for_each_entry_safe
• function v4l2_async_nf_cleanup
• function __v4l2_async_nf_add_connection
• function __v4l2_async_nf_add_fwnode
• function __v4l2_async_nf_add_fwnode_remote
• function __v4l2_async_nf_add_i2c
• function v4l2_async_subdev_endpoint_add
• function v4l2_async_connection_unique
• function __v4l2_async_register_subdev
• function list_for_each_entry
• function v4l2_async_unregister_subdev
• function print_waiting_match
• function v4l2_async_nf_name

Annotated Snippet

subsys_initcall(v4l2_async_init);
module_exit(v4l2_async_exit);

MODULE_AUTHOR("Guennadi Liakhovetski <g.liakhovetski@gmx.de>");
MODULE_AUTHOR("Sakari Ailus <sakari.ailus@linux.intel.com>");
MODULE_AUTHOR("Ezequiel Garcia <ezequiel@collabora.com>");
MODULE_DESCRIPTION("V4L2 asynchronous subdevice registration API");
MODULE_LICENSE("GPL");

Annotation

• Immediate include surface: `linux/debugfs.h`, `linux/device.h`, `linux/err.h`, `linux/i2c.h`, `linux/list.h`, `linux/mm.h`, `linux/module.h`, `linux/mutex.h`.
• Detected declarations: `function Copyright`, `function v4l2_async_nf_call_unbind`, `function v4l2_async_nf_call_complete`, `function v4l2_async_nf_call_destroy`, `function match_i2c`, `function match_fwnode_one`, `function match_fwnode`, `function list_for_each_entry`, `function v4l2_async_find_match`, `function list_for_each_entry`.
• Atlas domain: Driver Families / drivers/media.
• 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.