Subject: kern/7734: Missing documentation for "scsi quirks" mechanism
To: None <>
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
>Originator:     Hauke Fath
>Release:        1.4
	Although the "quirks" concept is essential to NetBSD SCSI
device handling, it is undocumented.

	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.

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