s390/cpum_cf: Add kernel message exaplanations

The CPU Measurement facility for counters and counter set
rework adds a few new kernel messages to the system log.
Add an explanation for some of these.

Signed-off-by: Thomas Richter <tmricht@linux.ibm.com>
Signed-off-by: Martin Schwidefsky <schwidefsky@de.ibm.com>

2 files changed, 81 insertions, 0 deletions

diff --git a/Documentation/kmsg/s390/cpum_cf_common b/Documentation/kmsg/s390/cpum_cf_common
new file mode 100644
index 000000000000..c890a5dabdd6
--- /dev/null
+++ b/Documentation/kmsg/s390/cpum_cf_common
@@ -0,0 +1,36 @@
+/*?
+ * Text: "CPU[%i] Counter data was lost\n"
+ * Severity: Error
+ * Parameter:
+ *   @1: CPU identifier
+ * Description:
+ * The kernel could not extract data provided by the Performance Measurement Unit
+ * (PMU) fast enough, some data is overwritten.
+ * User action:
+ * None
+ */
+
+/*?
+ * Text: "CPU[%i] MT counter data was lost\n"
+ * Severity: Warning
+ * Parameter:
+ *   @1: CPU identifier
+ * Description:
+ * The kernel could not extract data provided by the Performance Measurement Unit
+ * (PMU) fast enough, some data is overwritten.
+ * User action:
+ * None
+ */
+
+/*?
+ * Text: "Registering for CPU-measurement alerts failed with rc=%i\n"
+ * Severity: Error
+ * Parameter:
+ *   @1: Return code of failed interrupt handler registration
+ * Description:
+ * Please insert description here
+ * User action:
+ * Reboot. If the problem persists, gather Linux debug data and report
+ * the problem to your support organization.
+ */
+/*? Text: "%s: %d output lines suppressed due to ratelimiting\n" */
diff --git a/Documentation/kmsg/s390/cpum_cf_diag b/Documentation/kmsg/s390/cpum_cf_diag
new file mode 100644
index 000000000000..fd166f96ded8
--- /dev/null
+++ b/Documentation/kmsg/s390/cpum_cf_diag
@@ -0,0 +1,45 @@
+/*? Text: "%s: %d output lines suppressed due to ratelimiting\n" */
+/*? Text: "cpum_cf_diag counter set compare error in set %i\n" */
+/*? Text: "Registration of s390dbf(cpum_cf_diag) failed\n" */
+/*? Text: "Registration of PMU(cpum_cf_diag) failed with rc=%i\n" */
+
+/*?
+ * Text: "Enabling the performance measuring unit failed with rc=%x\n"
+ * Severity: Error
+ * Parameter:
+ *   @1: Error code returned by PMU enable function
+ * Description:
+ * The CPU Measurement Facilitiy for counters needs to be enabled to extract
+ * counter data.
+ * User action:
+ * To use the CPU-measurement counter facility, authorize the LPAR for each
+ * counter set you want to use. Customize the LPAR activation profile and modify
+ * the Counter Facility Security Options. Then reboot.
+ * If the problem persists, gather Linux debug data and report the
+ * problem to your support organization.
+ */
+
+/*?
+ * Text: "Disabling the performance measuring unit failed with rc=%x\n"
+ * Severity: Error
+ * Parameter:
+ *   @1: Error code returned by PMU disable function
+ * Description:
+ * The CPU Measurement Facilitiy for counters is disabled to stop extraction
+ * of counter data.
+ * User action:
+ * Reboot. If the problem persists, gather Linux debug data and report the
+ * problem to your support organization.
+ */
+
+/*?
+ * Text: "Insufficient memory for PMU(cpum_cf_diag) need=%zu\n"
+ * Severity: Error
+ * Parameter:
+ *   @1: Required amount of bytes needed to store the counter sets.
+ * Description:
+ * The preallocted memory to store counter sets is too small.
+ * User action:
+ * If the problem persists, gather Linux debug data and report the
+ * problem to your support organization.
+ */