diff options
Diffstat (limited to 'Documentation/s390/CommonIO')
| -rw-r--r-- | Documentation/s390/CommonIO | 51 |
1 files changed, 29 insertions, 22 deletions
diff --git a/Documentation/s390/CommonIO b/Documentation/s390/CommonIO index 22f82f21bc60..86320aa3fb0b 100644 --- a/Documentation/s390/CommonIO +++ b/Documentation/s390/CommonIO | |||
| @@ -1,5 +1,5 @@ | |||
| 1 | S/390 common I/O-Layer - command line parameters and /proc entries | 1 | S/390 common I/O-Layer - command line parameters, procfs and debugfs entries |
| 2 | ================================================================== | 2 | ============================================================================ |
| 3 | 3 | ||
| 4 | Command line parameters | 4 | Command line parameters |
| 5 | ----------------------- | 5 | ----------------------- |
| @@ -7,9 +7,9 @@ Command line parameters | |||
| 7 | * cio_msg = yes | no | 7 | * cio_msg = yes | no |
| 8 | 8 | ||
| 9 | Determines whether information on found devices and sensed device | 9 | Determines whether information on found devices and sensed device |
| 10 | characteristics should be shown during startup, i. e. messages of the types | 10 | characteristics should be shown during startup or when new devices are |
| 11 | "Detected device 0.0.4711 on subchannel 0.0.0042" and "SenseID: Device | 11 | found, i. e. messages of the types "Detected device 0.0.4711 on subchannel |
| 12 | 0.0.4711 reports: ...". | 12 | 0.0.0042" and "SenseID: Device 0.0.4711 reports: ...". |
| 13 | 13 | ||
| 14 | Default is off. | 14 | Default is off. |
| 15 | 15 | ||
| @@ -26,8 +26,10 @@ Command line parameters | |||
| 26 | An ignored device can be un-ignored later; see the "/proc entries"-section for | 26 | An ignored device can be un-ignored later; see the "/proc entries"-section for |
| 27 | details. | 27 | details. |
| 28 | 28 | ||
| 29 | The devices must be given either as bus ids (0.0.abcd) or as hexadecimal | 29 | The devices must be given either as bus ids (0.x.abcd) or as hexadecimal |
| 30 | device numbers (0xabcd or abcd, for 2.4 backward compatibility). | 30 | device numbers (0xabcd or abcd, for 2.4 backward compatibility). If you |
| 31 | give a device number 0xabcd, it will be interpreted as 0.0.abcd. | ||
| 32 | |||
| 31 | You can use the 'all' keyword to ignore all devices. | 33 | You can use the 'all' keyword to ignore all devices. |
| 32 | The '!' operator will cause the I/O-layer to _not_ ignore a device. | 34 | The '!' operator will cause the I/O-layer to _not_ ignore a device. |
| 33 | The command line is parsed from left to right. | 35 | The command line is parsed from left to right. |
| @@ -81,31 +83,36 @@ Command line parameters | |||
| 81 | will add 0.0.a000-0.0.accc and 0.0.af00-0.0.afff to the list of ignored | 83 | will add 0.0.a000-0.0.accc and 0.0.af00-0.0.afff to the list of ignored |
| 82 | devices. | 84 | devices. |
| 83 | 85 | ||
| 84 | The devices can be specified either by bus id (0.0.abcd) or, for 2.4 backward | 86 | The devices can be specified either by bus id (0.x.abcd) or, for 2.4 backward |
| 85 | compatibility, by the device number in hexadecimal (0xabcd or abcd). | 87 | compatibility, by the device number in hexadecimal (0xabcd or abcd). Device |
| 88 | numbers given as 0xabcd will be interpreted as 0.0.abcd. | ||
| 89 | |||
| 90 | * For some of the information present in the /proc filesystem in 2.4 (namely, | ||
| 91 | /proc/subchannels and /proc/chpids), see driver-model.txt. | ||
| 92 | Information formerly in /proc/irq_count is now in /proc/interrupts. | ||
| 93 | |||
| 86 | 94 | ||
| 95 | debugfs entries | ||
| 96 | --------------- | ||
| 87 | 97 | ||
| 88 | * /proc/s390dbf/cio_*/ (S/390 debug feature) | 98 | * /sys/kernel/debug/s390dbf/cio_*/ (S/390 debug feature) |
| 89 | 99 | ||
| 90 | Some views generated by the debug feature to hold various debug outputs. | 100 | Some views generated by the debug feature to hold various debug outputs. |
| 91 | 101 | ||
| 92 | - /proc/s390dbf/cio_crw/sprintf | 102 | - /sys/kernel/debug/s390dbf/cio_crw/sprintf |
| 93 | Messages from the processing of pending channel report words (machine check | 103 | Messages from the processing of pending channel report words (machine check |
| 94 | handling), which will also show when CONFIG_DEBUG_CRW is defined. | 104 | handling). |
| 95 | 105 | ||
| 96 | - /proc/s390dbf/cio_msg/sprintf | 106 | - /sys/kernel/debug/s390dbf/cio_msg/sprintf |
| 97 | Various debug messages from the common I/O-layer; generally, messages which | 107 | Various debug messages from the common I/O-layer, including messages |
| 98 | will also show when CONFIG_DEBUG_IO is defined. | 108 | printed when cio_msg=yes. |
| 99 | 109 | ||
| 100 | - /proc/s390dbf/cio_trace/hex_ascii | 110 | - /sys/kernel/debug/s390dbf/cio_trace/hex_ascii |
| 101 | Logs the calling of functions in the common I/O-layer and, if applicable, | 111 | Logs the calling of functions in the common I/O-layer and, if applicable, |
| 102 | which subchannel they were called for, as well as dumps of some data | 112 | which subchannel they were called for, as well as dumps of some data |
| 103 | structures (like irb in an error case). | 113 | structures (like irb in an error case). |
| 104 | 114 | ||
| 105 | The level of logging can be changed to be more or less verbose by piping to | 115 | The level of logging can be changed to be more or less verbose by piping to |
| 106 | /proc/s390dbf/cio_*/level a number between 0 and 6; see the documentation on | 116 | /sys/kernel/debug/s390dbf/cio_*/level a number between 0 and 6; see the |
| 107 | the S/390 debug feature (Documentation/s390/s390dbf.txt) for details. | 117 | documentation on the S/390 debug feature (Documentation/s390/s390dbf.txt) |
| 108 | 118 | for details. | |
| 109 | * For some of the information present in the /proc filesystem in 2.4 (namely, | ||
| 110 | /proc/subchannels and /proc/chpids), see driver-model.txt. | ||
| 111 | Information formerly in /proc/irq_count is now in /proc/interrupts. | ||