The scsi_mid_low_api.txt file describes the interface
between the SCSI mid level and a low level driver,
seen from the latter's perspective. It is found in
the kernel source in the Documentation/scsi directory.

The attachment incorporates a patch sent to me by Christoph
and ideas in Mike Anderson's refcounting document (url?).

It anticipates various patches that Christoph has sent to
this list being accepted. These include:
   - addition of scsi_host_alloc()
   - renaming of struct SHT to struct scsi_host_template

The attachment (gzipped due to its size) is a diff against
lk 2.5.72 . A gzipped version of the document can be found at:
   http://www.torque.net/scsi/scsi_mid_low_api.txt.gz


Idea: perhaps scsi_add_host() could have an extra argument
to inhibit the scsi device scan (or alternatively a new field
in struct scsi_host_template and struct Scsi_Host). Then
LLDs that know about their devices hot (un)plugging can use
scsi_add_device() and scsi_remove_device() at their leisure.
[Actually ieee1394/sbp2.c is already doing this ...]

Comments and corrections welcome.

Doug Gilbert