Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

ABI: fix some syntax issues at the ABI database

On those three files, the ABI representation described at
README are violated.

- at sysfs-bus-iio-proximity-as3935:
a ':' character is missing after "What"

- at sysfs-class-devfreq:
there's a typo at Description

- at sysfs-class-cxl, it is using the ":" character at a
file preamble, causing it to be misinterpreted as a
tag.

- On the other files, instead of "What", they use "Where".

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Acked-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Acked-by: Andrew Donnellan <ajd@linux.ibm.com> # cxl
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Mauro Carvalho Chehab and committed by
Greg Kroah-Hartman
ed66bcd0 dad4afe7

+33 -33
+1 -1
Documentation/ABI/testing/pstore
··· 1 - Where: /sys/fs/pstore/... (or /dev/pstore/...) 1 + What: /sys/fs/pstore/... (or /dev/pstore/...) 2 2 Date: March 2011 3 3 Kernel Version: 2.6.39 4 4 Contact: tony.luck@intel.com
+1 -1
Documentation/ABI/testing/sysfs-bus-event_source-devices-format
··· 1 - Where: /sys/bus/event_source/devices/<dev>/format 1 + What: /sys/bus/event_source/devices/<dev>/format 2 2 Date: January 2012 3 3 Kernel Version: 3.3 4 4 Contact: Jiri Olsa <jolsa@redhat.com>
+3 -3
Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352
··· 1 - Where: /sys/bus/i2c/devices/.../heading0_input 1 + What: /sys/bus/i2c/devices/.../heading0_input 2 2 Date: April 2010 3 3 Kernel Version: 2.6.36? 4 4 Contact: alan.cox@intel.com 5 5 Description: Reports the current heading from the compass as a floating 6 6 point value in degrees. 7 7 8 - Where: /sys/bus/i2c/devices/.../power_state 8 + What: /sys/bus/i2c/devices/.../power_state 9 9 Date: April 2010 10 10 Kernel Version: 2.6.36? 11 11 Contact: alan.cox@intel.com 12 12 Description: Sets the power state of the device. 0 sets the device into 13 13 sleep mode, 1 wakes it up. 14 14 15 - Where: /sys/bus/i2c/devices/.../calibration 15 + What: /sys/bus/i2c/devices/.../calibration 16 16 Date: April 2010 17 17 Kernel Version: 2.6.36? 18 18 Contact: alan.cox@intel.com
+2 -2
Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
··· 1 - What /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity 1 + What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity 2 2 Date: January 2017 3 3 KernelVersion: 4.11 4 4 Contact: linux-iio@vger.kernel.org ··· 6 6 Show or set the gain boost of the amp, from 0-31 range. 7 7 default 31 8 8 9 - What /sys/bus/iio/devices/iio:deviceX/sensor_max_range 9 + What: /sys/bus/iio/devices/iio:deviceX/sensor_max_range 10 10 Date: January 2017 11 11 KernelVersion: 4.11 12 12 Contact: linux-iio@vger.kernel.org
+2 -2
Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935
··· 1 - What /sys/bus/iio/devices/iio:deviceX/in_proximity_input 1 + What: /sys/bus/iio/devices/iio:deviceX/in_proximity_input 2 2 Date: March 2014 3 3 KernelVersion: 3.15 4 4 Contact: Matt Ranostay <matt.ranostay@konsulko.com> ··· 6 6 Get the current distance in meters of storm (1km steps) 7 7 1000-40000 = distance in meters 8 8 9 - What /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity 9 + What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity 10 10 Date: March 2014 11 11 KernelVersion: 3.15 12 12 Contact: Matt Ranostay <matt.ranostay@konsulko.com>
+11 -11
Documentation/ABI/testing/sysfs-bus-pci-devices-cciss
··· 1 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/model 1 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/model 2 2 Date: March 2009 3 3 Kernel Version: 2.6.30 4 4 Contact: iss_storagedev@hp.com 5 5 Description: Displays the SCSI INQUIRY page 0 model for logical drive 6 6 Y of controller X. 7 7 8 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/rev 8 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/rev 9 9 Date: March 2009 10 10 Kernel Version: 2.6.30 11 11 Contact: iss_storagedev@hp.com 12 12 Description: Displays the SCSI INQUIRY page 0 revision for logical 13 13 drive Y of controller X. 14 14 15 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/unique_id 15 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/unique_id 16 16 Date: March 2009 17 17 Kernel Version: 2.6.30 18 18 Contact: iss_storagedev@hp.com 19 19 Description: Displays the SCSI INQUIRY page 83 serial number for logical 20 20 drive Y of controller X. 21 21 22 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/vendor 22 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/vendor 23 23 Date: March 2009 24 24 Kernel Version: 2.6.30 25 25 Contact: iss_storagedev@hp.com 26 26 Description: Displays the SCSI INQUIRY page 0 vendor for logical drive 27 27 Y of controller X. 28 28 29 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/block:cciss!cXdY 29 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/block:cciss!cXdY 30 30 Date: March 2009 31 31 Kernel Version: 2.6.30 32 32 Contact: iss_storagedev@hp.com 33 33 Description: A symbolic link to /sys/block/cciss!cXdY 34 34 35 - Where: /sys/bus/pci/devices/<dev>/ccissX/rescan 35 + What: /sys/bus/pci/devices/<dev>/ccissX/rescan 36 36 Date: August 2009 37 37 Kernel Version: 2.6.31 38 38 Contact: iss_storagedev@hp.com 39 39 Description: Kicks of a rescan of the controller to discover logical 40 40 drive topology changes. 41 41 42 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/lunid 42 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/lunid 43 43 Date: August 2009 44 44 Kernel Version: 2.6.31 45 45 Contact: iss_storagedev@hp.com 46 46 Description: Displays the 8-byte LUN ID used to address logical 47 47 drive Y of controller X. 48 48 49 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/raid_level 49 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/raid_level 50 50 Date: August 2009 51 51 Kernel Version: 2.6.31 52 52 Contact: iss_storagedev@hp.com 53 53 Description: Displays the RAID level of logical drive Y of 54 54 controller X. 55 55 56 - Where: /sys/bus/pci/devices/<dev>/ccissX/cXdY/usage_count 56 + What: /sys/bus/pci/devices/<dev>/ccissX/cXdY/usage_count 57 57 Date: August 2009 58 58 Kernel Version: 2.6.31 59 59 Contact: iss_storagedev@hp.com 60 60 Description: Displays the usage count (number of opens) of logical drive Y 61 61 of controller X. 62 62 63 - Where: /sys/bus/pci/devices/<dev>/ccissX/resettable 63 + What: /sys/bus/pci/devices/<dev>/ccissX/resettable 64 64 Date: February 2011 65 65 Kernel Version: 2.6.38 66 66 Contact: iss_storagedev@hp.com ··· 71 71 a dump device, as kdump requires resetting the device in order 72 72 to work reliably. 73 73 74 - Where: /sys/bus/pci/devices/<dev>/ccissX/transport_mode 74 + What: /sys/bus/pci/devices/<dev>/ccissX/transport_mode 75 75 Date: July 2011 76 76 Kernel Version: 3.0 77 77 Contact: iss_storagedev@hp.com
+6 -6
Documentation/ABI/testing/sysfs-bus-usb-devices-usbsevseg
··· 1 - Where: /sys/bus/usb/.../powered 1 + What: /sys/bus/usb/.../powered 2 2 Date: August 2008 3 3 Kernel Version: 2.6.26 4 4 Contact: Harrison Metzger <harrisonmetz@gmail.com> 5 5 Description: Controls whether the device's display will powered. 6 6 A value of 0 is off and a non-zero value is on. 7 7 8 - Where: /sys/bus/usb/.../mode_msb 9 - Where: /sys/bus/usb/.../mode_lsb 8 + What: /sys/bus/usb/.../mode_msb 9 + What: /sys/bus/usb/.../mode_lsb 10 10 Date: August 2008 11 11 Kernel Version: 2.6.26 12 12 Contact: Harrison Metzger <harrisonmetz@gmail.com> ··· 16 16 for an 8 character display the values are 17 17 MSB 0x08; LSB 0xFF. 18 18 19 - Where: /sys/bus/usb/.../textmode 19 + What: /sys/bus/usb/.../textmode 20 20 Date: August 2008 21 21 Kernel Version: 2.6.26 22 22 Contact: Harrison Metzger <harrisonmetz@gmail.com> ··· 25 25 hex: each character is between 0-15 26 26 ascii: each character is between '0'-'9' and 'A'-'F'. 27 27 28 - Where: /sys/bus/usb/.../text 28 + What: /sys/bus/usb/.../text 29 29 Date: August 2008 30 30 Kernel Version: 2.6.26 31 31 Contact: Harrison Metzger <harrisonmetz@gmail.com> 32 32 Description: The text (or data) for the device to display 33 33 34 - Where: /sys/bus/usb/.../decimals 34 + What: /sys/bus/usb/.../decimals 35 35 Date: August 2008 36 36 Kernel Version: 2.6.26 37 37 Contact: Harrison Metzger <harrisonmetz@gmail.com>
+3 -3
Documentation/ABI/testing/sysfs-class-cxl
··· 1 - Note: Attributes that are shared between devices are stored in the directory 2 - pointed to by the symlink device/. 3 - Example: The real path of the attribute /sys/class/cxl/afu0.0s/irqs_max is 1 + Please note that attributes that are shared between devices are stored in 2 + the directory pointed to by the symlink device/. 3 + For example, the real path of the attribute /sys/class/cxl/afu0.0s/irqs_max is 4 4 /sys/class/cxl/afu0.0s/device/irqs_max, i.e. /sys/class/cxl/afu0.0/irqs_max. 5 5 6 6
+1 -1
Documentation/ABI/testing/sysfs-class-devfreq
··· 47 47 What: /sys/class/devfreq/.../trans_stat 48 48 Date: October 2012 49 49 Contact: MyungJoo Ham <myungjoo.ham@samsung.com> 50 - Descrtiption: 50 + Description: 51 51 This ABI shows the statistics of devfreq behavior on a 52 52 specific device. It shows the time spent in each state and 53 53 the number of transitions between states.
+1 -1
Documentation/ABI/testing/sysfs-class-powercap
··· 147 147 Date: September 2013 148 148 KernelVersion: 3.13 149 149 Contact: linux-pm@vger.kernel.org 150 - Description 150 + Description: 151 151 This allows to enable/disable power capping at power zone level. 152 152 This applies to current power zone and its children.
+1 -1
Documentation/ABI/testing/sysfs-kernel-fscaps
··· 2 2 Date: February 2011 3 3 KernelVersion: 2.6.38 4 4 Contact: Ludwig Nussel <ludwig.nussel@suse.de> 5 - Description 5 + Description: 6 6 Shows whether file system capabilities are honored 7 7 when executing a binary 8 8
+1 -1
Documentation/ABI/testing/sysfs-kernel-vmcoreinfo
··· 4 4 Contact: Ken'ichi Ohmichi <oomichi@mxs.nes.nec.co.jp> 5 5 Kexec Mailing List <kexec@lists.infradead.org> 6 6 Vivek Goyal <vgoyal@redhat.com> 7 - Description 7 + Description: 8 8 Shows physical address and size of vmcoreinfo ELF note. 9 9 First value contains physical address of note in hex and 10 10 second value contains the size of note in hex. This ELF