drivers/s390/scsi/zfcp_ccw.c

   1 /*
   2  * linux/drivers/s390/scsi/zfcp_ccw.c
   3  *
   4  * FCP adapter driver for IBM eServer zSeries
   5  *
   6  * CCW driver related routines
   7  *
   8  * (C) Copyright IBM Corp. 2003, 2004
   9  *
  10  * Authors:
  11  *      Martin Peschke <mpeschke@de.ibm.com>
  12  *      Heiko Carstens <heiko.carstens@de.ibm.com>
  13  *
  14  * This program is free software; you can redistribute it and/or modify
  15  * it under the terms of the GNU General Public License as published by
  16  * the Free Software Foundation; either version 2, or (at your option)
  17  * any later version.
  18  *
  19  * This program is distributed in the hope that it will be useful,
  20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22  * GNU General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License
  25  * along with this program; if not, write to the Free Software
  26  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  27  */
  28
  29 #define ZFCP_CCW_C_REVISION "$Revision: 1.55 $"
  30
  31 #include "zfcp_ext.h"
  32
  33 #define ZFCP_LOG_AREA                   ZFCP_LOG_AREA_CONFIG
  34
  35 static int zfcp_ccw_probe(struct ccw_device *);
  36 static void zfcp_ccw_remove(struct ccw_device *);
  37 static int zfcp_ccw_set_online(struct ccw_device *);
  38 static int zfcp_ccw_set_offline(struct ccw_device *);
  39 static int zfcp_ccw_notify(struct ccw_device *, int);
  40
  41 static struct ccw_device_id zfcp_ccw_device_id[] = {
  42         {CCW_DEVICE_DEVTYPE(ZFCP_CONTROL_UNIT_TYPE,
  43                             ZFCP_CONTROL_UNIT_MODEL,
  44                             ZFCP_DEVICE_TYPE,
  45                             ZFCP_DEVICE_MODEL)},
  46         {CCW_DEVICE_DEVTYPE(ZFCP_CONTROL_UNIT_TYPE,
  47                             ZFCP_CONTROL_UNIT_MODEL,
  48                             ZFCP_DEVICE_TYPE,
  49                             ZFCP_DEVICE_MODEL_PRIV)},
  50         {},
  51 };
  52
  53 static struct ccw_driver zfcp_ccw_driver = {
  54         .owner       = THIS_MODULE,
  55         .name        = ZFCP_NAME,
  56         .ids         = zfcp_ccw_device_id,
  57         .probe       = zfcp_ccw_probe,
  58         .remove      = zfcp_ccw_remove,
  59         .set_online  = zfcp_ccw_set_online,
  60         .set_offline = zfcp_ccw_set_offline,
  61         .notify      = zfcp_ccw_notify,
  62 };
  63
  64 MODULE_DEVICE_TABLE(ccw, zfcp_ccw_device_id);
  65
  66 /**
  67  * zfcp_ccw_probe - probe function of zfcp driver
  68  * @ccw_device: pointer to belonging ccw device
  69  *
  70  * This function gets called by the common i/o layer and sets up the initial
  71  * data structures for each fcp adapter, which was detected by the system.
  72  * Also the sysfs files for this adapter will be created by this function.
  73  * In addition the nameserver port will be added to the ports of the adapter
  74  * and its sysfs representation will be created too.
  75  */
  76 static int
  77 zfcp_ccw_probe(struct ccw_device *ccw_device)
  78 {
  79         struct zfcp_adapter *adapter;
  80         int retval = 0;
  81
  82         down(&zfcp_data.config_sema);
  83         adapter = zfcp_adapter_enqueue(ccw_device);
  84         if (!adapter)
  85                 retval = -EINVAL;
  86         else
  87                 ZFCP_LOG_DEBUG("Probed adapter %s\n",
  88                                zfcp_get_busid_by_adapter(adapter));
  89         up(&zfcp_data.config_sema);
  90         return retval;
  91 }
  92
  93 /**
  94  * zfcp_ccw_remove - remove function of zfcp driver
  95  * @ccw_device: pointer to belonging ccw device
  96  *
  97  * This function gets called by the common i/o layer and removes an adapter
  98  * from the system. Task of this function is to get rid of all units and
  99  * ports that belong to this adapter. And in addition all resources of this
 100  * adapter will be freed too.
 101  */
 102 static void
 103 zfcp_ccw_remove(struct ccw_device *ccw_device)
 104 {
 105         struct zfcp_adapter *adapter;
 106         struct zfcp_port *port, *p;
 107         struct zfcp_unit *unit, *u;
 108
 109         ccw_device_set_offline(ccw_device);
 110         down(&zfcp_data.config_sema);
 111         adapter = dev_get_drvdata(&ccw_device->dev);
 112
 113         ZFCP_LOG_DEBUG("Removing adapter %s\n",
 114                        zfcp_get_busid_by_adapter(adapter));
 115         write_lock_irq(&zfcp_data.config_lock);
 116         list_for_each_entry_safe(port, p, &adapter->port_list_head, list) {
 117                 list_for_each_entry_safe(unit, u, &port->unit_list_head, list) {
 118                         list_move(&unit->list, &port->unit_remove_lh);
 119                         atomic_set_mask(ZFCP_STATUS_COMMON_REMOVE,
 120                                         &unit->status);
 121                 }
 122                 list_move(&port->list, &adapter->port_remove_lh);
 123                 atomic_set_mask(ZFCP_STATUS_COMMON_REMOVE, &port->status);
 124         }
 125         atomic_set_mask(ZFCP_STATUS_COMMON_REMOVE, &adapter->status);
 126         write_unlock_irq(&zfcp_data.config_lock);
 127
 128         list_for_each_entry_safe(port, p, &adapter->port_remove_lh, list) {
 129                 list_for_each_entry_safe(unit, u, &port->unit_remove_lh, list) {
 130                         zfcp_unit_dequeue(unit);
 131                 }
 132                 zfcp_port_dequeue(port);
 133         }
 134         zfcp_adapter_wait(adapter);
 135         zfcp_adapter_dequeue(adapter);
 136
 137         up(&zfcp_data.config_sema);
 138 }
 139
 140 /**
 141  * zfcp_ccw_set_online - set_online function of zfcp driver
 142  * @ccw_device: pointer to belonging ccw device
 143  *
 144  * This function gets called by the common i/o layer and sets an adapter
 145  * into state online. Setting an fcp device online means that it will be
 146  * registered with the SCSI stack, that the QDIO queues will be set up
 147  * and that the adapter will be opened (asynchronously).
 148  */
 149 static int
 150 zfcp_ccw_set_online(struct ccw_device *ccw_device)
 151 {
 152         struct zfcp_adapter *adapter;
 153         int retval;
 154
 155         down(&zfcp_data.config_sema);
 156         adapter = dev_get_drvdata(&ccw_device->dev);
 157
 158         retval = zfcp_adapter_debug_register(adapter);
 159         if (retval)
 160                 goto out;
 161         retval = zfcp_erp_thread_setup(adapter);
 162         if (retval) {
 163                 ZFCP_LOG_INFO("error: start of error recovery thread for "
 164                               "adapter %s failed\n",
 165                               zfcp_get_busid_by_adapter(adapter));
 166                 goto out_erp_thread;
 167         }
 168
 169         retval = zfcp_adapter_scsi_register(adapter);
 170         if (retval)
 171                 goto out_scsi_register;
 172         zfcp_erp_modify_adapter_status(adapter, ZFCP_STATUS_COMMON_RUNNING,
 173                                        ZFCP_SET);
 174         zfcp_erp_adapter_reopen(adapter, ZFCP_STATUS_COMMON_ERP_FAILED);
 175         zfcp_erp_wait(adapter);
 176         goto out;
 177
 178  out_scsi_register:
 179         zfcp_erp_thread_kill(adapter);
 180  out_erp_thread:
 181         zfcp_adapter_debug_unregister(adapter);
 182  out:
 183         up(&zfcp_data.config_sema);
 184         return retval;
 185 }
 186
 187 /**
 188  * zfcp_ccw_set_offline - set_offline function of zfcp driver
 189  * @ccw_device: pointer to belonging ccw device
 190  *
 191  * This function gets called by the common i/o layer and sets an adapter
 192  * into state offline. Setting an fcp device offline means that it will be
 193  * unregistered from the SCSI stack and that the adapter will be shut down
 194  * asynchronously.
 195  */
 196 static int
 197 zfcp_ccw_set_offline(struct ccw_device *ccw_device)
 198 {
 199         struct zfcp_adapter *adapter;
 200
 201         down(&zfcp_data.config_sema);
 202         adapter = dev_get_drvdata(&ccw_device->dev);
 203         zfcp_erp_adapter_shutdown(adapter, 0);
 204         zfcp_erp_wait(adapter);
 205         zfcp_adapter_scsi_unregister(adapter);
 206         zfcp_erp_thread_kill(adapter);
 207         zfcp_adapter_debug_unregister(adapter);
 208         up(&zfcp_data.config_sema);
 209         return 0;
 210 }
 211
 212 /**
 213  * zfcp_ccw_notify
 214  * @ccw_device: pointer to belonging ccw device
 215  * @event: indicates if adapter was detached or attached
 216  *
 217  * This function gets called by the common i/o layer if an adapter has gone
 218  * or reappeared.
 219  */
 220 static int
 221 zfcp_ccw_notify(struct ccw_device *ccw_device, int event)
 222 {
 223         struct zfcp_adapter *adapter;
 224
 225         down(&zfcp_data.config_sema);
 226         adapter = dev_get_drvdata(&ccw_device->dev);
 227         switch (event) {
 228         case CIO_GONE:
 229                 ZFCP_LOG_NORMAL("adapter %s: device gone\n",
 230                                 zfcp_get_busid_by_adapter(adapter));
 231                 debug_text_event(adapter->erp_dbf,1,"dev_gone");
 232                 zfcp_erp_adapter_shutdown(adapter, 0);
 233                 break;
 234         case CIO_NO_PATH:
 235                 ZFCP_LOG_NORMAL("adapter %s: no path\n",
 236                                 zfcp_get_busid_by_adapter(adapter));
 237                 debug_text_event(adapter->erp_dbf,1,"no_path");
 238                 zfcp_erp_adapter_shutdown(adapter, 0);
 239                 break;
 240         case CIO_OPER:
 241                 ZFCP_LOG_NORMAL("adapter %s: operational again\n",
 242                                 zfcp_get_busid_by_adapter(adapter));
 243                 debug_text_event(adapter->erp_dbf,1,"dev_oper");
 244                 zfcp_erp_modify_adapter_status(adapter,
 245                                                ZFCP_STATUS_COMMON_RUNNING,
 246                                                ZFCP_SET);
 247                 zfcp_erp_adapter_reopen(adapter,
 248                                         ZFCP_STATUS_COMMON_ERP_FAILED);
 249                 break;
 250         }
 251         zfcp_erp_wait(adapter);
 252         up(&zfcp_data.config_sema);
 253         return 1;
 254 }
 255
 256 /**
 257  * zfcp_ccw_register - ccw register function
 258  *
 259  * Registers the driver at the common i/o layer. This function will be called
 260  * at module load time/system start.
 261  */
 262 int __init
 263 zfcp_ccw_register(void)
 264 {
 265         int retval;
 266
 267         retval = ccw_driver_register(&zfcp_ccw_driver);
 268         if (retval)
 269                 goto out;
 270         retval = zfcp_sysfs_driver_create_files(&zfcp_ccw_driver.driver);
 271         if (retval)
 272                 ccw_driver_unregister(&zfcp_ccw_driver);
 273  out:
 274         return retval;
 275 }
 276
 277 /**
 278  * zfcp_ccw_unregister - ccw unregister function
 279  *
 280  * Unregisters the driver from common i/o layer. Function will be called at
 281  * module unload/system shutdown.
 282  */
 283 void __exit
 284 zfcp_ccw_unregister(void)
 285 {
 286         zfcp_sysfs_driver_remove_files(&zfcp_ccw_driver.driver);
 287         ccw_driver_unregister(&zfcp_ccw_driver);
 288 }
 289
 290 #undef ZFCP_LOG_AREA