On 10/29/20 8:12 PM, Jonathan Cameron wrote: > 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 Those nit changes for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7 looks fine to me. Reviewed-By: Kajol Jain<kjain@xxxxxxxxxxxxx> Thanks, Kajol Jain > >> --- >> 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