xref: /linux/drivers/scsi/scsi_proc.c (revision cd354f1ae75e6466a7e31b727faede57a1f89ca5)
1 /*
2  * linux/drivers/scsi/scsi_proc.c
3  *
4  * The functions in this file provide an interface between
5  * the PROC file system and the SCSI device drivers
6  * It is mainly used for debugging, statistics and to pass
7  * information directly to the lowlevel driver.
8  *
9  * (c) 1995 Michael Neuffer neuffer@goofy.zdv.uni-mainz.de
10  * Version: 0.99.8   last change: 95/09/13
11  *
12  * generic command parser provided by:
13  * Andreas Heilwagen <crashcar@informatik.uni-koblenz.de>
14  *
15  * generic_proc_info() support of xxxx_info() by:
16  * Michael A. Griffith <grif@acm.org>
17  */
18 
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/string.h>
22 #include <linux/mm.h>
23 #include <linux/slab.h>
24 #include <linux/proc_fs.h>
25 #include <linux/errno.h>
26 #include <linux/blkdev.h>
27 #include <linux/seq_file.h>
28 #include <linux/mutex.h>
29 #include <asm/uaccess.h>
30 
31 #include <scsi/scsi.h>
32 #include <scsi/scsi_device.h>
33 #include <scsi/scsi_host.h>
34 #include <scsi/scsi_transport.h>
35 
36 #include "scsi_priv.h"
37 #include "scsi_logging.h"
38 
39 
40 /* 4K page size, but our output routines, use some slack for overruns */
41 #define PROC_BLOCK_SIZE (3*1024)
42 
43 static struct proc_dir_entry *proc_scsi;
44 
45 /* Protect sht->present and sht->proc_dir */
46 static DEFINE_MUTEX(global_host_template_mutex);
47 
48 static int proc_scsi_read(char *buffer, char **start, off_t offset,
49 			  int length, int *eof, void *data)
50 {
51 	struct Scsi_Host *shost = data;
52 	int n;
53 
54 	n = shost->hostt->proc_info(shost, buffer, start, offset, length, 0);
55 	*eof = (n < length);
56 
57 	return n;
58 }
59 
60 static int proc_scsi_write_proc(struct file *file, const char __user *buf,
61                            unsigned long count, void *data)
62 {
63 	struct Scsi_Host *shost = data;
64 	ssize_t ret = -ENOMEM;
65 	char *page;
66 	char *start;
67 
68 	if (count > PROC_BLOCK_SIZE)
69 		return -EOVERFLOW;
70 
71 	page = (char *)__get_free_page(GFP_KERNEL);
72 	if (page) {
73 		ret = -EFAULT;
74 		if (copy_from_user(page, buf, count))
75 			goto out;
76 		ret = shost->hostt->proc_info(shost, page, &start, 0, count, 1);
77 	}
78 out:
79 	free_page((unsigned long)page);
80 	return ret;
81 }
82 
83 void scsi_proc_hostdir_add(struct scsi_host_template *sht)
84 {
85 	if (!sht->proc_info)
86 		return;
87 
88 	mutex_lock(&global_host_template_mutex);
89 	if (!sht->present++) {
90 		sht->proc_dir = proc_mkdir(sht->proc_name, proc_scsi);
91         	if (!sht->proc_dir)
92 			printk(KERN_ERR "%s: proc_mkdir failed for %s\n",
93 			       __FUNCTION__, sht->proc_name);
94 		else
95 			sht->proc_dir->owner = sht->module;
96 	}
97 	mutex_unlock(&global_host_template_mutex);
98 }
99 
100 void scsi_proc_hostdir_rm(struct scsi_host_template *sht)
101 {
102 	if (!sht->proc_info)
103 		return;
104 
105 	mutex_lock(&global_host_template_mutex);
106 	if (!--sht->present && sht->proc_dir) {
107 		remove_proc_entry(sht->proc_name, proc_scsi);
108 		sht->proc_dir = NULL;
109 	}
110 	mutex_unlock(&global_host_template_mutex);
111 }
112 
113 void scsi_proc_host_add(struct Scsi_Host *shost)
114 {
115 	struct scsi_host_template *sht = shost->hostt;
116 	struct proc_dir_entry *p;
117 	char name[10];
118 
119 	if (!sht->proc_dir)
120 		return;
121 
122 	sprintf(name,"%d", shost->host_no);
123 	p = create_proc_read_entry(name, S_IFREG | S_IRUGO | S_IWUSR,
124 			sht->proc_dir, proc_scsi_read, shost);
125 	if (!p) {
126 		printk(KERN_ERR "%s: Failed to register host %d in"
127 		       "%s\n", __FUNCTION__, shost->host_no,
128 		       sht->proc_name);
129 		return;
130 	}
131 
132 	p->write_proc = proc_scsi_write_proc;
133 	p->owner = sht->module;
134 }
135 
136 void scsi_proc_host_rm(struct Scsi_Host *shost)
137 {
138 	char name[10];
139 
140 	if (!shost->hostt->proc_dir)
141 		return;
142 
143 	sprintf(name,"%d", shost->host_no);
144 	remove_proc_entry(name, shost->hostt->proc_dir);
145 }
146 
147 static int proc_print_scsidevice(struct device *dev, void *data)
148 {
149 	struct scsi_device *sdev = to_scsi_device(dev);
150 	struct seq_file *s = data;
151 	int i;
152 
153 	seq_printf(s,
154 		"Host: scsi%d Channel: %02d Id: %02d Lun: %02d\n  Vendor: ",
155 		sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
156 	for (i = 0; i < 8; i++) {
157 		if (sdev->vendor[i] >= 0x20)
158 			seq_printf(s, "%c", sdev->vendor[i]);
159 		else
160 			seq_printf(s, " ");
161 	}
162 
163 	seq_printf(s, " Model: ");
164 	for (i = 0; i < 16; i++) {
165 		if (sdev->model[i] >= 0x20)
166 			seq_printf(s, "%c", sdev->model[i]);
167 		else
168 			seq_printf(s, " ");
169 	}
170 
171 	seq_printf(s, " Rev: ");
172 	for (i = 0; i < 4; i++) {
173 		if (sdev->rev[i] >= 0x20)
174 			seq_printf(s, "%c", sdev->rev[i]);
175 		else
176 			seq_printf(s, " ");
177 	}
178 
179 	seq_printf(s, "\n");
180 
181 	seq_printf(s, "  Type:   %s ", scsi_device_type(sdev->type));
182 	seq_printf(s, "               ANSI"
183 		     " SCSI revision: %02x", (sdev->scsi_level - 1) ?
184 		     sdev->scsi_level - 1 : 1);
185 	if (sdev->scsi_level == 2)
186 		seq_printf(s, " CCS\n");
187 	else
188 		seq_printf(s, "\n");
189 
190 	return 0;
191 }
192 
193 static int scsi_add_single_device(uint host, uint channel, uint id, uint lun)
194 {
195 	struct Scsi_Host *shost;
196 	int error = -ENXIO;
197 
198 	shost = scsi_host_lookup(host);
199 	if (IS_ERR(shost))
200 		return PTR_ERR(shost);
201 
202 	if (shost->transportt->user_scan)
203 		error = shost->transportt->user_scan(shost, channel, id, lun);
204 	else
205 		error = scsi_scan_host_selected(shost, channel, id, lun, 1);
206 	scsi_host_put(shost);
207 	return error;
208 }
209 
210 static int scsi_remove_single_device(uint host, uint channel, uint id, uint lun)
211 {
212 	struct scsi_device *sdev;
213 	struct Scsi_Host *shost;
214 	int error = -ENXIO;
215 
216 	shost = scsi_host_lookup(host);
217 	if (IS_ERR(shost))
218 		return PTR_ERR(shost);
219 	sdev = scsi_device_lookup(shost, channel, id, lun);
220 	if (sdev) {
221 		scsi_remove_device(sdev);
222 		scsi_device_put(sdev);
223 		error = 0;
224 	}
225 
226 	scsi_host_put(shost);
227 	return error;
228 }
229 
230 static ssize_t proc_scsi_write(struct file *file, const char __user *buf,
231 			       size_t length, loff_t *ppos)
232 {
233 	int host, channel, id, lun;
234 	char *buffer, *p;
235 	int err;
236 
237 	if (!buf || length > PAGE_SIZE)
238 		return -EINVAL;
239 
240 	buffer = (char *)__get_free_page(GFP_KERNEL);
241 	if (!buffer)
242 		return -ENOMEM;
243 
244 	err = -EFAULT;
245 	if (copy_from_user(buffer, buf, length))
246 		goto out;
247 
248 	err = -EINVAL;
249 	if (length < PAGE_SIZE)
250 		buffer[length] = '\0';
251 	else if (buffer[PAGE_SIZE-1])
252 		goto out;
253 
254 	/*
255 	 * Usage: echo "scsi add-single-device 0 1 2 3" >/proc/scsi/scsi
256 	 * with  "0 1 2 3" replaced by your "Host Channel Id Lun".
257 	 */
258 	if (!strncmp("scsi add-single-device", buffer, 22)) {
259 		p = buffer + 23;
260 
261 		host = simple_strtoul(p, &p, 0);
262 		channel = simple_strtoul(p + 1, &p, 0);
263 		id = simple_strtoul(p + 1, &p, 0);
264 		lun = simple_strtoul(p + 1, &p, 0);
265 
266 		err = scsi_add_single_device(host, channel, id, lun);
267 
268 	/*
269 	 * Usage: echo "scsi remove-single-device 0 1 2 3" >/proc/scsi/scsi
270 	 * with  "0 1 2 3" replaced by your "Host Channel Id Lun".
271 	 */
272 	} else if (!strncmp("scsi remove-single-device", buffer, 25)) {
273 		p = buffer + 26;
274 
275 		host = simple_strtoul(p, &p, 0);
276 		channel = simple_strtoul(p + 1, &p, 0);
277 		id = simple_strtoul(p + 1, &p, 0);
278 		lun = simple_strtoul(p + 1, &p, 0);
279 
280 		err = scsi_remove_single_device(host, channel, id, lun);
281 	}
282 
283 	/*
284 	 * convert success returns so that we return the
285 	 * number of bytes consumed.
286 	 */
287 	if (!err)
288 		err = length;
289 
290  out:
291 	free_page((unsigned long)buffer);
292 	return err;
293 }
294 
295 static int proc_scsi_show(struct seq_file *s, void *p)
296 {
297 	seq_printf(s, "Attached devices:\n");
298 	bus_for_each_dev(&scsi_bus_type, NULL, s, proc_print_scsidevice);
299 	return 0;
300 }
301 
302 static int proc_scsi_open(struct inode *inode, struct file *file)
303 {
304 	/*
305 	 * We don't really needs this for the write case but it doesn't
306 	 * harm either.
307 	 */
308 	return single_open(file, proc_scsi_show, NULL);
309 }
310 
311 static const struct file_operations proc_scsi_operations = {
312 	.open		= proc_scsi_open,
313 	.read		= seq_read,
314 	.write		= proc_scsi_write,
315 	.llseek		= seq_lseek,
316 	.release	= single_release,
317 };
318 
319 int __init scsi_init_procfs(void)
320 {
321 	struct proc_dir_entry *pde;
322 
323 	proc_scsi = proc_mkdir("scsi", NULL);
324 	if (!proc_scsi)
325 		goto err1;
326 
327 	pde = create_proc_entry("scsi/scsi", 0, NULL);
328 	if (!pde)
329 		goto err2;
330 	pde->proc_fops = &proc_scsi_operations;
331 
332 	return 0;
333 
334 err2:
335 	remove_proc_entry("scsi", NULL);
336 err1:
337 	return -ENOMEM;
338 }
339 
340 void scsi_exit_procfs(void)
341 {
342 	remove_proc_entry("scsi/scsi", NULL);
343 	remove_proc_entry("scsi", NULL);
344 }
345