2 * osd_uld.c - OSD Upper Layer Driver
4 * A Linux driver module that registers as a SCSI ULD and probes
5 * for OSD type SCSI devices.
6 * It's main function is to export osd devices to in-kernel users like
7 * osdfs and pNFS-objects-LD. It also provides one ioctl for running
10 * Copyright (C) 2008 Panasas Inc. All rights reserved.
13 * Boaz Harrosh <bharrosh@panasas.com>
14 * Benny Halevy <bhalevy@panasas.com>
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License version 2
19 * Redistribution and use in source and binary forms, with or without
20 * modification, are permitted provided that the following conditions
23 * 1. Redistributions of source code must retain the above copyright
24 * notice, this list of conditions and the following disclaimer.
25 * 2. Redistributions in binary form must reproduce the above copyright
26 * notice, this list of conditions and the following disclaimer in the
27 * documentation and/or other materials provided with the distribution.
28 * 3. Neither the name of the Panasas company nor the names of its
29 * contributors may be used to endorse or promote products derived
30 * from this software without specific prior written permission.
32 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
33 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
34 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
35 * DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
36 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
37 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
38 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
39 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
40 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
41 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
42 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
45 #include <linux/namei.h>
46 #include <linux/cdev.h>
48 #include <linux/module.h>
49 #include <linux/device.h>
50 #include <linux/idr.h>
51 #include <linux/major.h>
52 #include <linux/file.h>
53 #include <linux/slab.h>
55 #include <scsi/scsi.h>
56 #include <scsi/scsi_driver.h>
57 #include <scsi/scsi_device.h>
58 #include <scsi/scsi_ioctl.h>
60 #include <scsi/osd_initiator.h>
61 #include <scsi/osd_sec.h>
63 #include "osd_debug.h"
66 # define TYPE_OSD 0x11
69 #ifndef SCSI_OSD_MAJOR
70 # define SCSI_OSD_MAJOR 260
72 #define SCSI_OSD_MAX_MINOR MINORMASK
74 static const char osd_name[] = "osd";
75 static const char *osd_version_string = "open-osd 0.2.1";
77 MODULE_AUTHOR("Boaz Harrosh <bharrosh@panasas.com>");
78 MODULE_DESCRIPTION("open-osd Upper-Layer-Driver osd.ko");
79 MODULE_LICENSE("GPL");
80 MODULE_ALIAS_CHARDEV_MAJOR(SCSI_OSD_MAJOR);
81 MODULE_ALIAS_SCSI_DEVICE(TYPE_OSD);
83 struct osd_uld_device {
85 struct device class_dev;
88 struct osd_dev_info odi;
92 struct osd_dev_handle {
95 struct osd_uld_device *oud;
98 static DEFINE_IDA(osd_minor_ida);
101 * scsi sysfs attribute operations
103 static ssize_t osdname_show(struct device *dev, struct device_attribute *attr,
106 struct osd_uld_device *ould = container_of(dev, struct osd_uld_device,
108 return sprintf(buf, "%s\n", ould->odi.osdname);
111 static ssize_t systemid_show(struct device *dev, struct device_attribute *attr,
114 struct osd_uld_device *ould = container_of(dev, struct osd_uld_device,
117 memcpy(buf, ould->odi.systemid, ould->odi.systemid_len);
118 return ould->odi.systemid_len;
121 static struct device_attribute osd_uld_attrs[] = {
122 __ATTR(osdname, S_IRUGO, osdname_show, NULL),
123 __ATTR(systemid, S_IRUGO, systemid_show, NULL),
127 static struct class osd_uld_class = {
128 .owner = THIS_MODULE,
130 .dev_attrs = osd_uld_attrs,
134 * Char Device operations
137 static int osd_uld_open(struct inode *inode, struct file *file)
139 struct osd_uld_device *oud = container_of(inode->i_cdev,
140 struct osd_uld_device, cdev);
142 get_device(&oud->class_dev);
143 /* cache osd_uld_device on file handle */
144 file->private_data = oud;
145 OSD_DEBUG("osd_uld_open %p\n", oud);
149 static int osd_uld_release(struct inode *inode, struct file *file)
151 struct osd_uld_device *oud = file->private_data;
153 OSD_DEBUG("osd_uld_release %p\n", file->private_data);
154 file->private_data = NULL;
155 put_device(&oud->class_dev);
159 /* FIXME: Only one vector for now */
160 unsigned g_test_ioctl;
161 do_test_fn *g_do_test;
163 int osduld_register_test(unsigned ioctl, do_test_fn *do_test)
168 g_test_ioctl = ioctl;
172 EXPORT_SYMBOL(osduld_register_test);
174 void osduld_unregister_test(unsigned ioctl)
176 if (ioctl == g_test_ioctl) {
181 EXPORT_SYMBOL(osduld_unregister_test);
183 static do_test_fn *_find_ioctl(unsigned cmd)
185 if (g_test_ioctl == cmd)
191 static long osd_uld_ioctl(struct file *file, unsigned int cmd,
194 struct osd_uld_device *oud = file->private_data;
198 do_test = _find_ioctl(cmd);
200 ret = do_test(&oud->od, cmd, arg);
202 OSD_ERR("Unknown ioctl %d: osd_uld_device=%p\n", cmd, oud);
208 static const struct file_operations osd_fops = {
209 .owner = THIS_MODULE,
210 .open = osd_uld_open,
211 .release = osd_uld_release,
212 .unlocked_ioctl = osd_uld_ioctl,
213 .llseek = noop_llseek,
216 struct osd_dev *osduld_path_lookup(const char *name)
218 struct osd_uld_device *oud;
219 struct osd_dev_handle *odh;
223 if (!name || !*name) {
224 OSD_ERR("Mount with !path || !*path\n");
225 return ERR_PTR(-EINVAL);
228 odh = kzalloc(sizeof(*odh), GFP_KERNEL);
230 return ERR_PTR(-ENOMEM);
232 file = filp_open(name, O_RDWR, 0);
234 error = PTR_ERR(file);
238 if (file->f_op != &osd_fops){
243 oud = file->private_data;
255 return ERR_PTR(error);
257 EXPORT_SYMBOL(osduld_path_lookup);
259 static inline bool _the_same_or_null(const u8 *a1, unsigned a1_len,
260 const u8 *a2, unsigned a2_len)
262 if (!a2_len) /* User string is Empty means don't care */
265 if (a1_len != a2_len)
268 return 0 == memcmp(a1, a2, a1_len);
272 const struct osd_dev_info *odi;
274 struct osd_uld_device *oud;
277 int _mach_odi(struct device *dev, void *find_data)
279 struct osd_uld_device *oud = container_of(dev, struct osd_uld_device,
281 struct find_oud_t *fot = find_data;
282 const struct osd_dev_info *odi = fot->odi;
284 if (_the_same_or_null(oud->odi.systemid, oud->odi.systemid_len,
285 odi->systemid, odi->systemid_len) &&
286 _the_same_or_null(oud->odi.osdname, oud->odi.osdname_len,
287 odi->osdname, odi->osdname_len)) {
288 OSD_DEBUG("found device sysid_len=%d osdname=%d\n",
289 odi->systemid_len, odi->osdname_len);
297 /* osduld_info_lookup - Loop through all devices, return the requested osd_dev.
299 * if @odi->systemid_len and/or @odi->osdname_len are zero, they act as a don't
300 * care. .e.g if they're both zero /dev/osd0 is returned.
302 struct osd_dev *osduld_info_lookup(const struct osd_dev_info *odi)
304 struct find_oud_t find = {.odi = odi};
306 find.dev = class_find_device(&osd_uld_class, NULL, &find, _mach_odi);
307 if (likely(find.dev)) {
308 struct osd_dev_handle *odh = kzalloc(sizeof(*odh), GFP_KERNEL);
310 if (unlikely(!odh)) {
311 put_device(find.dev);
312 return ERR_PTR(-ENOMEM);
315 odh->od = find.oud->od;
321 return ERR_PTR(-ENODEV);
323 EXPORT_SYMBOL(osduld_info_lookup);
325 void osduld_put_device(struct osd_dev *od)
327 if (od && !IS_ERR(od)) {
328 struct osd_dev_handle *odh =
329 container_of(od, struct osd_dev_handle, od);
330 struct osd_uld_device *oud = odh->oud;
332 BUG_ON(od->scsi_device != oud->od.scsi_device);
334 /* If scsi has released the device (logout), and exofs has last
335 * reference on oud it will be freed by above osd_uld_release
336 * within fput below. But this will oops in cdev_release which
337 * is called after the fops->release. A get_/put_ pair makes
338 * sure we have a cdev for the duration of fput
341 get_device(&oud->class_dev);
344 put_device(&oud->class_dev);
348 EXPORT_SYMBOL(osduld_put_device);
350 const struct osd_dev_info *osduld_device_info(struct osd_dev *od)
352 struct osd_dev_handle *odh =
353 container_of(od, struct osd_dev_handle, od);
354 return &odh->oud->odi;
356 EXPORT_SYMBOL(osduld_device_info);
358 bool osduld_device_same(struct osd_dev *od, const struct osd_dev_info *odi)
360 struct osd_dev_handle *odh =
361 container_of(od, struct osd_dev_handle, od);
362 struct osd_uld_device *oud = odh->oud;
364 return (oud->odi.systemid_len == odi->systemid_len) &&
365 _the_same_or_null(oud->odi.systemid, oud->odi.systemid_len,
366 odi->systemid, odi->systemid_len) &&
367 (oud->odi.osdname_len == odi->osdname_len) &&
368 _the_same_or_null(oud->odi.osdname, oud->odi.osdname_len,
369 odi->osdname, odi->osdname_len);
371 EXPORT_SYMBOL(osduld_device_same);
374 * Scsi Device operations
377 static int __detect_osd(struct osd_uld_device *oud)
379 struct scsi_device *scsi_device = oud->od.scsi_device;
380 char caps[OSD_CAP_LEN];
383 /* sending a test_unit_ready as first command seems to be needed
386 OSD_DEBUG("start scsi_test_unit_ready %p %p %p\n",
387 oud, scsi_device, scsi_device->request_queue);
388 error = scsi_test_unit_ready(scsi_device, 10*HZ, 5, NULL);
390 OSD_ERR("warning: scsi_test_unit_ready failed\n");
392 osd_sec_init_nosec_doall_caps(caps, &osd_root_object, false, true);
393 if (osd_auto_detect_ver(&oud->od, caps, &oud->odi))
399 static void __remove(struct device *dev)
401 struct osd_uld_device *oud = container_of(dev, struct osd_uld_device,
403 struct scsi_device *scsi_device = oud->od.scsi_device;
405 kfree(oud->odi.osdname);
408 cdev_del(&oud->cdev);
410 osd_dev_fini(&oud->od);
411 scsi_device_put(scsi_device);
413 OSD_INFO("osd_remove %s\n",
414 oud->disk ? oud->disk->disk_name : NULL);
418 ida_remove(&osd_minor_ida, oud->minor);
423 static int osd_probe(struct device *dev)
425 struct scsi_device *scsi_device = to_scsi_device(dev);
426 struct gendisk *disk;
427 struct osd_uld_device *oud;
431 if (scsi_device->type != TYPE_OSD)
435 if (!ida_pre_get(&osd_minor_ida, GFP_KERNEL))
438 error = ida_get_new(&osd_minor_ida, &minor);
439 } while (error == -EAGAIN);
443 if (minor >= SCSI_OSD_MAX_MINOR) {
445 goto err_retract_minor;
449 oud = kzalloc(sizeof(*oud), GFP_KERNEL);
451 goto err_retract_minor;
453 dev_set_drvdata(dev, oud);
456 /* allocate a disk and set it up */
457 /* FIXME: do we need this since sg has already done that */
458 disk = alloc_disk(1);
460 OSD_ERR("alloc_disk failed\n");
463 disk->major = SCSI_OSD_MAJOR;
464 disk->first_minor = oud->minor;
465 sprintf(disk->disk_name, "osd%d", oud->minor);
468 /* hold one more reference to the scsi_device that will get released
469 * in __release, in case a logout is happening while fs is mounted
471 scsi_device_get(scsi_device);
472 osd_dev_init(&oud->od, scsi_device);
474 /* Detect the OSD Version */
475 error = __detect_osd(oud);
477 OSD_ERR("osd detection failed, non-compatible OSD device\n");
481 /* init the char-device for communication with user-mode */
482 cdev_init(&oud->cdev, &osd_fops);
483 oud->cdev.owner = THIS_MODULE;
484 error = cdev_add(&oud->cdev,
485 MKDEV(SCSI_OSD_MAJOR, oud->minor), 1);
487 OSD_ERR("cdev_add failed\n");
491 /* class device member */
492 oud->class_dev.devt = oud->cdev.dev;
493 oud->class_dev.class = &osd_uld_class;
494 oud->class_dev.parent = dev;
495 oud->class_dev.release = __remove;
496 error = dev_set_name(&oud->class_dev, disk->disk_name);
498 OSD_ERR("dev_set_name failed => %d\n", error);
502 error = device_register(&oud->class_dev);
504 OSD_ERR("device_register failed => %d\n", error);
508 get_device(&oud->class_dev);
510 OSD_INFO("osd_probe %s\n", disk->disk_name);
514 cdev_del(&oud->cdev);
516 scsi_device_put(scsi_device);
519 dev_set_drvdata(dev, NULL);
522 ida_remove(&osd_minor_ida, minor);
526 static int osd_remove(struct device *dev)
528 struct scsi_device *scsi_device = to_scsi_device(dev);
529 struct osd_uld_device *oud = dev_get_drvdata(dev);
531 if (!oud || (oud->od.scsi_device != scsi_device)) {
532 OSD_ERR("Half cooked osd-device %p,%p || %p!=%p",
533 dev, oud, oud ? oud->od.scsi_device : NULL,
537 device_unregister(&oud->class_dev);
539 put_device(&oud->class_dev);
544 * Global driver and scsi registration
547 static struct scsi_driver osd_driver = {
548 .owner = THIS_MODULE,
552 .remove = osd_remove,
556 static int __init osd_uld_init(void)
560 err = class_register(&osd_uld_class);
562 OSD_ERR("Unable to register sysfs class => %d\n", err);
566 err = register_chrdev_region(MKDEV(SCSI_OSD_MAJOR, 0),
567 SCSI_OSD_MAX_MINOR, osd_name);
569 OSD_ERR("Unable to register major %d for osd ULD => %d\n",
570 SCSI_OSD_MAJOR, err);
574 err = scsi_register_driver(&osd_driver.gendrv);
576 OSD_ERR("scsi_register_driver failed => %d\n", err);
580 OSD_INFO("LOADED %s\n", osd_version_string);
584 unregister_chrdev_region(MKDEV(SCSI_OSD_MAJOR, 0), SCSI_OSD_MAX_MINOR);
586 class_unregister(&osd_uld_class);
590 static void __exit osd_uld_exit(void)
592 scsi_unregister_driver(&osd_driver.gendrv);
593 unregister_chrdev_region(MKDEV(SCSI_OSD_MAJOR, 0), SCSI_OSD_MAX_MINOR);
594 class_unregister(&osd_uld_class);
595 OSD_INFO("UNLOADED %s\n", osd_version_string);
598 module_init(osd_uld_init);
599 module_exit(osd_uld_exit);