On Wed, 28 Oct 2020 15:23:28 +0100 Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> wrote: > There are some ABI documents that, while they don't generate > any warnings, they have issues when parsed by get_abi.pl script > on its output result. > > Address them, in order to provide a clean output. > > Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> All the IIO ones look sensible. Thanks Acked-by: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx> #for IIO > --- > Documentation/ABI/obsolete/sysfs-class-dax | 8 +- > .../ABI/obsolete/sysfs-driver-hid-roccat-pyra | 3 + > Documentation/ABI/removed/devfs | 1 + > Documentation/ABI/removed/raw1394 | 1 + > Documentation/ABI/removed/sysfs-class-rfkill | 2 +- > Documentation/ABI/removed/video1394 | 1 + > Documentation/ABI/stable/firewire-cdev | 63 ++--- > Documentation/ABI/stable/sysfs-acpi-pmprofile | 4 +- > Documentation/ABI/stable/sysfs-bus-w1 | 1 + > Documentation/ABI/stable/sysfs-class-tpm | 4 +- > Documentation/ABI/stable/sysfs-driver-speakup | 4 + > Documentation/ABI/testing/configfs-most | 135 +++++++---- > .../ABI/testing/configfs-usb-gadget-ecm | 12 +- > .../ABI/testing/configfs-usb-gadget-eem | 10 +- > .../ABI/testing/configfs-usb-gadget-loopback | 6 +- > .../testing/configfs-usb-gadget-mass-storage | 18 +- > .../ABI/testing/configfs-usb-gadget-midi | 14 +- > .../ABI/testing/configfs-usb-gadget-printer | 6 +- > .../testing/configfs-usb-gadget-sourcesink | 18 +- > .../ABI/testing/configfs-usb-gadget-subset | 10 +- > .../ABI/testing/configfs-usb-gadget-uac2 | 14 +- > .../ABI/testing/configfs-usb-gadget-uvc | 2 +- > .../ABI/testing/debugfs-cec-error-inj | 2 +- > .../ABI/testing/debugfs-driver-habanalabs | 12 +- > .../ABI/testing/debugfs-pfo-nx-crypto | 28 +-- > Documentation/ABI/testing/debugfs-pktcdvd | 2 +- > .../ABI/testing/debugfs-turris-mox-rwtm | 10 +- > Documentation/ABI/testing/debugfs-wilco-ec | 21 +- > Documentation/ABI/testing/dell-smbios-wmi | 32 +-- > Documentation/ABI/testing/gpio-cdev | 13 +- > Documentation/ABI/testing/procfs-diskstats | 6 +- > Documentation/ABI/testing/procfs-smaps_rollup | 48 ++-- > Documentation/ABI/testing/pstore | 19 +- > Documentation/ABI/testing/sysfs-block-rnbd | 4 +- > Documentation/ABI/testing/sysfs-bus-acpi | 1 + > .../testing/sysfs-bus-coresight-devices-etb10 | 5 +- > Documentation/ABI/testing/sysfs-bus-css | 3 + > Documentation/ABI/testing/sysfs-bus-dfl | 2 + > .../sysfs-bus-event_source-devices-hv_24x7 | 6 +- > .../sysfs-bus-event_source-devices-hv_gpci | 7 +- > Documentation/ABI/testing/sysfs-bus-fcoe | 68 ++++-- > Documentation/ABI/testing/sysfs-bus-fsl-mc | 12 +- > .../ABI/testing/sysfs-bus-i2c-devices-fsa9480 | 26 +- > Documentation/ABI/testing/sysfs-bus-i3c | 2 + > Documentation/ABI/testing/sysfs-bus-iio | 19 +- > .../ABI/testing/sysfs-bus-iio-adc-hi8435 | 5 + > .../ABI/testing/sysfs-bus-iio-adc-stm32 | 3 + > .../ABI/testing/sysfs-bus-iio-distance-srf08 | 7 +- > .../testing/sysfs-bus-iio-frequency-ad9523 | 2 + > .../testing/sysfs-bus-iio-frequency-adf4371 | 10 +- > .../ABI/testing/sysfs-bus-iio-health-afe440x | 12 +- > .../ABI/testing/sysfs-bus-iio-light-isl29018 | 6 +- > .../testing/sysfs-bus-intel_th-devices-gth | 11 +- > Documentation/ABI/testing/sysfs-bus-papr-pmem | 23 +- > Documentation/ABI/testing/sysfs-bus-pci | 22 +- > .../ABI/testing/sysfs-bus-pci-devices-catpt | 1 + > .../testing/sysfs-bus-pci-drivers-ehci_hcd | 4 +- > Documentation/ABI/testing/sysfs-bus-rbd | 37 ++- > Documentation/ABI/testing/sysfs-bus-siox | 3 + > .../ABI/testing/sysfs-bus-thunderbolt | 18 +- > Documentation/ABI/testing/sysfs-bus-usb | 2 + > .../sysfs-class-backlight-driver-lm3533 | 26 +- > Documentation/ABI/testing/sysfs-class-bdi | 1 - > .../ABI/testing/sysfs-class-chromeos | 15 +- > Documentation/ABI/testing/sysfs-class-cxl | 8 +- > Documentation/ABI/testing/sysfs-class-devlink | 30 ++- > Documentation/ABI/testing/sysfs-class-extcon | 34 +-- > .../ABI/testing/sysfs-class-fpga-manager | 5 +- > Documentation/ABI/testing/sysfs-class-gnss | 2 + > Documentation/ABI/testing/sysfs-class-led | 1 + > .../testing/sysfs-class-led-driver-el15203000 | 30 +-- > .../ABI/testing/sysfs-class-led-driver-lm3533 | 44 ++-- > .../ABI/testing/sysfs-class-led-flash | 27 ++- > .../testing/sysfs-class-led-trigger-netdev | 7 + > .../testing/sysfs-class-led-trigger-usbport | 1 + > .../ABI/testing/sysfs-class-leds-gt683r | 8 +- > Documentation/ABI/testing/sysfs-class-net | 61 +++-- > .../ABI/testing/sysfs-class-net-cdc_ncm | 6 +- > .../ABI/testing/sysfs-class-net-phydev | 2 + > Documentation/ABI/testing/sysfs-class-pktcdvd | 36 +-- > Documentation/ABI/testing/sysfs-class-power | 12 +- > .../ABI/testing/sysfs-class-power-mp2629 | 1 + > .../ABI/testing/sysfs-class-power-twl4030 | 4 +- > Documentation/ABI/testing/sysfs-class-rapidio | 46 ++-- > .../ABI/testing/sysfs-class-regulator | 36 +-- > .../ABI/testing/sysfs-class-remoteproc | 14 +- > ...ysfs-class-rtc-rtc0-device-rtc_calibration | 1 + > Documentation/ABI/testing/sysfs-class-uwb_rc | 13 +- > .../ABI/testing/sysfs-class-watchdog | 7 +- > Documentation/ABI/testing/sysfs-dev | 7 +- > .../ABI/testing/sysfs-devices-mapping | 41 ++-- > .../ABI/testing/sysfs-devices-memory | 15 +- > .../sysfs-devices-platform-_UDC_-gadget | 10 +- > .../ABI/testing/sysfs-devices-platform-ipmi | 52 ++-- > .../ABI/testing/sysfs-devices-system-cpu | 4 +- > .../ABI/testing/sysfs-driver-hid-lenovo | 10 + > .../ABI/testing/sysfs-driver-hid-ntrig | 13 +- > .../ABI/testing/sysfs-driver-hid-roccat-kone | 19 ++ > .../ABI/testing/sysfs-driver-hid-wiimote | 1 + > .../ABI/testing/sysfs-driver-input-exc3000 | 2 + > .../ABI/testing/sysfs-driver-jz4780-efuse | 6 +- > .../ABI/testing/sysfs-driver-pciback | 6 +- > Documentation/ABI/testing/sysfs-driver-ufs | 228 ++++++++++++++---- > .../ABI/testing/sysfs-driver-w1_ds28e17 | 3 + > Documentation/ABI/testing/sysfs-firmware-acpi | 16 +- > .../ABI/testing/sysfs-firmware-efi-esrt | 28 ++- > .../testing/sysfs-firmware-efi-runtime-map | 14 +- > .../ABI/testing/sysfs-firmware-qemu_fw_cfg | 20 +- > Documentation/ABI/testing/sysfs-firmware-sfi | 6 +- > .../ABI/testing/sysfs-firmware-sgi_uv | 6 +- > Documentation/ABI/testing/sysfs-fs-f2fs | 48 ++-- > Documentation/ABI/testing/sysfs-kernel-mm-ksm | 5 +- > Documentation/ABI/testing/sysfs-kernel-slab | 3 + > Documentation/ABI/testing/sysfs-module | 17 +- > .../ABI/testing/sysfs-platform-dell-laptop | 10 +- > .../ABI/testing/sysfs-platform-dell-smbios | 4 +- > .../testing/sysfs-platform-i2c-demux-pinctrl | 4 +- > Documentation/ABI/testing/sysfs-platform-kim | 1 + > .../testing/sysfs-platform-phy-rcar-gen3-usb2 | 10 +- > .../ABI/testing/sysfs-platform-renesas_usb3 | 10 +- > Documentation/ABI/testing/sysfs-power | 21 +- > Documentation/ABI/testing/sysfs-profiling | 2 +- > Documentation/ABI/testing/sysfs-wusb_cbaf | 3 +- > Documentation/ABI/testing/usb-charger-uevent | 82 ++++--- > Documentation/ABI/testing/usb-uevent | 32 +-- > scripts/get_abi.pl | 2 - > 126 files changed, 1323 insertions(+), 767 deletions(-) > > diff --git a/Documentation/ABI/obsolete/sysfs-class-dax b/Documentation/ABI/obsolete/sysfs-class-dax > index 2cb9fc5e8bd1..0faf1354cd05 100644 > --- a/Documentation/ABI/obsolete/sysfs-class-dax > +++ b/Documentation/ABI/obsolete/sysfs-class-dax > @@ -8,11 +8,11 @@ Description: Device DAX is the device-centric analogue of Filesystem > system. Device DAX is strict, precise and predictable. > Specifically this interface: > > - 1/ Guarantees fault granularity with respect to a given > - page size (pte, pmd, or pud) set at configuration time. > + 1. Guarantees fault granularity with respect to a given > + page size (pte, pmd, or pud) set at configuration time. > > - 2/ Enforces deterministic behavior by being strict about > - what fault scenarios are supported. > + 2. Enforces deterministic behavior by being strict about > + what fault scenarios are supported. > > The /sys/class/dax/ interface enumerates all the > device-dax instances in the system. The ABI is > diff --git a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra > index 5d41ebadf15e..66545c587a64 100644 > --- a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra > +++ b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra > @@ -7,10 +7,13 @@ Description: It is possible to switch the cpi setting of the mouse with the > setting reported by the mouse. This number has to be further > processed to receive the real dpi value: > > + ===== ==== > VALUE DPI > + ===== ==== > 1 400 > 2 800 > 4 1600 > + ===== ==== > > This file is readonly. > Has never been used. If bookkeeping is done, it's done in userland tools. > diff --git a/Documentation/ABI/removed/devfs b/Documentation/ABI/removed/devfs > index 0020c49933c4..24fb35adf277 100644 > --- a/Documentation/ABI/removed/devfs > +++ b/Documentation/ABI/removed/devfs > @@ -5,6 +5,7 @@ Description: > devfs has been unmaintained for a number of years, has unfixable > races, contains a naming policy within the kernel that is > against the LSB, and can be replaced by using udev. > + > The files fs/devfs/*, include/linux/devfs_fs*.h were removed, > along with the assorted devfs function calls throughout the > kernel tree. > diff --git a/Documentation/ABI/removed/raw1394 b/Documentation/ABI/removed/raw1394 > index ec333e676322..9ec7ec493920 100644 > --- a/Documentation/ABI/removed/raw1394 > +++ b/Documentation/ABI/removed/raw1394 > @@ -7,6 +7,7 @@ Description: > to implement sensible device security policies, and its low level > of abstraction that required userspace clients to duplicate much > of the kernel's ieee1394 core functionality. > + > Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of > firewire-core. > > diff --git a/Documentation/ABI/removed/sysfs-class-rfkill b/Documentation/ABI/removed/sysfs-class-rfkill > index 9c08c7f98ffb..f25174eafd55 100644 > --- a/Documentation/ABI/removed/sysfs-class-rfkill > +++ b/Documentation/ABI/removed/sysfs-class-rfkill > @@ -10,4 +10,4 @@ Description: This file was deprecated because there no longer was a way to > claim just control over a single rfkill instance. > This file was scheduled to be removed in 2012, and was removed > in 2016. > -Values: 0: Kernel handles events > +Values: 0: Kernel handles events > diff --git a/Documentation/ABI/removed/video1394 b/Documentation/ABI/removed/video1394 > index c39c25aee77b..1905d35a6619 100644 > --- a/Documentation/ABI/removed/video1394 > +++ b/Documentation/ABI/removed/video1394 > @@ -8,6 +8,7 @@ Description: > performance issues in its first generation. Any video1394 user had > to use raw1394 + libraw1394 too because video1394 did not provide > asynchronous I/O for device discovery and configuration. > + > Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of > firewire-core. > > diff --git a/Documentation/ABI/stable/firewire-cdev b/Documentation/ABI/stable/firewire-cdev > index c9e8ff026154..261f85b13154 100644 > --- a/Documentation/ABI/stable/firewire-cdev > +++ b/Documentation/ABI/stable/firewire-cdev > @@ -16,6 +16,7 @@ Description: > different scope: > > - The 1394 node which is associated with the file: > + > - Asynchronous request transmission > - Get the Configuration ROM > - Query node ID > @@ -23,6 +24,7 @@ Description: > and local node > > - The 1394 bus (i.e. "card") to which the node is attached to: > + > - Isochronous stream transmission and reception > - Asynchronous stream transmission and reception > - Asynchronous broadcast request transmission > @@ -35,6 +37,7 @@ Description: > - Bus reset initiation, bus reset event reception > > - All 1394 buses: > + > - Allocation of IEEE 1212 address ranges on the local > link layers, reception of inbound requests to such > an address range, asynchronous response transmission > @@ -59,50 +62,50 @@ Description: > The following file operations are supported: > > open(2) > - Currently the only useful flags are O_RDWR. > + Currently the only useful flags are O_RDWR. > > ioctl(2) > - Initiate various actions. Some take immediate effect, others > - are performed asynchronously while or after the ioctl returns. > - See the inline documentation in <linux/firewire-cdev.h> for > - descriptions of all ioctls. > + Initiate various actions. Some take immediate effect, others > + are performed asynchronously while or after the ioctl returns. > + See the inline documentation in <linux/firewire-cdev.h> for > + descriptions of all ioctls. > > poll(2), select(2), epoll_wait(2) etc. > - Watch for events to become available to be read. > + Watch for events to become available to be read. > > read(2) > - Receive various events. There are solicited events like > - outbound asynchronous transaction completion or isochronous > - buffer completion, and unsolicited events such as bus resets, > - request reception, or PHY packet reception. Always use a read > - buffer which is large enough to receive the largest event that > - could ever arrive. See <linux/firewire-cdev.h> for descriptions > - of all event types and for which ioctls affect reception of > - events. > + Receive various events. There are solicited events like > + outbound asynchronous transaction completion or isochronous > + buffer completion, and unsolicited events such as bus resets, > + request reception, or PHY packet reception. Always use a read > + buffer which is large enough to receive the largest event that > + could ever arrive. See <linux/firewire-cdev.h> for descriptions > + of all event types and for which ioctls affect reception of > + events. > > mmap(2) > - Allocate a DMA buffer for isochronous reception or transmission > - and map it into the process address space. The arguments should > - be used as follows: addr = NULL, length = the desired buffer > - size, i.e. number of packets times size of largest packet, > - prot = at least PROT_READ for reception and at least PROT_WRITE > - for transmission, flags = MAP_SHARED, fd = the handle to the > - /dev/fw*, offset = 0. > + Allocate a DMA buffer for isochronous reception or transmission > + and map it into the process address space. The arguments should > + be used as follows: addr = NULL, length = the desired buffer > + size, i.e. number of packets times size of largest packet, > + prot = at least PROT_READ for reception and at least PROT_WRITE > + for transmission, flags = MAP_SHARED, fd = the handle to the > + /dev/fw*, offset = 0. > > Isochronous reception works in packet-per-buffer fashion except > for multichannel reception which works in buffer-fill mode. > > munmap(2) > - Unmap the isochronous I/O buffer from the process address space. > + Unmap the isochronous I/O buffer from the process address space. > > close(2) > - Besides stopping and freeing I/O contexts that were associated > - with the file descriptor, back out any changes to the local > - nodes' Configuration ROM. Deallocate isochronous channels and > - bandwidth at the IRM that were marked for kernel-assisted > - re- and deallocation. > + Besides stopping and freeing I/O contexts that were associated > + with the file descriptor, back out any changes to the local > + nodes' Configuration ROM. Deallocate isochronous channels and > + bandwidth at the IRM that were marked for kernel-assisted > + re- and deallocation. > > -Users: libraw1394 > - libdc1394 > - libhinawa > +Users: libraw1394; > + libdc1394; > + libhinawa; > tools like linux-firewire-utils, fwhack, ... > diff --git a/Documentation/ABI/stable/sysfs-acpi-pmprofile b/Documentation/ABI/stable/sysfs-acpi-pmprofile > index fd97d22b677f..2d6314f0e4e4 100644 > --- a/Documentation/ABI/stable/sysfs-acpi-pmprofile > +++ b/Documentation/ABI/stable/sysfs-acpi-pmprofile > @@ -1,8 +1,8 @@ > -What: /sys/firmware/acpi/pm_profile > +What: /sys/firmware/acpi/pm_profile > Date: 03-Nov-2011 > KernelVersion: v3.2 > Contact: linux-acpi@xxxxxxxxxxxxxxx > -Description: The ACPI pm_profile sysfs interface exports the platform > +Description: The ACPI pm_profile sysfs interface exports the platform > power management (and performance) requirement expectations > as provided by BIOS. The integer value is directly passed as > retrieved from the FADT ACPI table. > diff --git a/Documentation/ABI/stable/sysfs-bus-w1 b/Documentation/ABI/stable/sysfs-bus-w1 > index 992dfb183ed0..5cd5e872bcae 100644 > --- a/Documentation/ABI/stable/sysfs-bus-w1 > +++ b/Documentation/ABI/stable/sysfs-bus-w1 > @@ -6,6 +6,7 @@ Description: Bus scanning interval, microseconds component. > control systems are attached/generate presence for as short as > 100 ms - hence the tens-to-hundreds milliseconds scan intervals > are required. > + > see Documentation/w1/w1-generic.rst for detailed information. > Users: any user space application which wants to know bus scanning > interval > diff --git a/Documentation/ABI/stable/sysfs-class-tpm b/Documentation/ABI/stable/sysfs-class-tpm > index ec464cf7861a..91ca63ec7581 100644 > --- a/Documentation/ABI/stable/sysfs-class-tpm > +++ b/Documentation/ABI/stable/sysfs-class-tpm > @@ -191,6 +191,6 @@ Contact: linux-integrity@xxxxxxxxxxxxxxx > Description: The "tpm_version_major" property shows the TCG spec major version > implemented by the TPM device. > > - Example output: > + Example output:: > > - 2 > + 2 > diff --git a/Documentation/ABI/stable/sysfs-driver-speakup b/Documentation/ABI/stable/sysfs-driver-speakup > index c6a32c434ce9..792f58ba327d 100644 > --- a/Documentation/ABI/stable/sysfs-driver-speakup > +++ b/Documentation/ABI/stable/sysfs-driver-speakup > @@ -69,6 +69,7 @@ Description: Controls if typing interrupts output from speakup. With > speakup if for example > the say screen command is used before the > entire screen is read. > + > With no_interrupt set to one, if the say > screen command is used, and one then types on the keyboard, > speakup will continue to say the whole screen regardless until > @@ -215,8 +216,10 @@ Description: This file contains names for key states. > Again, these are part of the help system. For instance, if you > had pressed speakup + keypad 3, you would hear: > "speakup keypad 3 is go to bottom edge." > + > The speakup key is depressed, so the name of the key state is > speakup. > + > This part of the message comes from the states collection. > > What: /sys/accessibility/speakup/i18n/characters > @@ -297,6 +300,7 @@ KernelVersion: 2.6 > Contact: speakup@xxxxxxxxxxxxxxxxx > Description: Controls if punctuation is spoken by speakup, or by the > synthesizer. > + > For example, speakup speaks ">" as "greater", while > the espeak synthesizer used by the soft driver speaks "greater > than". Zero lets speakup speak the punctuation. One lets the > diff --git a/Documentation/ABI/testing/configfs-most b/Documentation/ABI/testing/configfs-most > index ed67a4d9f6d6..bc6b8bd18da4 100644 > --- a/Documentation/ABI/testing/configfs-most > +++ b/Documentation/ABI/testing/configfs-most > @@ -15,22 +15,28 @@ KernelVersion: 5.2 > Description: > The attributes: > > - buffer_size configure the buffer size for this channel > + buffer_size > + configure the buffer size for this channel > > - subbuffer_size configure the sub-buffer size for this channel > + subbuffer_size > + configure the sub-buffer size for this channel > (needed for synchronous and isochrnous data) > > > - num_buffers configure number of buffers used for this > + num_buffers > + configure number of buffers used for this > channel > > - datatype configure type of data that will travel over > + datatype > + configure type of data that will travel over > this channel > > - direction configure whether this link will be an input > + direction > + configure whether this link will be an input > or output > > - dbr_size configure DBR data buffer size (this is used > + dbr_size > + configure DBR data buffer size (this is used > for MediaLB communication only) > > packets_per_xact > @@ -39,18 +45,23 @@ Description: > transmitted via USB (this is used for USB > communication only) > > - device name of the device the link is to be attached to > + device > + name of the device the link is to be attached to > > - channel name of the channel the link is to be attached to > + channel > + name of the channel the link is to be attached to > > - comp_params pass parameters needed by some components > + comp_params > + pass parameters needed by some components > > - create_link write '1' to this attribute to trigger the > + create_link > + write '1' to this attribute to trigger the > creation of the link. In case of speculative > configuration, the creation is post-poned until > a physical device is being attached to the bus. > > - destroy_link write '1' to this attribute to destroy an > + destroy_link > + write '1' to this attribute to destroy an > active link > > What: /sys/kernel/config/most_video/<link> > @@ -59,22 +70,28 @@ KernelVersion: 5.2 > Description: > The attributes: > > - buffer_size configure the buffer size for this channel > + buffer_size > + configure the buffer size for this channel > > - subbuffer_size configure the sub-buffer size for this channel > + subbuffer_size > + configure the sub-buffer size for this channel > (needed for synchronous and isochrnous data) > > > - num_buffers configure number of buffers used for this > + num_buffers > + configure number of buffers used for this > channel > > - datatype configure type of data that will travel over > + datatype > + configure type of data that will travel over > this channel > > - direction configure whether this link will be an input > + direction > + configure whether this link will be an input > or output > > - dbr_size configure DBR data buffer size (this is used > + dbr_size > + configure DBR data buffer size (this is used > for MediaLB communication only) > > packets_per_xact > @@ -83,18 +100,23 @@ Description: > transmitted via USB (this is used for USB > communication only) > > - device name of the device the link is to be attached to > + device > + name of the device the link is to be attached to > > - channel name of the channel the link is to be attached to > + channel > + name of the channel the link is to be attached to > > - comp_params pass parameters needed by some components > + comp_params > + pass parameters needed by some components > > - create_link write '1' to this attribute to trigger the > + create_link > + write '1' to this attribute to trigger the > creation of the link. In case of speculative > configuration, the creation is post-poned until > a physical device is being attached to the bus. > > - destroy_link write '1' to this attribute to destroy an > + destroy_link > + write '1' to this attribute to destroy an > active link > > What: /sys/kernel/config/most_net/<link> > @@ -103,22 +125,28 @@ KernelVersion: 5.2 > Description: > The attributes: > > - buffer_size configure the buffer size for this channel > + buffer_size > + configure the buffer size for this channel > > - subbuffer_size configure the sub-buffer size for this channel > + subbuffer_size > + configure the sub-buffer size for this channel > (needed for synchronous and isochrnous data) > > > - num_buffers configure number of buffers used for this > + num_buffers > + configure number of buffers used for this > channel > > - datatype configure type of data that will travel over > + datatype > + configure type of data that will travel over > this channel > > - direction configure whether this link will be an input > + direction > + configure whether this link will be an input > or output > > - dbr_size configure DBR data buffer size (this is used > + dbr_size > + configure DBR data buffer size (this is used > for MediaLB communication only) > > packets_per_xact > @@ -127,18 +155,23 @@ Description: > transmitted via USB (this is used for USB > communication only) > > - device name of the device the link is to be attached to > + device > + name of the device the link is to be attached to > > - channel name of the channel the link is to be attached to > + channel > + name of the channel the link is to be attached to > > - comp_params pass parameters needed by some components > + comp_params > + pass parameters needed by some components > > - create_link write '1' to this attribute to trigger the > + create_link > + write '1' to this attribute to trigger the > creation of the link. In case of speculative > configuration, the creation is post-poned until > a physical device is being attached to the bus. > > - destroy_link write '1' to this attribute to destroy an > + destroy_link > + write '1' to this attribute to destroy an > active link > > What: /sys/kernel/config/most_sound/<card> > @@ -147,7 +180,8 @@ KernelVersion: 5.2 > Description: > The attributes: > > - create_card write '1' to this attribute to trigger the > + create_card > + write '1' to this attribute to trigger the > registration of the sound card with the ALSA > subsystem. > > @@ -157,22 +191,28 @@ KernelVersion: 5.2 > Description: > The attributes: > > - buffer_size configure the buffer size for this channel > + buffer_size > + configure the buffer size for this channel > > - subbuffer_size configure the sub-buffer size for this channel > + subbuffer_size > + configure the sub-buffer size for this channel > (needed for synchronous and isochrnous data) > > > - num_buffers configure number of buffers used for this > + num_buffers > + configure number of buffers used for this > channel > > - datatype configure type of data that will travel over > + datatype > + configure type of data that will travel over > this channel > > - direction configure whether this link will be an input > + direction > + configure whether this link will be an input > or output > > - dbr_size configure DBR data buffer size (this is used > + dbr_size > + configure DBR data buffer size (this is used > for MediaLB communication only) > > packets_per_xact > @@ -181,16 +221,21 @@ Description: > transmitted via USB (this is used for USB > communication only) > > - device name of the device the link is to be attached to > + device > + name of the device the link is to be attached to > > - channel name of the channel the link is to be attached to > + channel > + name of the channel the link is to be attached to > > - comp_params pass parameters needed by some components > + comp_params > + pass parameters needed by some components > > - create_link write '1' to this attribute to trigger the > + create_link > + write '1' to this attribute to trigger the > creation of the link. In case of speculative > configuration, the creation is post-poned until > a physical device is being attached to the bus. > > - destroy_link write '1' to this attribute to destroy an > + destroy_link > + write '1' to this attribute to destroy an > active link > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-ecm b/Documentation/ABI/testing/configfs-usb-gadget-ecm > index 0addf7704b4c..272bc1e4ce2e 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-ecm > +++ b/Documentation/ABI/testing/configfs-usb-gadget-ecm > @@ -4,13 +4,17 @@ KernelVersion: 3.11 > Description: > The attributes: > > - ifname - network device interface name associated with > + ifname > + - network device interface name associated with > this function instance > - qmult - queue length multiplier for high and > + qmult > + - queue length multiplier for high and > super speed > - host_addr - MAC address of host's end of this > + host_addr > + - MAC address of host's end of this > Ethernet over USB link > - dev_addr - MAC address of device's end of this > + dev_addr > + - MAC address of device's end of this > Ethernet over USB link > > > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-eem b/Documentation/ABI/testing/configfs-usb-gadget-eem > index a4c57158fcde..178c3d5fb647 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-eem > +++ b/Documentation/ABI/testing/configfs-usb-gadget-eem > @@ -4,11 +4,13 @@ KernelVersion: 3.11 > Description: > The attributes: > > - ifname - network device interface name associated with > + ========== ============================================= > + ifname network device interface name associated with > this function instance > - qmult - queue length multiplier for high and > + qmult queue length multiplier for high and > super speed > - host_addr - MAC address of host's end of this > + host_addr MAC address of host's end of this > Ethernet over USB link > - dev_addr - MAC address of device's end of this > + dev_addr MAC address of device's end of this > Ethernet over USB link > + ========== ============================================= > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-loopback b/Documentation/ABI/testing/configfs-usb-gadget-loopback > index 06beefbcf061..e6c6ba5ac7ff 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-loopback > +++ b/Documentation/ABI/testing/configfs-usb-gadget-loopback > @@ -4,5 +4,7 @@ KernelVersion: 3.13 > Description: > The attributes: > > - qlen - depth of loopback queue > - buflen - buffer length > + ======= ======================= > + qlen depth of loopback queue > + buflen buffer length > + ======= ======================= > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage > index 9931fb0d63ba..c86b63a7bb43 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage > +++ b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage > @@ -4,12 +4,14 @@ KernelVersion: 3.13 > Description: > The attributes: > > - stall - Set to permit function to halt bulk endpoints. > + =========== ============================================== > + stall Set to permit function to halt bulk endpoints. > Disabled on some USB devices known not to work > correctly. You should set it to true. > - num_buffers - Number of pipeline buffers. Valid numbers > + num_buffers Number of pipeline buffers. Valid numbers > are 2..4. Available only if > CONFIG_USB_GADGET_DEBUG_FILES is set. > + =========== ============================================== > > What: /config/usb-gadget/gadget/functions/mass_storage.name/lun.name > Date: Oct 2013 > @@ -17,15 +19,17 @@ KernelVersion: 3.13 > Description: > The attributes: > > - file - The path to the backing file for the LUN. > + =========== ============================================== > + file The path to the backing file for the LUN. > Required if LUN is not marked as removable. > - ro - Flag specifying access to the LUN shall be > + ro Flag specifying access to the LUN shall be > read-only. This is implied if CD-ROM emulation > is enabled as well as when it was impossible > to open "filename" in R/W mode. > - removable - Flag specifying that LUN shall be indicated as > + removable Flag specifying that LUN shall be indicated as > being removable. > - cdrom - Flag specifying that LUN shall be reported as > + cdrom Flag specifying that LUN shall be reported as > being a CD-ROM. > - nofua - Flag specifying that FUA flag > + nofua Flag specifying that FUA flag > in SCSI WRITE(10,12) > + =========== ============================================== > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-midi b/Documentation/ABI/testing/configfs-usb-gadget-midi > index 6b341df7249c..07389cddd51a 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-midi > +++ b/Documentation/ABI/testing/configfs-usb-gadget-midi > @@ -4,9 +4,11 @@ KernelVersion: 3.19 > Description: > The attributes: > > - index - index value for the USB MIDI adapter > - id - ID string for the USB MIDI adapter > - buflen - MIDI buffer length > - qlen - USB read request queue length > - in_ports - number of MIDI input ports > - out_ports - number of MIDI output ports > + ========== ==================================== > + index index value for the USB MIDI adapter > + id ID string for the USB MIDI adapter > + buflen MIDI buffer length > + qlen USB read request queue length > + in_ports number of MIDI input ports > + out_ports number of MIDI output ports > + ========== ==================================== > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-printer b/Documentation/ABI/testing/configfs-usb-gadget-printer > index 6b0714e3c605..7aa731bac2da 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-printer > +++ b/Documentation/ABI/testing/configfs-usb-gadget-printer > @@ -4,6 +4,8 @@ KernelVersion: 4.1 > Description: > The attributes: > > - pnp_string - Data to be passed to the host in pnp string > - q_len - Number of requests per endpoint > + ========== =========================================== > + pnp_string Data to be passed to the host in pnp string > + q_len Number of requests per endpoint > + ========== =========================================== > > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink > index f56335af2d88..1f3d31b607b7 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink > +++ b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink > @@ -4,11 +4,13 @@ KernelVersion: 3.13 > Description: > The attributes: > > - pattern - 0 (all zeros), 1 (mod63), 2 (none) > - isoc_interval - 1..16 > - isoc_maxpacket - 0 - 1023 (fs), 0 - 1024 (hs/ss) > - isoc_mult - 0..2 (hs/ss only) > - isoc_maxburst - 0..15 (ss only) > - buflen - buffer length > - bulk_qlen - depth of queue for bulk > - iso_qlen - depth of queue for iso > + ============== ================================== > + pattern 0 (all zeros), 1 (mod63), 2 (none) > + isoc_interval 1..16 > + isoc_maxpacket 0 - 1023 (fs), 0 - 1024 (hs/ss) > + isoc_mult 0..2 (hs/ss only) > + isoc_maxburst 0..15 (ss only) > + buflen buffer length > + bulk_qlen depth of queue for bulk > + iso_qlen depth of queue for iso > + ============== ================================== > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-subset b/Documentation/ABI/testing/configfs-usb-gadget-subset > index 9373e2c51ea4..0061b864351f 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-subset > +++ b/Documentation/ABI/testing/configfs-usb-gadget-subset > @@ -4,11 +4,13 @@ KernelVersion: 3.11 > Description: > The attributes: > > - ifname - network device interface name associated with > + ========== ============================================= > + ifname network device interface name associated with > this function instance > - qmult - queue length multiplier for high and > + qmult queue length multiplier for high and > super speed > - host_addr - MAC address of host's end of this > + host_addr MAC address of host's end of this > Ethernet over USB link > - dev_addr - MAC address of device's end of this > + dev_addr MAC address of device's end of this > Ethernet over USB link > + ========== ============================================= > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uac2 b/Documentation/ABI/testing/configfs-usb-gadget-uac2 > index 2bfdd4efa9bd..d4356c8b8cd6 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-uac2 > +++ b/Documentation/ABI/testing/configfs-usb-gadget-uac2 > @@ -4,9 +4,11 @@ KernelVersion: 3.18 > Description: > The attributes: > > - c_chmask - capture channel mask > - c_srate - capture sampling rate > - c_ssize - capture sample size (bytes) > - p_chmask - playback channel mask > - p_srate - playback sampling rate > - p_ssize - playback sample size (bytes) > + ========= ============================ > + c_chmask capture channel mask > + c_srate capture sampling rate > + c_ssize capture sample size (bytes) > + p_chmask playback channel mask > + p_srate playback sampling rate > + p_ssize playback sample size (bytes) > + ========= ============================ > diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uvc b/Documentation/ABI/testing/configfs-usb-gadget-uvc > index cee81b0347bb..ac5e11af79a8 100644 > --- a/Documentation/ABI/testing/configfs-usb-gadget-uvc > +++ b/Documentation/ABI/testing/configfs-usb-gadget-uvc > @@ -55,7 +55,7 @@ Description: Default output terminal descriptors > > ============== ============================================= > iTerminal index of string descriptor > - bSourceID id of the terminal to which this terminal > + bSourceID id of the terminal to which this terminal > is connected > bAssocTerminal id of the input terminal to which this output > terminal is associated > diff --git a/Documentation/ABI/testing/debugfs-cec-error-inj b/Documentation/ABI/testing/debugfs-cec-error-inj > index 5afcd78fbdb7..8debcb08a3b5 100644 > --- a/Documentation/ABI/testing/debugfs-cec-error-inj > +++ b/Documentation/ABI/testing/debugfs-cec-error-inj > @@ -23,7 +23,7 @@ error injections without having to know the details of the driver-specific > commands. > > Note that the output of 'error-inj' shall be valid as input to 'error-inj'. > -So this must work: > +So this must work:: > > $ cat error-inj >einj.txt > $ cat einj.txt >error-inj > diff --git a/Documentation/ABI/testing/debugfs-driver-habanalabs b/Documentation/ABI/testing/debugfs-driver-habanalabs > index 2e9ae311e02d..c5d678d39144 100644 > --- a/Documentation/ABI/testing/debugfs-driver-habanalabs > +++ b/Documentation/ABI/testing/debugfs-driver-habanalabs > @@ -20,9 +20,13 @@ Description: Allow the root user to disable/enable in runtime the clock > The user can supply a bitmask value, each bit represents > a different engine to disable/enable its clock gating feature. > The bitmask is composed of 20 bits: > - 0 - 7 : DMA channels > - 8 - 11 : MME engines > - 12 - 19 : TPC engines > + > + ======= ============ > + 0 - 7 DMA channels > + 8 - 11 MME engines > + 12 - 19 TPC engines > + ======= ============ > + > The bit's location of a specific engine can be determined > using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values > are defined in uapi habanalabs.h file in enum gaudi_engine_id > @@ -59,6 +63,7 @@ Description: Allows the root user to read or write directly through the > the generic Linux user-space PCI mapping) because the DDR bar > is very small compared to the DDR memory and only the driver can > move the bar before and after the transaction. > + > If the IOMMU is disabled, it also allows the root user to read > or write from the host a device VA of a host mapped memory > > @@ -73,6 +78,7 @@ Description: Allows the root user to read or write 64 bit data directly > the generic Linux user-space PCI mapping) because the DDR bar > is very small compared to the DDR memory and only the driver can > move the bar before and after the transaction. > + > If the IOMMU is disabled, it also allows the root user to read > or write from the host a device VA of a host mapped memory > > diff --git a/Documentation/ABI/testing/debugfs-pfo-nx-crypto b/Documentation/ABI/testing/debugfs-pfo-nx-crypto > index 685d5a448423..f75a655c1531 100644 > --- a/Documentation/ABI/testing/debugfs-pfo-nx-crypto > +++ b/Documentation/ABI/testing/debugfs-pfo-nx-crypto > @@ -4,42 +4,42 @@ KernelVersion: 3.4 > Contact: Kent Yoder <key@xxxxxxxxxxxxxxxxxx> > Description: > > - These debugfs interfaces are built by the nx-crypto driver, built in > +These debugfs interfaces are built by the nx-crypto driver, built in > arch/powerpc/crypto/nx. > > Error Detection > =============== > > errors: > -- A u32 providing a total count of errors since the driver was loaded. The > -only errors counted here are those returned from the hcall, H_COP_OP. > + A u32 providing a total count of errors since the driver was loaded. The > + only errors counted here are those returned from the hcall, H_COP_OP. > > last_error: > -- The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not > -recorded here (the hcall will retry until -EBUSY goes away). > + The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not > + recorded here (the hcall will retry until -EBUSY goes away). > > last_error_pid: > -- The process ID of the process who received the most recent error from the > -hcall. > + The process ID of the process who received the most recent error from the > + hcall. > > Device Use > ========== > > aes_bytes: > -- The total number of bytes encrypted using AES in any of the driver's > -supported modes. > + The total number of bytes encrypted using AES in any of the driver's > + supported modes. > > aes_ops: > -- The total number of AES operations submitted to the hardware. > + The total number of AES operations submitted to the hardware. > > sha256_bytes: > -- The total number of bytes hashed by the hardware using SHA-256. > + The total number of bytes hashed by the hardware using SHA-256. > > sha256_ops: > -- The total number of SHA-256 operations submitted to the hardware. > + The total number of SHA-256 operations submitted to the hardware. > > sha512_bytes: > -- The total number of bytes hashed by the hardware using SHA-512. > + The total number of bytes hashed by the hardware using SHA-512. > > sha512_ops: > -- The total number of SHA-512 operations submitted to the hardware. > + The total number of SHA-512 operations submitted to the hardware. > diff --git a/Documentation/ABI/testing/debugfs-pktcdvd b/Documentation/ABI/testing/debugfs-pktcdvd > index 787907d70462..f6f65a4faea0 100644 > --- a/Documentation/ABI/testing/debugfs-pktcdvd > +++ b/Documentation/ABI/testing/debugfs-pktcdvd > @@ -10,7 +10,7 @@ these files in debugfs: > /sys/kernel/debug/pktcdvd/pktcdvd[0-7]/ > > ==== ====== ==================================== > - info (0444) Lots of driver statistics and infos. > + info 0444 Lots of driver statistics and infos. > ==== ====== ==================================== > > Example:: > diff --git a/Documentation/ABI/testing/debugfs-turris-mox-rwtm b/Documentation/ABI/testing/debugfs-turris-mox-rwtm > index c8f7dadd591c..ad08f535af3b 100644 > --- a/Documentation/ABI/testing/debugfs-turris-mox-rwtm > +++ b/Documentation/ABI/testing/debugfs-turris-mox-rwtm > @@ -2,10 +2,12 @@ What: /sys/kernel/debug/turris-mox-rwtm/do_sign > Date: Jun 2020 > KernelVersion: 5.8 > Contact: Marek Behún <marek.behun@xxxxxx> > -Description: (W) > - Message to sign with the ECDSA private key stored in > +Description: > + > + === =========================================================== > + (W) Message to sign with the ECDSA private key stored in > device's OTP. The message must be exactly 64 bytes (since > this is intended for SHA-512 hashes). > - (R) > - The resulting signature, 136 bytes. This contains the R and > + (R) The resulting signature, 136 bytes. This contains the R and > S values of the ECDSA signature, both in big-endian format. > + === =========================================================== > diff --git a/Documentation/ABI/testing/debugfs-wilco-ec b/Documentation/ABI/testing/debugfs-wilco-ec > index 9d8d9d2def5b..682e3c09ef4d 100644 > --- a/Documentation/ABI/testing/debugfs-wilco-ec > +++ b/Documentation/ABI/testing/debugfs-wilco-ec > @@ -27,16 +27,17 @@ Description: > for writing, two for the type and at least a single byte of > data. > > - Example: > - // Request EC info type 3 (EC firmware build date) > - // Corresponds with sending type 0x00f0 with > - // MBOX = [38, 00, 03, 00] > - $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw > - // View the result. The decoded ASCII result "12/21/18" is > - // included after the raw hex. > - // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...] > - $ cat /sys/kernel/debug/wilco_ec/raw > - 00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00 ..12/21/18.8... > + Example:: > + > + // Request EC info type 3 (EC firmware build date) > + // Corresponds with sending type 0x00f0 with > + // MBOX = [38, 00, 03, 00] > + $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw > + // View the result. The decoded ASCII result "12/21/18" is > + // included after the raw hex. > + // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...] > + $ cat /sys/kernel/debug/wilco_ec/raw > + 00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00 ..12/21/18.8... > > Note that the first 16 bytes of the received MBOX[] will be > printed, even if some of the data is junk, and skipping bytes > diff --git a/Documentation/ABI/testing/dell-smbios-wmi b/Documentation/ABI/testing/dell-smbios-wmi > index fc919ce16008..5f3a0dc67050 100644 > --- a/Documentation/ABI/testing/dell-smbios-wmi > +++ b/Documentation/ABI/testing/dell-smbios-wmi > @@ -10,29 +10,29 @@ Description: > <uapi/linux/wmi.h> > > 1) To perform an SMBIOS call from userspace, you'll need to > - first determine the minimum size of the calling interface > - buffer for your machine. > - Platforms that contain larger buffers can return larger > - objects from the system firmware. > - Commonly this size is either 4k or 32k. > + first determine the minimum size of the calling interface > + buffer for your machine. > + Platforms that contain larger buffers can return larger > + objects from the system firmware. > + Commonly this size is either 4k or 32k. > > - To determine the size of the buffer read() a u64 dword from > - the WMI character device /dev/wmi/dell-smbios. > + To determine the size of the buffer read() a u64 dword from > + the WMI character device /dev/wmi/dell-smbios. > > 2) After you've determined the minimum size of the calling > - interface buffer, you can allocate a structure that represents > - the structure documented above. > + interface buffer, you can allocate a structure that represents > + the structure documented above. > > 3) In the 'length' object store the size of the buffer you > - determined above and allocated. > + determined above and allocated. > > 4) In this buffer object, prepare as necessary for the SMBIOS > - call you're interested in. Typically SMBIOS buffers have > - "class", "select", and "input" defined to values that coincide > - with the data you are interested in. > - Documenting class/select/input values is outside of the scope > - of this documentation. Check with the libsmbios project for > - further documentation on these values. > + call you're interested in. Typically SMBIOS buffers have > + "class", "select", and "input" defined to values that coincide > + with the data you are interested in. > + Documenting class/select/input values is outside of the scope > + of this documentation. Check with the libsmbios project for > + further documentation on these values. > > 6) Run the call by using ioctl() as described in the header. > > diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev > index 7b265fbb47e3..66bdcd188b6c 100644 > --- a/Documentation/ABI/testing/gpio-cdev > +++ b/Documentation/ABI/testing/gpio-cdev > @@ -12,15 +12,16 @@ Description: > The following file operations are supported: > > open(2) > - Currently the only useful flags are O_RDWR. > + Currently the only useful flags are O_RDWR. > > ioctl(2) > - Initiate various actions. > - See the inline documentation in [include/uapi]<linux/gpio.h> > - for descriptions of all ioctls. > + Initiate various actions. > + > + See the inline documentation in [include/uapi]<linux/gpio.h> > + for descriptions of all ioctls. > > close(2) > - Stops and free up the I/O contexts that was associated > - with the file descriptor. > + Stops and free up the I/O contexts that was associated > + with the file descriptor. > > Users: TBD > diff --git a/Documentation/ABI/testing/procfs-diskstats b/Documentation/ABI/testing/procfs-diskstats > index df5a3a8c1edf..e58d641443d3 100644 > --- a/Documentation/ABI/testing/procfs-diskstats > +++ b/Documentation/ABI/testing/procfs-diskstats > @@ -35,7 +35,9 @@ Description: > > Kernel 5.5+ appends two more fields for flush requests: > > - 19 - flush requests completed successfully > - 20 - time spent flushing > + == ===================================== > + 19 flush requests completed successfully > + 20 time spent flushing > + == ===================================== > > For more details refer to Documentation/admin-guide/iostats.rst > diff --git a/Documentation/ABI/testing/procfs-smaps_rollup b/Documentation/ABI/testing/procfs-smaps_rollup > index 046978193368..a4e31c465194 100644 > --- a/Documentation/ABI/testing/procfs-smaps_rollup > +++ b/Documentation/ABI/testing/procfs-smaps_rollup > @@ -14,28 +14,28 @@ Description: > For more details, see Documentation/filesystems/proc.rst > and the procfs man page. > > - Typical output looks like this: > + Typical output looks like this:: > > - 00100000-ff709000 ---p 00000000 00:00 0 [rollup] > - Size: 1192 kB > - KernelPageSize: 4 kB > - MMUPageSize: 4 kB > - Rss: 884 kB > - Pss: 385 kB > - Pss_Anon: 301 kB > - Pss_File: 80 kB > - Pss_Shmem: 4 kB > - Shared_Clean: 696 kB > - Shared_Dirty: 0 kB > - Private_Clean: 120 kB > - Private_Dirty: 68 kB > - Referenced: 884 kB > - Anonymous: 68 kB > - LazyFree: 0 kB > - AnonHugePages: 0 kB > - ShmemPmdMapped: 0 kB > - Shared_Hugetlb: 0 kB > - Private_Hugetlb: 0 kB > - Swap: 0 kB > - SwapPss: 0 kB > - Locked: 385 kB > + 00100000-ff709000 ---p 00000000 00:00 0 [rollup] > + Size: 1192 kB > + KernelPageSize: 4 kB > + MMUPageSize: 4 kB > + Rss: 884 kB > + Pss: 385 kB > + Pss_Anon: 301 kB > + Pss_File: 80 kB > + Pss_Shmem: 4 kB > + Shared_Clean: 696 kB > + Shared_Dirty: 0 kB > + Private_Clean: 120 kB > + Private_Dirty: 68 kB > + Referenced: 884 kB > + Anonymous: 68 kB > + LazyFree: 0 kB > + AnonHugePages: 0 kB > + ShmemPmdMapped: 0 kB > + Shared_Hugetlb: 0 kB > + Private_Hugetlb: 0 kB > + Swap: 0 kB > + SwapPss: 0 kB > + Locked: 385 kB > diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore > index d45209abdb1b..5b02540781a2 100644 > --- a/Documentation/ABI/testing/pstore > +++ b/Documentation/ABI/testing/pstore > @@ -9,25 +9,25 @@ Description: Generic interface to platform dependent persistent storage. > provide a generic interface to show records captured in > the dying moments. In the case of a panic the last part > of the console log is captured, but other interesting > - data can also be saved. > + data can also be saved:: > > - # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore > + # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore > > - $ ls -l /sys/fs/pstore/ > - total 0 > - -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1 > + $ ls -l /sys/fs/pstore/ > + total 0 > + -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1 > > Different users of this interface will result in different > filename prefixes. Currently two are defined: > > - "dmesg" - saved console log > - "mce" - architecture dependent data from fatal h/w error > + - "dmesg" - saved console log > + - "mce" - architecture dependent data from fatal h/w error > > Once the information in a file has been read, removing > the file will signal to the underlying persistent storage > - device that it can reclaim the space for later re-use. > + device that it can reclaim the space for later re-use:: > > - $ rm /sys/fs/pstore/dmesg-erst-1 > + $ rm /sys/fs/pstore/dmesg-erst-1 > > The expectation is that all files in /sys/fs/pstore/ > will be saved elsewhere and erased from persistent store > @@ -44,4 +44,3 @@ Description: Generic interface to platform dependent persistent storage. > backends are available, the preferred backend may be > set by passing the pstore.backend= argument to the kernel at > boot time. > - > diff --git a/Documentation/ABI/testing/sysfs-block-rnbd b/Documentation/ABI/testing/sysfs-block-rnbd > index 8f070b47f361..14a6fe9422b3 100644 > --- a/Documentation/ABI/testing/sysfs-block-rnbd > +++ b/Documentation/ABI/testing/sysfs-block-rnbd > @@ -9,9 +9,9 @@ Description: To unmap a volume, "normal" or "force" has to be written to: > is using the device. When "force" is used, the device is also unmapped > when device is in use. All I/Os that are in progress will fail. > > - Example: > + Example:: > > - # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device > + # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device > > What: /sys/block/rnbd<N>/rnbd/state > Date: Feb 2020 > diff --git a/Documentation/ABI/testing/sysfs-bus-acpi b/Documentation/ABI/testing/sysfs-bus-acpi > index c78603497b97..58abacf59b2a 100644 > --- a/Documentation/ABI/testing/sysfs-bus-acpi > +++ b/Documentation/ABI/testing/sysfs-bus-acpi > @@ -5,6 +5,7 @@ Description: > This attribute indicates the full path of ACPI namespace > object associated with the device object. For example, > \_SB_.PCI0. > + > This file is not present for device objects representing > fixed ACPI hardware features (like power and sleep > buttons). > diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 > index b5f526081711..3e92cbd3fd83 100644 > --- a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 > +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 > @@ -4,7 +4,10 @@ KernelVersion: 3.19 > Contact: Mathieu Poirier <mathieu.poirier@xxxxxxxxxx> > Description: (RW) Add/remove a sink from a trace path. There can be multiple > source for a single sink. > - ex: echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink > + > + ex:: > + > + echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink > > What: /sys/bus/coresight/devices/<memory_map>.etb/trigger_cntr > Date: November 2014 > diff --git a/Documentation/ABI/testing/sysfs-bus-css b/Documentation/ABI/testing/sysfs-bus-css > index 966f8504bd7b..12a733fe357f 100644 > --- a/Documentation/ABI/testing/sysfs-bus-css > +++ b/Documentation/ABI/testing/sysfs-bus-css > @@ -20,6 +20,7 @@ Contact: Cornelia Huck <cornelia.huck@xxxxxxxxxx> > Description: Contains the ids of the channel paths used by this > subchannel, as reported by the channel subsystem > during subchannel recognition. > + > Note: This is an I/O-subchannel specific attribute. > Users: s390-tools, HAL > > @@ -31,6 +32,7 @@ Description: Contains the PIM/PAM/POM values, as reported by the > channel subsystem when last queried by the common I/O > layer (this implies that this attribute is not necessarily > in sync with the values current in the channel subsystem). > + > Note: This is an I/O-subchannel specific attribute. > Users: s390-tools, HAL > > @@ -53,6 +55,7 @@ Description: This file allows the driver for a device to be specified. When > opt-out of driver binding using a driver_override name such as > "none". Only a single driver may be specified in the override, > there is no support for parsing delimiters. > + > Note that unlike the mechanism of the same name for pci, this > file does not allow to override basic matching rules. I.e., > the driver must still match the subchannel type of the device. > diff --git a/Documentation/ABI/testing/sysfs-bus-dfl b/Documentation/ABI/testing/sysfs-bus-dfl > index 23543be904f2..b0265ab17200 100644 > --- a/Documentation/ABI/testing/sysfs-bus-dfl > +++ b/Documentation/ABI/testing/sysfs-bus-dfl > @@ -4,6 +4,7 @@ KernelVersion: 5.10 > Contact: Xu Yilun <yilun.xu@xxxxxxxxx> > Description: Read-only. It returns type of DFL FIU of the device. Now DFL > supports 2 FIU types, 0 for FME, 1 for PORT. > + > Format: 0x%x > > What: /sys/bus/dfl/devices/dfl_dev.X/feature_id > @@ -12,4 +13,5 @@ KernelVersion: 5.10 > Contact: Xu Yilun <yilun.xu@xxxxxxxxx> > Description: Read-only. It returns feature identifier local to its DFL FIU > type. > + > Format: 0x%x > diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 > index 2273627df190..de390a010af8 100644 > --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 > +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 > @@ -7,7 +7,7 @@ Description: Read-only. Attribute group to describe the magic bits > > Each attribute under this group defines a bit range of the > perf_event_attr.config. All supported attributes are listed > - below. > + below:: > > chip = "config:16-31" > core = "config:16-31" > @@ -16,9 +16,9 @@ Description: Read-only. Attribute group to describe the magic bits > offset = "config:32-63" > vcpu = "config:16-31" > > - For example, > + For example:: > > - PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0" > + PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0" > > In this event, '?' after chip specifies that > this value will be provided by user while running this event. > diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci > index 6a023b42486c..12e2bf92783f 100644 > --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci > +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci > @@ -7,7 +7,7 @@ Description: Read-only. Attribute group to describe the magic bits > > Each attribute under this group defines a bit range of the > perf_event_attr.config. All supported attributes are listed > - below. > + below:: > > counter_info_version = "config:16-23" > length = "config:24-31" > @@ -20,9 +20,9 @@ Description: Read-only. Attribute group to describe the magic bits > secondary_index = "config:0-15" > starting_index = "config:32-63" > > - For example, > + For example:: > > - processor_core_utilization_instructions_completed = "request=0x94, > + processor_core_utilization_instructions_completed = "request=0x94, > phys_processor_idx=?,counter_info_version=0x8, > length=8,offset=0x18" > > @@ -36,6 +36,7 @@ Description: > '0' if the hypervisor is configured to forbid access to event > counters being accumulated by other guests and to physical > domain event counters. > + > '1' if that access is allowed. > > What: /sys/bus/event_source/devices/hv_gpci/interface/ga > diff --git a/Documentation/ABI/testing/sysfs-bus-fcoe b/Documentation/ABI/testing/sysfs-bus-fcoe > index 657df13b100d..8fe787cc4ab7 100644 > --- a/Documentation/ABI/testing/sysfs-bus-fcoe > +++ b/Documentation/ABI/testing/sysfs-bus-fcoe > @@ -3,16 +3,19 @@ Date: August 2012 > KernelVersion: TBD > Contact: Robert Love <robert.w.love@xxxxxxxxx>, devel@xxxxxxxxxxxxx > Description: The FCoE bus. Attributes in this directory are control interfaces. > + > Attributes: > > - ctlr_create: 'FCoE Controller' instance creation interface. Writing an > + ctlr_create: > + 'FCoE Controller' instance creation interface. Writing an > <ifname> to this file will allocate and populate sysfs with a > fcoe_ctlr_device (ctlr_X). The user can then configure any > per-port settings and finally write to the fcoe_ctlr_device's > 'start' attribute to begin the kernel's discovery and login > process. > > - ctlr_destroy: 'FCoE Controller' instance removal interface. Writing a > + ctlr_destroy: > + 'FCoE Controller' instance removal interface. Writing a > fcoe_ctlr_device's sysfs name to this file will log the > fcoe_ctlr_device out of the fabric or otherwise connected > FCoE devices. It will also free all kernel memory allocated > @@ -32,11 +35,13 @@ Description: 'FCoE Controller' instances on the fcoe bus. > > Attributes: > > - fcf_dev_loss_tmo: Device loss timeout period (see below). Changing > + fcf_dev_loss_tmo: > + Device loss timeout period (see below). Changing > this value will change the dev_loss_tmo for all > FCFs discovered by this controller. > > - mode: Display or change the FCoE Controller's mode. Possible > + mode: > + Display or change the FCoE Controller's mode. Possible > modes are 'Fabric' and 'VN2VN'. If a FCoE Controller > is started in 'Fabric' mode then FIP FCF discovery is > initiated and ultimately a fabric login is attempted. > @@ -44,23 +49,30 @@ Attributes: > FIP VN2VN discovery and login is performed. A FCoE > Controller only supports one mode at a time. > > - enabled: Whether an FCoE controller is enabled or disabled. > + enabled: > + Whether an FCoE controller is enabled or disabled. > 0 if disabled, 1 if enabled. Writing either 0 or 1 > to this file will enable or disable the FCoE controller. > > - lesb/link_fail: Link Error Status Block (LESB) link failure count. > + lesb/link_fail: > + Link Error Status Block (LESB) link failure count. > > - lesb/vlink_fail: Link Error Status Block (LESB) virtual link > + lesb/vlink_fail: > + Link Error Status Block (LESB) virtual link > failure count. > > - lesb/miss_fka: Link Error Status Block (LESB) missed FCoE > + lesb/miss_fka: > + Link Error Status Block (LESB) missed FCoE > Initialization Protocol (FIP) Keep-Alives (FKA). > > - lesb/symb_err: Link Error Status Block (LESB) symbolic error count. > + lesb/symb_err: > + Link Error Status Block (LESB) symbolic error count. > > - lesb/err_block: Link Error Status Block (LESB) block error count. > + lesb/err_block: > + Link Error Status Block (LESB) block error count. > > - lesb/fcs_error: Link Error Status Block (LESB) Fibre Channel > + lesb/fcs_error: > + Link Error Status Block (LESB) Fibre Channel > Services error count. > > Notes: ctlr_X (global increment starting at 0) > @@ -75,31 +87,41 @@ Description: 'FCoE FCF' instances on the fcoe bus. A FCF is a Fibre Channel > Fibre Channel frames into a FC fabric. It can also take > outbound FC frames and pack them in Ethernet packets to > be sent to their destination on the Ethernet segment. > + > Attributes: > > - fabric_name: Identifies the fabric that the FCF services. > + fabric_name: > + Identifies the fabric that the FCF services. > > - switch_name: Identifies the FCF. > + switch_name: > + Identifies the FCF. > > - priority: The switch's priority amongst other FCFs on the same > + priority: > + The switch's priority amongst other FCFs on the same > fabric. > > - selected: 1 indicates that the switch has been selected for use; > + selected: > + 1 indicates that the switch has been selected for use; > 0 indicates that the switch will not be used. > > - fc_map: The Fibre Channel MAP > + fc_map: > + The Fibre Channel MAP > > - vfid: The Virtual Fabric ID > + vfid: > + The Virtual Fabric ID > > - mac: The FCF's MAC address > + mac: > + The FCF's MAC address > > - fka_period: The FIP Keep-Alive period > + fka_period: > + The FIP Keep-Alive period > > fabric_state: The internal kernel state > - "Unknown" - Initialization value > - "Disconnected" - No link to the FCF/fabric > - "Connected" - Host is connected to the FCF > - "Deleted" - FCF is being removed from the system > + > + - "Unknown" - Initialization value > + - "Disconnected" - No link to the FCF/fabric > + - "Connected" - Host is connected to the FCF > + - "Deleted" - FCF is being removed from the system > > dev_loss_tmo: The device loss timeout period for this FCF. > > diff --git a/Documentation/ABI/testing/sysfs-bus-fsl-mc b/Documentation/ABI/testing/sysfs-bus-fsl-mc > index 80256b8b4f26..bf3c6af6ad89 100644 > --- a/Documentation/ABI/testing/sysfs-bus-fsl-mc > +++ b/Documentation/ABI/testing/sysfs-bus-fsl-mc > @@ -6,8 +6,10 @@ Description: > the driver to attempt to bind to the device found at > this location. The format for the location is Object.Id > and is the same as found in /sys/bus/fsl-mc/devices/. > - For example: > - # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind > + > + For example:: > + > + # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind > > What: /sys/bus/fsl-mc/drivers/.../unbind > Date: December 2016 > @@ -17,5 +19,7 @@ Description: > driver to attempt to unbind from the device found at > this location. The format for the location is Object.Id > and is the same as found in /sys/bus/fsl-mc/devices/. > - For example: > - # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind > + > + For example:: > + > + # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind > diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 > index 9de269bb0ae5..42dfc9399d2d 100644 > --- a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 > +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 > @@ -3,19 +3,25 @@ Date: February 2011 > Contact: Minkyu Kang <mk7.kang@xxxxxxxxxxx> > Description: > show what device is attached > - NONE - no device > - USB - USB device is attached > - UART - UART is attached > - CHARGER - Charger is attaced > - JIG - JIG is attached > + > + ======= ====================== > + NONE no device > + USB USB device is attached > + UART UART is attached > + CHARGER Charger is attaced > + JIG JIG is attached > + ======= ====================== > > What: /sys/bus/i2c/devices/.../switch > Date: February 2011 > Contact: Minkyu Kang <mk7.kang@xxxxxxxxxxx> > Description: > show or set the state of manual switch > - VAUDIO - switch to VAUDIO path > - UART - switch to UART path > - AUDIO - switch to AUDIO path > - DHOST - switch to DHOST path > - AUTO - switch automatically by device > + > + ======= ============================== > + VAUDIO switch to VAUDIO path > + UART switch to UART path > + AUDIO switch to AUDIO path > + DHOST switch to DHOST path > + AUTO switch automatically by device > + ======= ============================== > diff --git a/Documentation/ABI/testing/sysfs-bus-i3c b/Documentation/ABI/testing/sysfs-bus-i3c > index 2f332ec36f82..1f4a2662335b 100644 > --- a/Documentation/ABI/testing/sysfs-bus-i3c > +++ b/Documentation/ABI/testing/sysfs-bus-i3c > @@ -84,6 +84,7 @@ Description: > by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl". > See the I3C specification for more details about these HDR > modes. > + > This entry describes the HDRCAP of the master controller > driving the bus. > > @@ -135,6 +136,7 @@ Description: > Expose the HDR (High Data Rate) capabilities of a device. > Returns a list of supported HDR mode, each element is separated > by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl". > + > See the I3C specification for more details about these HDR > modes. > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio > index e3df71987eff..df42bed09f25 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio > +++ b/Documentation/ABI/testing/sysfs-bus-iio > @@ -15,6 +15,7 @@ Description: > based on hardware generated events (e.g. data ready) or > provided by a separate driver for other hardware (e.g. > periodic timer, GPIO or high resolution timer). > + > Contains trigger type specific elements. These do not > generalize well and hence are not documented in this file. > X is the IIO index of the trigger. > @@ -666,6 +667,7 @@ Description: > <type>[Y][_name]_<raw|input>_thresh_falling_value may take > different values, but the device can only enable both thresholds > or neither. > + > Note the driver will assume the last p events requested are > to be enabled where p is how many it supports (which may vary > depending on the exact set requested. So if you want to be > @@ -720,6 +722,7 @@ Description: > <type>[Y][_name]_<raw|input>_roc_falling_value may take > different values, but the device can only enable both rate of > change thresholds or neither. > + > Note the driver will assume the last p events requested are > to be enabled where p is however many it supports (which may > vary depending on the exact set requested. So if you want to be > @@ -775,9 +778,11 @@ Description: > Specifies the value of threshold that the device is comparing > against for the events enabled by > <type>Y[_name]_thresh[_rising|falling]_en. > + > If separate attributes exist for the two directions, but > direction is not specified for this attribute, then a single > threshold value applies to both directions. > + > The raw or input element of the name indicates whether the > value is in raw device units or in processed units (as _raw > and _input do on sysfs direct channel read attributes). > @@ -860,6 +865,7 @@ Description: > If separate attributes exist for the two directions, but > direction is not specified for this attribute, then a single > hysteresis value applies to both directions. > + > For falling events the hysteresis is added to the _value attribute for > this event to get the upper threshold for when the event goes back to > normal, for rising events the hysteresis is subtracted from the _value > @@ -906,6 +912,7 @@ Description: > Specifies the value of rate of change threshold that the > device is comparing against for the events enabled by > <type>[Y][_name]_roc[_rising|falling]_en. > + > If separate attributes exist for the two directions, > but direction is not specified for this attribute, > then a single threshold value applies to both directions. > @@ -1305,6 +1312,7 @@ Description: > Proximity measurement indicating that some > object is near the sensor, usually by observing > reflectivity of infrared or ultrasound emitted. > + > Often these sensors are unit less and as such conversion > to SI units is not possible. Higher proximity measurements > indicate closer objects, and vice versa. Units after > @@ -1450,9 +1458,12 @@ Contact: linux-iio@xxxxxxxxxxxxxxx > Description: > A single positive integer specifying the maximum number of scan > elements to wait for. > + > Poll will block until the watermark is reached. > + > Blocking read will wait until the minimum between the requested > read amount or the low water mark is available. > + > Non-blocking read will retrieve the available samples from the > buffer even if there are less samples then watermark level. This > allows the application to block on poll with a timeout and read > @@ -1481,11 +1492,13 @@ Description: > device settings allows it (e.g. if a trigger is set that samples > data differently that the hardware fifo does then hardware fifo > will not enabled). > + > If the hardware fifo is enabled and the level of the hardware > fifo reaches the hardware fifo watermark level the device will > flush its hardware fifo to the device buffer. Doing a non > blocking read on the device when no samples are present in the > device buffer will also force a flush. > + > When the hardware fifo is enabled there is no need to use a > trigger to use buffer mode since the watermark settings > guarantees that the hardware fifo is flushed to the device > @@ -1523,6 +1536,7 @@ Description: > A single positive integer specifying the minimum watermark level > for the hardware fifo of this device. If the device does not > have a hardware fifo this entry is not present. > + > If the user sets buffer/watermark to a value less than this one, > then the hardware watermark will remain unset. > > @@ -1533,6 +1547,7 @@ Description: > A single positive integer specifying the maximum watermark level > for the hardware fifo of this device. If the device does not > have a hardware fifo this entry is not present. > + > If the user sets buffer/watermark to a value greater than this > one, then the hardware watermark will be capped at this value. > > @@ -1544,6 +1559,7 @@ Description: > levels for the hardware fifo. This entry is optional and if it > is not present it means that all the values between > hwfifo_watermark_min and hwfifo_watermark_max are supported. > + > If the user sets buffer/watermark to a value greater than > hwfifo_watermak_min but not equal to any of the values in this > list, the driver will chose an appropriate value for the > @@ -1605,7 +1621,8 @@ KernelVersion: 4.1.0 > Contact: linux-iio@xxxxxxxxxxxxxxx > Description: > '1' (enable) or '0' (disable) specifying the enable > - of heater function. Same reading values apply > + of heater function. Same reading values apply. > + > This ABI is especially applicable for humidity sensors > to heatup the device and get rid of any condensation > in some humidity environment > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 > index f30b4c424fb6..4b01150af397 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 > @@ -19,9 +19,11 @@ Description: > is separately set for "GND-Open" and "Supply-Open" modes. > Channels 0..31 have common low threshold values, but could have different > sensing_modes. > + > The low voltage threshold range is between 2..21V. > Hysteresis between low and high thresholds can not be lower then 2 and > can not be odd. > + > If falling threshold results hysteresis to odd value then rising > threshold is automatically subtracted by one. > > @@ -34,10 +36,13 @@ Description: > this value then the threshold rising event is pushed. > Depending on in_voltageY_sensing_mode the high voltage threshold > is separately set for "GND-Open" and "Supply-Open" modes. > + > Channels 0..31 have common high threshold values, but could have different > sensing_modes. > + > The high voltage threshold range is between 3..22V. > Hysteresis between low and high thresholds can not be lower then 2 and > can not be odd. > + > If rising threshold results hysteresis to odd value then falling > threshold is automatically appended by one. > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 > index efe4c85e3c8b..1975c7a1af34 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 > @@ -5,10 +5,13 @@ Description: > The STM32 ADC can be configured to use external trigger sources > (e.g. timers, pwm or exti gpio). Then, it can be tuned to start > conversions on external trigger by either: > + > - "rising-edge" > - "falling-edge" > - "both-edges". > + > Reading returns current trigger polarity. > + > Writing value before enabling conversions sets trigger polarity. > > What: /sys/bus/iio/devices/triggerX/trigger_polarity_available > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > index a133fd8d081a..40df5c9fef99 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > @@ -15,8 +15,11 @@ Description: > first object echoed in meters. Default value is 6.020. > This setting limits the time the driver is waiting for a > echo. > + > Showing the range of available values is represented as the > minimum value, the step and the maximum value, all enclosed > in square brackets. > - Example: > - [0.043 0.043 11.008] > + > + Example:: > + > + [0.043 0.043 11.008] > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 > index a91aeabe7b24..d065cda7dd96 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 > @@ -8,7 +8,9 @@ KernelVersion: 3.4.0 > Contact: linux-iio@xxxxxxxxxxxxxxx > Description: > Reading returns either '1' or '0'. > + > '1' means that the clock in question is present. > + > '0' means that the clock is missing. > > What: /sys/bus/iio/devices/iio:deviceX/pllY_locked > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 > index 302de64cb424..544548ee794c 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 > @@ -27,12 +27,12 @@ What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_name > KernelVersion: > Contact: linux-iio@xxxxxxxxxxxxxxx > Description: > - Reading returns the datasheet name for channel Y: > + Reading returns the datasheet name for channel Y:: > > - out_altvoltage0_name: RF8x > - out_altvoltage1_name: RFAUX8x > - out_altvoltage2_name: RF16x > - out_altvoltage3_name: RF32x > + out_altvoltage0_name: RF8x > + out_altvoltage1_name: RFAUX8x > + out_altvoltage2_name: RF16x > + out_altvoltage3_name: RF32x > > What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown > KernelVersion: > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x > index 6adba9058b22..66b621f10223 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x > +++ b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x > @@ -6,10 +6,14 @@ Description: > Get measured values from the ADC for these stages. Y is the > specific stage number corresponding to datasheet stage names > as follows: > - 1 -> LED2 > - 2 -> ALED2/LED3 > - 3 -> LED1 > - 4 -> ALED1/LED4 > + > + == ========== > + 1 LED2 > + 2 ALED2/LED3 > + 3 LED1 > + 4 ALED1/LED4 > + == ========== > + > Note that channels 5 and 6 represent LED2-ALED2 and LED1-ALED1 > respectively which simply helper channels containing the > calculated difference in the value of stage 1 - 2 and 3 - 4. > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 > index f0ce0a0476ea..220206a20d98 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 > @@ -15,5 +15,7 @@ Description: > Scheme 0 has wider dynamic range, Scheme 1 proximity detection > is less affected by the ambient IR noise variation. > > - 0 Sensing IR from LED and ambient > - 1 Sensing IR from LED with ambient IR rejection > + == ============================================= > + 0 Sensing IR from LED and ambient > + 1 Sensing IR from LED with ambient IR rejection > + == ============================================= > diff --git a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth > index 22d0843849a8..b7b2278fe042 100644 > --- a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth > +++ b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth > @@ -10,10 +10,13 @@ Date: June 2015 > KernelVersion: 4.3 > Contact: Alexander Shishkin <alexander.shishkin@xxxxxxxxxxxxxxx> > Description: (RO) Output port type: > - 0: not present, > - 1: MSU (Memory Storage Unit) > - 2: CTP (Common Trace Port) > - 4: PTI (MIPI PTI). > + > + == ========================= > + 0 not present, > + 1 MSU (Memory Storage Unit) > + 2 CTP (Common Trace Port) > + 4 PTI (MIPI PTI). > + == ========================= > > What: /sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_drop > Date: June 2015 > diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem > index c1a67275c43f..8316c33862a0 100644 > --- a/Documentation/ABI/testing/sysfs-bus-papr-pmem > +++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem > @@ -11,19 +11,26 @@ Description: > at 'Documentation/powerpc/papr_hcalls.rst' . Below are > the flags reported in this sysfs file: > > - * "not_armed" : Indicates that NVDIMM contents will not > + * "not_armed" > + Indicates that NVDIMM contents will not > survive a power cycle. > - * "flush_fail" : Indicates that NVDIMM contents > + * "flush_fail" > + Indicates that NVDIMM contents > couldn't be flushed during last > shut-down event. > - * "restore_fail": Indicates that NVDIMM contents > + * "restore_fail" > + Indicates that NVDIMM contents > couldn't be restored during NVDIMM > initialization. > - * "encrypted" : NVDIMM contents are encrypted. > - * "smart_notify": There is health event for the NVDIMM. > - * "scrubbed" : Indicating that contents of the > + * "encrypted" > + NVDIMM contents are encrypted. > + * "smart_notify" > + There is health event for the NVDIMM. > + * "scrubbed" > + Indicating that contents of the > NVDIMM have been scrubbed. > - * "locked" : Indicating that NVDIMM contents cant > + * "locked" > + Indicating that NVDIMM contents cant > be modified until next power cycle. > > What: /sys/bus/nd/devices/nmemX/papr/perf_stats > @@ -51,4 +58,4 @@ Description: > * "MedWDur " : Media Write Duration > * "CchRHCnt" : Cache Read Hit Count > * "CchWHCnt" : Cache Write Hit Count > - * "FastWCnt" : Fast Write Count > \ No newline at end of file > + * "FastWCnt" : Fast Write Count > diff --git a/Documentation/ABI/testing/sysfs-bus-pci b/Documentation/ABI/testing/sysfs-bus-pci > index 450296cc7948..77ad9ec3c801 100644 > --- a/Documentation/ABI/testing/sysfs-bus-pci > +++ b/Documentation/ABI/testing/sysfs-bus-pci > @@ -7,8 +7,10 @@ Description: > this location. This is useful for overriding default > bindings. The format for the location is: DDDD:BB:DD.F. > That is Domain:Bus:Device.Function and is the same as > - found in /sys/bus/pci/devices/. For example: > - # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind > + found in /sys/bus/pci/devices/. For example:: > + > + # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind > + > (Note: kernels before 2.6.28 may require echo -n). > > What: /sys/bus/pci/drivers/.../unbind > @@ -20,8 +22,10 @@ Description: > this location. This may be useful when overriding default > bindings. The format for the location is: DDDD:BB:DD.F. > That is Domain:Bus:Device.Function and is the same as > - found in /sys/bus/pci/devices/. For example: > - # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind > + found in /sys/bus/pci/devices/. For example:: > + > + # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind > + > (Note: kernels before 2.6.28 may require echo -n). > > What: /sys/bus/pci/drivers/.../new_id > @@ -38,8 +42,9 @@ Description: > Class, Class Mask, and Private Driver Data. The Vendor ID > and Device ID fields are required, the rest are optional. > Upon successfully adding an ID, the driver will probe > - for the device and attempt to bind to it. For example: > - # echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id > + for the device and attempt to bind to it. For example:: > + > + # echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id > > What: /sys/bus/pci/drivers/.../remove_id > Date: February 2009 > @@ -54,8 +59,9 @@ Description: > required, the rest are optional. After successfully > removing an ID, the driver will no longer support the > device. This is useful to ensure auto probing won't > - match the driver to the device. For example: > - # echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id > + match the driver to the device. For example:: > + > + # echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id > > What: /sys/bus/pci/rescan > Date: January 2009 > diff --git a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt > index 8a200f4eefbd..f85db86d63e8 100644 > --- a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt > +++ b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt > @@ -4,6 +4,7 @@ Contact: Cezary Rojewski <cezary.rojewski@xxxxxxxxx> > Description: > Version of AudioDSP firmware ASoC catpt driver is > communicating with. > + > Format: %d.%d.%d.%d, type:major:minor:build. > > What: /sys/devices/pci0000:00/<dev>/fw_info > diff --git a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd > index 60c60fa624b2..c90d97a80855 100644 > --- a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd > +++ b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd > @@ -21,11 +21,11 @@ Description: > number returns the port to normal operation. > > For example: To force the high-speed device attached to > - port 4 on bus 2 to run at full speed: > + port 4 on bus 2 to run at full speed:: > > echo 4 >/sys/bus/usb/devices/usb2/../companion > > - To return the port to high-speed operation: > + To return the port to high-speed operation:: > > echo -4 >/sys/bus/usb/devices/usb2/../companion > > diff --git a/Documentation/ABI/testing/sysfs-bus-rbd b/Documentation/ABI/testing/sysfs-bus-rbd > index cc30bee8b5f4..417a2fe21be1 100644 > --- a/Documentation/ABI/testing/sysfs-bus-rbd > +++ b/Documentation/ABI/testing/sysfs-bus-rbd > @@ -7,6 +7,8 @@ Description: > > Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>] > > + Example:: > + > $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add > > The snapshot name can be "-" or omitted to map the image > @@ -23,6 +25,8 @@ Description: > > Usage: <dev-id> [force] > > + Example:: > + > $ echo 2 > /sys/bus/rbd/remove > > Optional "force" argument which when passed will wait for > @@ -80,26 +84,29 @@ Date: Oct, 2010 > KernelVersion: v2.6.37 > Contact: Sage Weil <sage@xxxxxxxxxxxx> > Description: > - size: (RO) The size (in bytes) of the mapped block > + > + ============== ================================================ > + size (RO) The size (in bytes) of the mapped block > device. > > - major: (RO) The block device major number. > + major (RO) The block device major number. > > - client_id: (RO) The ceph unique client id that was assigned > + client_id (RO) The ceph unique client id that was assigned > for this specific session. > > - pool: (RO) The name of the storage pool where this rbd > + pool (RO) The name of the storage pool where this rbd > image resides. An rbd image name is unique > within its pool. > > - name: (RO) The name of the rbd image. > + name (RO) The name of the rbd image. > > - refresh: (WO) Writing to this file will reread the image > + refresh (WO) Writing to this file will reread the image > header data and set all relevant data structures > accordingly. > > - current_snap: (RO) The current snapshot for which the device > + current_snap (RO) The current snapshot for which the device > is mapped. > + ============== ================================================ > > > What: /sys/bus/rbd/devices/<dev-id>/pool_id > @@ -117,11 +124,13 @@ Date: Oct, 2012 > KernelVersion: v3.7 > Contact: Sage Weil <sage@xxxxxxxxxxxx> > Description: > - image_id: (RO) The unique id for the rbd image. (For rbd > + ========= =============================================== > + image_id (RO) The unique id for the rbd image. (For rbd > image format 1 this is empty.) > > - features: (RO) A hexadecimal encoding of the feature bits > + features (RO) A hexadecimal encoding of the feature bits > for this image. > + ========= =============================================== > > > What: /sys/bus/rbd/devices/<dev-id>/parent > @@ -149,14 +158,16 @@ Date: Aug, 2016 > KernelVersion: v4.9 > Contact: Sage Weil <sage@xxxxxxxxxxxx> > Description: > - snap_id: (RO) The current snapshot's id. > + ============ ================================================ > + snap_id (RO) The current snapshot's id. > > - config_info: (RO) The string written into > + config_info (RO) The string written into > /sys/bus/rbd/add{,_single_major}. > > - cluster_fsid: (RO) The ceph cluster UUID. > + cluster_fsid (RO) The ceph cluster UUID. > > - client_addr: (RO) The ceph unique client > + client_addr (RO) The ceph unique client > entity_addr_t (address + nonce). The format is > <address>:<port>/<nonce>: '1.2.3.4:1234/5678' or > '[1:2:3:4:5:6:7:8]:1234/5678'. > + ============ ================================================ > diff --git a/Documentation/ABI/testing/sysfs-bus-siox b/Documentation/ABI/testing/sysfs-bus-siox > index c2a403f20b90..50e80238f30d 100644 > --- a/Documentation/ABI/testing/sysfs-bus-siox > +++ b/Documentation/ABI/testing/sysfs-bus-siox > @@ -8,6 +8,7 @@ Description: > When the file contains a "1" the bus is operated and periodically > does a push-pull cycle to write and read data from the > connected devices. > + > When writing a "0" or "1" the bus moves to the described state. > > What: /sys/bus/siox/devices/siox-X/device_add > @@ -21,8 +22,10 @@ Description: > to add a new device dynamically. <type> is the name that is used to match > to a driver (similar to the platform bus). <inbytes> and <outbytes> define > the length of the input and output shift register in bytes respectively. > + > <statustype> defines the 4 bit device type that is check to identify connection > problems. > + > The new device is added to the end of the existing chain. > > What: /sys/bus/siox/devices/siox-X/device_remove > diff --git a/Documentation/ABI/testing/sysfs-bus-thunderbolt b/Documentation/ABI/testing/sysfs-bus-thunderbolt > index 171127294674..0b4ab9e4b8f4 100644 > --- a/Documentation/ABI/testing/sysfs-bus-thunderbolt > +++ b/Documentation/ABI/testing/sysfs-bus-thunderbolt > @@ -193,10 +193,11 @@ Description: When new NVM image is written to the non-active NVM > verification fails an error code is returned instead. > > This file will accept writing values "1" or "2" > + > - Writing "1" will flush the image to the storage > - area and authenticate the image in one action. > + area and authenticate the image in one action. > - Writing "2" will run some basic validation on the image > - and flush it to the storage area. > + and flush it to the storage area. > > When read holds status of the last authentication > operation if an error occurred during the process. This > @@ -213,9 +214,11 @@ Description: This contains name of the property directory the XDomain > question. Following directories are already reserved by > the Apple XDomain specification: > > - network: IP/ethernet over Thunderbolt > - targetdm: Target disk mode protocol over Thunderbolt > - extdisp: External display mode protocol over Thunderbolt > + ======== =============================================== > + network IP/ethernet over Thunderbolt > + targetdm Target disk mode protocol over Thunderbolt > + extdisp External display mode protocol over Thunderbolt > + ======== =============================================== > > What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias > Date: Jan 2018 > @@ -293,7 +296,8 @@ Description: For supported devices, automatically authenticate the new Thunderbo > image when the device is disconnected from the host system. > > This file will accept writing values "1" or "2" > + > - Writing "1" will flush the image to the storage > - area and prepare the device for authentication on disconnect. > + area and prepare the device for authentication on disconnect. > - Writing "2" will run some basic validation on the image > - and flush it to the storage area. > + and flush it to the storage area. > diff --git a/Documentation/ABI/testing/sysfs-bus-usb b/Documentation/ABI/testing/sysfs-bus-usb > index e449b8374f6a..bf2c1968525f 100644 > --- a/Documentation/ABI/testing/sysfs-bus-usb > +++ b/Documentation/ABI/testing/sysfs-bus-usb > @@ -9,6 +9,7 @@ Description: > by writing INTERFACE to /sys/bus/usb/drivers_probe > This allows to avoid side-effects with drivers > that need multiple interfaces. > + > A deauthorized interface cannot be probed or claimed. > > What: /sys/bus/usb/devices/usbX/interface_authorized_default > @@ -216,6 +217,7 @@ Description: > - Bit 0 of this field selects the "old" enumeration scheme, > as it is considerably faster (it only causes one USB reset > instead of 2). > + > The old enumeration scheme can also be selected globally > using /sys/module/usbcore/parameters/old_scheme_first, but > it is often not desirable as the new scheme was introduced to > diff --git a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 > index c0e0a9ae7b3d..8251e78abc49 100644 > --- a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 > +++ b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 > @@ -6,8 +6,10 @@ Description: > Get the ALS output channel used as input in > ALS-current-control mode (0, 1), where: > > - 0 - out_current0 (backlight 0) > - 1 - out_current1 (backlight 1) > + == ========================== > + 0 out_current0 (backlight 0) > + 1 out_current1 (backlight 1) > + == ========================== > > What: /sys/class/backlight/<backlight>/als_en > Date: May 2012 > @@ -30,8 +32,10 @@ Contact: Johan Hovold <jhovold@xxxxxxxxx> > Description: > Set the brightness-mapping mode (0, 1), where: > > - 0 - exponential mode > - 1 - linear mode > + == ================ > + 0 exponential mode > + 1 linear mode > + == ================ > > What: /sys/class/backlight/<backlight>/pwm > Date: April 2012 > @@ -40,9 +44,11 @@ Contact: Johan Hovold <jhovold@xxxxxxxxx> > Description: > Set the PWM-input control mask (5 bits), where: > > - bit 5 - PWM-input enabled in Zone 4 > - bit 4 - PWM-input enabled in Zone 3 > - bit 3 - PWM-input enabled in Zone 2 > - bit 2 - PWM-input enabled in Zone 1 > - bit 1 - PWM-input enabled in Zone 0 > - bit 0 - PWM-input enabled > + ===== =========================== > + bit 5 PWM-input enabled in Zone 4 > + bit 4 PWM-input enabled in Zone 3 > + bit 3 PWM-input enabled in Zone 2 > + bit 2 PWM-input enabled in Zone 1 > + bit 1 PWM-input enabled in Zone 0 > + bit 0 PWM-input enabled > + ===== =========================== > diff --git a/Documentation/ABI/testing/sysfs-class-bdi b/Documentation/ABI/testing/sysfs-class-bdi > index d773d5697cf5..5402bd74ba43 100644 > --- a/Documentation/ABI/testing/sysfs-class-bdi > +++ b/Documentation/ABI/testing/sysfs-class-bdi > @@ -24,7 +24,6 @@ default > filesystems which do not provide their own BDI. > > Files under /sys/class/bdi/<bdi>/ > ---------------------------------- > > read_ahead_kb (read-write) > > diff --git a/Documentation/ABI/testing/sysfs-class-chromeos b/Documentation/ABI/testing/sysfs-class-chromeos > index 5819699d66ec..74ece942722e 100644 > --- a/Documentation/ABI/testing/sysfs-class-chromeos > +++ b/Documentation/ABI/testing/sysfs-class-chromeos > @@ -17,13 +17,14 @@ Date: August 2015 > KernelVersion: 4.2 > Description: > Tell the EC to reboot in various ways. Options are: > - "cancel": Cancel a pending reboot. > - "ro": Jump to RO without rebooting. > - "rw": Jump to RW without rebooting. > - "cold": Cold reboot. > - "disable-jump": Disable jump until next reboot. > - "hibernate": Hibernate the EC. > - "at-shutdown": Reboot after an AP shutdown. > + > + - "cancel": Cancel a pending reboot. > + - "ro": Jump to RO without rebooting. > + - "rw": Jump to RW without rebooting. > + - "cold": Cold reboot. > + - "disable-jump": Disable jump until next reboot. > + - "hibernate": Hibernate the EC. > + - "at-shutdown": Reboot after an AP shutdown. > > What: /sys/class/chromeos/<ec-device-name>/version > Date: August 2015 > diff --git a/Documentation/ABI/testing/sysfs-class-cxl b/Documentation/ABI/testing/sysfs-class-cxl > index a6f51a104c44..818f55970efb 100644 > --- a/Documentation/ABI/testing/sysfs-class-cxl > +++ b/Documentation/ABI/testing/sysfs-class-cxl > @@ -217,6 +217,7 @@ Description: read/write > card. A power cycle is required to load the image. > "none" could be useful for debugging because the trace arrays > are preserved. > + > "user" and "factory" means PERST will cause either the user or > user or factory image to be loaded. > Default is to reload on PERST whichever image the card has > @@ -240,8 +241,11 @@ Contact: linuxppc-dev@xxxxxxxxxxxxxxxx > Description: read/write > Trust that when an image is reloaded via PERST, it will not > have changed. > - 0 = don't trust, the image may be different (default) > - 1 = trust that the image will not change. > + > + == ================================================= > + 0 don't trust, the image may be different (default) > + 1 trust that the image will not change. > + == ================================================= > Users: https://github.com/ibm-capi/libcxl > > What: /sys/class/cxl/<card>/psl_timebase_synced > diff --git a/Documentation/ABI/testing/sysfs-class-devlink b/Documentation/ABI/testing/sysfs-class-devlink > index 64791b65c9a3..b662f747c83e 100644 > --- a/Documentation/ABI/testing/sysfs-class-devlink > +++ b/Documentation/ABI/testing/sysfs-class-devlink > @@ -18,9 +18,9 @@ Description: > > This will be one of the following strings: > > - 'consumer unbind' > - 'supplier unbind' > - 'never' > + - 'consumer unbind' > + - 'supplier unbind' > + - 'never' > > 'consumer unbind' means the device link will be removed when > the consumer's driver is unbound from the consumer device. > @@ -49,8 +49,10 @@ Description: > > This will be one of the following strings: > > - '0' - Does not affect runtime power management > - '1' - Affects runtime power management > + === ======================================== > + '0' Does not affect runtime power management > + '1' Affects runtime power management > + === ======================================== > > What: /sys/class/devlink/.../status > Date: May 2020 > @@ -68,13 +70,13 @@ Description: > > This will be one of the following strings: > > - 'not tracked' > - 'dormant' > - 'available' > - 'consumer probing' > - 'active' > - 'supplier unbinding' > - 'unknown' > + - 'not tracked' > + - 'dormant' > + - 'available' > + - 'consumer probing' > + - 'active' > + - 'supplier unbinding' > + - 'unknown' > > 'not tracked' means this device link does not track the status > and has no impact on the binding, unbinding and syncing the > @@ -114,8 +116,10 @@ Description: > > This will be one of the following strings: > > + === ================================ > '0' > - '1' - Affects runtime power management > + '1' Affects runtime power management > + === ================================ > > '0' means the device link can affect other device behaviors > like binding/unbinding, suspend/resume, runtime power > diff --git a/Documentation/ABI/testing/sysfs-class-extcon b/Documentation/ABI/testing/sysfs-class-extcon > index 57a726232912..fde0fecd5de9 100644 > --- a/Documentation/ABI/testing/sysfs-class-extcon > +++ b/Documentation/ABI/testing/sysfs-class-extcon > @@ -39,19 +39,22 @@ Description: > callback. > > If the default callback for showing function is used, the > - format is like this: > - # cat state > - USB_OTG=1 > - HDMI=0 > - TA=1 > - EAR_JACK=0 > - # > + format is like this:: > + > + # cat state > + USB_OTG=1 > + HDMI=0 > + TA=1 > + EAR_JACK=0 > + # > + > In this example, the extcon device has USB_OTG and TA > cables attached and HDMI and EAR_JACK cables detached. > > In order to update the state of an extcon device, enter a hex > - state number starting with 0x: > - # echo 0xHEX > state > + state number starting with 0x:: > + > + # echo 0xHEX > state > > This updates the whole state of the extcon device. > Inputs of all the methods are required to meet the > @@ -84,12 +87,13 @@ Contact: MyungJoo Ham <myungjoo.ham@xxxxxxxxxxx> > Description: > Shows the relations of mutually exclusiveness. For example, > if the mutually_exclusive array of extcon device is > - {0x3, 0x5, 0xC, 0x0}, then the output is: > - # ls mutually_exclusive/ > - 0x3 > - 0x5 > - 0xc > - # > + {0x3, 0x5, 0xC, 0x0}, then the output is:: > + > + # ls mutually_exclusive/ > + 0x3 > + 0x5 > + 0xc > + # > > Note that mutually_exclusive is a sub-directory of the extcon > device and the file names under the mutually_exclusive > diff --git a/Documentation/ABI/testing/sysfs-class-fpga-manager b/Documentation/ABI/testing/sysfs-class-fpga-manager > index 5284fa33d4c5..d78689c357a5 100644 > --- a/Documentation/ABI/testing/sysfs-class-fpga-manager > +++ b/Documentation/ABI/testing/sysfs-class-fpga-manager > @@ -28,8 +28,7 @@ Description: Read fpga manager state as a string. > * firmware request = firmware class request in progress > * firmware request error = firmware request failed > * write init = preparing FPGA for programming > - * write init error = Error while preparing FPGA for > - programming > + * write init error = Error while preparing FPGA for programming > * write = FPGA ready to receive image data > * write error = Error while programming > * write complete = Doing post programming steps > @@ -47,7 +46,7 @@ Description: Read fpga manager status as a string. > programming errors to userspace. This is a list of strings for > the supported status. > > - * reconfig operation error - invalid operations detected by > + * reconfig operation error - invalid operations detected by > reconfiguration hardware. > e.g. start reconfiguration > with errors not cleared > diff --git a/Documentation/ABI/testing/sysfs-class-gnss b/Documentation/ABI/testing/sysfs-class-gnss > index 2467b6900eae..c8553d972edd 100644 > --- a/Documentation/ABI/testing/sysfs-class-gnss > +++ b/Documentation/ABI/testing/sysfs-class-gnss > @@ -6,9 +6,11 @@ Description: > The GNSS receiver type. The currently identified types reflect > the protocol(s) supported by the receiver: > > + ====== =========== > "NMEA" NMEA 0183 > "SiRF" SiRF Binary > "UBX" UBX > + ====== =========== > > Note that also non-"NMEA" type receivers typically support a > subset of NMEA 0183 with vendor extensions (e.g. to allow > diff --git a/Documentation/ABI/testing/sysfs-class-led b/Documentation/ABI/testing/sysfs-class-led > index 65e040978f73..0ed5c2629c6f 100644 > --- a/Documentation/ABI/testing/sysfs-class-led > +++ b/Documentation/ABI/testing/sysfs-class-led > @@ -47,6 +47,7 @@ Contact: Richard Purdie <rpurdie@xxxxxxxxx> > Description: > Set the trigger for this LED. A trigger is a kernel based source > of LED events. > + > You can change triggers in a similar manner to the way an IO > scheduler is chosen. Trigger specific parameters can appear in > /sys/class/leds/<led> once a given trigger is selected. For > diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 > index 69befe947d7e..da546e86deb5 100644 > --- a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 > +++ b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 > @@ -27,23 +27,23 @@ Description: > > ^ > | > - 0 On -|----+ +----+ +--- > + 0 On -|----+ +----+ +--- > | | | | | > Off-| +-------------------+ +-------------------+ > | > - 1 On -| +----+ +----+ > + 1 On -| +----+ +----+ > | | | | | > Off |----+ +-------------------+ +------------------ > | > - 2 On -| +----+ +----+ > + 2 On -| +----+ +----+ > | | | | | > Off-|---------+ +-------------------+ +------------- > | > - 3 On -| +----+ +----+ > + 3 On -| +----+ +----+ > | | | | | > Off-|--------------+ +-------------------+ +-------- > | > - 4 On -| +----+ +----+ > + 4 On -| +----+ +----+ > | | | | | > Off-|-------------------+ +-------------------+ +--- > | > @@ -55,23 +55,23 @@ Description: > > ^ > | > - 0 On -| +-------------------+ +-------------------+ > + 0 On -| +-------------------+ +-------------------+ > | | | | | > Off-|----+ +----+ +--- > | > - 1 On -|----+ +-------------------+ +------------------ > + 1 On -|----+ +-------------------+ +------------------ > | | | | | > Off | +----+ +----+ > | > - 2 On -|---------+ +-------------------+ +------------- > + 2 On -|---------+ +-------------------+ +------------- > | | | | | > Off-| +----+ +----+ > | > - 3 On -|--------------+ +-------------------+ +-------- > + 3 On -|--------------+ +-------------------+ +-------- > | | | | | > Off-| +----+ +----+ > | > - 4 On -|-------------------+ +-------------------+ +--- > + 4 On -|-------------------+ +-------------------+ +--- > | | | | | > Off-| +----+ +----+ > | > @@ -83,23 +83,23 @@ Description: > > ^ > | > - 0 On -|----+ +-------- > + 0 On -|----+ +-------- > | | | > Off-| +---------------------------------------+ > | > - 1 On -| +----+ +----+ > + 1 On -| +----+ +----+ > | | | | | > Off |----+ +-----------------------------+ +-------- > | > - 2 On -| +----+ +----+ > + 2 On -| +----+ +----+ > | | | | | > Off-|---------+ +-------------------+ +------------- > | > - 3 On -| +----+ +----+ > + 3 On -| +----+ +----+ > | | | | | > Off-|--------------+ +---------+ +------------------ > | > - 4 On -| +---------+ > + 4 On -| +---------+ > | | | > Off-|-------------------+ +----------------------- > | > diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 > index e4c89b261546..e38a835d0a85 100644 > --- a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 > +++ b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 > @@ -6,8 +6,10 @@ Description: > Set the ALS output channel to use as input in > ALS-current-control mode (1, 2), where: > > - 1 - out_current1 > - 2 - out_current2 > + == ============ > + 1 out_current1 > + 2 out_current2 > + == ============ > > What: /sys/class/leds/<led>/als_en > Date: May 2012 > @@ -24,14 +26,16 @@ Contact: Johan Hovold <jhovold@xxxxxxxxx> > Description: > Set the pattern generator fall and rise times (0..7), where: > > - 0 - 2048 us > - 1 - 262 ms > - 2 - 524 ms > - 3 - 1.049 s > - 4 - 2.097 s > - 5 - 4.194 s > - 6 - 8.389 s > - 7 - 16.78 s > + == ======= > + 0 2048 us > + 1 262 ms > + 2 524 ms > + 3 1.049 s > + 4 2.097 s > + 5 4.194 s > + 6 8.389 s > + 7 16.78 s > + == ======= > > What: /sys/class/leds/<led>/id > Date: April 2012 > @@ -47,8 +51,10 @@ Contact: Johan Hovold <jhovold@xxxxxxxxx> > Description: > Set the brightness-mapping mode (0, 1), where: > > - 0 - exponential mode > - 1 - linear mode > + == ================ > + 0 exponential mode > + 1 linear mode > + == ================ > > What: /sys/class/leds/<led>/pwm > Date: April 2012 > @@ -57,9 +63,11 @@ Contact: Johan Hovold <jhovold@xxxxxxxxx> > Description: > Set the PWM-input control mask (5 bits), where: > > - bit 5 - PWM-input enabled in Zone 4 > - bit 4 - PWM-input enabled in Zone 3 > - bit 3 - PWM-input enabled in Zone 2 > - bit 2 - PWM-input enabled in Zone 1 > - bit 1 - PWM-input enabled in Zone 0 > - bit 0 - PWM-input enabled > + ===== =========================== > + bit 5 PWM-input enabled in Zone 4 > + bit 4 PWM-input enabled in Zone 3 > + bit 3 PWM-input enabled in Zone 2 > + bit 2 PWM-input enabled in Zone 1 > + bit 1 PWM-input enabled in Zone 0 > + bit 0 PWM-input enabled > + ===== =========================== > diff --git a/Documentation/ABI/testing/sysfs-class-led-flash b/Documentation/ABI/testing/sysfs-class-led-flash > index 220a0270b47b..11e5677c3672 100644 > --- a/Documentation/ABI/testing/sysfs-class-led-flash > +++ b/Documentation/ABI/testing/sysfs-class-led-flash > @@ -55,26 +55,35 @@ Description: read only > Flash faults are re-read after strobing the flash. Possible > flash faults: > > - * led-over-voltage - flash controller voltage to the flash LED > + * led-over-voltage > + flash controller voltage to the flash LED > has exceeded the limit specific to the flash controller > - * flash-timeout-exceeded - the flash strobe was still on when > + * flash-timeout-exceeded > + the flash strobe was still on when > the timeout set by the user has expired; not all flash > controllers may set this in all such conditions > - * controller-over-temperature - the flash controller has > + * controller-over-temperature > + the flash controller has > overheated > - * controller-short-circuit - the short circuit protection > + * controller-short-circuit > + the short circuit protection > of the flash controller has been triggered > - * led-power-supply-over-current - current in the LED power > + * led-power-supply-over-current > + current in the LED power > supply has exceeded the limit specific to the flash > controller > - * indicator-led-fault - the flash controller has detected > + * indicator-led-fault > + the flash controller has detected > a short or open circuit condition on the indicator LED > - * led-under-voltage - flash controller voltage to the flash > + * led-under-voltage > + flash controller voltage to the flash > LED has been below the minimum limit specific to > the flash > - * controller-under-voltage - the input voltage of the flash > + * controller-under-voltage > + the input voltage of the flash > controller is below the limit under which strobing the > flash at full current will not be possible; > the condition persists until this flag is no longer set > - * led-over-temperature - the temperature of the LED has exceeded > + * led-over-temperature > + the temperature of the LED has exceeded > its allowed upper limit > diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev > index 451af6d6768c..646540950e38 100644 > --- a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev > +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev > @@ -19,18 +19,23 @@ KernelVersion: 4.16 > Contact: linux-leds@xxxxxxxxxxxxxxx > Description: > Signal the link state of the named network device. > + > If set to 0 (default), the LED's normal state is off. > + > If set to 1, the LED's normal state reflects the link state > of the named network device. > Setting this value also immediately changes the LED state. > > + > What: /sys/class/leds/<led>/tx > Date: Dec 2017 > KernelVersion: 4.16 > Contact: linux-leds@xxxxxxxxxxxxxxx > Description: > Signal transmission of data on the named network device. > + > If set to 0 (default), the LED will not blink on transmission. > + > If set to 1, the LED will blink for the milliseconds specified > in interval to signal transmission. > > @@ -40,6 +45,8 @@ KernelVersion: 4.16 > Contact: linux-leds@xxxxxxxxxxxxxxx > Description: > Signal reception of data on the named network device. > + > If set to 0 (default), the LED will not blink on reception. > + > If set to 1, the LED will blink for the milliseconds specified > in interval to signal reception. > diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport > index f440e690daef..eb81152b8348 100644 > --- a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport > +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport > @@ -8,5 +8,6 @@ Description: > selected for the USB port trigger. Selecting ports makes trigger > observing them for any connected devices and lighting on LED if > there are any. > + > Echoing "1" value selects USB port. Echoing "0" unselects it. > Current state can be also read. > diff --git a/Documentation/ABI/testing/sysfs-class-leds-gt683r b/Documentation/ABI/testing/sysfs-class-leds-gt683r > index 6adab27f646e..b57ffb26e722 100644 > --- a/Documentation/ABI/testing/sysfs-class-leds-gt683r > +++ b/Documentation/ABI/testing/sysfs-class-leds-gt683r > @@ -7,9 +7,11 @@ Description: > of one LED will update the mode of its two sibling devices as > well. Possible values are: > > - 0 - normal > - 1 - audio > - 2 - breathing > + == ========= > + 0 normal > + 1 audio > + 2 breathing > + == ========= > > Normal: LEDs are fully on when enabled > Audio: LEDs brightness depends on sound level > diff --git a/Documentation/ABI/testing/sysfs-class-net b/Documentation/ABI/testing/sysfs-class-net > index 3b404577f380..7670012ae9b6 100644 > --- a/Documentation/ABI/testing/sysfs-class-net > +++ b/Documentation/ABI/testing/sysfs-class-net > @@ -4,10 +4,13 @@ KernelVersion: 3.17 > Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates the name assignment type. Possible values are: > - 1: enumerated by the kernel, possibly in an unpredictable way > - 2: predictably named by the kernel > - 3: named by userspace > - 4: renamed > + > + == ========================================================== > + 1 enumerated by the kernel, possibly in an unpredictable way > + 2 predictably named by the kernel > + 3 named by userspace > + 4 renamed > + == ========================================================== > > What: /sys/class/net/<iface>/addr_assign_type > Date: July 2010 > @@ -15,10 +18,13 @@ KernelVersion: 3.2 > Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates the address assignment type. Possible values are: > - 0: permanent address > - 1: randomly generated > - 2: stolen from another device > - 3: set using dev_set_mac_address > + > + == ============================= > + 0 permanent address > + 1 randomly generated > + 2 stolen from another device > + 3 set using dev_set_mac_address > + == ============================= > > What: /sys/class/net/<iface>/addr_len > Date: April 2005 > @@ -51,9 +57,12 @@ Description: > Default value 0 does not forward any link local frames. > > Restricted bits: > - 0: 01-80-C2-00-00-00 Bridge Group Address used for STP > - 1: 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE > - 2: 01-80-C2-00-00-02 (Link Aggregation) 802.3ad > + > + == ======================================================== > + 0 01-80-C2-00-00-00 Bridge Group Address used for STP > + 1 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE > + 2 01-80-C2-00-00-02 (Link Aggregation) 802.3ad > + == ======================================================== > > Any values not setting these bits can be used. Take special > care when forwarding control frames e.g. 802.1X-PAE or LLDP. > @@ -74,8 +83,11 @@ Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates the current physical link state of the interface. > Posssible values are: > - 0: physical link is down > - 1: physical link is up > + > + == ===================== > + 0 physical link is down > + 1 physical link is up > + == ===================== > > Note: some special devices, e.g: bonding and team drivers will > allow this attribute to be written to force a link state for > @@ -131,8 +143,11 @@ Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates whether the interface is under test. Possible > values are: > - 0: interface is not being tested > - 1: interface is being tested > + > + == ============================= > + 0 interface is not being tested > + 1 interface is being tested > + == ============================= > > When an interface is under test, it cannot be expected > to pass packets as normal. > @@ -144,8 +159,11 @@ Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates the interface latest or current duplex value. Possible > values are: > - half: half duplex > - full: full duplex > + > + ==== =========== > + half half duplex > + full full duplex > + ==== =========== > > Note: This attribute is only valid for interfaces that implement > the ethtool get_link_ksettings method (mostly Ethernet). > @@ -196,8 +214,11 @@ Description: > Indicates the interface link mode, as a decimal number. This > attribute should be used in conjunction with 'dormant' attribute > to determine the interface usability. Possible values: > - 0: default link mode > - 1: dormant link mode > + > + == ================= > + 0 default link mode > + 1 dormant link mode > + == ================= > > What: /sys/class/net/<iface>/mtu > Date: April 2005 > @@ -226,7 +247,9 @@ KernelVersion: 2.6.17 > Contact: netdev@xxxxxxxxxxxxxxx > Description: > Indicates the interface RFC2863 operational state as a string. > + > Possible values are: > + > "unknown", "notpresent", "down", "lowerlayerdown", "testing", > "dormant", "up". > > diff --git a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm > index f7be0e88b139..06416d0e163d 100644 > --- a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm > +++ b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm > @@ -91,9 +91,9 @@ Date: May 2014 > KernelVersion: 3.16 > Contact: Bjørn Mork <bjorn@xxxxxxx> > Description: > - Bit 0: 16-bit NTB supported (set to 1) > - Bit 1: 32-bit NTB supported > - Bits 2 – 15: reserved (reset to zero; must be ignored by host) > + - Bit 0: 16-bit NTB supported (set to 1) > + - Bit 1: 32-bit NTB supported > + - Bits 2 – 15: reserved (reset to zero; must be ignored by host) > > What: /sys/class/net/<iface>/cdc_ncm/dwNtbInMaxSize > Date: May 2014 > diff --git a/Documentation/ABI/testing/sysfs-class-net-phydev b/Documentation/ABI/testing/sysfs-class-net-phydev > index 206cbf538b59..40ced0ea4316 100644 > --- a/Documentation/ABI/testing/sysfs-class-net-phydev > +++ b/Documentation/ABI/testing/sysfs-class-net-phydev > @@ -35,7 +35,9 @@ Description: > Ethernet driver during bus enumeration, encoded in string. > This interface mode is used to configure the Ethernet MAC with the > appropriate mode for its data lines to the PHY hardware. > + > Possible values are: > + > <empty> (not available), mii, gmii, sgmii, tbi, rev-mii, > rmii, rgmii, rgmii-id, rgmii-rxid, rgmii-txid, rtbi, smii > xgmii, moca, qsgmii, trgmii, 1000base-x, 2500base-x, rxaui, > diff --git a/Documentation/ABI/testing/sysfs-class-pktcdvd b/Documentation/ABI/testing/sysfs-class-pktcdvd > index dde4f26d0780..ba1ce626591d 100644 > --- a/Documentation/ABI/testing/sysfs-class-pktcdvd > +++ b/Documentation/ABI/testing/sysfs-class-pktcdvd > @@ -11,15 +11,17 @@ KernelVersion: 2.6.20 > Contact: Thomas Maier <balagi@xxxxxxxxxxx> > Description: > > - add: (WO) Write a block device id (major:minor) to > + ========== ============================================== > + add (WO) Write a block device id (major:minor) to > create a new pktcdvd device and map it to the > block device. > > - remove: (WO) Write the pktcdvd device id (major:minor) > + remove (WO) Write the pktcdvd device id (major:minor) > to remove the pktcdvd device. > > - device_map: (RO) Shows the device mapping in format: > + device_map (RO) Shows the device mapping in format: > pktcdvd[0-7] <pktdevid> <blkdevid> > + ========== ============================================== > > > What: /sys/class/pktcdvd/pktcdvd[0-7]/dev > @@ -65,29 +67,31 @@ Date: Oct. 2006 > KernelVersion: 2.6.20 > Contact: Thomas Maier <balagi@xxxxxxxxxxx> > Description: > - size: (RO) Contains the size of the bio write queue. > + ============== ================================================ > + size (RO) Contains the size of the bio write queue. > > - congestion_off: (RW) If bio write queue size is below this mark, > + congestion_off (RW) If bio write queue size is below this mark, > accept new bio requests from the block layer. > > - congestion_on: (RW) If bio write queue size is higher as this > + congestion_on (RW) If bio write queue size is higher as this > mark, do no longer accept bio write requests > from the block layer and wait till the pktcdvd > device has processed enough bio's so that bio > write queue size is below congestion off mark. > A value of <= 0 disables congestion control. > + ============== ================================================ > > > Example: > -------- > -To use the pktcdvd sysfs interface directly, you can do: > +To use the pktcdvd sysfs interface directly, you can do:: > > -# create a new pktcdvd device mapped to /dev/hdc > -echo "22:0" >/sys/class/pktcdvd/add > -cat /sys/class/pktcdvd/device_map > -# assuming device pktcdvd0 was created, look at stat's > -cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written > -# print the device id of the mapped block device > -fgrep pktcdvd0 /sys/class/pktcdvd/device_map > -# remove device, using pktcdvd0 device id 253:0 > -echo "253:0" >/sys/class/pktcdvd/remove > + # create a new pktcdvd device mapped to /dev/hdc > + echo "22:0" >/sys/class/pktcdvd/add > + cat /sys/class/pktcdvd/device_map > + # assuming device pktcdvd0 was created, look at stat's > + cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written > + # print the device id of the mapped block device > + fgrep pktcdvd0 /sys/class/pktcdvd/device_map > + # remove device, using pktcdvd0 device id 253:0 > + echo "253:0" >/sys/class/pktcdvd/remove > diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power > index d4319a04c302..d68ad528a8e5 100644 > --- a/Documentation/ABI/testing/sysfs-class-power > +++ b/Documentation/ABI/testing/sysfs-class-power > @@ -43,7 +43,9 @@ Date: May 2007 > Contact: linux-pm@xxxxxxxxxxxxxxx > Description: > Fine grain representation of battery capacity. > + > Access: Read > + > Valid values: 0 - 100 (percent) > > What: /sys/class/power_supply/<supply_name>/capacity_alert_max > @@ -58,6 +60,7 @@ Description: > low). > > Access: Read, Write > + > Valid values: 0 - 100 (percent) > > What: /sys/class/power_supply/<supply_name>/capacity_alert_min > @@ -88,6 +91,7 @@ Description: > completely useless. > > Access: Read > + > Valid values: 0 - 100 (percent) > > What: /sys/class/power_supply/<supply_name>/capacity_level > @@ -111,6 +115,7 @@ Description: > which they average readings to smooth out the reported value. > > Access: Read > + > Valid values: Represented in microamps. Negative values are used > for discharging batteries, positive values for charging batteries. > > @@ -131,6 +136,7 @@ Description: > This value is not averaged/smoothed. > > Access: Read > + > Valid values: Represented in microamps. Negative values are used > for discharging batteries, positive values for charging batteries. > > @@ -383,7 +389,7 @@ Description: > > **USB Properties** > > -What: /sys/class/power_supply/<supply_name>/current_avg > +What: /sys/class/power_supply/<supply_name>/current_avg > Date: May 2007 > Contact: linux-pm@xxxxxxxxxxxxxxx > Description: > @@ -449,6 +455,7 @@ Description: > solved using power limit use input_voltage_limit. > > Access: Read, Write > + > Valid values: Represented in microvolts > > What: /sys/class/power_supply/<supply_name>/input_power_limit > @@ -462,6 +469,7 @@ Description: > limit only for problems that can be solved using power limit. > > Access: Read, Write > + > Valid values: Represented in microwatts > > What: /sys/class/power_supply/<supply_name>/online, > @@ -747,6 +755,7 @@ Description: > manufactured. > > Access: Read > + > Valid values: Reported as integer > > What: /sys/class/power_supply/<supply_name>/manufacture_month > @@ -756,6 +765,7 @@ Description: > Reports the month when the device has been manufactured. > > Access: Read > + > Valid values: 1-12 > > What: /sys/class/power_supply/<supply_name>/manufacture_day > diff --git a/Documentation/ABI/testing/sysfs-class-power-mp2629 b/Documentation/ABI/testing/sysfs-class-power-mp2629 > index 327a07e22805..914d67caac0d 100644 > --- a/Documentation/ABI/testing/sysfs-class-power-mp2629 > +++ b/Documentation/ABI/testing/sysfs-class-power-mp2629 > @@ -5,4 +5,5 @@ Description: > Represents a battery impedance compensation to accelerate charging. > > Access: Read, Write > + > Valid values: Represented in milli-ohms. Valid range is [0, 140]. > diff --git a/Documentation/ABI/testing/sysfs-class-power-twl4030 b/Documentation/ABI/testing/sysfs-class-power-twl4030 > index 7ac36dba87bc..b52f7023f8ba 100644 > --- a/Documentation/ABI/testing/sysfs-class-power-twl4030 > +++ b/Documentation/ABI/testing/sysfs-class-power-twl4030 > @@ -6,9 +6,9 @@ Description: > Possible values are: > > ============= =========================================== > - "auto" draw power as appropriate for detected > + "auto" draw power as appropriate for detected > power source and battery status. > - "off" do not draw any power. > + "off" do not draw any power. > "continuous" activate mode described as "linear" in > TWL data sheets. This uses whatever > current is available and doesn't switch off > diff --git a/Documentation/ABI/testing/sysfs-class-rapidio b/Documentation/ABI/testing/sysfs-class-rapidio > index 8716beeb16c1..19aefb21b639 100644 > --- a/Documentation/ABI/testing/sysfs-class-rapidio > +++ b/Documentation/ABI/testing/sysfs-class-rapidio > @@ -6,6 +6,7 @@ Description: > The /sys/class/rapidio_port subdirectory contains individual > subdirectories named as "rapidioN" where N = mport ID registered > with RapidIO subsystem. > + > NOTE: An mport ID is not a RapidIO destination ID assigned to a > given local mport device. > > @@ -16,7 +17,9 @@ Contact: Matt Porter <mporter@xxxxxxxxxxxxxxxxxxx>, > Alexandre Bounine <alexandre.bounine@xxxxxxx> > Description: > (RO) reports RapidIO common transport system size: > + > 0 = small (8-bit destination ID, max. 256 devices), > + > 1 = large (16-bit destination ID, max. 65536 devices). > > What: /sys/class/rapidio_port/rapidioN/port_destid > @@ -25,31 +28,32 @@ KernelVersion: v3.15 > Contact: Matt Porter <mporter@xxxxxxxxxxxxxxxxxxx>, > Alexandre Bounine <alexandre.bounine@xxxxxxx> > Description: > - (RO) reports RapidIO destination ID assigned to the given > - RapidIO mport device. If value 0xFFFFFFFF is returned this means > - that no valid destination ID have been assigned to the mport > - (yet). Normally, before enumeration/discovery have been executed > - only fabric enumerating mports have a valid destination ID > - assigned to them using "hdid=..." rapidio module parameter. > + > +(RO) reports RapidIO destination ID assigned to the given > +RapidIO mport device. If value 0xFFFFFFFF is returned this means > +that no valid destination ID have been assigned to the mport > +(yet). Normally, before enumeration/discovery have been executed > +only fabric enumerating mports have a valid destination ID > +assigned to them using "hdid=..." rapidio module parameter. > > After enumeration or discovery was performed for a given mport device, > the corresponding subdirectory will also contain subdirectories for each > child RapidIO device connected to the mport. > > The example below shows mport device subdirectory with several child RapidIO > -devices attached to it. > +devices attached to it:: > > -[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l > -total 0 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0001 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0004 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0007 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0002 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0003 > -drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0005 > -lrwxrwxrwx 1 root root 0 Feb 11 15:11 device -> ../../../0000:01:00.0 > --r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid > -drwxr-xr-x 2 root root 0 Feb 11 15:11 power > -lrwxrwxrwx 1 root root 0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port > --r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size > --rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent > + [rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l > + total 0 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0001 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0004 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0007 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0002 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0003 > + drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0005 > + lrwxrwxrwx 1 root root 0 Feb 11 15:11 device -> ../../../0000:01:00.0 > + -r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid > + drwxr-xr-x 2 root root 0 Feb 11 15:11 power > + lrwxrwxrwx 1 root root 0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port > + -r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size > + -rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent > diff --git a/Documentation/ABI/testing/sysfs-class-regulator b/Documentation/ABI/testing/sysfs-class-regulator > index bc578bc60628..8516f08806dd 100644 > --- a/Documentation/ABI/testing/sysfs-class-regulator > +++ b/Documentation/ABI/testing/sysfs-class-regulator > @@ -35,13 +35,13 @@ Description: > > This will be one of the following strings: > > - off > - on > - error > - fast > - normal > - idle > - standby > + - off > + - on > + - error > + - fast > + - normal > + - idle > + - standby > > "off" means the regulator is not supplying power to the > system. > @@ -74,9 +74,9 @@ Description: > > This will be one of the following strings: > > - 'voltage' > - 'current' > - 'unknown' > + - 'voltage' > + - 'current' > + - 'unknown' > > 'voltage' means the regulator output voltage can be controlled > by software. > @@ -129,11 +129,11 @@ Description: > > The opmode value can be one of the following strings: > > - 'fast' > - 'normal' > - 'idle' > - 'standby' > - 'unknown' > + - 'fast' > + - 'normal' > + - 'idle' > + - 'standby' > + - 'unknown' > > The modes are described in include/linux/regulator/consumer.h > > @@ -360,9 +360,9 @@ Description: > > This will be one of the following strings: > > - 'enabled' > - 'disabled' > - 'unknown' > + - 'enabled' > + - 'disabled' > + - 'unknown' > > 'enabled' means the regulator is in bypass mode. > > diff --git a/Documentation/ABI/testing/sysfs-class-remoteproc b/Documentation/ABI/testing/sysfs-class-remoteproc > index 066b9b6f4924..0c9ee55098b8 100644 > --- a/Documentation/ABI/testing/sysfs-class-remoteproc > +++ b/Documentation/ABI/testing/sysfs-class-remoteproc > @@ -16,11 +16,11 @@ Description: Remote processor state > > Reports the state of the remote processor, which will be one of: > > - "offline" > - "suspended" > - "running" > - "crashed" > - "invalid" > + - "offline" > + - "suspended" > + - "running" > + - "crashed" > + - "invalid" > > "offline" means the remote processor is powered off. > > @@ -38,8 +38,8 @@ Description: Remote processor state > Writing this file controls the state of the remote processor. > The following states can be written: > > - "start" > - "stop" > + - "start" > + - "stop" > > Writing "start" will attempt to start the processor running the > firmware indicated by, or written to, > diff --git a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration > index ec950c93e5c6..ee8ed6494a01 100644 > --- a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration > +++ b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration > @@ -7,6 +7,7 @@ Description: Attribute for calibrating ST-Ericsson AB8500 Real Time Clock > calibrate the AB8500.s 32KHz Real Time Clock. > Every 60 seconds the AB8500 will correct the RTC's value > by adding to it the value of this attribute. > + > The range of the attribute is -127 to +127 in units of > 30.5 micro-seconds (half-parts-per-million of the 32KHz clock) > Users: The /vendor/st-ericsson/base_utilities/core/rtc_calibration > diff --git a/Documentation/ABI/testing/sysfs-class-uwb_rc b/Documentation/ABI/testing/sysfs-class-uwb_rc > index a0578751c1e3..6c5dcad21e19 100644 > --- a/Documentation/ABI/testing/sysfs-class-uwb_rc > +++ b/Documentation/ABI/testing/sysfs-class-uwb_rc > @@ -66,11 +66,14 @@ Description: > <channel> <type> [<bpst offset>] > > to start (or stop) scanning on a channel. <type> is one of: > - 0 - scan > - 1 - scan outside BP > - 2 - scan while inactive > - 3 - scanning disabled > - 4 - scan (with start time of <bpst offset>) > + > + == ======================================= > + 0 scan > + 1 scan outside BP > + 2 scan while inactive > + 3 scanning disabled > + 4 scan (with start time of <bpst offset>) > + == ======================================= > > What: /sys/class/uwb_rc/uwbN/mac_address > Date: July 2008 > diff --git a/Documentation/ABI/testing/sysfs-class-watchdog b/Documentation/ABI/testing/sysfs-class-watchdog > index 9860a8b2ba75..585caecda3a5 100644 > --- a/Documentation/ABI/testing/sysfs-class-watchdog > +++ b/Documentation/ABI/testing/sysfs-class-watchdog > @@ -91,10 +91,13 @@ Description: > h/w strapping (for WDT2 only). > > At alternate flash the 'access_cs0' sysfs node provides: > - ast2400: a way to get access to the primary SPI flash > + > + ast2400: > + a way to get access to the primary SPI flash > chip at CS0 after booting from the alternate > chip at CS1. > - ast2500: a way to restore the normal address mapping > + ast2500: > + a way to restore the normal address mapping > from (CS0->CS1, CS1->CS0) to (CS0->CS0, > CS1->CS1). > > diff --git a/Documentation/ABI/testing/sysfs-dev b/Documentation/ABI/testing/sysfs-dev > index a9f2b8b0530f..d1739063e762 100644 > --- a/Documentation/ABI/testing/sysfs-dev > +++ b/Documentation/ABI/testing/sysfs-dev > @@ -9,9 +9,10 @@ Description: The /sys/dev tree provides a method to look up the sysfs > the form "<major>:<minor>". These links point to the > corresponding sysfs path for the given device. > > - Example: > - $ readlink /sys/dev/block/8:32 > - ../../block/sdc > + Example:: > + > + $ readlink /sys/dev/block/8:32 > + ../../block/sdc > > Entries in /sys/dev/char and /sys/dev/block will be > dynamically created and destroyed as devices enter and > diff --git a/Documentation/ABI/testing/sysfs-devices-mapping b/Documentation/ABI/testing/sysfs-devices-mapping > index 490ccfd67f12..8d202bac9394 100644 > --- a/Documentation/ABI/testing/sysfs-devices-mapping > +++ b/Documentation/ABI/testing/sysfs-devices-mapping > @@ -8,26 +8,27 @@ Description: > block. > For example, on 4-die Xeon platform with up to 6 IIO stacks per > die and, therefore, 6 IIO PMON blocks per die, the mapping of > - IIO PMON block 0 exposes as the following: > + IIO PMON block 0 exposes as the following:: > > - $ ls /sys/devices/uncore_iio_0/die* > - -r--r--r-- /sys/devices/uncore_iio_0/die0 > - -r--r--r-- /sys/devices/uncore_iio_0/die1 > - -r--r--r-- /sys/devices/uncore_iio_0/die2 > - -r--r--r-- /sys/devices/uncore_iio_0/die3 > + $ ls /sys/devices/uncore_iio_0/die* > + -r--r--r-- /sys/devices/uncore_iio_0/die0 > + -r--r--r-- /sys/devices/uncore_iio_0/die1 > + -r--r--r-- /sys/devices/uncore_iio_0/die2 > + -r--r--r-- /sys/devices/uncore_iio_0/die3 > > - $ tail /sys/devices/uncore_iio_0/die* > - ==> /sys/devices/uncore_iio_0/die0 <== > - 0000:00 > - ==> /sys/devices/uncore_iio_0/die1 <== > - 0000:40 > - ==> /sys/devices/uncore_iio_0/die2 <== > - 0000:80 > - ==> /sys/devices/uncore_iio_0/die3 <== > - 0000:c0 > + $ tail /sys/devices/uncore_iio_0/die* > + ==> /sys/devices/uncore_iio_0/die0 <== > + 0000:00 > + ==> /sys/devices/uncore_iio_0/die1 <== > + 0000:40 > + ==> /sys/devices/uncore_iio_0/die2 <== > + 0000:80 > + ==> /sys/devices/uncore_iio_0/die3 <== > + 0000:c0 > > - Which means: > - IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000 > - IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000 > - IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000 > - IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000 > + Which means:: > + > + IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000 > + IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000 > + IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000 > + IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000 > diff --git a/Documentation/ABI/testing/sysfs-devices-memory b/Documentation/ABI/testing/sysfs-devices-memory > index deef3b5723cf..2da2b1fba2c1 100644 > --- a/Documentation/ABI/testing/sysfs-devices-memory > +++ b/Documentation/ABI/testing/sysfs-devices-memory > @@ -47,16 +47,19 @@ Description: > online/offline state of the memory section. When written, > root can toggle the the online/offline state of a removable > memory section (see removable file description above) > - using the following commands. > - # echo online > /sys/devices/system/memory/memoryX/state > - # echo offline > /sys/devices/system/memory/memoryX/state > + using the following commands:: > + > + # echo online > /sys/devices/system/memory/memoryX/state > + # echo offline > /sys/devices/system/memory/memoryX/state > > For example, if /sys/devices/system/memory/memory22/removable > contains a value of 1 and > /sys/devices/system/memory/memory22/state contains the > string "online" the following command can be executed by > - by root to offline that section. > - # echo offline > /sys/devices/system/memory/memory22/state > + by root to offline that section:: > + > + # echo offline > /sys/devices/system/memory/memory22/state > + > Users: hotplug memory remove tools > http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils > > @@ -78,6 +81,7 @@ Description: > > For example, the following symbolic link is created for > memory section 9 on node0: > + > /sys/devices/system/memory/memory9/node0 -> ../../node/node0 > > > @@ -90,4 +94,5 @@ Description: > points to the corresponding /sys/devices/system/memory/memoryY > memory section directory. For example, the following symbolic > link is created for memory section 9 on node0. > + > /sys/devices/system/node/node0/memory9 -> ../../memory/memory9 > diff --git a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget > index d548eaac230a..40f29a01fd14 100644 > --- a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget > +++ b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget > @@ -3,8 +3,9 @@ Date: April 2010 > Contact: Fabien Chouteau <fabien.chouteau@xxxxxxxxx> > Description: > Show the suspend state of an USB composite gadget. > - 1 -> suspended > - 0 -> resumed > + > + - 1 -> suspended > + - 0 -> resumed > > (_UDC_ is the name of the USB Device Controller driver) > > @@ -17,5 +18,6 @@ Description: > Storage mode. > > Possible values are: > - 1 -> ignore the FUA flag > - 0 -> obey the FUA flag > + > + - 1 -> ignore the FUA flag > + - 0 -> obey the FUA flag > diff --git a/Documentation/ABI/testing/sysfs-devices-platform-ipmi b/Documentation/ABI/testing/sysfs-devices-platform-ipmi > index afb5db856e1c..07df0ddc0b69 100644 > --- a/Documentation/ABI/testing/sysfs-devices-platform-ipmi > +++ b/Documentation/ABI/testing/sysfs-devices-platform-ipmi > @@ -123,38 +123,40 @@ KernelVersion: v4.15 > Contact: openipmi-developer@xxxxxxxxxxxxxxxxxxxxx > Description: > > - idles: (RO) Number of times the interface was > + ====================== ======================================== > + idles (RO) Number of times the interface was > idle while being polled. > > - watchdog_pretimeouts: (RO) Number of watchdog pretimeouts. > + watchdog_pretimeouts (RO) Number of watchdog pretimeouts. > > - complete_transactions: (RO) Number of completed messages. > + complete_transactions (RO) Number of completed messages. > > - events: (RO) Number of IPMI events received from > + events (RO) Number of IPMI events received from > the hardware. > > - interrupts: (RO) Number of interrupts the driver > + interrupts (RO) Number of interrupts the driver > handled. > > - hosed_count: (RO) Number of times the hardware didn't > + hosed_count (RO) Number of times the hardware didn't > follow the state machine. > > - long_timeouts: (RO) Number of times the driver > + long_timeouts (RO) Number of times the driver > requested a timer while nothing was in > progress. > > - flag_fetches: (RO) Number of times the driver > + flag_fetches (RO) Number of times the driver > requested flags from the hardware. > > - attentions: (RO) Number of time the driver got an > + attentions (RO) Number of time the driver got an > ATTN from the hardware. > > - incoming_messages: (RO) Number of asynchronous messages > + incoming_messages (RO) Number of asynchronous messages > received. > > - short_timeouts: (RO) Number of times the driver > + short_timeouts (RO) Number of times the driver > requested a timer while an operation was > in progress. > + ====================== ======================================== > > > What: /sys/devices/platform/ipmi_si.*/interrupts_enabled > @@ -201,38 +203,40 @@ Date: Sep, 2017 > KernelVersion: v4.15 > Contact: openipmi-developer@xxxxxxxxxxxxxxxxxxxxx > Description: > - hosed: (RO) Number of times the hardware didn't > + ====================== ======================================== > + hosed (RO) Number of times the hardware didn't > follow the state machine. > > - alerts: (RO) Number of alerts received. > + alerts (RO) Number of alerts received. > > - sent_messages: (RO) Number of total messages sent. > + sent_messages (RO) Number of total messages sent. > > - sent_message_parts: (RO) Number of message parts sent. > + sent_message_parts (RO) Number of message parts sent. > Messages may be broken into parts if > they are long. > > - received_messages: (RO) Number of message responses > + received_messages (RO) Number of message responses > received. > > - received_message_parts: (RO) Number of message fragments > + received_message_parts (RO) Number of message fragments > received. > > - events: (RO) Number of received events. > + events (RO) Number of received events. > > - watchdog_pretimeouts: (RO) Number of watchdog pretimeouts. > + watchdog_pretimeouts (RO) Number of watchdog pretimeouts. > > - flag_fetches: (RO) Number of times a flag fetch was > + flag_fetches (RO) Number of times a flag fetch was > requested. > > - send_retries: (RO) Number of time a message was > + send_retries (RO) Number of time a message was > retried. > > - receive_retries: (RO) Number of times the receive of a > + receive_retries (RO) Number of times the receive of a > message was retried. > > - send_errors: (RO) Number of times the send of a > + send_errors (RO) Number of times the send of a > message failed. > > - receive_errors: (RO) Number of errors in receiving > + receive_errors (RO) Number of errors in receiving > messages. > + ====================== ======================================== > diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu > index 274c337ec6a9..1a04ca8162ad 100644 > --- a/Documentation/ABI/testing/sysfs-devices-system-cpu > +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu > @@ -169,7 +169,7 @@ Description: > observed CPU idle duration was too short for it > (a count). > > - below: (RO) Number of times this state was entered, but the > + below: (RO) Number of times this state was entered, but the > observed CPU idle duration was too long for it > (a count). > ======== ==== ================================================= > @@ -601,7 +601,7 @@ Description: Secure Virtual Machine > Facility in POWER9 and newer processors. i.e., it is a Secure > Virtual Machine. > > -What: /sys/devices/system/cpu/cpuX/purr > +What: /sys/devices/system/cpu/cpuX/purr > Date: Apr 2005 > Contact: Linux for PowerPC mailing list <linuxppc-dev@xxxxxxxxxx> > Description: PURR ticks for this CPU since the system boot. > diff --git a/Documentation/ABI/testing/sysfs-driver-hid-lenovo b/Documentation/ABI/testing/sysfs-driver-hid-lenovo > index 53a0725962e1..aee85ca1f6be 100644 > --- a/Documentation/ABI/testing/sysfs-driver-hid-lenovo > +++ b/Documentation/ABI/testing/sysfs-driver-hid-lenovo > @@ -3,14 +3,18 @@ Date: July 2011 > Contact: linux-input@xxxxxxxxxxxxxxx > Description: This controls if mouse clicks should be generated if the trackpoint is quickly pressed. How fast this press has to be > is being controlled by press_speed. > + > Values are 0 or 1. > + > Applies to Thinkpad USB Keyboard with TrackPoint. > > What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/dragging > Date: July 2011 > Contact: linux-input@xxxxxxxxxxxxxxx > Description: If this setting is enabled, it is possible to do dragging by pressing the trackpoint. This requires press_to_select to be enabled. > + > Values are 0 or 1. > + > Applies to Thinkpad USB Keyboard with TrackPoint. > > What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/release_to_select > @@ -25,7 +29,9 @@ Date: July 2011 > Contact: linux-input@xxxxxxxxxxxxxxx > Description: This setting controls if the mouse click events generated by pressing the trackpoint (if press_to_select is enabled) generate > a left or right mouse button click. > + > Values are 0 or 1. > + > Applies to Thinkpad USB Keyboard with TrackPoint. > > What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/sensitivity > @@ -39,12 +45,16 @@ What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid- > Date: July 2011 > Contact: linux-input@xxxxxxxxxxxxxxx > Description: This setting controls how fast the trackpoint needs to be pressed to generate a mouse click if press_to_select is enabled. > + > Values are decimal integers from 1 (slowest) to 255 (fastest). > + > Applies to Thinkpad USB Keyboard with TrackPoint. > > What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fn_lock > Date: July 2014 > Contact: linux-input@xxxxxxxxxxxxxxx > Description: This setting controls whether Fn Lock is enabled on the keyboard (i.e. if F1 is Mute or F1) > + > Values are 0 or 1 > + > Applies to ThinkPad Compact (USB|Bluetooth) Keyboard with TrackPoint. > diff --git a/Documentation/ABI/testing/sysfs-driver-hid-ntrig b/Documentation/ABI/testing/sysfs-driver-hid-ntrig > index e574a5625efe..0e323a5cec6c 100644 > --- a/Documentation/ABI/testing/sysfs-driver-hid-ntrig > +++ b/Documentation/ABI/testing/sysfs-driver-hid-ntrig > @@ -29,12 +29,13 @@ Contact: linux-input@xxxxxxxxxxxxxxx > Description: > Threholds to override activation slack. > > - activation_width: (RW) Width threshold to immediately > + ================= ===================================== > + activation_width (RW) Width threshold to immediately > start processing touch events. > > - activation_height: (RW) Height threshold to immediately > + activation_height (RW) Height threshold to immediately > start processing touch events. > - > + ================= ===================================== > > What: /sys/bus/hid/drivers/ntrig/<dev>/min_width > What: /sys/bus/hid/drivers/ntrig/<dev>/min_height > @@ -44,11 +45,13 @@ Contact: linux-input@xxxxxxxxxxxxxxx > Description: > Minimum size contact accepted. > > - min_width: (RW) Minimum touch contact width to decide > + ========== =========================================== > + min_width (RW) Minimum touch contact width to decide > activation and activity. > > - min_height: (RW) Minimum touch contact height to decide > + min_height (RW) Minimum touch contact height to decide > activation and activity. > + ========== =========================================== > > > What: /sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width > diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone > index 8f7982c70d72..11cd9bf0ad18 100644 > --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone > +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone > @@ -3,17 +3,21 @@ Date: March 2010 > Contact: Stefan Achatz <erazor_de@xxxxxxxxxxxxxxxxxxxxx> > Description: It is possible to switch the dpi setting of the mouse with the > press of a button. > + > When read, this file returns the raw number of the actual dpi > setting reported by the mouse. This number has to be further > processed to receive the real dpi value: > > + ===== ===== > VALUE DPI > + ===== ===== > 1 800 > 2 1200 > 3 1600 > 4 2000 > 5 2400 > 6 3200 > + ===== ===== > > This file is readonly. > Users: http://roccat.sourceforge.net > @@ -22,6 +26,7 @@ What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid- > Date: March 2010 > Contact: Stefan Achatz <erazor_de@xxxxxxxxxxxxxxxxxxxxx> > Description: When read, this file returns the number of the actual profile. > + > This file is readonly. > Users: http://roccat.sourceforge.net > > @@ -33,6 +38,7 @@ Description: When read, this file returns the raw integer version number of the > further usage in other programs. To receive the real version > number the decimal point has to be shifted 2 positions to the > left. E.g. a returned value of 138 means 1.38 > + > This file is readonly. > Users: http://roccat.sourceforge.net > > @@ -43,10 +49,13 @@ Description: The mouse can store 5 profiles which can be switched by the > press of a button. A profile holds information like button > mappings, sensitivity, the colors of the 5 leds and light > effects. > + > When read, these files return the respective profile. The > returned data is 975 bytes in size. > + > When written, this file lets one write the respective profile > data back to the mouse. The data has to be 975 bytes long. > + > The mouse will reject invalid data, whereas the profile number > stored in the profile doesn't need to fit the number of the > store. > @@ -58,6 +67,7 @@ Contact: Stefan Achatz <erazor_de@xxxxxxxxxxxxxxxxxxxxx> > Description: When read, this file returns the settings stored in the mouse. > The size of the data is 36 bytes and holds information like the > startup_profile, tcu state and calibration_data. > + > When written, this file lets write settings back to the mouse. > The data has to be 36 bytes long. The mouse will reject invalid > data. > @@ -67,8 +77,10 @@ What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid- > Date: March 2010 > Contact: Stefan Achatz <erazor_de@xxxxxxxxxxxxxxxxxxxxx> > Description: The integer value of this attribute ranges from 1 to 5. > + > When read, this attribute returns the number of the profile > that's active when the mouse is powered on. > + > When written, this file sets the number of the startup profile > and the mouse activates this profile immediately. > Users: http://roccat.sourceforge.net > @@ -80,9 +92,12 @@ Description: The mouse has a "Tracking Control Unit" which lets the user > calibrate the laser power to fit the mousepad surface. > When read, this file returns the current state of the TCU, > where 0 means off and 1 means on. > + > Writing 0 in this file will switch the TCU off. > + > Writing 1 in this file will start the calibration which takes > around 6 seconds to complete and activates the TCU. > + > Users: http://roccat.sourceforge.net > > What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight > @@ -93,14 +108,18 @@ Description: The mouse can be equipped with one of four supplied weights > and its value can be read out. When read, this file returns the > raw value returned by the mouse which eases further processing > in other software. > + > The values map to the weights as follows: > > + ===== ====== > VALUE WEIGHT > + ===== ====== > 0 none > 1 5g > 2 10g > 3 15g > 4 20g > + ===== ====== > > This file is readonly. > Users: http://roccat.sourceforge.net > diff --git a/Documentation/ABI/testing/sysfs-driver-hid-wiimote b/Documentation/ABI/testing/sysfs-driver-hid-wiimote > index cd7b82a5c27d..3bf43d9dcdfe 100644 > --- a/Documentation/ABI/testing/sysfs-driver-hid-wiimote > +++ b/Documentation/ABI/testing/sysfs-driver-hid-wiimote > @@ -20,6 +20,7 @@ Description: This file contains the currently connected and initialized > the official Nintendo Nunchuck extension and classic is the > Nintendo Classic Controller extension. The motionp extension can > be combined with the other two. > + > Starting with kernel-version 3.11 Motion Plus hotplugging is > supported and if detected, it's no longer reported as static > extension. You will get uevent notifications for the motion-plus > diff --git a/Documentation/ABI/testing/sysfs-driver-input-exc3000 b/Documentation/ABI/testing/sysfs-driver-input-exc3000 > index 3d316d54f81c..cd7c578aef2c 100644 > --- a/Documentation/ABI/testing/sysfs-driver-input-exc3000 > +++ b/Documentation/ABI/testing/sysfs-driver-input-exc3000 > @@ -4,6 +4,7 @@ Contact: linux-input@xxxxxxxxxxxxxxx > Description: Reports the firmware version provided by the touchscreen, for example "00_T6" on a EXC80H60 > > Access: Read > + > Valid values: Represented as string > > What: /sys/bus/i2c/devices/xxx/model > @@ -12,4 +13,5 @@ Contact: linux-input@xxxxxxxxxxxxxxx > Description: Reports the model identification provided by the touchscreen, for example "Orion_1320" on a EXC80H60 > > Access: Read > + > Valid values: Represented as string > diff --git a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse > index bb6f5d6ceea0..4cf595d681e6 100644 > --- a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse > +++ b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse > @@ -4,7 +4,9 @@ Contact: PrasannaKumar Muralidharan <prasannatsmkumar@xxxxxxxxx> > Description: read-only access to the efuse on the Ingenic JZ4780 SoC > The SoC has a one time programmable 8K efuse that is > split into segments. The driver supports read only. > - The segments are > + The segments are: > + > + ===== ======== ================= > 0x000 64 bit Random Number > 0x008 128 bit Ingenic Chip ID > 0x018 128 bit Customer ID > @@ -12,5 +14,7 @@ Description: read-only access to the efuse on the Ingenic JZ4780 SoC > 0x1E0 8 bit Protect Segment > 0x1E1 2296 bit HDMI Key > 0x300 2048 bit Security boot key > + ===== ======== ================= > + > Users: any user space application which wants to read the Chip > and Customer ID > diff --git a/Documentation/ABI/testing/sysfs-driver-pciback b/Documentation/ABI/testing/sysfs-driver-pciback > index 73308c2b81b0..49f5fd0c8bbd 100644 > --- a/Documentation/ABI/testing/sysfs-driver-pciback > +++ b/Documentation/ABI/testing/sysfs-driver-pciback > @@ -7,8 +7,10 @@ Description: > the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest > to write and read from the PCI device. That is Domain:Bus: > Device.Function-Register:Size:Mask (Domain is optional). > - For example: > - #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks > + For example:: > + > + #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks > + > will allow the guest to read and write to the configuration > register 0x0E. > > diff --git a/Documentation/ABI/testing/sysfs-driver-ufs b/Documentation/ABI/testing/sysfs-driver-ufs > index d1a352194d2e..adc0d0e91607 100644 > --- a/Documentation/ABI/testing/sysfs-driver-ufs > +++ b/Documentation/ABI/testing/sysfs-driver-ufs > @@ -18,6 +18,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the device type. This is one of the UFS > device descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class > @@ -26,6 +27,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the device class. This is one of the UFS > device descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class > @@ -34,6 +36,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the UFS storage subclass. This is one of > the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol > @@ -43,6 +46,7 @@ Description: This file shows the protocol supported by an UFS device. > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns > @@ -51,6 +55,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows number of logical units. This is one of > the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns > @@ -60,6 +65,7 @@ Description: This file shows number of well known logical units. > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable > @@ -69,6 +75,7 @@ Description: This file shows value that indicates whether the device is > enabled for boot. This is one of the UFS device descriptor > parameters. The full information about the descriptor could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable > @@ -79,6 +86,7 @@ Description: This file shows value that indicates whether the device > of the boot sequence. This is one of the UFS device descriptor > parameters. The full information about the descriptor could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode > @@ -88,6 +96,7 @@ Description: This file shows value that defines the power mode after > device initialization or hardware reset. This is one of > the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun > @@ -96,6 +105,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the high priority lun. This is one of > the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type > @@ -104,6 +114,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the secure removal type. This is one of > the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun > @@ -113,6 +124,7 @@ Description: This file shows whether the security lun is supported. > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency > @@ -122,6 +134,7 @@ Description: This file shows the background operations termination > latency. This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level > @@ -130,6 +143,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the initial active ICC level. This is one > of the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version > @@ -138,6 +152,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the specification version. This is one > of the UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date > @@ -147,6 +162,7 @@ Description: This file shows the manufacturing date in BCD format. > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id > @@ -155,6 +171,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the manufacturee ID. This is one of the > UFS device descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability > @@ -164,6 +181,7 @@ Description: This file shows the maximum number of outstanding RTTs > supported by the device. This is one of the UFS device > descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update > @@ -173,6 +191,7 @@ Description: This file shows the frequency and method of the realtime > clock update. This is one of the UFS device descriptor > parameters. The full information about the descriptor > could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features > @@ -182,6 +201,7 @@ Description: This file shows which features are supported by the device. > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be > found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout > @@ -190,6 +210,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the FFU timeout. This is one of the > UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth > @@ -198,6 +219,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the device queue depth. This is one of the > UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version > @@ -206,6 +228,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the device version. This is one of the > UFS device descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa > @@ -215,6 +238,7 @@ Description: This file shows number of secure write protect areas > supported by the device. This is one of the UFS device > descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size > @@ -225,6 +249,7 @@ Description: This file shows the maximum amount of data that may be > This is one of the UFS device descriptor parameters. > The full information about the descriptor could be found > at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout > @@ -234,6 +259,7 @@ Description: This file shows the command maximum timeout for a change > in PSA state. This is one of the UFS device descriptor > parameters. The full information about the descriptor could > be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -244,6 +270,7 @@ Description: This file shows the MIPI UniPro version number in BCD format. > This is one of the UFS interconnect descriptor parameters. > The full information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version > @@ -253,6 +280,7 @@ Description: This file shows the MIPI M-PHY version number in BCD format. > This is one of the UFS interconnect descriptor parameters. > The full information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > > @@ -264,6 +292,7 @@ Description: This file shows the total memory quantity available to > of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns > @@ -273,6 +302,7 @@ Description: This file shows the maximum number of logical units > supported by the UFS device. This is one of the UFS > geometry descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size > @@ -281,6 +311,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the segment size. This is one of the UFS > geometry descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size > @@ -289,6 +320,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the allocation unit size. This is one of > the UFS geometry descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size > @@ -298,6 +330,7 @@ Description: This file shows the minimum addressable block size. This > is one of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at UFS > specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size > @@ -307,6 +340,7 @@ Description: This file shows the optimal read block size. This is one > of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at UFS > specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size > @@ -316,6 +350,7 @@ Description: This file shows the optimal write block size. This is one > of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at UFS > specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size > @@ -325,6 +360,7 @@ Description: This file shows the maximum data-in buffer size. This > is one of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at UFS > specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size > @@ -334,6 +370,7 @@ Description: This file shows the maximum data-out buffer size. This > is one of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at UFS > specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size > @@ -343,6 +380,7 @@ Description: This file shows the maximum number of RPMB frames allowed > in Security Protocol In/Out. This is one of the UFS geometry > descriptor parameters. The full information about the > descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy > @@ -352,6 +390,7 @@ Description: This file shows the dynamic capacity resource policy. This > is one of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering > @@ -361,6 +400,7 @@ Description: This file shows support for out-of-order data transfer. > This is one of the UFS geometry descriptor parameters. > The full information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts > @@ -370,6 +410,7 @@ Description: This file shows maximum available number of contexts which > are supported by the device. This is one of the UFS geometry > descriptor parameters. The full information about the > descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size > @@ -378,6 +419,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows system data tag unit size. This is one of > the UFS geometry descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size > @@ -388,6 +430,7 @@ Description: This file shows maximum storage area size allocated by > This is one of the UFS geometry descriptor parameters. > The full information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types > @@ -397,6 +440,7 @@ Description: This file shows supported secure removal types. This is > one of the UFS geometry descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types > @@ -406,6 +450,7 @@ Description: This file shows supported memory types. This is one of > the UFS geometry descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units > @@ -416,6 +461,7 @@ Description: This file shows the maximum number of allocation units for > enhanced type 1-4). This is one of the UFS geometry > descriptor parameters. The full information about the > descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor > @@ -426,6 +472,7 @@ Description: This file shows the memory capacity adjustment factor for > enhanced type 1-4). This is one of the UFS geometry > descriptor parameters. The full information about the > descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -436,6 +483,7 @@ Description: This file shows preend of life information. This is one > of the UFS health descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a > @@ -445,6 +493,7 @@ Description: This file shows indication of the device life time > (method a). This is one of the UFS health descriptor > parameters. The full information about the descriptor > could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b > @@ -454,6 +503,7 @@ Description: This file shows indication of the device life time > (method b). This is one of the UFS health descriptor > parameters. The full information about the descriptor > could be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -464,6 +514,7 @@ Description: This file shows maximum VCC, VCCQ and VCCQ2 value for > active ICC levels from 0 to 15. This is one of the UFS > power descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -473,6 +524,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file contains a device manufactureer name string. > The full information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name > @@ -480,6 +532,7 @@ Date: February 2018 > Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file contains a product name string. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id > @@ -487,6 +540,7 @@ Date: February 2018 > Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file contains a OEM ID string. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number > @@ -495,6 +549,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file contains a device serial number string. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision > @@ -503,6 +558,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file contains a product revision string. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > > @@ -512,6 +568,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows boot LUN information. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect > @@ -520,6 +577,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows LUN write protection status. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth > @@ -528,6 +586,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows LUN queue depth. This is one of the UFS > unit descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive > @@ -536,6 +595,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows PSA sensitivity. This is one of the UFS > unit descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type > @@ -544,6 +604,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows LUN memory type. This is one of the UFS > unit descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/data_reliability > @@ -553,6 +614,7 @@ Description: This file defines the device behavior when a power failure > occurs during a write operation. This is one of the UFS > unit descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/logical_block_size > @@ -562,6 +624,7 @@ Description: This file shows the size of addressable logical blocks > (calculated as an exponent with base 2). This is one of > the UFS unit descriptor parameters. The full information about > the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/logical_block_count > @@ -571,6 +634,7 @@ Description: This file shows total number of addressable logical blocks. > This is one of the UFS unit descriptor parameters. The full > information about the descriptor could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/erase_block_size > @@ -579,6 +643,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the erase block size. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/provisioning_type > @@ -587,6 +652,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the thin provisioning type. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count > @@ -595,6 +661,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the total physical memory resources. This is > one of the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/context_capabilities > @@ -603,6 +670,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the context capabilities. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity > @@ -611,6 +679,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the granularity of the LUN. This is one of > the UFS unit descriptor parameters. The full information > about the descriptor could be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -619,6 +688,7 @@ Date: February 2018 > Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the device init status. The full information > about the flag could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe > @@ -627,6 +697,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether permanent write protection is enabled. > The full information about the flag could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe > @@ -636,6 +707,7 @@ Description: This file shows whether write protection is enabled on all > logical units configured as power on write protected. The > full information about the flag could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable > @@ -644,6 +716,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether the device background operations are > enabled. The full information about the flag could be > found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable > @@ -652,6 +725,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether the device life span mode is enabled. > The full information about the flag could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal > @@ -660,6 +734,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether physical resource removal is enable. > The full information about the flag could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc > @@ -668,6 +743,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether the device is executing internal > operation related to real time clock. The full information > about the flag could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update > @@ -676,6 +752,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows whether the device FW update is permanently > disabled. The full information about the flag could be found > at UFS specifications 2.1. > + > The file is read only. > > > @@ -685,6 +762,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the boot lun enabled UFS device attribute. > The full information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode > @@ -693,6 +771,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the current power mode UFS device attribute. > The full information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level > @@ -701,6 +780,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the active icc level UFS device attribute. > The full information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled > @@ -709,6 +789,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the out of order data transfer enabled UFS > device attribute. The full information about the attribute > could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status > @@ -717,6 +798,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the background operations status UFS device > attribute. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/purge_status > @@ -725,6 +807,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the purge operation status UFS device > attribute. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size > @@ -733,6 +816,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the maximum data size in a DATA IN > UPIU. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size > @@ -741,6 +825,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file shows the maximum number of bytes that can be > requested with a READY TO TRANSFER UPIU. The full information > about the attribute could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency > @@ -749,6 +834,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the reference clock frequency UFS device > attribute. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock > @@ -765,6 +851,7 @@ Description: This file provides the maximum current number of > outstanding RTTs in device that is allowed. The full > information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control > @@ -773,6 +860,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the exception event control UFS device > attribute. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status > @@ -781,6 +869,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the exception event status UFS device > attribute. The full information about the attribute could > be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status > @@ -789,6 +878,7 @@ Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file provides the ffu status UFS device attribute. > The full information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_state > @@ -796,6 +886,7 @@ Date: February 2018 > Contact: Stanislav Nijnikov <stanislav.nijnikov@xxxxxxx> > Description: This file show the PSA feature status. The full information > about the attribute could be found at UFS specifications 2.1. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size > @@ -805,6 +896,7 @@ Description: This file shows the amount of data that the host plans to > load to all logical units in pre-soldering state. > The full information about the attribute could be found at > UFS specifications 2.1. > + > The file is read only. > > > @@ -815,6 +907,7 @@ Description: This file shows the The amount of physical memory needed > to be removed from the physical memory resources pool of > the particular logical unit. The full information about > the attribute could be found at UFS specifications 2.1. > + > The file is read only. > > > @@ -824,24 +917,28 @@ Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry could be used to set or show the UFS device > runtime power management level. The current driver > implementation supports 6 levels with next target states: > - 0 - an UFS device will stay active, an UIC link will > - stay active > - 1 - an UFS device will stay active, an UIC link will > - hibernate > - 2 - an UFS device will moved to sleep, an UIC link will > - stay active > - 3 - an UFS device will moved to sleep, an UIC link will > - hibernate > - 4 - an UFS device will be powered off, an UIC link will > - hibernate > - 5 - an UFS device will be powered off, an UIC link will > - be powered off > + > + == ==================================================== > + 0 an UFS device will stay active, an UIC link will > + stay active > + 1 an UFS device will stay active, an UIC link will > + hibernate > + 2 an UFS device will moved to sleep, an UIC link will > + stay active > + 3 an UFS device will moved to sleep, an UIC link will > + hibernate > + 4 an UFS device will be powered off, an UIC link will > + hibernate > + 5 an UFS device will be powered off, an UIC link will > + be powered off > + == ==================================================== > > What: /sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state > Date: February 2018 > Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry shows the target power mode of an UFS device > for the chosen runtime power management level. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/rpm_target_link_state > @@ -849,6 +946,7 @@ Date: February 2018 > Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry shows the target state of an UFS UIC link > for the chosen runtime power management level. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/spm_lvl > @@ -857,24 +955,28 @@ Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry could be used to set or show the UFS device > system power management level. The current driver > implementation supports 6 levels with next target states: > - 0 - an UFS device will stay active, an UIC link will > - stay active > - 1 - an UFS device will stay active, an UIC link will > - hibernate > - 2 - an UFS device will moved to sleep, an UIC link will > - stay active > - 3 - an UFS device will moved to sleep, an UIC link will > - hibernate > - 4 - an UFS device will be powered off, an UIC link will > - hibernate > - 5 - an UFS device will be powered off, an UIC link will > - be powered off > + > + == ==================================================== > + 0 an UFS device will stay active, an UIC link will > + stay active > + 1 an UFS device will stay active, an UIC link will > + hibernate > + 2 an UFS device will moved to sleep, an UIC link will > + stay active > + 3 an UFS device will moved to sleep, an UIC link will > + hibernate > + 4 an UFS device will be powered off, an UIC link will > + hibernate > + 5 an UFS device will be powered off, an UIC link will > + be powered off > + == ==================================================== > > What: /sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state > Date: February 2018 > Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry shows the target power mode of an UFS device > for the chosen system power management level. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/spm_target_link_state > @@ -882,18 +984,21 @@ Date: February 2018 > Contact: Subhash Jadavani <subhashj@xxxxxxxxxxxxxx> > Description: This entry shows the target state of an UFS UIC link > for the chosen system power management level. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_presv_us_en > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows if preserve user-space was configured > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_shared_alloc_units > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the shared allocated units of WB buffer > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_type > @@ -901,6 +1006,7 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the configured WB type. > 0x1 for shared buffer mode. 0x0 for dedicated buffer mode. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_buff_cap_adj > @@ -910,6 +1016,7 @@ Description: This entry shows the total user-space decrease in shared > buffer mode. > The value of this parameter is 3 for TLC NAND when SLC mode > is used as WriteBooster Buffer. 2 for MLC NAND. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_alloc_units > @@ -917,6 +1024,7 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the Maximum total WriteBooster Buffer size > which is supported by the entire device. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_wb_luns > @@ -924,6 +1032,7 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the maximum number of luns that can support > WriteBooster. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_red_type > @@ -937,46 +1046,59 @@ Description: The supportability of user space reduction mode > preserve user space type. > 02h: Device can be configured in either user space > reduction type or preserve user space type. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_wb_type > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: The supportability of WriteBooster Buffer type. > - 00h: LU based WriteBooster Buffer configuration > - 01h: Single shared WriteBooster Buffer > - configuration > - 02h: Supporting both LU based WriteBooster > - Buffer and Single shared WriteBooster Buffer > - configuration > + > + === ========================================================== > + 00h LU based WriteBooster Buffer configuration > + 01h Single shared WriteBooster Buffer configuration > + 02h Supporting both LU based WriteBooster. > + Buffer and Single shared WriteBooster Buffer configuration > + === ========================================================== > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_enable > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the status of WriteBooster. > - 0: WriteBooster is not enabled. > - 1: WriteBooster is enabled > + > + == ============================ > + 0 WriteBooster is not enabled. > + 1 WriteBooster is enabled > + == ============================ > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_en > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows if flush is enabled. > - 0: Flush operation is not performed. > - 1: Flush operation is performed. > + > + == ================================= > + 0 Flush operation is not performed. > + 1 Flush operation is performed. > + == ================================= > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_during_h8 > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: Flush WriteBooster Buffer during hibernate state. > - 0: Device is not allowed to flush the > - WriteBooster Buffer during link hibernate > - state. > - 1: Device is allowed to flush the > - WriteBooster Buffer during link hibernate > - state > + > + == ================================================= > + 0 Device is not allowed to flush the > + WriteBooster Buffer during link hibernate state. > + 1 Device is allowed to flush the > + WriteBooster Buffer during link hibernate state. > + == ================================================= > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_avail_buf > @@ -984,23 +1106,30 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the amount of unused WriteBooster buffer > available. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_buf > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the amount of unused current buffer. > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_flush_status > Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the flush operation status. > - 00h: idle > - 01h: Flush operation in progress > - 02h: Flush operation stopped prematurely. > - 03h: Flush operation completed successfully > - 04h: Flush operation general failure > + > + > + === ====================================== > + 00h idle > + 01h Flush operation in progress > + 02h Flush operation stopped prematurely. > + 03h Flush operation completed successfully > + 04h Flush operation general failure > + === ====================================== > + > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_life_time_est > @@ -1008,9 +1137,13 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows an indication of the WriteBooster Buffer > lifetime based on the amount of performed program/erase cycles > - 01h: 0% - 10% WriteBooster Buffer life time used > + > + === ============================================= > + 01h 0% - 10% WriteBooster Buffer life time used > ... > - 0Ah: 90% - 100% WriteBooster Buffer life time used > + 0Ah 90% - 100% WriteBooster Buffer life time used > + === ============================================= > + > The file is read only. > > What: /sys/class/scsi_device/*/device/unit_descriptor/wb_buf_alloc_units > @@ -1018,4 +1151,5 @@ Date: June 2020 > Contact: Asutosh Das <asutoshd@xxxxxxxxxxxxxx> > Description: This entry shows the configured size of WriteBooster buffer. > 0400h corresponds to 4GB. > + > The file is read only. > diff --git a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 > index d301e7017afe..e92aba4eb594 100644 > --- a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 > +++ b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 > @@ -5,7 +5,9 @@ Contact: Jan Kandziora <jjj@xxxxxx> > Description: When written, this file sets the I2C speed on the connected > DS28E17 chip. When read, it reads the current setting from > the DS28E17 chip. > + > Valid values: 100, 400, 900 [kBaud]. > + > Default 100, can be set by w1_ds28e17.speed= module parameter. > Users: w1_ds28e17 driver > > @@ -17,5 +19,6 @@ Description: When written, this file sets the multiplier used to calculate > the busy timeout for I2C operations on the connected DS28E17 > chip. When read, returns the current setting. > Valid values: 1 to 9. > + > Default 1, can be set by w1_ds28e17.stretch= module parameter. > Users: w1_ds28e17 driver > diff --git a/Documentation/ABI/testing/sysfs-firmware-acpi b/Documentation/ABI/testing/sysfs-firmware-acpi > index e4afc2538210..b16d30a71709 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-acpi > +++ b/Documentation/ABI/testing/sysfs-firmware-acpi > @@ -81,11 +81,11 @@ Description: > $ cd /sys/firmware/acpi/interrupts > $ grep . * > error: 0 > - ff_gbl_lock: 0 enable > - ff_pmtimer: 0 invalid > - ff_pwr_btn: 0 enable > - ff_rt_clk: 2 disable > - ff_slp_btn: 0 invalid > + ff_gbl_lock: 0 enable > + ff_pmtimer: 0 invalid > + ff_pwr_btn: 0 enable > + ff_rt_clk: 2 disable > + ff_slp_btn: 0 invalid > gpe00: 0 invalid > gpe01: 0 enable > gpe02: 108 enable > @@ -118,9 +118,9 @@ Description: > gpe1D: 0 invalid > gpe1E: 0 invalid > gpe1F: 0 invalid > - gpe_all: 1192 > - sci: 1194 > - sci_not: 0 > + gpe_all: 1192 > + sci: 1194 > + sci_not: 0 > > =========== ================================================== > sci The number of times the ACPI SCI > diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-esrt b/Documentation/ABI/testing/sysfs-firmware-efi-esrt > index 6e431d1a4e79..31b57676d4ad 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-efi-esrt > +++ b/Documentation/ABI/testing/sysfs-firmware-efi-esrt > @@ -35,10 +35,13 @@ What: /sys/firmware/efi/esrt/entries/entry$N/fw_type > Date: February 2015 > Contact: Peter Jones <pjones@xxxxxxxxxx> > Description: What kind of firmware entry this is: > - 0 - Unknown > - 1 - System Firmware > - 2 - Device Firmware > - 3 - UEFI Driver > + > + == =============== > + 0 Unknown > + 1 System Firmware > + 2 Device Firmware > + 3 UEFI Driver > + == =============== > > What: /sys/firmware/efi/esrt/entries/entry$N/fw_class > Date: February 2015 > @@ -71,11 +74,14 @@ Date: February 2015 > Contact: Peter Jones <pjones@xxxxxxxxxx> > Description: The result of the last firmware update attempt for the > firmware resource entry. > - 0 - Success > - 1 - Insufficient resources > - 2 - Incorrect version > - 3 - Invalid format > - 4 - Authentication error > - 5 - AC power event > - 6 - Battery power event > + > + == ====================== > + 0 Success > + 1 Insufficient resources > + 2 Incorrect version > + 3 Invalid format > + 4 Authentication error > + 5 AC power event > + 6 Battery power event > + == ====================== > > diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map > index c61b9b348e99..9c4d581be396 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map > +++ b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map > @@ -14,7 +14,7 @@ Description: Switching efi runtime services to virtual mode requires > /sys/firmware/efi/runtime-map/ is the directory the kernel > exports that information in. > > - subdirectories are named with the number of the memory range: > + subdirectories are named with the number of the memory range:: > > /sys/firmware/efi/runtime-map/0 > /sys/firmware/efi/runtime-map/1 > @@ -24,11 +24,13 @@ Description: Switching efi runtime services to virtual mode requires > > Each subdirectory contains five files: > > - attribute : The attributes of the memory range. > - num_pages : The size of the memory range in pages. > - phys_addr : The physical address of the memory range. > - type : The type of the memory range. > - virt_addr : The virtual address of the memory range. > + ========= ========================================= > + attribute The attributes of the memory range. > + num_pages The size of the memory range in pages. > + phys_addr The physical address of the memory range. > + type The type of the memory range. > + virt_addr The virtual address of the memory range. > + ========= ========================================= > > Above values are all hexadecimal numbers with the '0x' prefix. > Users: Kexec > diff --git a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg > index 011dda4f8e8a..ee0d6dbc810e 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg > +++ b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg > @@ -15,7 +15,7 @@ Description: > to the fw_cfg device can be found in "docs/specs/fw_cfg.txt" > in the QEMU source tree. > > - === SysFS fw_cfg Interface === > + **SysFS fw_cfg Interface** > > The fw_cfg sysfs interface described in this document is only > intended to display discoverable blobs (i.e., those registered > @@ -31,7 +31,7 @@ Description: > > /sys/firmware/qemu_fw_cfg/rev > > - --- Discoverable fw_cfg blobs by selector key --- > + **Discoverable fw_cfg blobs by selector key** > > All discoverable blobs listed in the fw_cfg file directory are > displayed as entries named after their unique selector key > @@ -45,24 +45,26 @@ Description: > Each such fw_cfg sysfs entry has the following values exported > as attributes: > > - name : The 56-byte nul-terminated ASCII string used as the > + ==== ==================================================== > + name The 56-byte nul-terminated ASCII string used as the > blob's 'file name' in the fw_cfg directory. > - size : The length of the blob, as given in the fw_cfg > + size The length of the blob, as given in the fw_cfg > directory. > - key : The value of the blob's selector key as given in the > + key The value of the blob's selector key as given in the > fw_cfg directory. This value is the same as used in > the parent directory name. > - raw : The raw bytes of the blob, obtained by selecting the > + raw The raw bytes of the blob, obtained by selecting the > entry via the control register, and reading a number > of bytes equal to the blob size from the data > register. > + ==== ==================================================== > > - --- Listing fw_cfg blobs by file name --- > + **Listing fw_cfg blobs by file name** > > While the fw_cfg device does not impose any specific naming > convention on the blobs registered in the file directory, > QEMU developers have traditionally used path name semantics > - to give each blob a descriptive name. For example: > + to give each blob a descriptive name. For example:: > > "bootorder" > "genroms/kvmvapic.bin" > @@ -81,7 +83,7 @@ Description: > of directories matching the path name components of fw_cfg > blob names, ending in symlinks to the by_key entry for each > "basename", as illustrated below (assume current directory is > - /sys/firmware): > + /sys/firmware):: > > qemu_fw_cfg/by_name/bootorder -> ../by_key/38 > qemu_fw_cfg/by_name/etc/e820 -> ../../by_key/35 > diff --git a/Documentation/ABI/testing/sysfs-firmware-sfi b/Documentation/ABI/testing/sysfs-firmware-sfi > index 4be7d44aeacf..5210e0f06ddb 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-sfi > +++ b/Documentation/ABI/testing/sysfs-firmware-sfi > @@ -9,7 +9,7 @@ Description: > http://simplefirmware.org/documentation > > While the tables are used by the kernel, user-space > - can observe them this way: > + can observe them this way:: > > - # cd /sys/firmware/sfi/tables > - # cat $TABLENAME > $TABLENAME.bin > + # cd /sys/firmware/sfi/tables > + # cat $TABLENAME > $TABLENAME.bin > diff --git a/Documentation/ABI/testing/sysfs-firmware-sgi_uv b/Documentation/ABI/testing/sysfs-firmware-sgi_uv > index 4573fd4b7876..66800baab096 100644 > --- a/Documentation/ABI/testing/sysfs-firmware-sgi_uv > +++ b/Documentation/ABI/testing/sysfs-firmware-sgi_uv > @@ -5,7 +5,7 @@ Description: > The /sys/firmware/sgi_uv directory contains information > about the SGI UV platform. > > - Under that directory are a number of files: > + Under that directory are a number of files:: > > partition_id > coherence_id > @@ -14,7 +14,7 @@ Description: > SGI UV systems can be partitioned into multiple physical > machines, which each partition running a unique copy > of the operating system. Each partition will have a unique > - partition id. To display the partition id, use the command: > + partition id. To display the partition id, use the command:: > > cat /sys/firmware/sgi_uv/partition_id > > @@ -22,6 +22,6 @@ Description: > A partitioned SGI UV system can have one or more coherence > domain. The coherence id indicates which coherence domain > this partition is in. To display the coherence id, use the > - command: > + command:: > > cat /sys/firmware/sgi_uv/coherence_id > diff --git a/Documentation/ABI/testing/sysfs-fs-f2fs b/Documentation/ABI/testing/sysfs-fs-f2fs > index 834d0becae6d..67b3ed8e8c2f 100644 > --- a/Documentation/ABI/testing/sysfs-fs-f2fs > +++ b/Documentation/ABI/testing/sysfs-fs-f2fs > @@ -20,10 +20,13 @@ What: /sys/fs/f2fs/<disk>/gc_idle > Date: July 2013 > Contact: "Namjae Jeon" <namjae.jeon@xxxxxxxxxxx> > Description: Controls the victim selection policy for garbage collection. > - Setting gc_idle = 0(default) will disable this option. Setting > - gc_idle = 1 will select the Cost Benefit approach & setting > - gc_idle = 2 will select the greedy approach & setting > - gc_idle = 3 will select the age-threshold based approach. > + Setting gc_idle = 0(default) will disable this option. Setting: > + > + =========== =============================================== > + gc_idle = 1 will select the Cost Benefit approach & setting > + gc_idle = 2 will select the greedy approach & setting > + gc_idle = 3 will select the age-threshold based approach. > + =========== =============================================== > > What: /sys/fs/f2fs/<disk>/reclaim_segments > Date: October 2013 > @@ -46,10 +49,17 @@ Date: November 2013 > Contact: "Jaegeuk Kim" <jaegeuk.kim@xxxxxxxxxxx> > Description: Controls the in-place-update policy. > updates in f2fs. User can set: > - 0x01: F2FS_IPU_FORCE, 0x02: F2FS_IPU_SSR, > - 0x04: F2FS_IPU_UTIL, 0x08: F2FS_IPU_SSR_UTIL, > - 0x10: F2FS_IPU_FSYNC, 0x20: F2FS_IPU_ASYNC, > - 0x40: F2FS_IPU_NOCACHE. > + > + ==== ================= > + 0x01 F2FS_IPU_FORCE > + 0x02 F2FS_IPU_SSR > + 0x04 F2FS_IPU_UTIL > + 0x08 F2FS_IPU_SSR_UTIL > + 0x10 F2FS_IPU_FSYNC > + 0x20 F2FS_IPU_ASYNC, > + 0x40 F2FS_IPU_NOCACHE > + ==== ================= > + > Refer segment.h for details. > > What: /sys/fs/f2fs/<disk>/min_ipu_util > @@ -332,18 +342,28 @@ Date: April 2020 > Contact: "Jaegeuk Kim" <jaegeuk@xxxxxxxxxx> > Description: Give a way to attach REQ_META|FUA to data writes > given temperature-based bits. Now the bits indicate: > - * REQ_META | REQ_FUA | > - * 5 | 4 | 3 | 2 | 1 | 0 | > - * Cold | Warm | Hot | Cold | Warm | Hot | > + > + +-------------------+-------------------+ > + | REQ_META | REQ_FUA | > + +------+------+-----+------+------+-----+ > + | 5 | 4 | 3 | 2 | 1 | 0 | > + +------+------+-----+------+------+-----+ > + | Cold | Warm | Hot | Cold | Warm | Hot | > + +------+------+-----+------+------+-----+ > > What: /sys/fs/f2fs/<disk>/node_io_flag > Date: June 2020 > Contact: "Jaegeuk Kim" <jaegeuk@xxxxxxxxxx> > Description: Give a way to attach REQ_META|FUA to node writes > given temperature-based bits. Now the bits indicate: > - * REQ_META | REQ_FUA | > - * 5 | 4 | 3 | 2 | 1 | 0 | > - * Cold | Warm | Hot | Cold | Warm | Hot | > + > + +-------------------+-------------------+ > + | REQ_META | REQ_FUA | > + +------+------+-----+------+------+-----+ > + | 5 | 4 | 3 | 2 | 1 | 0 | > + +------+------+-----+------+------+-----+ > + | Cold | Warm | Hot | Cold | Warm | Hot | > + +------+------+-----+------+------+-----+ > > What: /sys/fs/f2fs/<disk>/iostat_period_ms > Date: April 2020 > diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-ksm b/Documentation/ABI/testing/sysfs-kernel-mm-ksm > index dfc13244cda3..1c9bed5595f5 100644 > --- a/Documentation/ABI/testing/sysfs-kernel-mm-ksm > +++ b/Documentation/ABI/testing/sysfs-kernel-mm-ksm > @@ -34,8 +34,9 @@ Description: Kernel Samepage Merging daemon sysfs interface > in a tree. > > run: write 0 to disable ksm, read 0 while ksm is disabled. > - write 1 to run ksm, read 1 while ksm is running. > - write 2 to disable ksm and unmerge all its pages. > + > + - write 1 to run ksm, read 1 while ksm is running. > + - write 2 to disable ksm and unmerge all its pages. > > sleep_millisecs: how many milliseconds ksm should sleep between > scans. > diff --git a/Documentation/ABI/testing/sysfs-kernel-slab b/Documentation/ABI/testing/sysfs-kernel-slab > index ed35833ad7f0..c9f12baf8baa 100644 > --- a/Documentation/ABI/testing/sysfs-kernel-slab > +++ b/Documentation/ABI/testing/sysfs-kernel-slab > @@ -346,6 +346,7 @@ Description: > number of objects per slab. If a slab cannot be allocated > because of fragmentation, SLUB will retry with the minimum order > possible depending on its characteristics. > + > When debug_guardpage_minorder=N (N > 0) parameter is specified > (see Documentation/admin-guide/kernel-parameters.rst), the minimum possible > order is used and this sysfs entry can not be used to change > @@ -361,6 +362,7 @@ Description: > new slab has not been possible at the cache's order and instead > fallen back to its minimum possible order. It can be written to > clear the current count. > + > Available when CONFIG_SLUB_STATS is enabled. > > What: /sys/kernel/slab/cache/partial > @@ -410,6 +412,7 @@ Description: > slab from a remote node as opposed to allocating a new slab on > the local node. This reduces the amount of wasted memory over > the entire system but can be expensive. > + > Available when CONFIG_NUMA is enabled. > > What: /sys/kernel/slab/cache/sanity_checks > diff --git a/Documentation/ABI/testing/sysfs-module b/Documentation/ABI/testing/sysfs-module > index 0aac02e7fb0e..353c0db5bc1f 100644 > --- a/Documentation/ABI/testing/sysfs-module > +++ b/Documentation/ABI/testing/sysfs-module > @@ -17,14 +17,15 @@ KernelVersion: 3.1 > Contact: Kirill Smelkov <kirr@xxxxxxxxxx> > Description: Maximum time allowed for periodic transfers per microframe (μs) > > - [ USB 2.0 sets maximum allowed time for periodic transfers per > + Note: > + USB 2.0 sets maximum allowed time for periodic transfers per > microframe to be 80%, that is 100 microseconds out of 125 > microseconds (full microframe). > > However there are cases, when 80% max isochronous bandwidth is > too limiting. For example two video streams could require 110 > microseconds of isochronous bandwidth per microframe to work > - together. ] > + together. > > Through this setting it is possible to raise the limit so that > the host controller would allow allocating more than 100 > @@ -45,8 +46,10 @@ Date: Jan 2012 > KernelVersion:»·3.3 > Contact: Kay Sievers <kay.sievers@xxxxxxxx> > Description: Module taint flags: > - P - proprietary module > - O - out-of-tree module > - F - force-loaded module > - C - staging driver module > - E - unsigned module > + == ===================== > + P proprietary module > + O out-of-tree module > + F force-loaded module > + C staging driver module > + E unsigned module > + == ===================== > diff --git a/Documentation/ABI/testing/sysfs-platform-dell-laptop b/Documentation/ABI/testing/sysfs-platform-dell-laptop > index 9b917c7453de..82bcfe9df66e 100644 > --- a/Documentation/ABI/testing/sysfs-platform-dell-laptop > +++ b/Documentation/ABI/testing/sysfs-platform-dell-laptop > @@ -34,9 +34,12 @@ Description: > this file. To disable a trigger, write its name preceded > by '-' instead. > > - For example, to enable the keyboard as trigger run: > + For example, to enable the keyboard as trigger run:: > + > echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers > - To disable it: > + > + To disable it:: > + > echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers > > Note that not all the available triggers can be configured. > @@ -57,7 +60,8 @@ Description: > with any the above units. If no unit is specified, the value > is assumed to be expressed in seconds. > > - For example, to set the timeout to 10 minutes run: > + For example, to set the timeout to 10 minutes run:: > + > echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout > > Note that when this file is read, the returned value might be > diff --git a/Documentation/ABI/testing/sysfs-platform-dell-smbios b/Documentation/ABI/testing/sysfs-platform-dell-smbios > index 205d3b6361e0..e6e0f7f834a7 100644 > --- a/Documentation/ABI/testing/sysfs-platform-dell-smbios > +++ b/Documentation/ABI/testing/sysfs-platform-dell-smbios > @@ -13,8 +13,8 @@ Description: > For example the token ID "5" would be available > as the following attributes: > > - 0005_location > - 0005_value > + - 0005_location > + - 0005_value > > Tokens will vary from machine to machine, and > only tokens available on that machine will be > diff --git a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl > index c394b808be19..b6a138b50d99 100644 > --- a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl > +++ b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl > @@ -5,9 +5,9 @@ Contact: Wolfram Sang <wsa+renesas@xxxxxxxxxxxxxxxxxxxx> > Description: > Reading the file will give you a list of masters which can be > selected for a demultiplexed bus. The format is > - "<index>:<name>". Example from a Renesas Lager board: > + "<index>:<name>". Example from a Renesas Lager board:: > > - 0:/i2c@e6500000 1:/i2c@e6508000 > + 0:/i2c@e6500000 1:/i2c@e6508000 > > What: /sys/devices/platform/<i2c-demux-name>/current_master > Date: January 2016 > diff --git a/Documentation/ABI/testing/sysfs-platform-kim b/Documentation/ABI/testing/sysfs-platform-kim > index c1653271872a..a7f81de68046 100644 > --- a/Documentation/ABI/testing/sysfs-platform-kim > +++ b/Documentation/ABI/testing/sysfs-platform-kim > @@ -5,6 +5,7 @@ Contact: "Pavan Savoy" <pavan_savoy@xxxxxx> > Description: > Name of the UART device at which the WL128x chip > is connected. example: "/dev/ttyS0". > + > The device name flows down to architecture specific board > initialization file from the SFI/ATAGS bootloader > firmware. The name exposed is read from the user-space > diff --git a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 > index 6212697bbf6f..bc510ccc37a7 100644 > --- a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 > +++ b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 > @@ -7,9 +7,11 @@ Description: > The file can show/change the phy mode for role swap of usb. > > Write the following strings to change the mode: > - "host" - switching mode from peripheral to host. > - "peripheral" - switching mode from host to peripheral. > + > + - "host" - switching mode from peripheral to host. > + - "peripheral" - switching mode from host to peripheral. > > Read the file, then it shows the following strings: > - "host" - The mode is host now. > - "peripheral" - The mode is peripheral now. > + > + - "host" - The mode is host now. > + - "peripheral" - The mode is peripheral now. > diff --git a/Documentation/ABI/testing/sysfs-platform-renesas_usb3 b/Documentation/ABI/testing/sysfs-platform-renesas_usb3 > index 5621c15d5dc0..8af5b9c3fabb 100644 > --- a/Documentation/ABI/testing/sysfs-platform-renesas_usb3 > +++ b/Documentation/ABI/testing/sysfs-platform-renesas_usb3 > @@ -7,9 +7,11 @@ Description: > The file can show/change the drd mode of usb. > > Write the following string to change the mode: > - "host" - switching mode from peripheral to host. > - "peripheral" - switching mode from host to peripheral. > + > + - "host" - switching mode from peripheral to host. > + - "peripheral" - switching mode from host to peripheral. > > Read the file, then it shows the following strings: > - "host" - The mode is host now. > - "peripheral" - The mode is peripheral now. > + > + - "host" - The mode is host now. > + - "peripheral" - The mode is peripheral now. > diff --git a/Documentation/ABI/testing/sysfs-power b/Documentation/ABI/testing/sysfs-power > index 5e6ead29124c..51c0f578bfce 100644 > --- a/Documentation/ABI/testing/sysfs-power > +++ b/Documentation/ABI/testing/sysfs-power > @@ -47,14 +47,18 @@ Description: > suspend-to-disk mechanism. Reading from this file returns > the name of the method by which the system will be put to > sleep on the next suspend. There are four methods supported: > + > 'firmware' - means that the memory image will be saved to disk > by some firmware, in which case we also assume that the > firmware will handle the system suspend. > + > 'platform' - the memory image will be saved by the kernel and > the system will be put to sleep by the platform driver (e.g. > ACPI or other PM registers). > + > 'shutdown' - the memory image will be saved by the kernel and > the system will be powered off. > + > 'reboot' - the memory image will be saved by the kernel and > the system will be rebooted. > > @@ -74,12 +78,12 @@ Description: > The suspend-to-disk method may be chosen by writing to this > file one of the accepted strings: > > - 'firmware' > - 'platform' > - 'shutdown' > - 'reboot' > - 'testproc' > - 'test' > + - 'firmware' > + - 'platform' > + - 'shutdown' > + - 'reboot' > + - 'testproc' > + - 'test' > > It will only change to 'firmware' or 'platform' if the system > supports that. > @@ -114,9 +118,9 @@ Description: > string representing a nonzero integer into it. > > To use this debugging feature you should attempt to suspend > - the machine, then reboot it and run > + the machine, then reboot it and run:: > > - dmesg -s 1000000 | grep 'hash matches' > + dmesg -s 1000000 | grep 'hash matches' > > If you do not get any matches (or they appear to be false > positives), it is possible that the last PM event point > @@ -244,6 +248,7 @@ Description: > wakeup sources created with the help of /sys/power/wake_lock. > When a string is written to /sys/power/wake_unlock, it will be > assumed to represent the name of a wakeup source to deactivate. > + > If a wakeup source object of that name exists and is active at > the moment, it will be deactivated. > > diff --git a/Documentation/ABI/testing/sysfs-profiling b/Documentation/ABI/testing/sysfs-profiling > index 8a8e466eb2c0..e39dd3a0ceef 100644 > --- a/Documentation/ABI/testing/sysfs-profiling > +++ b/Documentation/ABI/testing/sysfs-profiling > @@ -5,7 +5,7 @@ Description: > /sys/kernel/profiling is the runtime equivalent > of the boot-time profile= option. > > - You can get the same effect running: > + You can get the same effect running:: > > echo 2 > /sys/kernel/profiling > > diff --git a/Documentation/ABI/testing/sysfs-wusb_cbaf b/Documentation/ABI/testing/sysfs-wusb_cbaf > index a99c5f86a37a..2969d3694ec0 100644 > --- a/Documentation/ABI/testing/sysfs-wusb_cbaf > +++ b/Documentation/ABI/testing/sysfs-wusb_cbaf > @@ -45,7 +45,8 @@ Description: > 7. Device is unplugged. > > References: > - [WUSB-AM] Association Models Supplement to the > + [WUSB-AM] > + Association Models Supplement to the > Certified Wireless Universal Serial Bus > Specification, version 1.0. > > diff --git a/Documentation/ABI/testing/usb-charger-uevent b/Documentation/ABI/testing/usb-charger-uevent > index 419a92dd0d86..1db89b0cf80f 100644 > --- a/Documentation/ABI/testing/usb-charger-uevent > +++ b/Documentation/ABI/testing/usb-charger-uevent > @@ -3,44 +3,52 @@ Date: 2020-01-14 > KernelVersion: 5.6 > Contact: linux-usb@xxxxxxxxxxxxxxx > Description: There are two USB charger states: > - USB_CHARGER_ABSENT > - USB_CHARGER_PRESENT > + > + - USB_CHARGER_ABSENT > + - USB_CHARGER_PRESENT > + > There are five USB charger types: > - USB_CHARGER_UNKNOWN_TYPE: Charger type is unknown > - USB_CHARGER_SDP_TYPE: Standard Downstream Port > - USB_CHARGER_CDP_TYPE: Charging Downstream Port > - USB_CHARGER_DCP_TYPE: Dedicated Charging Port > - USB_CHARGER_ACA_TYPE: Accessory Charging Adapter > + > + ======================== ========================== > + USB_CHARGER_UNKNOWN_TYPE Charger type is unknown > + USB_CHARGER_SDP_TYPE Standard Downstream Port > + USB_CHARGER_CDP_TYPE Charging Downstream Port > + USB_CHARGER_DCP_TYPE Dedicated Charging Port > + USB_CHARGER_ACA_TYPE Accessory Charging Adapter > + ======================== ========================== > + > https://www.usb.org/document-library/battery-charging-v12-spec-and-adopters-agreement > > - Here are two examples taken using udevadm monitor -p when > - USB charger is online: > - UDEV change /devices/soc0/usbphynop1 (platform) > - ACTION=change > - DEVPATH=/devices/soc0/usbphynop1 > - DRIVER=usb_phy_generic > - MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv > - OF_COMPATIBLE_0=usb-nop-xceiv > - OF_COMPATIBLE_N=1 > - OF_FULLNAME=/usbphynop1 > - OF_NAME=usbphynop1 > - SEQNUM=2493 > - SUBSYSTEM=platform > - USB_CHARGER_STATE=USB_CHARGER_PRESENT > - USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE > - USEC_INITIALIZED=227422826 > + Here are two examples taken using ``udevadm monitor -p`` when > + USB charger is online:: > > - USB charger is offline: > - KERNEL change /devices/soc0/usbphynop1 (platform) > - ACTION=change > - DEVPATH=/devices/soc0/usbphynop1 > - DRIVER=usb_phy_generic > - MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv > - OF_COMPATIBLE_0=usb-nop-xceiv > - OF_COMPATIBLE_N=1 > - OF_FULLNAME=/usbphynop1 > - OF_NAME=usbphynop1 > - SEQNUM=2494 > - SUBSYSTEM=platform > - USB_CHARGER_STATE=USB_CHARGER_ABSENT > - USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE > + UDEV change /devices/soc0/usbphynop1 (platform) > + ACTION=change > + DEVPATH=/devices/soc0/usbphynop1 > + DRIVER=usb_phy_generic > + MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv > + OF_COMPATIBLE_0=usb-nop-xceiv > + OF_COMPATIBLE_N=1 > + OF_FULLNAME=/usbphynop1 > + OF_NAME=usbphynop1 > + SEQNUM=2493 > + SUBSYSTEM=platform > + USB_CHARGER_STATE=USB_CHARGER_PRESENT > + USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE > + USEC_INITIALIZED=227422826 > + > + USB charger is offline:: > + > + KERNEL change /devices/soc0/usbphynop1 (platform) > + ACTION=change > + DEVPATH=/devices/soc0/usbphynop1 > + DRIVER=usb_phy_generic > + MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv > + OF_COMPATIBLE_0=usb-nop-xceiv > + OF_COMPATIBLE_N=1 > + OF_FULLNAME=/usbphynop1 > + OF_NAME=usbphynop1 > + SEQNUM=2494 > + SUBSYSTEM=platform > + USB_CHARGER_STATE=USB_CHARGER_ABSENT > + USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE > diff --git a/Documentation/ABI/testing/usb-uevent b/Documentation/ABI/testing/usb-uevent > index d35c3cad892c..2b8eca4bf2b1 100644 > --- a/Documentation/ABI/testing/usb-uevent > +++ b/Documentation/ABI/testing/usb-uevent > @@ -6,22 +6,22 @@ Description: When the USB Host Controller has entered a state where it is no > longer functional a uevent will be raised. The uevent will > contain ACTION=offline and ERROR=DEAD. > > - Here is an example taken using udevadm monitor -p: > + Here is an example taken using udevadm monitor -p:: > > - KERNEL[130.428945] offline /devices/pci0000:00/0000:00:10.0/usb2 (usb) > - ACTION=offline > - BUSNUM=002 > - DEVNAME=/dev/bus/usb/002/001 > - DEVNUM=001 > - DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2 > - DEVTYPE=usb_device > - DRIVER=usb > - ERROR=DEAD > - MAJOR=189 > - MINOR=128 > - PRODUCT=1d6b/2/414 > - SEQNUM=2168 > - SUBSYSTEM=usb > - TYPE=9/0/1 > + KERNEL[130.428945] offline /devices/pci0000:00/0000:00:10.0/usb2 (usb) > + ACTION=offline > + BUSNUM=002 > + DEVNAME=/dev/bus/usb/002/001 > + DEVNUM=001 > + DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2 > + DEVTYPE=usb_device > + DRIVER=usb > + ERROR=DEAD > + MAJOR=189 > + MINOR=128 > + PRODUCT=1d6b/2/414 > + SEQNUM=2168 > + SUBSYSTEM=usb > + TYPE=9/0/1 > > Users: chromium-os-dev@xxxxxxxxxxxx > diff --git a/scripts/get_abi.pl b/scripts/get_abi.pl > index 413349789145..bdef3e5c35c7 100755 > --- a/scripts/get_abi.pl > +++ b/scripts/get_abi.pl > @@ -316,8 +316,6 @@ sub output_rest { > $len = length($name) if (length($name) > $len); > } > > - print "What:\n\n"; > - > print "+-" . "-" x $len . "-+\n"; > foreach my $name (@names) { > printf "| %s", $name . " " x ($len - length($name)) . " |\n"; _______________________________________________ dri-devel mailing list dri-devel@xxxxxxxxxxxxxxxxxxxxx https://lists.freedesktop.org/mailman/listinfo/dri-devel