linux/include/acpi
Lance Ortiz d1efe3c324 ACPI: Add new sysfs interface to export device description
Add support to export the device description obtained from the ACPI _STR
method, if one exists for a device, to user-space via a sysfs interface.
This new interface provides a standard and platform neutral way for users
to obtain the description text stored in the ACPI _STR method.  If no
_STR method exists for the device, no sysfs 'description' file will be
created.  The 'description' file will be located in the /sys/devices/
directory using the device's path.

/sys/device/<bus>/<bridge path>/<device path>.../firmware_node/description

Example:

/sys/devices/pci0000:00/0000:00.07.0/0000:0e:00.0/firmware_node/description

It can also be located using the ACPI device path, for example:

/sys/devices/LNXSYSTM:00/device:00/ACPI0004:00/PNP0A08:00/device:13/device:15/description
/sys/devices/LNXSYSTM:00/device:00/ACPI0004:00/ACPI0004:01/ACPI0007:02/description

Execute the 'cat' command on the 'description' file to obtain the
description string for that device.

This patch also includes documentation describing how the new sysfs
interface works

Changes from v1-v2 based on comments by Len Brown and Fengguang Wu
* Removed output "No Description" and leaving a NULL attribute if the
_STR method failed to evaluate.

* In acpi_device_remove_files() removed the redundent check of
dev->pnp.str_obj before calling free.  This check triggered a message
from smatch.

Signed-off-by: Lance Ortiz <lance.ortiz@hp.com>
Signed-off-by: Len Brown <len.brown@intel.com>
2012-10-06 15:52:16 -04:00
..
platform ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
acconfig.h ACPICA: Support for custom ACPICA build for ACPI 5 reduced hardware 2012-03-22 01:44:49 -04:00
acexcep.h ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
acnames.h Merge branch 'release' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux 2012-07-26 14:28:55 -07:00
acoutput.h ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
acpi_bus.h ACPI: Add new sysfs interface to export device description 2012-10-06 15:52:16 -04:00
acpi_drivers.h ACPI: Fix CONFIG_ACPI_DOCK=n compiler warning 2011-11-06 20:58:17 -05:00
acpi_numa.h ACPI: Store SRAT table revision 2012-01-17 04:19:04 -05:00
acpi.h ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
acpiosxf.h ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
acpixf.h ACPI: delete _GTS/_BFS support 2012-07-30 21:11:25 -04:00
acrestyp.h ACPICA: AcpiSrc: Fix some translation issues for Linux conversion 2012-07-17 00:05:51 -04:00
actbl1.h ACPICA: AcpiSrc: Fix some translation issues for Linux conversion 2012-07-17 00:05:51 -04:00
actbl2.h ACPICA: AcpiSrc: Fix some translation issues for Linux conversion 2012-07-17 00:05:51 -04:00
actbl3.h ACPICA: Update header files copyrights to 2012 2012-07-17 00:05:50 -04:00
actbl.h ACPICA: AcpiSrc: Fix some translation issues for Linux conversion 2012-07-17 00:05:51 -04:00
actypes.h ACPI: delete _GTS/_BFS support 2012-07-30 21:11:25 -04:00
apei.h module_param: make bool parameters really bool (drivers & misc) 2012-01-13 09:32:20 +10:30
button.h ACPI: make ACPI button funcs no-ops if not built in 2009-09-17 14:48:23 -07:00
container.h
hed.h ACPI Hardware Error Device (PNP0C33) support 2010-05-19 22:40:24 -04:00
pdc_intel.h ACPI: Enable bit 11 in _PDC to advertise hw coord 2009-02-07 00:41:14 -05:00
processor.h Merge branch 'pm-acpi' 2012-07-19 00:03:35 +02:00
reboot.h Add the ability to reset the machine using the RESET_REG in ACPI's FADT table. 2008-07-16 23:27:08 +02:00
video.h i915: Fix opregion notifications 2011-07-13 11:19:47 -07:00