Re: [PATCH] ABI: sysfs-driver-mlxreg-io: fix the what fields

[Andy Shevchenko]

On Fri, Jun 21, 2019 at 12:54 PM Mauro Carvalho Chehab
<mchehab+samsung@xxxxxxxxxx> 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@xxxxxxxxx>

Thanks, Mauro, for fixing this.

> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx>
> ---
>  .../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