s390/cio/qdio_debug.c

0001 // SPDX-License-Identifier: GPL-2.0
0002 /*
0003  *  Copyright IBM Corp. 2008, 2009
0004  *
0005  *  Author: Jan Glauber (jang@linux.vnet.ibm.com)
0006  */
0007 #include <linux/seq_file.h>
0008 #include <linux/debugfs.h>
0009 #include <linux/uaccess.h>
0010 #include <linux/export.h>
0011 #include <linux/slab.h>
0012 #include <asm/debug.h>
0013 #include "qdio_debug.h"
0014 #include "qdio.h"
0015
0016 debug_info_t *qdio_dbf_setup;
0017 debug_info_t *qdio_dbf_error;
0018
0019 static struct dentry *debugfs_root;
0020 #define QDIO_DEBUGFS_NAME_LEN   10
0021 #define QDIO_DBF_NAME_LEN   20
0022
0023 struct qdio_dbf_entry {
0024     char dbf_name[QDIO_DBF_NAME_LEN];
0025     debug_info_t *dbf_info;
0026     struct list_head dbf_list;
0027 };
0028
0029 static LIST_HEAD(qdio_dbf_list);
0030 static DEFINE_MUTEX(qdio_dbf_list_mutex);
0031
0032 static debug_info_t *qdio_get_dbf_entry(char *name)
0033 {
0034     struct qdio_dbf_entry *entry;
0035     debug_info_t *rc = NULL;
0036
0037     mutex_lock(&qdio_dbf_list_mutex);
0038     list_for_each_entry(entry, &qdio_dbf_list, dbf_list) {
0039         if (strcmp(entry->dbf_name, name) == 0) {
0040             rc = entry->dbf_info;
0041             break;
0042         }
0043     }
0044     mutex_unlock(&qdio_dbf_list_mutex);
0045     return rc;
0046 }
0047
0048 static void qdio_clear_dbf_list(void)
0049 {
0050     struct qdio_dbf_entry *entry, *tmp;
0051
0052     mutex_lock(&qdio_dbf_list_mutex);
0053     list_for_each_entry_safe(entry, tmp, &qdio_dbf_list, dbf_list) {
0054         list_del(&entry->dbf_list);
0055         debug_unregister(entry->dbf_info);
0056         kfree(entry);
0057     }
0058     mutex_unlock(&qdio_dbf_list_mutex);
0059 }
0060
0061 int qdio_allocate_dbf(struct qdio_irq *irq_ptr)
0062 {
0063     char text[QDIO_DBF_NAME_LEN];
0064     struct qdio_dbf_entry *new_entry;
0065
0066     DBF_EVENT("irq:%8lx", (unsigned long)irq_ptr);
0067
0068     /* allocate trace view for the interface */
0069     snprintf(text, QDIO_DBF_NAME_LEN, "qdio_%s",
0070          dev_name(&irq_ptr->cdev->dev));
0071     irq_ptr->debug_area = qdio_get_dbf_entry(text);
0072     if (irq_ptr->debug_area)
0073         DBF_DEV_EVENT(DBF_ERR, irq_ptr, "dbf reused");
0074     else {
0075         irq_ptr->debug_area = debug_register(text, 2, 1, 16);
0076         if (!irq_ptr->debug_area)
0077             return -ENOMEM;
0078         if (debug_register_view(irq_ptr->debug_area,
0079                         &debug_hex_ascii_view)) {
0080             debug_unregister(irq_ptr->debug_area);
0081             return -ENOMEM;
0082         }
0083         debug_set_level(irq_ptr->debug_area, DBF_WARN);
0084         DBF_DEV_EVENT(DBF_ERR, irq_ptr, "dbf created");
0085         new_entry = kzalloc(sizeof(struct qdio_dbf_entry), GFP_KERNEL);
0086         if (!new_entry) {
0087             debug_unregister(irq_ptr->debug_area);
0088             return -ENOMEM;
0089         }
0090         strlcpy(new_entry->dbf_name, text, QDIO_DBF_NAME_LEN);
0091         new_entry->dbf_info = irq_ptr->debug_area;
0092         mutex_lock(&qdio_dbf_list_mutex);
0093         list_add(&new_entry->dbf_list, &qdio_dbf_list);
0094         mutex_unlock(&qdio_dbf_list_mutex);
0095     }
0096     return 0;
0097 }
0098
0099 static int qstat_show(struct seq_file *m, void *v)
0100 {
0101     unsigned char state;
0102     struct qdio_q *q = m->private;
0103     int i;
0104
0105     if (!q)
0106         return 0;
0107
0108     seq_printf(m, "Timestamp: %llx\n", q->timestamp);
0109     seq_printf(m, "Last Data IRQ: %llx  Last AI: %llx\n",
0110            q->irq_ptr->last_data_irq_time, last_ai_time);
0111     seq_printf(m, "nr_used: %d  ftc: %d\n",
0112            atomic_read(&q->nr_buf_used), q->first_to_check);
0113     if (q->is_input_q) {
0114         seq_printf(m, "batch start: %u  batch count: %u\n",
0115                q->u.in.batch_start, q->u.in.batch_count);
0116         seq_printf(m, "DSCI: %x   IRQs disabled: %u\n",
0117                *(u8 *)q->irq_ptr->dsci,
0118                test_bit(QDIO_IRQ_DISABLED,
0119                     &q->irq_ptr->poll_state));
0120     }
0121     seq_printf(m, "SBAL states:\n");
0122     seq_printf(m, "|0      |8      |16     |24     |32     |40     |48     |56  63|\n");
0123
0124     for (i = 0; i < QDIO_MAX_BUFFERS_PER_Q; i++) {
0125         debug_get_buf_state(q, i, &state);
0126         switch (state) {
0127         case SLSB_P_INPUT_NOT_INIT:
0128         case SLSB_P_OUTPUT_NOT_INIT:
0129             seq_printf(m, "N");
0130             break;
0131         case SLSB_P_OUTPUT_PENDING:
0132             seq_printf(m, "P");
0133             break;
0134         case SLSB_P_INPUT_PRIMED:
0135         case SLSB_CU_OUTPUT_PRIMED:
0136             seq_printf(m, "+");
0137             break;
0138         case SLSB_P_INPUT_ACK:
0139             seq_printf(m, "A");
0140             break;
0141         case SLSB_P_INPUT_ERROR:
0142         case SLSB_P_OUTPUT_ERROR:
0143             seq_printf(m, "x");
0144             break;
0145         case SLSB_CU_INPUT_EMPTY:
0146         case SLSB_P_OUTPUT_EMPTY:
0147             seq_printf(m, "-");
0148             break;
0149         case SLSB_P_INPUT_HALTED:
0150         case SLSB_P_OUTPUT_HALTED:
0151             seq_printf(m, ".");
0152             break;
0153         default:
0154             seq_printf(m, "?");
0155         }
0156         if (i == 63)
0157             seq_printf(m, "\n");
0158     }
0159     seq_printf(m, "\n");
0160     seq_printf(m, "|64     |72     |80     |88     |96     |104    |112    |   127|\n");
0161
0162     seq_printf(m, "\nSBAL statistics:");
0163     if (!q->irq_ptr->perf_stat_enabled) {
0164         seq_printf(m, " disabled\n");
0165         return 0;
0166     }
0167
0168     seq_printf(m, "\n1          2..        4..        8..        "
0169            "16..       32..       64..       128\n");
0170     for (i = 0; i < ARRAY_SIZE(q->q_stats.nr_sbals); i++)
0171         seq_printf(m, "%-10u ", q->q_stats.nr_sbals[i]);
0172     seq_printf(m, "\nError      NOP        Total\n%-10u %-10u %-10u\n\n",
0173            q->q_stats.nr_sbal_error, q->q_stats.nr_sbal_nop,
0174            q->q_stats.nr_sbal_total);
0175     return 0;
0176 }
0177
0178 DEFINE_SHOW_ATTRIBUTE(qstat);
0179
0180 static int ssqd_show(struct seq_file *m, void *v)
0181 {
0182     struct ccw_device *cdev = m->private;
0183     struct qdio_ssqd_desc ssqd;
0184     int rc;
0185
0186     rc = qdio_get_ssqd_desc(cdev, &ssqd);
0187     if (rc)
0188         return rc;
0189
0190     seq_hex_dump(m, "", DUMP_PREFIX_NONE, 16, 4, &ssqd, sizeof(ssqd),
0191              false);
0192     return 0;
0193 }
0194
0195 DEFINE_SHOW_ATTRIBUTE(ssqd);
0196
0197 static char *qperf_names[] = {
0198     "Assumed adapter interrupts",
0199     "QDIO interrupts",
0200     "SIGA read",
0201     "SIGA write",
0202     "SIGA sync",
0203     "Inbound calls",
0204     "Inbound stop_polling",
0205     "Inbound queue full",
0206     "Outbound calls",
0207     "Outbound queue full",
0208     "Outbound fast_requeue",
0209     "Outbound target_full",
0210     "QEBSM eqbs",
0211     "QEBSM eqbs partial",
0212     "QEBSM sqbs",
0213     "QEBSM sqbs partial",
0214     "Discarded interrupts"
0215 };
0216
0217 static int qperf_show(struct seq_file *m, void *v)
0218 {
0219     struct qdio_irq *irq_ptr = m->private;
0220     unsigned int *stat;
0221     int i;
0222
0223     if (!irq_ptr)
0224         return 0;
0225     if (!irq_ptr->perf_stat_enabled) {
0226         seq_printf(m, "disabled\n");
0227         return 0;
0228     }
0229     stat = (unsigned int *)&irq_ptr->perf_stat;
0230
0231     for (i = 0; i < ARRAY_SIZE(qperf_names); i++)
0232         seq_printf(m, "%26s:\t%u\n",
0233                qperf_names[i], *(stat + i));
0234     return 0;
0235 }
0236
0237 static ssize_t qperf_seq_write(struct file *file, const char __user *ubuf,
0238                    size_t count, loff_t *off)
0239 {
0240     struct seq_file *seq = file->private_data;
0241     struct qdio_irq *irq_ptr = seq->private;
0242     struct qdio_q *q;
0243     unsigned long val;
0244     int ret, i;
0245
0246     if (!irq_ptr)
0247         return 0;
0248
0249     ret = kstrtoul_from_user(ubuf, count, 10, &val);
0250     if (ret)
0251         return ret;
0252
0253     switch (val) {
0254     case 0:
0255         irq_ptr->perf_stat_enabled = 0;
0256         memset(&irq_ptr->perf_stat, 0, sizeof(irq_ptr->perf_stat));
0257         for_each_input_queue(irq_ptr, q, i)
0258             memset(&q->q_stats, 0, sizeof(q->q_stats));
0259         for_each_output_queue(irq_ptr, q, i)
0260             memset(&q->q_stats, 0, sizeof(q->q_stats));
0261         break;
0262     case 1:
0263         irq_ptr->perf_stat_enabled = 1;
0264         break;
0265     }
0266     return count;
0267 }
0268
0269 static int qperf_seq_open(struct inode *inode, struct file *filp)
0270 {
0271     return single_open(filp, qperf_show,
0272                file_inode(filp)->i_private);
0273 }
0274
0275 static const struct file_operations debugfs_perf_fops = {
0276     .owner   = THIS_MODULE,
0277     .open    = qperf_seq_open,
0278     .read    = seq_read,
0279     .write   = qperf_seq_write,
0280     .llseek  = seq_lseek,
0281     .release = single_release,
0282 };
0283
0284 static void setup_debugfs_entry(struct dentry *parent, struct qdio_q *q)
0285 {
0286     char name[QDIO_DEBUGFS_NAME_LEN];
0287
0288     snprintf(name, QDIO_DEBUGFS_NAME_LEN, "%s_%d",
0289          q->is_input_q ? "input" : "output",
0290          q->nr);
0291     debugfs_create_file(name, 0444, parent, q, &qstat_fops);
0292 }
0293
0294 void qdio_setup_debug_entries(struct qdio_irq *irq_ptr)
0295 {
0296     struct qdio_q *q;
0297     int i;
0298
0299     irq_ptr->debugfs_dev = debugfs_create_dir(dev_name(&irq_ptr->cdev->dev),
0300                           debugfs_root);
0301     debugfs_create_file("statistics", S_IFREG | S_IRUGO | S_IWUSR,
0302                 irq_ptr->debugfs_dev, irq_ptr, &debugfs_perf_fops);
0303     debugfs_create_file("ssqd", 0444, irq_ptr->debugfs_dev, irq_ptr->cdev,
0304                 &ssqd_fops);
0305
0306     for_each_input_queue(irq_ptr, q, i)
0307         setup_debugfs_entry(irq_ptr->debugfs_dev, q);
0308     for_each_output_queue(irq_ptr, q, i)
0309         setup_debugfs_entry(irq_ptr->debugfs_dev, q);
0310 }
0311
0312 void qdio_shutdown_debug_entries(struct qdio_irq *irq_ptr)
0313 {
0314     debugfs_remove_recursive(irq_ptr->debugfs_dev);
0315 }
0316
0317 int __init qdio_debug_init(void)
0318 {
0319     debugfs_root = debugfs_create_dir("qdio", NULL);
0320
0321     qdio_dbf_setup = debug_register("qdio_setup", 16, 1, 16);
0322     debug_register_view(qdio_dbf_setup, &debug_hex_ascii_view);
0323     debug_set_level(qdio_dbf_setup, DBF_INFO);
0324     DBF_EVENT("dbf created\n");
0325
0326     qdio_dbf_error = debug_register("qdio_error", 4, 1, 16);
0327     debug_register_view(qdio_dbf_error, &debug_hex_ascii_view);
0328     debug_set_level(qdio_dbf_error, DBF_INFO);
0329     DBF_ERROR("dbf created\n");
0330     return 0;
0331 }
0332
0333 void qdio_debug_exit(void)
0334 {
0335     qdio_clear_dbf_list();
0336     debugfs_remove_recursive(debugfs_root);
0337     debug_unregister(qdio_dbf_setup);
0338     debug_unregister(qdio_dbf_error);
0339 }