All of lore.kernel.org
 help / color / mirror / Atom feed
From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
To: Linux Doc Mailing List <linux-doc@vger.kernel.org>
Cc: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>,
	Mauro Carvalho Chehab <mchehab@infradead.org>,
	linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
	Martin Schwidefsky <schwidefsky@de.ibm.com>,
	Heiko Carstens <heiko.carstens@de.ibm.com>,
	linux-s390@vger.kernel.org
Subject: [PATCH 30/57] docs: s390: Debugging390.txt: convert table to ascii artwork
Date: Mon, 15 Apr 2019 23:55:55 -0300	[thread overview]
Message-ID: <f186aeca9675371b4551425a1fa880d6fc48babc.1555382110.git.mchehab+samsung@kernel.org> (raw)
In-Reply-To: <cover.1555382110.git.mchehab+samsung@kernel.org>

The first bit/value table inside the document is very
hard to read and won't fit ReST format. Convert it to
a nice ascii artwork table with makes it easier to read
and is compatible with ReST format parser on Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/s390/Debugging390.txt | 210 ++++++++++++++++------------
 1 file changed, 120 insertions(+), 90 deletions(-)

diff --git a/Documentation/s390/Debugging390.txt b/Documentation/s390/Debugging390.txt
index 5ae7f868a007..c35804c238ad 100644
--- a/Documentation/s390/Debugging390.txt
+++ b/Documentation/s390/Debugging390.txt
@@ -78,96 +78,126 @@ e.g. switching address translation off requires that you
 have a logical=physical mapping for the address you are
 currently running at.
 
-      Bit           Value
-s/390 z/Architecture
-0       0     Reserved ( must be 0 ) otherwise specification exception occurs.
-
-1       1     Program Event Recording 1 PER enabled, 
-	      PER is used to facilitate debugging e.g. single stepping.
-
-2-4    2-4    Reserved ( must be 0 ). 
-
-5       5     Dynamic address translation 1=DAT on.
-
-6       6     Input/Output interrupt Mask
-
-7	7     External interrupt Mask used primarily for interprocessor
-	      signalling and clock interrupts.
-
-8-11  8-11    PSW Key used for complex memory protection mechanism
-	      (not used under linux)
-
-12      12    1 on s/390 0 on z/Architecture
-
-13      13    Machine Check Mask 1=enable machine check interrupts
-
-14	14    Wait State. Set this to 1 to stop the processor except for
-	      interrupts and give  time to other LPARS. Used in CPU idle in
-	      the kernel to increase overall usage of processor resources.
-
-15      15    Problem state ( if set to 1 certain instructions are disabled )
-	      all linux user programs run with this bit 1 
-	      ( useful info for debugging under VM ).
-
-16-17 16-17   Address Space Control
-
-	      00 Primary Space Mode:
-	      The register CR1 contains the primary address-space control ele-
-	      ment (PASCE), which points to the primary space region/segment
-	      table origin.
-
-	      01 Access register mode
-
-	      10 Secondary Space Mode:
-	      The register CR7 contains the secondary address-space control
-	      element (SASCE), which points to the secondary space region or
-	      segment table origin.
-
-	      11 Home Space Mode:
-	      The register CR13 contains the home space address-space control
-	      element (HASCE), which points to the home space region/segment
-	      table origin.
-
-	      See "Address Spaces on Linux for s/390 & z/Architecture" below
-	      for more information about address space usage in Linux.
-
-18-19 18-19   Condition codes (CC)
-
-20    20      Fixed point overflow mask if 1=FPU exceptions for this event 
-              occur ( normally 0 ) 
-
-21    21      Decimal overflow mask if 1=FPU exceptions for this event occur 
-              ( normally 0 )
-
-22    22      Exponent underflow mask if 1=FPU exceptions for this event occur 
-              ( normally 0 )
-
-23    23      Significance Mask if 1=FPU exceptions for this event occur 
-              ( normally 0 )
-
-24-31 24-30   Reserved Must be 0.
-
-      31      Extended Addressing Mode
-      32      Basic Addressing Mode
-              Used to set addressing mode
-	      PSW 31   PSW 32
-                0         0        24 bit
-                0         1        31 bit
-                1         1        64 bit
-
-32             1=31 bit addressing mode 0=24 bit addressing mode (for backward 
-               compatibility), linux always runs with this bit set to 1
-
-33-64          Instruction address.
-      33-63    Reserved must be 0
-      64-127   Address
-               In 24 bits mode bits 64-103=0 bits 104-127 Address 
-               In 31 bits mode bits 64-96=0 bits 97-127 Address
-               Note: unlike 31 bit mode on s/390 bit 96 must be zero
-	       when loading the address with LPSWE otherwise a 
-               specification exception occurs, LPSW is fully backward
-               compatible.
-
++-------------------------+-------------------------------------------------+
+|          Bit            |                                                 |
++--------+----------------+                     Value                       |
+| s/390  | z/Architecture |                                                 |
++========+================+=================================================+
+| 0      |     0          | Reserved (must be 0) otherwise specification    |
+|        |                | exception occurs.                               |
++--------+----------------+-------------------------------------------------+
+| 1      |     1          | Program Event Recording 1 PER enabled,          |
+|        |                | PER is used to facilitate debugging e.g.        |
+|        |                | single stepping.                                |
++--------+----------------+-------------------------------------------------+
+| 2-4    |    2-4         | Reserved (must be 0).                           |
++--------+----------------+-------------------------------------------------+
+| 5      |     5          | Dynamic address translation 1=DAT on.           |
++--------+----------------+-------------------------------------------------+
+| 6      |     6          | Input/Output interrupt Mask                     |
++--------+----------------+-------------------------------------------------+
+| 7      |     7          | External interrupt Mask used primarily for      |
+|        |                | interprocessor signalling and clock interrupts. |
++--------+----------------+-------------------------------------------------+
+| 8-11   |   8-11         | PSW Key used for complex memory protection      |
+|        |                | mechanism (not used under linux)                |
++--------+----------------+-------------------------------------------------+
+| 12     |     12         | 1 on s/390 0 on z/Architecture                  |
++--------+----------------+-------------------------------------------------+
+| 13     |     13         | Machine Check Mask 1=enable machine check       |
+|        |                | interrupts                                      |
++--------+----------------+-------------------------------------------------+
+| 14     |     14         | Wait State. Set this to 1 to stop the processor |
+|        |                | except for interrupts and give  time to other   |
+|        |                | LPARS. Used in CPU idle in the kernel to        |
+|        |                | increase overall usage of processor resources.  |
++--------+----------------+-------------------------------------------------+
+| 15     |     15         | Problem state (if set to 1 certain instructions |
+|        |                | are disabled). All linux user programs run with |
+|        |                | this bit 1 (useful info for debugging under VM).|
++--------+----------------+-------------------------------------------------+
+| 16-17  |    16-17       | Address Space Control                           |
+|        |                |                                                 |
+|        |                | 00 Primary Space Mode:                          |
+|        |                |                                                 |
+|        |                | The register CR1 contains the primary           |
+|        |                | address-space control element (PASCE), which    |
+|        |                | points to the primary space region/segment      |
+|        |                | table origin.                                   |
+|        |                |                                                 |
+|        |                | 01 Access register mode                         |
+|        |                |                                                 |
+|        |                | 10 Secondary Space Mode:                        |
+|        |                |                                                 |
+|        |                | The register CR7 contains the secondary         |
+|        |                | address-space control element (SASCE), which    |
+|        |                | points to the secondary space region or         |
+|        |                | segment table origin.                           |
+|        |                |                                                 |
+|        |                | 11 Home Space Mode:                             |
+|        |                |                                                 |
+|        |                | The register CR13 contains the home space       |
+|        |                | address-space control element (HASCE), which    |
+|        |                | points to the home space region/segment         |
+|        |                | table origin.                                   |
+|        |                |                                                 |
+|        |                | See "Address Spaces on Linux for s/390 &        |
+|        |                | z/Architecture" below for more information      |
+|        |                | about address space usage in Linux.             |
++--------+----------------+-------------------------------------------------+
+| 18-19  |    18-19       | Condition codes (CC)                            |
++--------+----------------+-------------------------------------------------+
+| 20     |    20          | Fixed point overflow mask if 1=FPU exceptions   |
+|        |                | for this event occur (normally 0)               |
++--------+----------------+-------------------------------------------------+
+| 21     |    21          | Decimal overflow mask if 1=FPU exceptions for   |
+|        |                | this event occur (normally 0)                   |
++--------+----------------+-------------------------------------------------+
+| 22     |    22          | Exponent underflow mask if 1=FPU exceptions     |
+|        |                | for this event occur (normally 0)               |
++--------+----------------+-------------------------------------------------+
+| 23     |    23          | Significance Mask if 1=FPU exceptions for this  |
+|        |                | event occur (normally 0)                        |
++--------+----------------+-------------------------------------------------+
+| 24-31  |    24-30       | Reserved Must be 0.                             |
+|        +----------------+-------------------------------------------------+
+|        |    31          | Extended Addressing Mode                        |
+|        +----------------+-------------------------------------------------+
+|        |    32          | Basic Addressing Mode                           |
+|        |                |                                                 |
+|        |                | Used to set addressing mode                     |
+|        |                |                                                 |
+|        |                |    +---------+----------+----------+            |
+|        |                |    | PSW 31  | PSW 32   |          |            |
+|        |                |    +---------+----------+----------+            |
+|        |                |    |   0     |    0     |  24 bit  |            |
+|        |                |    +---------+----------+----------+            |
+|        |                |    |   0     |    1     |  31 bit  |            |
+|        |                |    +---------+----------+----------+            |
+|        |                |    |   1     |    1     |  64 bit  |            |
+|        |                |    +---------+----------+----------+            |
++--------+----------------+-------------------------------------------------+
+| 32     |                | 1=31 bit addressing mode 0=24 bit addressing    |
+|        |                | mode (for backward compatibility), linux        |
+|        |                | always runs with this bit set to 1              |
++--------+----------------+-------------------------------------------------+
+| 33-64  |                | Instruction address.                            |
+|        +----------------+-------------------------------------------------+
+|        |    33-63       | Reserved must be 0                              |
+|        +----------------+-------------------------------------------------+
+|        |    64-127      | Address                                         |
+|        |                |                                                 |
+|        |                |   - In 24 bits mode bits 64-103=0 bits 104-127  |
+|        |                |     Address                                     |
+|        |                |   - In 31 bits mode bits 64-96=0 bits 97-127    |
+|        |                |     Address                                     |
+|        |                |                                                 |
+|        |                | Note:                                           |
+|        |                |     unlike 31 bit mode on s/390 bit 96 must be  |
+|        |                |     zero when loading the address with LPSWE    |
+|        |                |     otherwise a specification exception occurs, |
+|        |                |     LPSW is fully backward compatible.          |
++--------+----------------+-------------------------------------------------+
 
 Prefix Page(s)
 --------------
-- 
2.20.1


  parent reply	other threads:[~2019-04-16  2:59 UTC|newest]

Thread overview: 121+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-04-16  2:55 [PATCH 00/57] Convert files to ReST Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 01/57] docs: trace: fix some Sphinx warnings Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 02/57] docs: acpi: convert text files to ReST Mauro Carvalho Chehab
2019-04-16  8:17   ` Rafael J. Wysocki
2019-04-16  9:54     ` Mauro Carvalho Chehab
2019-04-16 10:17       ` Rafael J. Wysocki
2019-04-16 14:55     ` Changbin Du
2019-04-22 13:31       ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 03/57] docs: aoe: " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 04/57] docs: arm64: convert documentation to ReST format Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 05/57] docs: cdrom/cdrom-standard.tex: convert from LaTeX to ReST Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 06/57] docs: cdrom: convert remaining files " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 07/57] docs: cgroup-v1: convert to ReST file format Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 08/57] docs: cgroup-v1/blkio-controller.rst: add a note about CFQ scheduler Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 09/57] docs: cpu-freq: convert files to ReST Mauro Carvalho Chehab
2019-04-16  8:21   ` Rafael J. Wysocki
2019-04-16  9:58     ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 10/57] docs: device-mapper: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 13:28   ` Mike Snitzer
2019-04-16 14:00     ` Jonathan Corbet
2019-04-16 14:33       ` Mauro Carvalho Chehab
2019-04-16 15:48       ` Mike Snitzer
2019-04-16 17:27         ` Jonathan Corbet
2019-04-16 18:14         ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 11/57] docs: extcon: move it to acpi dir and convert it to ReST Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 12/57] docs: fault-injection: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 13/57] docs: fb: convert documentation " Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-05-06 13:36   ` Bartlomiej Zolnierkiewicz
2019-05-06 13:36     ` Bartlomiej Zolnierkiewicz
2019-04-16  2:55 ` [PATCH 14/57] docs: fpga: convert it to ReST Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 15/57] docs: gpio: " Mauro Carvalho Chehab
2019-04-23 10:52   ` Linus Walleij
2019-04-23 12:38     ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 16/57] docs: ide: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 17/57] docs: infiniband: " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 18/57] docs: kbuild: convert it to ReST output Mauro Carvalho Chehab
2019-04-18  9:25   ` Masahiro Yamada
2019-04-18 10:26     ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 19/57] docs: kdump: convert it to ReST Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 20/57] docs: livepatch: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  8:43   ` Petr Mladek
2019-04-16 11:47     ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 21/57] docs: locking: convert docs " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 22/57] docs: mic: convert it " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 23/57] docs: netlabel: convert it to ReST Mauro Carvalho Chehab
2019-04-17 14:36   ` Paul Moore
2019-04-16  2:55 ` [PATCH 24/57] docs: pcmcia: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  4:58   ` Dominik Brodowski
2019-04-16  2:55 ` [PATCH 25/57] docs: power: convert docs to ReST Mauro Carvalho Chehab
2019-04-16  7:20   ` Pavel Machek
2019-04-16  8:59   ` Rafael J. Wysocki
2019-04-16 10:41     ` Mauro Carvalho Chehab
2019-04-16 10:47       ` Rafael J. Wysocki
2019-04-16  2:55 ` [PATCH 26/57] docs: powerpc: " Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 27/57] docs: pps/pps.txt convert it to ReST and move to API book Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 28/57] docs: ptp.txt: convert to ReST and move to driver-api Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 29/57] docs: riscv: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-04-16  2:55 ` Mauro Carvalho Chehab [this message]
2019-04-16  2:55 ` [PATCH 31/57] docs: s390: convert text files " Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 32/57] s390: include/asm/debug.h add kerneldoc markups Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 33/57] docs: serial: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  2:55 ` [PATCH 34/57] docs: target: " Mauro Carvalho Chehab
2019-04-16  2:55   ` Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 35/57] docs: timers: convert documentation to ReST Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 36/57] docs: usb: convert documents " Mauro Carvalho Chehab
2019-04-16  2:56   ` [36/57] " Mauro Carvalho Chehab
2019-04-16  6:12   ` [PATCH 36/57] " Felipe Balbi
2019-04-16  6:12     ` [36/57] " Felipe Balbi
2019-04-16 11:43     ` [PATCH 36/57] " Mauro Carvalho Chehab
2019-04-16 11:43       ` [36/57] " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 37/57] docs: watchdog: convert documents to ReST format Mauro Carvalho Chehab
2019-04-17 17:53   ` Guenter Roeck
2019-04-16  2:56 ` [PATCH 38/57] docs: x86: convert text files to ReST Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 39/57] docs: xilinx: convert eemi.txt " Mauro Carvalho Chehab
2019-04-16  2:56   ` Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 40/57] docs: scheduler: convert files " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 41/57] docs: EDID/HOWTO.txt: convert to ReST and move to kernel-API Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 42/57] docs: connector.txt: convert to ReST Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 43/57] docs: lcd-panel-cgram.txt convert it to ReST and move to admin-guide Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 44/57] docs: lp855x-driver.txt: convert to ReST and move to kernel-api Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 45/57] docs: m68k: convert it to ReST file format and add to arch bookset Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 46/57] docs: cma/debugfs.txt: convert to ReST and move to admin-guide/mm Mauro Carvalho Chehab
2019-04-16  5:21   ` Mike Rapoport
2019-04-16 11:35     ` Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 47/57] docs: console.txt: convert to ReST format Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 48/57] docs: pti_intel_mid.txt: convert to ReST Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 49/57] docs: early-userspace: convert docs " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 50/57] docs: driver-model: convert it to ReST format Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 51/57] docs: arm: convert text files " Mauro Carvalho Chehab
2019-04-16  2:56   ` Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 52/57] docs: memory-devices: convert ti-emif.txt " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 53/57] docs: xen-tpmfront.txt: convert the file " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 54/57] docs: bus-devices: ti-gpmc.txt: convert it to ReST Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 55/57] docs: nvmem: convert file to ReST format Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 56/57] docs: phy: convert samsung-usb2.txt " Mauro Carvalho Chehab
2019-04-16  2:56 ` [PATCH 57/57] docs: Prepare files to be renamed to *.rst Mauro Carvalho Chehab
2019-04-18 12:42 ` Avoiding merge conflicts while adding new docs - Was: Re: [PATCH 00/57] Convert files to ReST Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-18 12:42   ` Mauro Carvalho Chehab
2019-04-19 22:10   ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet
2019-04-19 22:10     ` Jonathan Corbet

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=f186aeca9675371b4551425a1fa880d6fc48babc.1555382110.git.mchehab+samsung@kernel.org \
    --to=mchehab+samsung@kernel.org \
    --cc=corbet@lwn.net \
    --cc=heiko.carstens@de.ibm.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-s390@vger.kernel.org \
    --cc=mchehab@infradead.org \
    --cc=schwidefsky@de.ibm.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.