linux/include/acpi
Andy Shevchenko 81eeb2f577 ACPI: utils: Document for_each_acpi_dev_match() macro
The macro requires to call acpi_dev_put() on each iteration.
Due to this it doesn't tolerate sudden disappearence of the devices.

Document all these nuances to prevent users blindly call it without
understanding the possible issues.

While at it, add the note to the acpi_dev_get_next_match_dev() and
advertise acpi_dev_put() instead of put_device() in the whole family
of the helper functions.

Fixes: bf263f64e8 ("media: ACPI / bus: Add acpi_dev_get_next_match_dev() and helper macro")
Signed-off-by: Andy Shevchenko <andy.shevchenko@gmail.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
2021-04-13 15:48:02 +02:00
..
platform ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acbuffer.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acconfig.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acexcep.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acnames.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acoutput.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acpi_bus.h ACPI: utils: Document for_each_acpi_dev_match() macro 2021-04-13 15:48:02 +02:00
acpi_drivers.h ACPI: thermal: Clean up printing messages 2021-02-04 19:45:46 +01:00
acpi_io.h ACPI: OSL: Change the type of acpi_os_map_generic_address() return value 2020-09-11 16:45:00 +02:00
acpi_lpat.h treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 174 2019-05-30 11:26:41 -07:00
acpi_numa.h ACPI / NUMA: add a stub function for node_to_pxm() 2021-02-11 08:47:06 +00:00
acpi.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acpiosxf.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acpixf.h ACPICA: Update version to 20210105 2021-01-22 15:51:53 +01:00
acrestyp.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
actbl1.h IOMMU Updates for Linux v5.12 2021-02-22 10:31:29 -08:00
actbl2.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
actbl3.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
actbl.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
actypes.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
acuuid.h ACPICA: Updated all copyrights to 2021 2021-01-22 15:51:53 +01:00
apei.h Merge branches 'acpi-pmic', 'acpi-apei' and 'acpi-x86' 2017-11-13 01:37:17 +01:00
battery.h ACPI: battery: include linux/power_supply.h 2020-09-25 18:31:19 +02:00
button.h ACPI: button: move HIDs to acpi/button.h 2020-02-13 23:36:23 +01:00
cppc_acpi.h ACPI: CPPC: remove __iomem annotation for cpc_reg's address 2021-01-22 16:28:19 +01:00
ghes.h ACPI / APEI: Add a notifier chain for unknown (vendor) CPER records 2020-09-16 10:30:42 +01:00
hed.h treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 428 2019-06-05 17:37:16 +02:00
nfit.h acpi, nfit: Add function to look up nvdimm device and provide SMBIOS handle 2018-03-14 12:43:50 +01:00
pcc.h treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 441 2019-06-05 17:37:17 +02:00
pdc_intel.h License cleanup: add SPDX GPL-2.0 license identifier to files with no license 2017-11-02 11:10:55 +01:00
processor.h x86: ACPI: fix CPU hotplug deadlock 2020-04-04 16:28:24 +02:00
reboot.h License cleanup: add SPDX GPL-2.0 license identifier to files with no license 2017-11-02 11:10:55 +01:00
video.h License cleanup: add SPDX GPL-2.0 license identifier to files with no license 2017-11-02 11:10:55 +01:00