arch/s390/driver-model.rst

6 --------------
8 All devices which can be addressed by means of ccws are called 'CCW devices' -
15      - system/
16      - css0/
17 	   - 0.0.0000/0.0.0815/
18 	   - 0.0.0001/0.0.4711/
19 	   - 0.0.0002/
20 	   - 0.1.0000/0.1.1234/
22 	   - defunct/
25 device 4711 via subchannel 1 in subchannel set 0, and subchannel 2 is a non-I/O
55 The device drivers can add entries to export per-device data and interfaces.
57 There is also some data exported on a per-subchannel basis (see under
70 ----------------------------
81 ------------------------------------
132 	 This function is called by the device layer for each device the driver
134 	 to put in dev->driver_data and create attributes (if needed). Also,
143 			- the device to be probed.
147 	 This function is called by the device layer upon removal of the driver,
156 			- the device to be removed.
160 	    This function is called by the common I/O layer when the device is
170 			- the device to be activated. The common layer has
174 set_offline: This function is called by the common I/O layer when the device is
175 	     de-activated via the 'online' attribute. The driver should shut
176 	     down the device, but not de-allocate its private data.
184 			- the device to be deactivated. The common layer has
189 	This function is called by the common I/O layer for some state changes
200 	  common I/O layer performs some sanity checks on device number and
205 	  removed and re-registered.
213 			- the device whose state changed.
216 			- the event that happened. This can be one of CIO_GONE,
221 distinct handlers (e.g. multi subchannel devices), this is a member of ccw_device
223 The handler is registered with the common layer during set_online() processing
232 Parameters:     dev     - the device the handler is called for
233 		intparm - the intparm which allows the device driver to identify
236 		irb     - interruption response block which contains the accumulated
239 The device driver is called from the common ccw_device layer and can retrieve
244 --------------------
260 touched by the driver - it should use the ccwgroup device's driver_data for its
269 -----------------
279        - Can be 'online' or 'offline'.
282 	 the chpid connects to. This can be used to force the kernel to re-use
287        - The physical type of the channel path.
290        - Whether the channel path is shared.
293        - The channel measurement group.
296 -----------------
299 ---------
304 --------
311 ----------------
314 -----------
325     - shows the connection partner.
328     - maximum buffer size. Pipe to it to change buffer size.