[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <CAHp75VdSWMzPCEogUMwkjwSx4e=fhd2a6Mu8RkczEaFhwO=rRw@mail.gmail.com>
Date: Fri, 21 Jun 2019 13:33:18 +0300
From: Andy Shevchenko <andy.shevchenko@...il.com>
To: Mauro Carvalho Chehab <mchehab+samsung@...nel.org>
Cc: Linux Doc Mailing List <linux-doc@...r.kernel.org>,
Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
Mauro Carvalho Chehab <mchehab@...radead.org>,
Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
Jonathan Corbet <corbet@....net>,
"Darren Hart (VMware)" <dvhart@...radead.org>,
Vadim Pasternak <vadimp@...lanox.com>
Subject: Re: [PATCH] ABI: sysfs-driver-mlxreg-io: fix the what fields
On Fri, Jun 21, 2019 at 12:54 PM Mauro Carvalho Chehab
<mchehab+samsung@...nel.org> wrote:
>
> The author of this file should be given an award for creativity:
> the What: fields on this file technically fulfills the description
> at README. Yet, the way it is, it can't be parsed on a script,
> and if someone would try to do something like:
>
> grep hwmon*/jtag_enable
>
> It wouldn't find anything.
>
> Fix the What fields in a way that it can be parseable by a
> script and other search tools.
>
Acked-by: Andy Shevchenko <andy.shevchenko@...il.com>
Thanks, Mauro, for fixing this.
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@...nel.org>
> ---
> .../ABI/stable/sysfs-driver-mlxreg-io | 45 ++++++++-----------
> 1 file changed, 19 insertions(+), 26 deletions(-)
>
> diff --git a/Documentation/ABI/stable/sysfs-driver-mlxreg-io b/Documentation/ABI/stable/sysfs-driver-mlxreg-io
> index 156319fc5b80..3544968f43cc 100644
> --- a/Documentation/ABI/stable/sysfs-driver-mlxreg-io
> +++ b/Documentation/ABI/stable/sysfs-driver-mlxreg-io
> @@ -1,5 +1,4 @@
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - asic_health
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health
>
> Date: June 2018
> KernelVersion: 4.19
> @@ -9,9 +8,8 @@ Description: This file shows ASIC health status. The possible values are:
>
> The files are read only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - cpld1_version
> - cpld2_version
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version
> Date: June 2018
> KernelVersion: 4.19
> Contact: Vadim Pasternak <vadimpmellanox.com>
> @@ -20,8 +18,7 @@ Description: These files show with which CPLD versions have been burned
>
> The files are read only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - fan_dir
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir
>
> Date: December 2018
> KernelVersion: 5.0
> @@ -32,8 +29,7 @@ Description: This file shows the system fans direction:
>
> The files are read only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - jtag_enable
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
>
> Date: November 2018
> KernelVersion: 5.0
> @@ -43,8 +39,7 @@ Description: These files show with which CPLD versions have been burned
>
> The files are read only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - jtag_enable
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
>
> Date: November 2018
> KernelVersion: 5.0
> @@ -87,16 +82,15 @@ Description: These files allow asserting system power cycling, switching
>
> The files are write only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - reset_aux_pwr_or_ref
> - reset_asic_thermal
> - reset_hotswap_or_halt
> - reset_hotswap_or_wd
> - reset_fw_reset
> - reset_long_pb
> - reset_main_pwr_fail
> - reset_short_pb
> - reset_sw_reset
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset
> Date: June 2018
> KernelVersion: 4.19
> Contact: Vadim Pasternak <vadimpmellanox.com>
> @@ -110,11 +104,10 @@ Description: These files show the system reset cause, as following: power
>
> The files are read only.
>
> -What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/
> - reset_comex_pwr_fail
> - reset_from_comex
> - reset_system
> - reset_voltmon_upgrade_fail
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system
> +What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail
>
> Date: November 2018
> KernelVersion: 5.0
> --
> 2.21.0
>
--
With Best Regards,
Andy Shevchenko
Powered by blists - more mailing lists