linux-kernel - Re: [PATCH 3/3] iio: Add relative hysteresis in ABI documentation

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]

Date:   Sat, 6 Feb 2021 16:46:34 +0000
From:   Jonathan Cameron <jic23@...nel.org>
To:     Ye Xiang <xiang.ye@...el.com>
Cc:     jikos@...nel.org, srinivas.pandruvada@...ux.intel.com,
        linux-input@...r.kernel.org, linux-iio@...r.kernel.org,
        linux-kernel@...r.kernel.org
Subject: Re: [PATCH 3/3] iio: Add relative hysteresis in ABI documentation

On Mon,  1 Feb 2021 15:43:58 +0800
Ye Xiang <xiang.ye@...el.com> wrote:

> Add relative hysteresis in ABI documentation.
> 
> Signed-off-by: Ye Xiang <xiang.ye@...el.com>
> ---
>  Documentation/ABI/testing/sysfs-bus-iio | 8 ++++++++
>  1 file changed, 8 insertions(+)
> 
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
> index d957f5da5c04..1c51db7eb8ef 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio
> +++ b/Documentation/ABI/testing/sysfs-bus-iio
> @@ -1823,3 +1823,11 @@ Description:
>  		hinge, keyboard, screen. It means the three channels
>  		each correspond respectively to hinge angle, keyboard angle,
>  		and screen angle.
> +
> +What:		/sys/bus/iio/devices/iio:deviceX/in_Y_hysteresis_relative

I'm rather undecided on whether a generic catch all for sensor types here makes
sense. Given we aren't currently applying it to too many devices, I think
I'd prefer we documented this for the particular entries we are adding as
that is the approach that we've taken for the majority of the rest of the
main ABI doc.   Note that tidying this doc up has been something I've wanted
to look at doing for a while, so it's possible I'll revisit this decision
at that time.

Otherwise, this looks good.

Thanks,

Jonathan


> +KernelVersion:	5.12
> +Contact:	linux-iio@...r.kernel.org
> +Description:
> +		Specify the percent relative to the current sensor channel
> +		Y absolute value that a data field should change before an event
> +		is generated. Units are a percentage of the prior reading.