xref: /linux/drivers/misc/mei/debugfs.c (revision da1d9caf95def6f0320819cf941c9fd1069ba9e1)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (c) 2012-2016, Intel Corporation. All rights reserved
4  * Intel Management Engine Interface (Intel MEI) Linux driver
5  */
6 
7 #include <linux/slab.h>
8 #include <linux/kernel.h>
9 #include <linux/device.h>
10 #include <linux/debugfs.h>
11 #include <linux/seq_file.h>
12 
13 #include <linux/mei.h>
14 
15 #include "mei_dev.h"
16 #include "client.h"
17 #include "hw.h"
18 
19 static int mei_dbgfs_meclients_show(struct seq_file *m, void *unused)
20 {
21 	struct mei_device *dev = m->private;
22 	struct mei_me_client *me_cl;
23 	int i = 0;
24 
25 	if (!dev)
26 		return -ENODEV;
27 
28 	down_read(&dev->me_clients_rwsem);
29 
30 	seq_puts(m, "  |id|fix|         UUID                       |con|msg len|sb|refc|vt|\n");
31 
32 	/*  if the driver is not enabled the list won't be consistent */
33 	if (dev->dev_state != MEI_DEV_ENABLED)
34 		goto out;
35 
36 	list_for_each_entry(me_cl, &dev->me_clients, list) {
37 		if (!mei_me_cl_get(me_cl))
38 			continue;
39 
40 		seq_printf(m, "%2d|%2d|%3d|%pUl|%3d|%7d|%2d|%4d|%2d|\n",
41 			   i++, me_cl->client_id,
42 			   me_cl->props.fixed_address,
43 			   &me_cl->props.protocol_name,
44 			   me_cl->props.max_number_of_connections,
45 			   me_cl->props.max_msg_length,
46 			   me_cl->props.single_recv_buf,
47 			   kref_read(&me_cl->refcnt),
48 			   me_cl->props.vt_supported);
49 		mei_me_cl_put(me_cl);
50 	}
51 
52 out:
53 	up_read(&dev->me_clients_rwsem);
54 	return 0;
55 }
56 DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_meclients);
57 
58 static int mei_dbgfs_active_show(struct seq_file *m, void *unused)
59 {
60 	struct mei_device *dev = m->private;
61 	struct mei_cl *cl;
62 	int i = 0;
63 
64 	if (!dev)
65 		return -ENODEV;
66 
67 	mutex_lock(&dev->device_lock);
68 
69 	seq_puts(m, "   |me|host|state|rd|wr|wrq\n");
70 
71 	/*  if the driver is not enabled the list won't be consistent */
72 	if (dev->dev_state != MEI_DEV_ENABLED)
73 		goto out;
74 
75 	list_for_each_entry(cl, &dev->file_list, link) {
76 
77 		seq_printf(m, "%3d|%2d|%4d|%5d|%2d|%2d|%3u\n",
78 			   i, mei_cl_me_id(cl), cl->host_client_id, cl->state,
79 			   !list_empty(&cl->rd_completed), cl->writing_state,
80 			   cl->tx_cb_queued);
81 		i++;
82 	}
83 out:
84 	mutex_unlock(&dev->device_lock);
85 	return 0;
86 }
87 DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_active);
88 
89 static int mei_dbgfs_devstate_show(struct seq_file *m, void *unused)
90 {
91 	struct mei_device *dev = m->private;
92 
93 	seq_printf(m, "dev: %s\n", mei_dev_state_str(dev->dev_state));
94 	seq_printf(m, "hbm: %s\n", mei_hbm_state_str(dev->hbm_state));
95 
96 	if (dev->hbm_state >= MEI_HBM_ENUM_CLIENTS &&
97 	    dev->hbm_state <= MEI_HBM_STARTED) {
98 		seq_puts(m, "hbm features:\n");
99 		seq_printf(m, "\tPG: %01d\n", dev->hbm_f_pg_supported);
100 		seq_printf(m, "\tDC: %01d\n", dev->hbm_f_dc_supported);
101 		seq_printf(m, "\tIE: %01d\n", dev->hbm_f_ie_supported);
102 		seq_printf(m, "\tDOT: %01d\n", dev->hbm_f_dot_supported);
103 		seq_printf(m, "\tEV: %01d\n", dev->hbm_f_ev_supported);
104 		seq_printf(m, "\tFA: %01d\n", dev->hbm_f_fa_supported);
105 		seq_printf(m, "\tOS: %01d\n", dev->hbm_f_os_supported);
106 		seq_printf(m, "\tDR: %01d\n", dev->hbm_f_dr_supported);
107 		seq_printf(m, "\tVT: %01d\n", dev->hbm_f_vt_supported);
108 		seq_printf(m, "\tCAP: %01d\n", dev->hbm_f_cap_supported);
109 		seq_printf(m, "\tCD: %01d\n", dev->hbm_f_cd_supported);
110 	}
111 
112 	seq_printf(m, "pg:  %s, %s\n",
113 		   mei_pg_is_enabled(dev) ? "ENABLED" : "DISABLED",
114 		   mei_pg_state_str(mei_pg_state(dev)));
115 	return 0;
116 }
117 DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_devstate);
118 
119 static ssize_t mei_dbgfs_write_allow_fa(struct file *file,
120 					const char __user *user_buf,
121 					size_t count, loff_t *ppos)
122 {
123 	struct mei_device *dev;
124 	int ret;
125 
126 	dev = container_of(file->private_data,
127 			   struct mei_device, allow_fixed_address);
128 
129 	ret = debugfs_write_file_bool(file, user_buf, count, ppos);
130 	if (ret < 0)
131 		return ret;
132 	dev->override_fixed_address = true;
133 	return ret;
134 }
135 
136 static const struct file_operations mei_dbgfs_allow_fa_fops = {
137 	.open = simple_open,
138 	.read = debugfs_read_file_bool,
139 	.write = mei_dbgfs_write_allow_fa,
140 	.llseek = generic_file_llseek,
141 };
142 
143 /**
144  * mei_dbgfs_deregister - Remove the debugfs files and directories
145  *
146  * @dev: the mei device structure
147  */
148 void mei_dbgfs_deregister(struct mei_device *dev)
149 {
150 	if (!dev->dbgfs_dir)
151 		return;
152 	debugfs_remove_recursive(dev->dbgfs_dir);
153 	dev->dbgfs_dir = NULL;
154 }
155 
156 /**
157  * mei_dbgfs_register - Add the debugfs files
158  *
159  * @dev: the mei device structure
160  * @name: the mei device name
161  */
162 void mei_dbgfs_register(struct mei_device *dev, const char *name)
163 {
164 	struct dentry *dir;
165 
166 	dir = debugfs_create_dir(name, NULL);
167 	dev->dbgfs_dir = dir;
168 
169 	debugfs_create_file("meclients", S_IRUSR, dir, dev,
170 			    &mei_dbgfs_meclients_fops);
171 	debugfs_create_file("active", S_IRUSR, dir, dev,
172 			    &mei_dbgfs_active_fops);
173 	debugfs_create_file("devstate", S_IRUSR, dir, dev,
174 			    &mei_dbgfs_devstate_fops);
175 	debugfs_create_file("allow_fixed_address", S_IRUSR | S_IWUSR, dir,
176 			    &dev->allow_fixed_address,
177 			    &mei_dbgfs_allow_fa_fops);
178 }
179