Subject: kern/7734: Missing documentation for "scsi quirks" mechanism
To: None <gnats-bugs@gnats.netbsd.org>
From: None <hauke@Espresso.Rhein-Neckar.DE>
List: netbsd-bugs
Date: 06/08/1999 02:22:58
>Number:         7734
>Category:       kern
>Synopsis:       Missing scsi_quirks(9) manpage
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kern-bug-people (Kernel Bug People)
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Tue Jun  8 02:20:01 1999
>Last-Modified:
>Originator:     Hauke Fath
>Organization:
None.
>Release:        1.4
>Environment:
>Description:
	Although the "quirks" concept is essential to NetBSD SCSI
device handling, it is undocumented.

>How-To-Repeat:
	Find that the 1.4 st driver is incapable of reading QIC2GB
tapes written by the 1.2G driver. Notify current-users and watch the
audience turn the thread into a discussion about dump(8) performance
data. Try to UTS and find that QIC drive handling appears to be stuck
in a 1990 state but that it's hard to tell without docs.  Watch "man
-k quirks" fail and bang head against wall.

The SCSI subsystem is one of the most important in the kernel and
about the worst documented.

>Fix:
	Someone knowledgable condense the state of the art into a
scsi_quirks(9) page. Please.

>Audit-Trail:
>Unformatted: