[S390] cio: Update documentation.

   <title>Introduction</title>

   <title>Introduction</title>

  <para>

  <para>

    This document describes the interfaces available for device drivers that

    This document describes the interfaces available for device drivers that

    drive s390 based channel attached devices. This includes interfaces for

    drive s390 based channel attached I/O devices. This includes interfaces for

    interaction with the hardware and interfaces for interacting with the

    interaction with the hardware and interfaces for interacting with the

    common driver core. Those interfaces are provided by the s390 common I/O

    common driver core. Those interfaces are provided by the s390 common I/O

    layer.

    layer.

	The ccw bus typically contains the majority of devices available to

	The ccw bus typically contains the majority of devices available to

	a s390 system. Named after the channel command word (ccw), the basic

	a s390 system. Named after the channel command word (ccw), the basic

	command structure used to address its devices, the ccw bus contains

	command structure used to address its devices, the ccw bus contains

	so-called channel attached devices. They are addressed via subchannels,

	so-called channel attached devices. They are addressed via I/O

	visible on the css bus. A device driver, however, will never interact

	subchannels, visible on the css bus. A device driver for

	with the subchannel directly, but only via the device on the ccw bus,

	channel-attached devices, however, will never interact	with the

	subchannel directly, but only via the I/O device on the ccw bus,

	the ccw device.

	the ccw device.

  </para>

  </para>

    <sect1 id="channelIO">

    <sect1 id="channelIO">

!Iinclude/asm-s390/ccwdev.h

!Iinclude/asm-s390/ccwdev.h

!Edrivers/s390/cio/device.c

!Edrivers/s390/cio/device.c

!Edrivers/s390/cio/device_ops.c

!Edrivers/s390/cio/device_ops.c

!Edrivers/s390/cio/airq.c

    </sect1>

    </sect1>

    <sect1 id="cmf">

    <sect1 id="cmf">

     <title>The channel-measurement facility</title>

     <title>The channel-measurement facility</title>

   </sect1>

   </sect1>

  </chapter>

  </chapter>

  <chapter id="genericinterfaces">

   <title>Generic interfaces</title>

  <para>

	Some interfaces are available to other drivers that do not necessarily

	have anything to do with the busses described above, but still are

	indirectly using basic infrastructure in the common I/O layer.

	One example is the support for adapter interrupts.

  </para>

!Edrivers/s390/cio/airq.c

  </chapter>

</book>

</book>