1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>ccw devices</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Writing s390 channel device drivers"><link rel="up" href="ccw.html" title="Chapter 2. The ccw bus"><link rel="prev" href="API-ccw-dev-id-is-equal.html" title="ccw_dev_id_is_equal"><link rel="next" href="API-struct-ccw-device.html" title="struct ccw_device"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ccw devices</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ccw-dev-id-is-equal.html">Prev</a> </td><th width="60%" align="center">Chapter 2. The ccw bus</th><td width="20%" align="right"> <a accesskey="n" href="API-struct-ccw-device.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="ccwdev"></a>ccw devices</h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="refentrytitle"><a href="API-struct-ccw-device.html"><span class="phrase">struct ccw_device</span></a></span><span class="refpurpose"> — 2 channel attached device 3 </span></dt><dt><span class="refentrytitle"><a href="API-struct-ccw-driver.html"><span class="phrase">struct ccw_driver</span></a></span><span class="refpurpose"> — 4 device driver for channel attached devices 5 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-set-offline.html"><span class="phrase">ccw_device_set_offline</span></a></span><span class="refpurpose"> — 6 disable a ccw device for I/O 7 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-set-online.html"><span class="phrase">ccw_device_set_online</span></a></span><span class="refpurpose"> — 8 enable a ccw device for I/O 9 </span></dt><dt><span class="refentrytitle"><a href="API-get-ccwdev-by-dev-id.html"><span class="phrase">get_ccwdev_by_dev_id</span></a></span><span class="refpurpose"> — 10 obtain device from a ccw device id 11 </span></dt><dt><span class="refentrytitle"><a href="API-get-ccwdev-by-busid.html"><span class="phrase">get_ccwdev_by_busid</span></a></span><span class="refpurpose"> — 12 obtain device from a bus id 13 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-driver-register.html"><span class="phrase">ccw_driver_register</span></a></span><span class="refpurpose"> — 14 register a ccw driver 15 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-driver-unregister.html"><span class="phrase">ccw_driver_unregister</span></a></span><span class="refpurpose"> — 16 deregister a ccw driver 17 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-siosl.html"><span class="phrase">ccw_device_siosl</span></a></span><span class="refpurpose"> — 18 initiate logging 19 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-set-options-mask.html"><span class="phrase">ccw_device_set_options_mask</span></a></span><span class="refpurpose"> — 20 set some options and unset the rest 21 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-set-options.html"><span class="phrase">ccw_device_set_options</span></a></span><span class="refpurpose"> — 22 set some options 23 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-clear-options.html"><span class="phrase">ccw_device_clear_options</span></a></span><span class="refpurpose"> — 24 clear some options 25 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-is-pathgroup.html"><span class="phrase">ccw_device_is_pathgroup</span></a></span><span class="refpurpose"> — 26 determine if paths to this device are grouped 27 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-is-multipath.html"><span class="phrase">ccw_device_is_multipath</span></a></span><span class="refpurpose"> — 28 determine if device is operating in multipath mode 29 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-clear.html"><span class="phrase">ccw_device_clear</span></a></span><span class="refpurpose"> — 30 terminate I/O request processing 31 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-start-key.html"><span class="phrase">ccw_device_start_key</span></a></span><span class="refpurpose"> — 32 start a s390 channel program with key 33 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-start-timeout-key.html"><span class="phrase">ccw_device_start_timeout_key</span></a></span><span class="refpurpose"> — 34 start a s390 channel program with timeout and key 35 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-start.html"><span class="phrase">ccw_device_start</span></a></span><span class="refpurpose"> — 36 start a s390 channel program 37 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-start-timeout.html"><span class="phrase">ccw_device_start_timeout</span></a></span><span class="refpurpose"> — 38 start a s390 channel program with timeout 39 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-halt.html"><span class="phrase">ccw_device_halt</span></a></span><span class="refpurpose"> — 40 halt I/O request processing 41 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-resume.html"><span class="phrase">ccw_device_resume</span></a></span><span class="refpurpose"> — 42 resume channel program execution 43 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-ciw.html"><span class="phrase">ccw_device_get_ciw</span></a></span><span class="refpurpose"> — 44 Search for CIW command in extended sense data. 45 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-path-mask.html"><span class="phrase">ccw_device_get_path_mask</span></a></span><span class="refpurpose"> — 46 get currently available paths 47 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-chp-desc.html"><span class="phrase">ccw_device_get_chp_desc</span></a></span><span class="refpurpose"> — 48 return newly allocated channel-path descriptor 49 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-id.html"><span class="phrase">ccw_device_get_id</span></a></span><span class="refpurpose"> — 50 obtain a ccw device id 51 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-tm-start-key.html"><span class="phrase">ccw_device_tm_start_key</span></a></span><span class="refpurpose"> — 52 perform start function 53 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-tm-start-timeout-key.html"><span class="phrase">ccw_device_tm_start_timeout_key</span></a></span><span class="refpurpose"> — 54 perform start function 55 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-tm-start.html"><span class="phrase">ccw_device_tm_start</span></a></span><span class="refpurpose"> — 56 perform start function 57 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-tm-start-timeout.html"><span class="phrase">ccw_device_tm_start_timeout</span></a></span><span class="refpurpose"> — 58 perform start function 59 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-mdc.html"><span class="phrase">ccw_device_get_mdc</span></a></span><span class="refpurpose"> — 60 accumulate max data count 61 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-tm-intrg.html"><span class="phrase">ccw_device_tm_intrg</span></a></span><span class="refpurpose"> — 62 perform interrogate function 63 </span></dt><dt><span class="refentrytitle"><a href="API-ccw-device-get-schid.html"><span class="phrase">ccw_device_get_schid</span></a></span><span class="refpurpose"> — 64 obtain a subchannel id 65 </span></dt></dl></div><p> 66 Devices that want to initiate channel I/O need to attach to the ccw bus. 67 Interaction with the driver core is done via the common I/O layer, which 68 provides the abstractions of ccw devices and ccw device drivers. 69 </p><p> 70 The functions that initiate or terminate channel I/O all act upon a 71 ccw device structure. Device drivers must not bypass those functions 72 or strange side effects may happen. 73 </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ccw-dev-id-is-equal.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ccw.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-struct-ccw-device.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">ccw_dev_id_is_equal</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">struct ccw_device</span></td></tr></table></div></body></html> 74