Re: [PATCH] Rationalise ACPI backlight implementation

From: Matthew Garrett
Date: Sat Jan 26 2008 - 21:06:44 EST


On Thu, Jan 24, 2008 at 04:44:48PM -0500, Len Brown wrote:
> On Tuesday 25 December 2007 21:03, Matthew Garrett wrote:
> > The sysfs backlight class provides no mechanism for querying the
> > acceptable brightness for a backlight. The ACPI spec states that values
> > are only valid if they are reported as available by the firmware. Since
> > we can't provide that information to userspace, instead collapse the
> > range to the number of actual values that can be set.
> >
> > Signed-off-by: Matthew Garrett <mjg59@xxxxxxxxxxxxx>
>
> I wish we did this in the first place.
> But doing it now is an API change -- since
> with the old way 100 always meant 100% brightness, yes?

Yes.

> so my concern is that if we change what "10" means, somebody like akpm
> with an existing script gets grumpy.

I don't buy that argument. Assuming that the values will always result
in an identical brightness is making incorrect assumptions about the
API. For example, consider the case where a bug means that only half the
hardware's available brightness levels are exposed. Fixing that bug
would change the meaning of the numbers, but it's not an API change in
any real way. Anyone using the backlight class should check the
maximum_brightness field before deciding what range of values to use.

--
Matthew Garrett | mjg59@xxxxxxxxxxxxx
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/