ACPI: thinkpad-acpi: warn once about weird hotkey masks
commitbdebd1ba9bfeb2bb276c665a330a74bc0782d174
authorHenrique de Moraes Holschuh <hmh@hmh.eng.br>
Tue, 26 Feb 2008 01:13:12 +0000 (25 22:13 -0300)
committerHenrique de Moraes Holschuh <hmh@hmh.eng.br>
Fri, 21 Mar 2008 04:35:27 +0000 (21 01:35 -0300)
tree7ea6baf84ffb9f6ffa66a8f3e0e231009e167638
parent51ff8420af6a0db272c15db0fd89e2df4455c4ab
ACPI: thinkpad-acpi: warn once about weird hotkey masks

thinkpad-acpi knows for a while now how to best program the hotkeys by
default, and always enable them by default.  Unfortunately, this
information has not filtered down everywhere it needs to, yet.  Notably,
old ibm-acpi documentation and most "thinkpad setup guides" will have wrong
information on this area.

Warn the local admin once whenever any of the following patterns are met:

1. Attempts to set hotkey mask to 0xffff (artifact from docs and config
   for the old ibm-acpi driver and behaviour).  This mask makes no
   real-world sense;

2. Attempts to set hotkey mask to 0xffffffff, which means the user is
   trying to just have "everything work" without even reading the
   documentation, or that we need to get a bug report, because there
   is a new thinkpad out there with new exciting hot keys :-)

3. Attempts to set hotkey mask to 0xffffff, which is almost never the
   correct way to set up volume and brightness event reporting (and with
   the current state-of-the-art, it is known to never be right way to do
   it).

The driver will perform any and all requested operations, though,
regardless of any warnings.  I hope these warnings can be removed one or
two years from now.

Signed-off-by: Henrique de Moraes Holschuh <hmh@hmh.eng.br>
drivers/misc/thinkpad_acpi.c