linux-kernel - Re: [PATCH 3/5] backlight: lm3639: document sysfs attributes

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20180131113423.v56373pepryyvl5x@oak.lan>
Date:   Wed, 31 Jan 2018 11:34:23 +0000
From:   Daniel Thompson <daniel.thompson@...aro.org>
To:     Aishwarya Pant <aishpant@...il.com>
Cc:     Lee Jones <lee.jones@...aro.org>,
        Jingoo Han <jingoohan1@...il.com>,
        Bartlomiej Zolnierkiewicz <b.zolnierkie@...sung.com>,
        dri-devel@...ts.freedesktop.org, linux-fbdev@...r.kernel.org,
        linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>,
        Greg KH <gregkh@...uxfoundation.org>,
        Julia Lawall <julia.lawall@...6.fr>
Subject: Re: [PATCH 3/5] backlight: lm3639: document sysfs attributes

On Fri, Jan 26, 2018 at 08:23:57PM +0530, Aishwarya Pant wrote:
> Add documentation for sysfs interfaces of Texas Instruments lm3639
> backlight + flash led driver chip by looking through git commits and
> reading code.
> 
> Signed-off-by: Aishwarya Pant <aishpant@...il.com>
> ---
>  Documentation/ABI/testing/sysfs-class-backlight-lm3639 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
>  create mode 100644 Documentation/ABI/testing/sysfs-class-backlight-lm3639
> 
> diff --git a/Documentation/ABI/testing/sysfs-class-backlight-lm3639 b/Documentation/ABI/testing/sysfs-class-backlight-lm3639
> new file mode 100644
> index 000000000000..ec87dc8f4395
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-class-backlight-lm3639
> @@ -0,0 +1,13 @@
> +sysfs interface for Texas Instruments lm3639 backlight + flash led driver chip
> +------------------------------------------------------------------------------
> +
> +What:		/sys/class/backlight/<backlight>/bled_mode
> +Date:		Oct, 2012
> +KernelVersion:	v3.10
> +Contact:	Lee Jones <lee.jones@...aro.org>,
> +		Daniel Thompson <daniel.thompson@...aro.org>,
> +		Jingoo Han <jingoohan1@...il.com>

We've recently added a ML to MAINTAINERS (see
https://patchwork.kernel.org/patch/10169327/ ). I think a better Contact
might simply be:

Contact:	dri-devel@...ts.freedesktop.org


> +Description:
> +		(WO) Write to the backlight mapping mode. The backlight current
> +		can be mapped for either exponential (value "0") or linear
> +		mapping modes (default).

The ambiguity of meaning w.r.t. linear or exponential is something of a thorn in 
the side of backlight... and so long as that ambiguity remains this
control is something the userspace may want to poke (albeit only once
during boot).

If you repost with an updated contact then please add my ack for this patch:
Acked-by: Daniel Thompson <daniel.thompson@...aro.org>


Daniel.