From owner-freebsd-stable@FreeBSD.ORG Thu Nov 19 12:32:02 2009 Return-Path: Delivered-To: freebsd-stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1F17F106566B for ; Thu, 19 Nov 2009 12:32:02 +0000 (UTC) (envelope-from mavbsd@gmail.com) Received: from mail-fx0-f227.google.com (mail-fx0-f227.google.com [209.85.220.227]) by mx1.freebsd.org (Postfix) with ESMTP id A0C278FC19 for ; Thu, 19 Nov 2009 12:32:01 +0000 (UTC) Received: by fxm27 with SMTP id 27so2428190fxm.3 for ; Thu, 19 Nov 2009 04:32:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=M6lgUcpzABv1Oh6lVnCseNIxg0eS/ccyVbkHTY+zqPM=; b=BhQkIOcKCZ39dkFILAhe72IMi05FH6f+YbBsh1uHqbMLFWM8J78Fiolu1y6FjwIJI+ Kqo7KlEXqtyglRuj9tKMb3tSuyn1ajDMcjELq1SXHTLRa+EKpmasXQ9aYYLI2n6291hH Mewu+kGdsBKF/FqMCXnveoHHLSrzG3Qc9iHh8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=BvwKefcAwSyJK1ukrSGZYneUAo+NJ18d5gBB3WGn4FdJFIRjRtXtGuy4Z8XlP23cxJ pgO1N3quQC60b/7skby06Cz4/LvDefuv70k1ofYVCFup4lU+Mx3VeQrsZjW0xqkovzk3 QyyJ+U1sbiTsct87NIF6ux8sv7DByoUDbWCiw= Received: by 10.204.32.201 with SMTP id e9mr5725474bkd.122.1258633920712; Thu, 19 Nov 2009 04:32:00 -0800 (PST) Received: from mavbook.mavhome.dp.ua (pc.mavhome.dp.ua [212.86.226.226]) by mx.google.com with ESMTPS id 14sm159966fxm.3.2009.11.19.04.31.59 (version=SSLv3 cipher=RC4-MD5); Thu, 19 Nov 2009 04:32:00 -0800 (PST) Sender: Alexander Motin Message-ID: <4B053ABD.5050705@FreeBSD.org> Date: Thu, 19 Nov 2009 14:31:57 +0200 From: Alexander Motin User-Agent: Thunderbird 2.0.0.23 (X11/20090901) MIME-Version: 1.0 To: Jeremy Chadwick References: <1258514582.00184609.1258501202@10.7.7.3> <1258536184.00184683.1258524603@10.7.7.3> <1258536184.00184684.1258525203@10.7.7.3> <1258611785.00185054.1258600801@10.7.7.3> <1258629784.00185092.1258619402@10.7.7.3> <1258633382.00185098.1258621201@10.7.7.3> In-Reply-To: <1258633382.00185098.1258621201@10.7.7.3> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-stable@freebsd.org Subject: Re: HEADS UP: major CAM ATA MFC X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Nov 2009 12:32:02 -0000 Jeremy Chadwick wrote: > On Thu, Nov 19, 2009 at 10:22:53AM +0200, Alexander Motin wrote: >> Read ahci(4) carefully. It has all possible references. If you think it >> is not enough, propose patches. > > I had no idea said details were in the ahci(4) man page, and I doubt the > rest of the user community will know that either. There's also no man > page for ada(4). > > There is some ambiguity in this part of the ahci(4) man page: > > AHCI hardware is also supported by ataahci driver from ata(4) subsystem. > If both drivers are loaded at the same time, this one will be given > precedence as the more functional of the two. > > The grammar here is very difficult to understand; "if both drivers" is > too vague. The way this paragraph can be interpreted: > > - "If both drivers" could refer to ata(4) and ataahci No. ataahci is a part of ata(4). > - "If both drivers" could refer to ata(4) and ahci(4) Yes, if with ata(4) understand it's ataahci part. > - "If both drivers" could refer to ada(4) and ahci(4) No. It is mentioned in ahci(4), that ada is peripheral driver. Not a controller. > - "If both drivers" could refer to ahci(4) and ata(4) It is same as second. > I'll happily re-write the documentation for this if someone can take the > time to explain what the paragraph actually is trying to say. Welcome. > Users are > going to be very, very confused if there is a driver called ataahci and > another driver called ahci. This is temporal situation, until new infrastructure will settle. Then old one will be removed. > Finally, appropriate details need to be placed into the i386 and amd64 > kernel configuration files; either in GENERIC (commented out) or in > /sys/conf/NOTES. As it stands, there's nothing that informs anyone of > this change, and if users are being pointed to the ahci(4) man page, > they're going to get confused (see above). Both new ahci and siis drivers are mentioned in NOTES file. -- Alexander Motin