KernelVersion: v2.6.12
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ===========================================
                node_type:      (RO) Node type (CA, RNIC, usNIC, usNIC UDP,
                                switch or router)
 
                node_guid:      (RO) Node GUID
 
                sys_image_guid: (RO) System image GUID
+               =============== ===========================================
 
 
 What:          /sys/class/infiniband/<device>/node_desc
 Contact:       linux-rdma@vger.kernel.org
 Description:
 
+               =============== ===============================================
                lid:            (RO) Port LID
 
                rate:           (RO) Port data rate (active width * active
 
                cap_mask:       (RO) Port capability mask. 2 bits here are
                                settable- IsCommunicationManagementSupported
-                               (set when CM module is loaded) and IsSM (set via
-                               open of issmN file).
+                               (set when CM module is loaded) and IsSM (set
+                               via open of issmN file).
+               =============== ===============================================
 
 
 What:          /sys/class/infiniband/<device>/ports/<port-num>/link_layer
 KernelVersion: v2.6.12
 Contact:       linux-rdma@vger.kernel.org
 Description:
-               Errors info:
-               -----------
+               **Errors info**:
 
                symbol_error: (RO) Total number of minor link errors detected on
                one or more physical lanes.
                intervention. It can also indicate hardware issues or extremely
                poor link signal integrity
 
-               Data info:
-               ---------
+               **Data info**:
 
                port_xmit_data: (RO) Total number of data octets, divided by 4
                (lanes), transmitted on all VLs. This is 64 bit counter
                transmitted on all VLs from the port. This may include multicast
                packets with errors.
 
-               Misc info:
-               ---------
+               **Misc info**:
 
                port_xmit_discards: (RO) Total number of outbound packets
                discarded by the port because the port is down or congested.
                two umad devices and two issm devices, while a switch will have
                one device of each type (for switch port 0).
 
+               ======= =====================================
                ibdev:  (RO) Show Infiniband (IB) device name
 
                port:   (RO) Display port number
+               ======= =====================================
 
 
 What:          /sys/class/infiniband_mad/abi_version
 KernelVersion: v2.6.14
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ===========================================
                ibdev:          (RO) Display Infiniband (IB) device name
 
                abi_version:    (RO) Show ABI version of IB device specific
                                interfaces.
+               =============== ===========================================
 
 
 What:          /sys/class/infiniband_verbs/abi_version
 KernelVersion: v2.6.12
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ================================================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Host Channel Adapter type: MT23108, MT25208
                                (MT23108 compat mode), MT25208 or MT25204
 
                board_id:       (RO) Manufacturing board ID
+               =============== ================================================
 
 
 sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
 KernelVersion: v2.6.24
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ===============================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Host channel adapter type
 
                board_id:       (RO) Manufacturing board ID
+               =============== ===============================
 
 
 What:          /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
                example, ports/1/pkeys/10 contains the value at index 10 in port
                1's P_Key table.
 
+               ======================= ==========================================
                gids/<n>:               (RO) The physical port gids n = 0..127
 
                admin_guids/<n>:        (RW) Allows examining or changing the
                                        guest, whenever it uses its pkey index
                                        1, will actually be using the real pkey
                                        index 10.
+               ======================= ==========================================
 
 
 What:          /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
                Enabling QP0 on VFs for selected VF/port. By default, no VFs are
                enabled for QP0 operation.
 
-               smi_enabled:    (RO) Indicates whether smi is currently enabled
-                               for the indicated VF/port
+               ================= ==== ===========================================
+               smi_enabled:      (RO) Indicates whether smi is currently enabled
+                                      for the indicated VF/port
 
-               enable_smi_admin:(RW) Used by the admin to request that smi
-                               capability be enabled or disabled for the
-                               indicated VF/port. 0 = disable, 1 = enable.
+               enable_smi_admin: (RW) Used by the admin to request that smi
+                                      capability be enabled or disabled for the
+                                      indicated VF/port. 0 = disable, 1 = enable.
+               ================= ==== ===========================================
 
                The requested enablement will occur at the next reset of the VF
                (e.g. driver restart on the VM which owns the VF).
 Contact:       linux-rdma@vger.kernel.org
 Description:
 
+               =============== =============================================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Driver short name. Should normally match
 
                board_id:       (RO) Manufacturing board id. (Vendor + device
                                information)
+               =============== =============================================
 
 
 sysfs interface for Intel IB driver qib
 KernelVersion: v2.6.35
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ======================================================
                version:        (RO) Display version information of installed software
                                and drivers.
 
                chip_reset:     (WO) Reset the chip if possible by writing
                                "reset" to this file. Only allowed if no user
                                contexts are open that use chip resources.
+               =============== ======================================================
 
 
 What:          /sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
 Description:
                Per-port congestion control. Both are binary attributes.
 
-               cc_table_bin:   (RO) Congestion control table size followed by
+               =============== ================================================
+               cc_table_bin    (RO) Congestion control table size followed by
                                table entries.
 
-               cc_settings_bin:(RO) Congestion settings: port control, control
+               cc_settings_bin (RO) Congestion settings: port control, control
                                map and an array of 16 entries for the
                                congestion entries - increase, timer, event log
                                trigger threshold and the minimum injection rate
                                delay.
+               =============== ================================================
 
 What:          /sys/class/infiniband/qibX/ports/N/linkstate/loopback
 What:          /sys/class/infiniband/qibX/ports/N/linkstate/led_override
 Description:
                [to be documented]
 
+               =============== ===============================================
                loopback:       (WO)
                led_override:   (WO)
                hrtbt_enable:   (RW)
                                errors. Possible states are- "Initted",
                                "Present", "IB_link_up", "IB_configured" or
                                "Fatal_Hardware_Error".
+               =============== ===============================================
 
 What:          /sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
 What:          /sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
                linux-rdma@vger.kernel.org
 Description:
 
+               =============== ===============================================
                board_id:       (RO) Manufacturing board id
 
                config:         (RO) Report the configuration for this PF
 
                iface:          (RO) Shows which network interface this usNIC
                                entry is associated to (visible with ifconfig).
+               =============== ===============================================
 
 What:          /sys/class/infiniband/usnic_X/qpn/summary
 What:          /sys/class/infiniband/usnic_X/qpn/context
 KernelVersion: v4.6
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== =============================================
                hw_rev:         (RO) Hardware revision number
 
                board_id:       (RO) Manufacturing board id
                                available.
 
                tempsense:      (RO) Thermal sense information
+               =============== =============================================
 
 
 What:          /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
 Description:
                Per-port congestion control.
 
-               cc_table_bin:   (RO) CCA tables used by PSM2 Congestion control
+               =============== ================================================
+               cc_table_bin    (RO) CCA tables used by PSM2 Congestion control
                                table size followed by table entries. Binary
                                attribute.
 
-               cc_settings_bin:(RO) Congestion settings: port control, control
+               cc_settings_bin (RO) Congestion settings: port control, control
                                map and an array of 16 entries for the
                                congestion entries - increase, timer, event log
                                trigger threshold and the minimum injection rate
                                delay. Binary attribute.
 
-               cc_prescan:     (RW) enable prescanning for faster BECN
+               cc_prescan      (RW) enable prescanning for faster BECN
                                response. Write "on" to enable and "off" to
                                disable.
+               =============== ================================================
 
 What:          /sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
 What:          /sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
 KernelVersion: v4.6
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ===================================================
                sc2vl/:         (RO) 32 files (0 - 31) used to translate sl->vl
 
                sl2sc/:         (RO) 32 files (0 - 31) used to translate sl->sc
 
                vl2mtu/:        (RO) 16 files (0 - 15) used to determine MTU for vl
+               =============== ===================================================
 
 
 What:          /sys/class/infiniband/hfi1_X/sdma_N/cpu_list
 Description:
                sdma<N>/ contains one directory per sdma engine (0 - 15)
 
+               =============== ==============================================
                cpu_list:       (RW) List of cpus for user-process to sdma
                                engine assignment.
 
                vl:             (RO) Displays the virtual lane (vl) the sdma
                                engine maps to.
+               =============== ==============================================
 
                This interface gives the user control on the affinity settings
                for the device. As an example, to set an sdma engine irq
                affinity and thread affinity of a user processes to use the
                sdma engine, which is "near" in terms of NUMA configuration, or
-               physical cpu location, the user will do:
+               physical cpu location, the user will do::
 
-               echo "3" > /proc/irq/<N>/smp_affinity_list
-               echo "4-7" > /sys/devices/.../sdma3/cpu_list
-               cat /sys/devices/.../sdma3/vl
-               0
-               echo "8" > /proc/irq/<M>/smp_affinity_list
-               echo "9-12" > /sys/devices/.../sdma4/cpu_list
-               cat /sys/devices/.../sdma4/vl
-               1
+                 echo "3" > /proc/irq/<N>/smp_affinity_list
+                 echo "4-7" > /sys/devices/.../sdma3/cpu_list
+                 cat /sys/devices/.../sdma3/vl
+                 0
+                 echo "8" > /proc/irq/<M>/smp_affinity_list
+                 echo "9-12" > /sys/devices/.../sdma4/cpu_list
+                 cat /sys/devices/.../sdma4/vl
+                 1
 
                to make sure that when a process runs on cpus 4,5,6, or 7, and
                uses vl=0, then sdma engine 3 is selected by the driver, and
 KernelVersion: v4.10
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ==== ========================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Show HCA type (I40IW)
 
                board_id:       (RO) I40IW board ID
+               =============== ==== ========================
 
 
 sysfs interface for QLogic qedr NIC Driver
 Contact:       linux-rdma@vger.kernel.org
 Description:
 
+               =============== ==== ========================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Display HCA type
+               =============== ==== ========================
 
 
 sysfs interface for VMware Paravirtual RDMA driver
 Contact:       linux-rdma@vger.kernel.org
 Description:
 
+               =============== ==== =====================================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Host channel adapter type
 
                board_id:       (RO) Display PVRDMA manufacturing board ID
+               =============== ==== =====================================
 
 
 sysfs interface for Broadcom NetXtreme-E RoCE driver
 KernelVersion: v4.11
 Contact:       linux-rdma@vger.kernel.org
 Description:
+               =============== ==== =========================
                hw_rev:         (RO) Hardware revision number
 
                hca_type:       (RO) Host channel adapter type
+               =============== ==== =========================
 
 Contact:       linux-integrity@vger.kernel.org
 Description:   The "caps" property contains TPM manufacturer and version info.
 
-               Example output:
+               Example output::
 
-               Manufacturer: 0x53544d20
-               TCG version: 1.2
-               Firmware version: 8.16
+                 Manufacturer: 0x53544d20
+                 TCG version: 1.2
+                 Firmware version: 8.16
 
                Manufacturer is a hex dump of the 4 byte manufacturer info
                space in a TPM. TCG version shows the TCG TPM spec level that
                any longer than necessary before starting to poll for a
                result.
 
-               Example output:
+               Example output::
 
-               3015000 4508000 180995000 [original]
+                 3015000 4508000 180995000 [original]
 
                Here the short, medium and long durations are displayed in
                usecs. "[original]" indicates that the values are displayed
                values may be constantly changing, the output is only valid
                for a snapshot in time.
 
-               Example output:
+               Example output::
 
-               PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
-               PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
-               PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
-               PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
-               PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
-               ...
+                 PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
+                 PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
+                 PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
+                 PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
+                 PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
+                 ...
 
                The number of PCRs and hex bytes needed to represent a PCR
                value will vary depending on TPM chip version. For TPM 1.1 and
                ated at TPM manufacture time and exists for the life of the
                chip.
 
-               Example output:
-
-               Algorithm: 00 00 00 01
-               Encscheme: 00 03
-               Sigscheme: 00 01
-               Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
-               Modulus length: 256
-               Modulus:
-               B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
-               3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
-               1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
-               86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
-               D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
-               82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
-               0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
-               1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
-               6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
-               A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
-               47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
-               10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
-               E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
-               F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
-               F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
-               C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B
-
-               Possible values:
-
-               Algorithm:      TPM_ALG_RSA                     (1)
-               Encscheme:      TPM_ES_RSAESPKCSv15             (2)
+               Example output::
+
+                 Algorithm: 00 00 00 01
+                 Encscheme: 00 03
+                 Sigscheme: 00 01
+                 Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
+                 Modulus length: 256
+                 Modulus:
+                 B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
+                 3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
+                 1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
+                 86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
+                 D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
+                 82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
+                 0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
+                 1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
+                 6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
+                 A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
+                 47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
+                 10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
+                 E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
+                 F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
+                 F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
+                 C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B
+
+               Possible values::
+
+                 Algorithm:    TPM_ALG_RSA                     (1)
+                 Encscheme:    TPM_ES_RSAESPKCSv15             (2)
                                TPM_ES_RSAESOAEP_SHA1_MGF1      (3)
-               Sigscheme:      TPM_SS_NONE                     (1)
-               Parameters, a byte string of 3 u32 values:
+                 Sigscheme:    TPM_SS_NONE                     (1)
+                 Parameters, a byte string of 3 u32 values:
                        Key Length (bits):      00 00 08 00     (2048)
                        Num primes:             00 00 00 02     (2)
                        Exponent Size:          00 00 00 00     (0 means the
                                                                 default exp)
-               Modulus Length: 256 (bytes)
-               Modulus:        The 256 byte Endorsement Key modulus
+                 Modulus Length: 256 (bytes)
+                 Modulus:      The 256 byte Endorsement Key modulus
 
 What:          /sys/class/tpm/tpmX/device/temp_deactivated
 Date:          April 2006
                timeouts is defined by the TPM interface spec that the chip
                conforms to.
 
-               Example output:
+               Example output::
 
-               750000 750000 750000 750000 [original]
+                 750000 750000 750000 750000 [original]
 
                The four timeout values are shown in usecs, with a trailing
                "[original]" or "[adjusted]" depending on whether the values