1 /* 2 * drivers/s390/cio/device_ops.c 3 * 4 * Copyright (C) 2002 IBM Deutschland Entwicklung GmbH, 5 * IBM Corporation 6 * Author(s): Martin Schwidefsky (schwidefsky@de.ibm.com) 7 * Cornelia Huck (cornelia.huck@de.ibm.com) 8 */ 9 #include <linux/module.h> 10 #include <linux/init.h> 11 #include <linux/errno.h> 12 #include <linux/slab.h> 13 #include <linux/list.h> 14 #include <linux/device.h> 15 #include <linux/delay.h> 16 17 #include <asm/ccwdev.h> 18 #include <asm/idals.h> 19 #include <asm/chpid.h> 20 #include <asm/fcx.h> 21 22 #include "cio.h" 23 #include "cio_debug.h" 24 #include "css.h" 25 #include "chsc.h" 26 #include "device.h" 27 #include "chp.h" 28 29 /** 30 * ccw_device_set_options_mask() - set some options and unset the rest 31 * @cdev: device for which the options are to be set 32 * @flags: options to be set 33 * 34 * All flags specified in @flags are set, all flags not specified in @flags 35 * are cleared. 36 * Returns: 37 * %0 on success, -%EINVAL on an invalid flag combination. 38 */ 39 int ccw_device_set_options_mask(struct ccw_device *cdev, unsigned long flags) 40 { 41 /* 42 * The flag usage is mutal exclusive ... 43 */ 44 if ((flags & CCWDEV_EARLY_NOTIFICATION) && 45 (flags & CCWDEV_REPORT_ALL)) 46 return -EINVAL; 47 cdev->private->options.fast = (flags & CCWDEV_EARLY_NOTIFICATION) != 0; 48 cdev->private->options.repall = (flags & CCWDEV_REPORT_ALL) != 0; 49 cdev->private->options.pgroup = (flags & CCWDEV_DO_PATHGROUP) != 0; 50 cdev->private->options.force = (flags & CCWDEV_ALLOW_FORCE) != 0; 51 return 0; 52 } 53 54 /** 55 * ccw_device_set_options() - set some options 56 * @cdev: device for which the options are to be set 57 * @flags: options to be set 58 * 59 * All flags specified in @flags are set, the remainder is left untouched. 60 * Returns: 61 * %0 on success, -%EINVAL if an invalid flag combination would ensue. 62 */ 63 int ccw_device_set_options(struct ccw_device *cdev, unsigned long flags) 64 { 65 /* 66 * The flag usage is mutal exclusive ... 67 */ 68 if (((flags & CCWDEV_EARLY_NOTIFICATION) && 69 (flags & CCWDEV_REPORT_ALL)) || 70 ((flags & CCWDEV_EARLY_NOTIFICATION) && 71 cdev->private->options.repall) || 72 ((flags & CCWDEV_REPORT_ALL) && 73 cdev->private->options.fast)) 74 return -EINVAL; 75 cdev->private->options.fast |= (flags & CCWDEV_EARLY_NOTIFICATION) != 0; 76 cdev->private->options.repall |= (flags & CCWDEV_REPORT_ALL) != 0; 77 cdev->private->options.pgroup |= (flags & CCWDEV_DO_PATHGROUP) != 0; 78 cdev->private->options.force |= (flags & CCWDEV_ALLOW_FORCE) != 0; 79 return 0; 80 } 81 82 /** 83 * ccw_device_clear_options() - clear some options 84 * @cdev: device for which the options are to be cleared 85 * @flags: options to be cleared 86 * 87 * All flags specified in @flags are cleared, the remainder is left untouched. 88 */ 89 void ccw_device_clear_options(struct ccw_device *cdev, unsigned long flags) 90 { 91 cdev->private->options.fast &= (flags & CCWDEV_EARLY_NOTIFICATION) == 0; 92 cdev->private->options.repall &= (flags & CCWDEV_REPORT_ALL) == 0; 93 cdev->private->options.pgroup &= (flags & CCWDEV_DO_PATHGROUP) == 0; 94 cdev->private->options.force &= (flags & CCWDEV_ALLOW_FORCE) == 0; 95 } 96 97 /** 98 * ccw_device_clear() - terminate I/O request processing 99 * @cdev: target ccw device 100 * @intparm: interruption parameter; value is only used if no I/O is 101 * outstanding, otherwise the intparm associated with the I/O request 102 * is returned 103 * 104 * ccw_device_clear() calls csch on @cdev's subchannel. 105 * Returns: 106 * %0 on success, 107 * -%ENODEV on device not operational, 108 * -%EINVAL on invalid device state. 109 * Context: 110 * Interrupts disabled, ccw device lock held 111 */ 112 int ccw_device_clear(struct ccw_device *cdev, unsigned long intparm) 113 { 114 struct subchannel *sch; 115 int ret; 116 117 if (!cdev) 118 return -ENODEV; 119 if (cdev->private->state == DEV_STATE_NOT_OPER) 120 return -ENODEV; 121 if (cdev->private->state != DEV_STATE_ONLINE && 122 cdev->private->state != DEV_STATE_W4SENSE) 123 return -EINVAL; 124 sch = to_subchannel(cdev->dev.parent); 125 if (!sch) 126 return -ENODEV; 127 ret = cio_clear(sch); 128 if (ret == 0) 129 cdev->private->intparm = intparm; 130 return ret; 131 } 132 133 /** 134 * ccw_device_start_key() - start a s390 channel program with key 135 * @cdev: target ccw device 136 * @cpa: logical start address of channel program 137 * @intparm: user specific interruption parameter; will be presented back to 138 * @cdev's interrupt handler. Allows a device driver to associate 139 * the interrupt with a particular I/O request. 140 * @lpm: defines the channel path to be used for a specific I/O request. A 141 * value of 0 will make cio use the opm. 142 * @key: storage key to be used for the I/O 143 * @flags: additional flags; defines the action to be performed for I/O 144 * processing. 145 * 146 * Start a S/390 channel program. When the interrupt arrives, the 147 * IRQ handler is called, either immediately, delayed (dev-end missing, 148 * or sense required) or never (no IRQ handler registered). 149 * Returns: 150 * %0, if the operation was successful; 151 * -%EBUSY, if the device is busy, or status pending; 152 * -%EACCES, if no path specified in @lpm is operational; 153 * -%ENODEV, if the device is not operational. 154 * Context: 155 * Interrupts disabled, ccw device lock held 156 */ 157 int ccw_device_start_key(struct ccw_device *cdev, struct ccw1 *cpa, 158 unsigned long intparm, __u8 lpm, __u8 key, 159 unsigned long flags) 160 { 161 struct subchannel *sch; 162 int ret; 163 164 if (!cdev) 165 return -ENODEV; 166 sch = to_subchannel(cdev->dev.parent); 167 if (!sch) 168 return -ENODEV; 169 if (cdev->private->state == DEV_STATE_NOT_OPER) 170 return -ENODEV; 171 if (cdev->private->state == DEV_STATE_VERIFY || 172 cdev->private->state == DEV_STATE_CLEAR_VERIFY) { 173 /* Remember to fake irb when finished. */ 174 if (!cdev->private->flags.fake_irb) { 175 cdev->private->flags.fake_irb = 1; 176 cdev->private->intparm = intparm; 177 return 0; 178 } else 179 /* There's already a fake I/O around. */ 180 return -EBUSY; 181 } 182 if (cdev->private->state != DEV_STATE_ONLINE || 183 ((sch->schib.scsw.cmd.stctl & SCSW_STCTL_PRIM_STATUS) && 184 !(sch->schib.scsw.cmd.stctl & SCSW_STCTL_SEC_STATUS)) || 185 cdev->private->flags.doverify) 186 return -EBUSY; 187 ret = cio_set_options (sch, flags); 188 if (ret) 189 return ret; 190 /* Adjust requested path mask to excluded varied off paths. */ 191 if (lpm) { 192 lpm &= sch->opm; 193 if (lpm == 0) 194 return -EACCES; 195 } 196 ret = cio_start_key (sch, cpa, lpm, key); 197 switch (ret) { 198 case 0: 199 cdev->private->intparm = intparm; 200 break; 201 case -EACCES: 202 case -ENODEV: 203 dev_fsm_event(cdev, DEV_EVENT_VERIFY); 204 break; 205 } 206 return ret; 207 } 208 209 /** 210 * ccw_device_start_timeout_key() - start a s390 channel program with timeout and key 211 * @cdev: target ccw device 212 * @cpa: logical start address of channel program 213 * @intparm: user specific interruption parameter; will be presented back to 214 * @cdev's interrupt handler. Allows a device driver to associate 215 * the interrupt with a particular I/O request. 216 * @lpm: defines the channel path to be used for a specific I/O request. A 217 * value of 0 will make cio use the opm. 218 * @key: storage key to be used for the I/O 219 * @flags: additional flags; defines the action to be performed for I/O 220 * processing. 221 * @expires: timeout value in jiffies 222 * 223 * Start a S/390 channel program. When the interrupt arrives, the 224 * IRQ handler is called, either immediately, delayed (dev-end missing, 225 * or sense required) or never (no IRQ handler registered). 226 * This function notifies the device driver if the channel program has not 227 * completed during the time specified by @expires. If a timeout occurs, the 228 * channel program is terminated via xsch, hsch or csch, and the device's 229 * interrupt handler will be called with an irb containing ERR_PTR(-%ETIMEDOUT). 230 * Returns: 231 * %0, if the operation was successful; 232 * -%EBUSY, if the device is busy, or status pending; 233 * -%EACCES, if no path specified in @lpm is operational; 234 * -%ENODEV, if the device is not operational. 235 * Context: 236 * Interrupts disabled, ccw device lock held 237 */ 238 int ccw_device_start_timeout_key(struct ccw_device *cdev, struct ccw1 *cpa, 239 unsigned long intparm, __u8 lpm, __u8 key, 240 unsigned long flags, int expires) 241 { 242 int ret; 243 244 if (!cdev) 245 return -ENODEV; 246 ccw_device_set_timeout(cdev, expires); 247 ret = ccw_device_start_key(cdev, cpa, intparm, lpm, key, flags); 248 if (ret != 0) 249 ccw_device_set_timeout(cdev, 0); 250 return ret; 251 } 252 253 /** 254 * ccw_device_start() - start a s390 channel program 255 * @cdev: target ccw device 256 * @cpa: logical start address of channel program 257 * @intparm: user specific interruption parameter; will be presented back to 258 * @cdev's interrupt handler. Allows a device driver to associate 259 * the interrupt with a particular I/O request. 260 * @lpm: defines the channel path to be used for a specific I/O request. A 261 * value of 0 will make cio use the opm. 262 * @flags: additional flags; defines the action to be performed for I/O 263 * processing. 264 * 265 * Start a S/390 channel program. When the interrupt arrives, the 266 * IRQ handler is called, either immediately, delayed (dev-end missing, 267 * or sense required) or never (no IRQ handler registered). 268 * Returns: 269 * %0, if the operation was successful; 270 * -%EBUSY, if the device is busy, or status pending; 271 * -%EACCES, if no path specified in @lpm is operational; 272 * -%ENODEV, if the device is not operational. 273 * Context: 274 * Interrupts disabled, ccw device lock held 275 */ 276 int ccw_device_start(struct ccw_device *cdev, struct ccw1 *cpa, 277 unsigned long intparm, __u8 lpm, unsigned long flags) 278 { 279 return ccw_device_start_key(cdev, cpa, intparm, lpm, 280 PAGE_DEFAULT_KEY, flags); 281 } 282 283 /** 284 * ccw_device_start_timeout() - start a s390 channel program with timeout 285 * @cdev: target ccw device 286 * @cpa: logical start address of channel program 287 * @intparm: user specific interruption parameter; will be presented back to 288 * @cdev's interrupt handler. Allows a device driver to associate 289 * the interrupt with a particular I/O request. 290 * @lpm: defines the channel path to be used for a specific I/O request. A 291 * value of 0 will make cio use the opm. 292 * @flags: additional flags; defines the action to be performed for I/O 293 * processing. 294 * @expires: timeout value in jiffies 295 * 296 * Start a S/390 channel program. When the interrupt arrives, the 297 * IRQ handler is called, either immediately, delayed (dev-end missing, 298 * or sense required) or never (no IRQ handler registered). 299 * This function notifies the device driver if the channel program has not 300 * completed during the time specified by @expires. If a timeout occurs, the 301 * channel program is terminated via xsch, hsch or csch, and the device's 302 * interrupt handler will be called with an irb containing ERR_PTR(-%ETIMEDOUT). 303 * Returns: 304 * %0, if the operation was successful; 305 * -%EBUSY, if the device is busy, or status pending; 306 * -%EACCES, if no path specified in @lpm is operational; 307 * -%ENODEV, if the device is not operational. 308 * Context: 309 * Interrupts disabled, ccw device lock held 310 */ 311 int ccw_device_start_timeout(struct ccw_device *cdev, struct ccw1 *cpa, 312 unsigned long intparm, __u8 lpm, 313 unsigned long flags, int expires) 314 { 315 return ccw_device_start_timeout_key(cdev, cpa, intparm, lpm, 316 PAGE_DEFAULT_KEY, flags, 317 expires); 318 } 319 320 321 /** 322 * ccw_device_halt() - halt I/O request processing 323 * @cdev: target ccw device 324 * @intparm: interruption parameter; value is only used if no I/O is 325 * outstanding, otherwise the intparm associated with the I/O request 326 * is returned 327 * 328 * ccw_device_halt() calls hsch on @cdev's subchannel. 329 * Returns: 330 * %0 on success, 331 * -%ENODEV on device not operational, 332 * -%EINVAL on invalid device state, 333 * -%EBUSY on device busy or interrupt pending. 334 * Context: 335 * Interrupts disabled, ccw device lock held 336 */ 337 int ccw_device_halt(struct ccw_device *cdev, unsigned long intparm) 338 { 339 struct subchannel *sch; 340 int ret; 341 342 if (!cdev) 343 return -ENODEV; 344 if (cdev->private->state == DEV_STATE_NOT_OPER) 345 return -ENODEV; 346 if (cdev->private->state != DEV_STATE_ONLINE && 347 cdev->private->state != DEV_STATE_W4SENSE) 348 return -EINVAL; 349 sch = to_subchannel(cdev->dev.parent); 350 if (!sch) 351 return -ENODEV; 352 ret = cio_halt(sch); 353 if (ret == 0) 354 cdev->private->intparm = intparm; 355 return ret; 356 } 357 358 /** 359 * ccw_device_resume() - resume channel program execution 360 * @cdev: target ccw device 361 * 362 * ccw_device_resume() calls rsch on @cdev's subchannel. 363 * Returns: 364 * %0 on success, 365 * -%ENODEV on device not operational, 366 * -%EINVAL on invalid device state, 367 * -%EBUSY on device busy or interrupt pending. 368 * Context: 369 * Interrupts disabled, ccw device lock held 370 */ 371 int ccw_device_resume(struct ccw_device *cdev) 372 { 373 struct subchannel *sch; 374 375 if (!cdev) 376 return -ENODEV; 377 sch = to_subchannel(cdev->dev.parent); 378 if (!sch) 379 return -ENODEV; 380 if (cdev->private->state == DEV_STATE_NOT_OPER) 381 return -ENODEV; 382 if (cdev->private->state != DEV_STATE_ONLINE || 383 !(sch->schib.scsw.cmd.actl & SCSW_ACTL_SUSPENDED)) 384 return -EINVAL; 385 return cio_resume(sch); 386 } 387 388 /* 389 * Pass interrupt to device driver. 390 */ 391 int 392 ccw_device_call_handler(struct ccw_device *cdev) 393 { 394 struct subchannel *sch; 395 unsigned int stctl; 396 int ending_status; 397 398 sch = to_subchannel(cdev->dev.parent); 399 400 /* 401 * we allow for the device action handler if . 402 * - we received ending status 403 * - the action handler requested to see all interrupts 404 * - we received an intermediate status 405 * - fast notification was requested (primary status) 406 * - unsolicited interrupts 407 */ 408 stctl = scsw_stctl(&cdev->private->irb.scsw); 409 ending_status = (stctl & SCSW_STCTL_SEC_STATUS) || 410 (stctl == (SCSW_STCTL_ALERT_STATUS | SCSW_STCTL_STATUS_PEND)) || 411 (stctl == SCSW_STCTL_STATUS_PEND); 412 if (!ending_status && 413 !cdev->private->options.repall && 414 !(stctl & SCSW_STCTL_INTER_STATUS) && 415 !(cdev->private->options.fast && 416 (stctl & SCSW_STCTL_PRIM_STATUS))) 417 return 0; 418 419 /* Clear pending timers for device driver initiated I/O. */ 420 if (ending_status) 421 ccw_device_set_timeout(cdev, 0); 422 /* 423 * Now we are ready to call the device driver interrupt handler. 424 */ 425 if (cdev->handler) 426 cdev->handler(cdev, cdev->private->intparm, 427 &cdev->private->irb); 428 429 /* 430 * Clear the old and now useless interrupt response block. 431 */ 432 memset(&cdev->private->irb, 0, sizeof(struct irb)); 433 434 return 1; 435 } 436 437 /** 438 * ccw_device_get_ciw() - Search for CIW command in extended sense data. 439 * @cdev: ccw device to inspect 440 * @ct: command type to look for 441 * 442 * During SenseID, command information words (CIWs) describing special 443 * commands available to the device may have been stored in the extended 444 * sense data. This function searches for CIWs of a specified command 445 * type in the extended sense data. 446 * Returns: 447 * %NULL if no extended sense data has been stored or if no CIW of the 448 * specified command type could be found, 449 * else a pointer to the CIW of the specified command type. 450 */ 451 struct ciw *ccw_device_get_ciw(struct ccw_device *cdev, __u32 ct) 452 { 453 int ciw_cnt; 454 455 if (cdev->private->flags.esid == 0) 456 return NULL; 457 for (ciw_cnt = 0; ciw_cnt < MAX_CIWS; ciw_cnt++) 458 if (cdev->private->senseid.ciw[ciw_cnt].ct == ct) 459 return cdev->private->senseid.ciw + ciw_cnt; 460 return NULL; 461 } 462 463 /** 464 * ccw_device_get_path_mask() - get currently available paths 465 * @cdev: ccw device to be queried 466 * Returns: 467 * %0 if no subchannel for the device is available, 468 * else the mask of currently available paths for the ccw device's subchannel. 469 */ 470 __u8 ccw_device_get_path_mask(struct ccw_device *cdev) 471 { 472 struct subchannel *sch; 473 474 sch = to_subchannel(cdev->dev.parent); 475 if (!sch) 476 return 0; 477 else 478 return sch->lpm; 479 } 480 481 /* 482 * Try to break the lock on a boxed device. 483 */ 484 int 485 ccw_device_stlck(struct ccw_device *cdev) 486 { 487 void *buf, *buf2; 488 unsigned long flags; 489 struct subchannel *sch; 490 int ret; 491 492 if (!cdev) 493 return -ENODEV; 494 495 if (cdev->drv && !cdev->private->options.force) 496 return -EINVAL; 497 498 sch = to_subchannel(cdev->dev.parent); 499 500 CIO_TRACE_EVENT(2, "stl lock"); 501 CIO_TRACE_EVENT(2, dev_name(&cdev->dev)); 502 503 buf = kmalloc(32*sizeof(char), GFP_DMA|GFP_KERNEL); 504 if (!buf) 505 return -ENOMEM; 506 buf2 = kmalloc(32*sizeof(char), GFP_DMA|GFP_KERNEL); 507 if (!buf2) { 508 kfree(buf); 509 return -ENOMEM; 510 } 511 spin_lock_irqsave(sch->lock, flags); 512 ret = cio_enable_subchannel(sch, (u32)(addr_t)sch); 513 if (ret) 514 goto out_unlock; 515 /* 516 * Setup ccw. We chain an unconditional reserve and a release so we 517 * only break the lock. 518 */ 519 cdev->private->iccws[0].cmd_code = CCW_CMD_STLCK; 520 cdev->private->iccws[0].cda = (__u32) __pa(buf); 521 cdev->private->iccws[0].count = 32; 522 cdev->private->iccws[0].flags = CCW_FLAG_CC; 523 cdev->private->iccws[1].cmd_code = CCW_CMD_RELEASE; 524 cdev->private->iccws[1].cda = (__u32) __pa(buf2); 525 cdev->private->iccws[1].count = 32; 526 cdev->private->iccws[1].flags = 0; 527 ret = cio_start(sch, cdev->private->iccws, 0); 528 if (ret) { 529 cio_disable_subchannel(sch); //FIXME: return code? 530 goto out_unlock; 531 } 532 cdev->private->irb.scsw.cmd.actl |= SCSW_ACTL_START_PEND; 533 spin_unlock_irqrestore(sch->lock, flags); 534 wait_event(cdev->private->wait_q, 535 cdev->private->irb.scsw.cmd.actl == 0); 536 spin_lock_irqsave(sch->lock, flags); 537 cio_disable_subchannel(sch); //FIXME: return code? 538 if ((cdev->private->irb.scsw.cmd.dstat != 539 (DEV_STAT_CHN_END|DEV_STAT_DEV_END)) || 540 (cdev->private->irb.scsw.cmd.cstat != 0)) 541 ret = -EIO; 542 /* Clear irb. */ 543 memset(&cdev->private->irb, 0, sizeof(struct irb)); 544 out_unlock: 545 kfree(buf); 546 kfree(buf2); 547 spin_unlock_irqrestore(sch->lock, flags); 548 return ret; 549 } 550 551 void *ccw_device_get_chp_desc(struct ccw_device *cdev, int chp_no) 552 { 553 struct subchannel *sch; 554 struct chp_id chpid; 555 556 sch = to_subchannel(cdev->dev.parent); 557 chp_id_init(&chpid); 558 chpid.id = sch->schib.pmcw.chpid[chp_no]; 559 return chp_get_chp_desc(chpid); 560 } 561 562 /** 563 * ccw_device_get_id - obtain a ccw device id 564 * @cdev: device to obtain the id for 565 * @dev_id: where to fill in the values 566 */ 567 void ccw_device_get_id(struct ccw_device *cdev, struct ccw_dev_id *dev_id) 568 { 569 *dev_id = cdev->private->dev_id; 570 } 571 EXPORT_SYMBOL(ccw_device_get_id); 572 573 /** 574 * ccw_device_tm_start_key - perform start function 575 * @cdev: ccw device on which to perform the start function 576 * @tcw: transport-command word to be started 577 * @intparm: user defined parameter to be passed to the interrupt handler 578 * @lpm: mask of paths to use 579 * @key: storage key to use for storage access 580 * 581 * Start the tcw on the given ccw device. Return zero on success, non-zero 582 * otherwise. 583 */ 584 int ccw_device_tm_start_key(struct ccw_device *cdev, struct tcw *tcw, 585 unsigned long intparm, u8 lpm, u8 key) 586 { 587 struct subchannel *sch; 588 int rc; 589 590 sch = to_subchannel(cdev->dev.parent); 591 if (cdev->private->state != DEV_STATE_ONLINE) 592 return -EIO; 593 /* Adjust requested path mask to excluded varied off paths. */ 594 if (lpm) { 595 lpm &= sch->opm; 596 if (lpm == 0) 597 return -EACCES; 598 } 599 rc = cio_tm_start_key(sch, tcw, lpm, key); 600 if (rc == 0) 601 cdev->private->intparm = intparm; 602 return rc; 603 } 604 EXPORT_SYMBOL(ccw_device_tm_start_key); 605 606 /** 607 * ccw_device_tm_start_timeout_key - perform start function 608 * @cdev: ccw device on which to perform the start function 609 * @tcw: transport-command word to be started 610 * @intparm: user defined parameter to be passed to the interrupt handler 611 * @lpm: mask of paths to use 612 * @key: storage key to use for storage access 613 * @expires: time span in jiffies after which to abort request 614 * 615 * Start the tcw on the given ccw device. Return zero on success, non-zero 616 * otherwise. 617 */ 618 int ccw_device_tm_start_timeout_key(struct ccw_device *cdev, struct tcw *tcw, 619 unsigned long intparm, u8 lpm, u8 key, 620 int expires) 621 { 622 int ret; 623 624 ccw_device_set_timeout(cdev, expires); 625 ret = ccw_device_tm_start_key(cdev, tcw, intparm, lpm, key); 626 if (ret != 0) 627 ccw_device_set_timeout(cdev, 0); 628 return ret; 629 } 630 EXPORT_SYMBOL(ccw_device_tm_start_timeout_key); 631 632 /** 633 * ccw_device_tm_start - perform start function 634 * @cdev: ccw device on which to perform the start function 635 * @tcw: transport-command word to be started 636 * @intparm: user defined parameter to be passed to the interrupt handler 637 * @lpm: mask of paths to use 638 * 639 * Start the tcw on the given ccw device. Return zero on success, non-zero 640 * otherwise. 641 */ 642 int ccw_device_tm_start(struct ccw_device *cdev, struct tcw *tcw, 643 unsigned long intparm, u8 lpm) 644 { 645 return ccw_device_tm_start_key(cdev, tcw, intparm, lpm, 646 PAGE_DEFAULT_KEY); 647 } 648 EXPORT_SYMBOL(ccw_device_tm_start); 649 650 /** 651 * ccw_device_tm_start_timeout - perform start function 652 * @cdev: ccw device on which to perform the start function 653 * @tcw: transport-command word to be started 654 * @intparm: user defined parameter to be passed to the interrupt handler 655 * @lpm: mask of paths to use 656 * @expires: time span in jiffies after which to abort request 657 * 658 * Start the tcw on the given ccw device. Return zero on success, non-zero 659 * otherwise. 660 */ 661 int ccw_device_tm_start_timeout(struct ccw_device *cdev, struct tcw *tcw, 662 unsigned long intparm, u8 lpm, int expires) 663 { 664 return ccw_device_tm_start_timeout_key(cdev, tcw, intparm, lpm, 665 PAGE_DEFAULT_KEY, expires); 666 } 667 EXPORT_SYMBOL(ccw_device_tm_start_timeout); 668 669 /** 670 * ccw_device_tm_intrg - perform interrogate function 671 * @cdev: ccw device on which to perform the interrogate function 672 * 673 * Perform an interrogate function on the given ccw device. Return zero on 674 * success, non-zero otherwise. 675 */ 676 int ccw_device_tm_intrg(struct ccw_device *cdev) 677 { 678 struct subchannel *sch = to_subchannel(cdev->dev.parent); 679 680 if (cdev->private->state != DEV_STATE_ONLINE) 681 return -EIO; 682 if (!scsw_is_tm(&sch->schib.scsw) || 683 !(scsw_actl(&sch->schib.scsw) | SCSW_ACTL_START_PEND)) 684 return -EINVAL; 685 return cio_tm_intrg(sch); 686 } 687 EXPORT_SYMBOL(ccw_device_tm_intrg); 688 689 // FIXME: these have to go: 690 691 int 692 _ccw_device_get_subchannel_number(struct ccw_device *cdev) 693 { 694 return cdev->private->schid.sch_no; 695 } 696 697 698 MODULE_LICENSE("GPL"); 699 EXPORT_SYMBOL(ccw_device_set_options_mask); 700 EXPORT_SYMBOL(ccw_device_set_options); 701 EXPORT_SYMBOL(ccw_device_clear_options); 702 EXPORT_SYMBOL(ccw_device_clear); 703 EXPORT_SYMBOL(ccw_device_halt); 704 EXPORT_SYMBOL(ccw_device_resume); 705 EXPORT_SYMBOL(ccw_device_start_timeout); 706 EXPORT_SYMBOL(ccw_device_start); 707 EXPORT_SYMBOL(ccw_device_start_timeout_key); 708 EXPORT_SYMBOL(ccw_device_start_key); 709 EXPORT_SYMBOL(ccw_device_get_ciw); 710 EXPORT_SYMBOL(ccw_device_get_path_mask); 711 EXPORT_SYMBOL(_ccw_device_get_subchannel_number); 712 EXPORT_SYMBOL_GPL(ccw_device_get_chp_desc); 713