[PATCH] scsi_mid_low_api.txt for 2.5.46-bk3

[PATCH] scsi_mid_low_api.txt for 2.5.46-bk3

[Douglas Gilbert]

[-- Attachment #1: Type: text/plain, Size: 377 bytes --]

This patch against 2.5.46-bk3 is work in progress
(since the interface is in flux). It dusts of some
cobwebs, removes politically incorrect typedefs and
describes slave_attach() and slave_detach(). It
removes the revoke() description (per hch? changes).

Is a section describing mid level functions provided
for LLDDs (e.g. scsi_adjust_queue_depth() )
warranted?

Doug Gilbert

[-- Attachment #2: scsi_mid_low_api_2546bk3.diff.gz --]
[-- Type: application/x-gzip, Size: 5929 bytes --]

Re: [PATCH] scsi_mid_low_api.txt for 2.5.46-bk3

[Christoph Hellwig]

On Fri, Nov 08, 2002 at 12:07:29PM +1100, Douglas Gilbert wrote:
> This patch against 2.5.46-bk3 is work in progress
> (since the interface is in flux). It dusts of some
> cobwebs, removes politically incorrect typedefs and

I'd suggest to leave them in where the struct names are raraly used and even
worse (e.g. struct SHT), I'm probably going to a do a big cleansweap to
give them saner struct names soon, and the fewer users they acquired until
then the better..

> describes slave_attach() and slave_detach(). It
> removes the revoke() description (per hch? changes).

Patrick did it.

> Is a section describing mid level functions provided
> for LLDDs (e.g. scsi_adjust_queue_depth() )
> warranted?

LLDD = Low Level Driver Developer?

It looks like a good idea to me, but I wonder whether that should be
a separate Document.  BTW, what about movinf this and the other docs
(e.g. README.*) in drivers/scsi/ to Documentation/scsi/ ?

Another things that's worth mentioning is that ->detect and ->release are
option now if you don't write a scsi_module.c-style driver.

And thanks a lot for caring for the scsi documentation, I usually try to update
it for my changes, but you do a much better job..

Re: [PATCH] scsi_mid_low_api.txt for 2.5.46-bk3

[Randy.Dunlap]

On Fri, 8 Nov 2002, Douglas Gilbert wrote:

| This patch against 2.5.46-bk3 is work in progress
| (since the interface is in flux). It dusts of some
| cobwebs, removes politically incorrect typedefs and
| describes slave_attach() and slave_detach(). It
| removes the revoke() description (per hch? changes).
|
| Is a section describing mid level functions provided
| for LLDDs (e.g. scsi_adjust_queue_depth() ) warranted?

Yes, please.

[LLDD = low-level device driver]

-- 
~Randy

Re: [PATCH] scsi_mid_low_api.txt for 2.5.46-bk3

[Doug Ledford]

On Thu, Nov 07, 2002 at 07:13:16PM -0800, Randy.Dunlap wrote:
> On Fri, 8 Nov 2002, Douglas Gilbert wrote:
> 
> | This patch against 2.5.46-bk3 is work in progress
> | (since the interface is in flux). It dusts of some
> | cobwebs, removes politically incorrect typedefs and
> | describes slave_attach() and slave_detach(). It
> | removes the revoke() description (per hch? changes).
> |
> | Is a section describing mid level functions provided
> | for LLDDs (e.g. scsi_adjust_queue_depth() ) warranted?
> 
> Yes, please.
> 
> [LLDD = low-level device driver]

I am writing such a doc BTW, but I've been asleep for a few hours so I 
have chimed in ;-)

-- 
  Doug Ledford <dledford@redhat.com>     919-754-3700 x44233
         Red Hat, Inc. 
         1801 Varsity Dr.
         Raleigh, NC 27606