diff options
Diffstat (limited to 'Documentation/s390/s390dbf.txt')
-rw-r--r-- | Documentation/s390/s390dbf.txt | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/Documentation/s390/s390dbf.txt b/Documentation/s390/s390dbf.txt index e321a8ed2a2d..000230cd26db 100644 --- a/Documentation/s390/s390dbf.txt +++ b/Documentation/s390/s390dbf.txt | |||
@@ -11,7 +11,7 @@ where log records can be stored efficiently in memory, where each component | |||
11 | (e.g. device drivers) can have one separate debug log. | 11 | (e.g. device drivers) can have one separate debug log. |
12 | One purpose of this is to inspect the debug logs after a production system crash | 12 | One purpose of this is to inspect the debug logs after a production system crash |
13 | in order to analyze the reason for the crash. | 13 | in order to analyze the reason for the crash. |
14 | If the system still runs but only a subcomponent which uses dbf failes, | 14 | If the system still runs but only a subcomponent which uses dbf fails, |
15 | it is possible to look at the debug logs on a live system via the Linux | 15 | it is possible to look at the debug logs on a live system via the Linux |
16 | debugfs filesystem. | 16 | debugfs filesystem. |
17 | The debug feature may also very useful for kernel and driver development. | 17 | The debug feature may also very useful for kernel and driver development. |
@@ -65,7 +65,7 @@ Predefined views for hex/ascii, sprintf and raw binary data are provided. | |||
65 | It is also possible to define other views. The content of | 65 | It is also possible to define other views. The content of |
66 | a view can be inspected simply by reading the corresponding debugfs file. | 66 | a view can be inspected simply by reading the corresponding debugfs file. |
67 | 67 | ||
68 | All debug logs have an an actual debug level (range from 0 to 6). | 68 | All debug logs have an actual debug level (range from 0 to 6). |
69 | The default level is 3. Event and Exception functions have a 'level' | 69 | The default level is 3. Event and Exception functions have a 'level' |
70 | parameter. Only debug entries with a level that is lower or equal | 70 | parameter. Only debug entries with a level that is lower or equal |
71 | than the actual level are written to the log. This means, when | 71 | than the actual level are written to the log. This means, when |
@@ -83,8 +83,8 @@ Example: | |||
83 | It is also possible to deactivate the debug feature globally for every | 83 | It is also possible to deactivate the debug feature globally for every |
84 | debug log. You can change the behavior using 2 sysctl parameters in | 84 | debug log. You can change the behavior using 2 sysctl parameters in |
85 | /proc/sys/s390dbf: | 85 | /proc/sys/s390dbf: |
86 | There are currently 2 possible triggers, which stop the debug feature | 86 | There are currently 2 possible triggers, which stop the debug feature |
87 | globally. The first possbility is to use the "debug_active" sysctl. If | 87 | globally. The first possibility is to use the "debug_active" sysctl. If |
88 | set to 1 the debug feature is running. If "debug_active" is set to 0 the | 88 | set to 1 the debug feature is running. If "debug_active" is set to 0 the |
89 | debug feature is turned off. | 89 | debug feature is turned off. |
90 | The second trigger which stops the debug feature is an kernel oops. | 90 | The second trigger which stops the debug feature is an kernel oops. |
@@ -468,7 +468,7 @@ The hex_ascii view shows the data field in hex and ascii representation | |||
468 | The raw view returns a bytestream as the debug areas are stored in memory. | 468 | The raw view returns a bytestream as the debug areas are stored in memory. |
469 | 469 | ||
470 | The sprintf view formats the debug entries in the same way as the sprintf | 470 | The sprintf view formats the debug entries in the same way as the sprintf |
471 | function would do. The sprintf event/expection functions write to the | 471 | function would do. The sprintf event/exception functions write to the |
472 | debug entry a pointer to the format string (size = sizeof(long)) | 472 | debug entry a pointer to the format string (size = sizeof(long)) |
473 | and for each vararg a long value. So e.g. for a debug entry with a format | 473 | and for each vararg a long value. So e.g. for a debug entry with a format |
474 | string plus two varargs one would need to allocate a (3 * sizeof(long)) | 474 | string plus two varargs one would need to allocate a (3 * sizeof(long)) |
@@ -556,7 +556,7 @@ The input_proc can be used to implement functionality when it is written to | |||
556 | the view (e.g. like with 'echo "0" > /sys/kernel/debug/s390dbf/dasd/level). | 556 | the view (e.g. like with 'echo "0" > /sys/kernel/debug/s390dbf/dasd/level). |
557 | 557 | ||
558 | For header_proc there can be used the default function | 558 | For header_proc there can be used the default function |
559 | debug_dflt_header_fn() which is defined in in debug.h. | 559 | debug_dflt_header_fn() which is defined in debug.h. |
560 | and which produces the same header output as the predefined views. | 560 | and which produces the same header output as the predefined views. |
561 | E.g: | 561 | E.g: |
562 | 00 00964419409:440761 2 - 00 88023ec | 562 | 00 00964419409:440761 2 - 00 88023ec |