From d27abec08f765976fb7c0189678eabd28138fbbb Mon Sep 17 00:00:00 2001 From: mycroft Date: Fri, 25 Jun 2004 13:23:55 +0000 Subject: Add a comment explaining quirk table policy. --- sys/dev/usb/umass_quirks.c | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) (limited to 'sys/dev') diff --git a/sys/dev/usb/umass_quirks.c b/sys/dev/usb/umass_quirks.c index c4060d34219..b586792e58e 100644 --- a/sys/dev/usb/umass_quirks.c +++ b/sys/dev/usb/umass_quirks.c @@ -1,4 +1,4 @@ -/* $NetBSD: umass_quirks.c,v 1.64 2003/11/07 01:04:27 kivinen Exp $ */ +/* $NetBSD: umass_quirks.c,v 1.65 2004/06/25 13:23:55 mycroft Exp $ */ /* * Copyright (c) 2001 The NetBSD Foundation, Inc. @@ -37,7 +37,7 @@ */ #include -__KERNEL_RCSID(0, "$NetBSD: umass_quirks.c,v 1.64 2003/11/07 01:04:27 kivinen Exp $"); +__KERNEL_RCSID(0, "$NetBSD: umass_quirks.c,v 1.65 2004/06/25 13:23:55 mycroft Exp $"); #include #include @@ -59,6 +59,19 @@ Static usbd_status umass_init_shuttle(struct umass_softc *); Static void umass_fixup_sony(struct umass_softc *); +/* + * XXX + * PLEASE NOTE that if you want quirk entries added to this table, you MUST + * compile a kernel with USB_DEBUG, and submit a full log of the output from + * whatever operation is "failing" with ?hcidebug=20 or higher and + * umassdebug=0xffffff. (It's usually helpful to also set MSGBUFSIZE to + * something "large" unless you're using a serial console.) Without this + * information, the source of the problem cannot be properly analyzed, and + * the quirk entry WILL NOT be accepted. + * Also, when an entry is committed to this table, a concise but clear + * description of the problem MUST accompany it. + * - mycroft + */ Static const struct umass_quirk umass_quirks[] = { /* * The following 3 In-System Design adapters use a non-standard ATA -- cgit