From owner-freebsd-arch@FreeBSD.ORG Sat Dec 15 22:02:29 2007 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3B57F16A550 for ; Sat, 15 Dec 2007 22:02:29 +0000 (UTC) (envelope-from kip.macy@gmail.com) Received: from wa-out-1112.google.com (wa-out-1112.google.com [209.85.146.183]) by mx1.freebsd.org (Postfix) with ESMTP id AE5F813C45B for ; Sat, 15 Dec 2007 22:02:28 +0000 (UTC) (envelope-from kip.macy@gmail.com) Received: by wa-out-1112.google.com with SMTP id k17so2357986waf.3 for ; Sat, 15 Dec 2007 14:02:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=GJ80xv4ybbGGM2jFPYOWs0MttisbZ6W6ea2OH9I8h08=; b=su269A67sQ31FcV7k8jvjE1Bftek9Ppp8wrX+Fswi1ckLskwtP+Kk0wOdqM/hG3KrMWiJpfljfuY2brAvccEkygnf5WWpdZBHRSKmDQeqBACxPhpQhC6UFENE7zWOQyt2cT6VGtqKzbujpwbLDGP31gMbUzOahhwTK7DxKojW4w= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=rOCYY1vN5VXTd3LHU+Rnd7xzkO6FNLK7fat8o25Rb5EksHf+31asZ6xbn+bdcnW4TUgNjaEwpTcmNmLoHdhOitfsg/rfyrxxeoQqj1EpRlrAz/3jr+9htKCYXvzWqYnlmDShns85QfvTsTHf3IwWEDZok2AbJZ/oyTCeMvuaJPE= Received: by 10.115.48.12 with SMTP id a12mr838011wak.149.1197756148165; Sat, 15 Dec 2007 14:02:28 -0800 (PST) Received: by 10.114.255.11 with HTTP; Sat, 15 Dec 2007 14:02:28 -0800 (PST) Message-ID: Date: Sat, 15 Dec 2007 14:02:28 -0800 From: "Kip Macy" To: "Robert Watson" In-Reply-To: <20071215214253.N85668@fledge.watson.org> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20071215100351.Q70617@fledge.watson.org> <20071215190252.I85668@fledge.watson.org> <20071215214253.N85668@fledge.watson.org> Cc: FreeBSD Current , freebsd-arch@freebsd.org Subject: Re: pending changes for TOE support X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 15 Dec 2007 22:02:29 -0000 > I think we should make a best faith effort to figure out how to do the right > thing. Employing harsh interrogation tactics is probably not called for, but > we have several vendors who are regularly involved in the FreeBSD community > and may be willing to lend their insight as to their requirements, even if an > implementation isn't immediately forthcoming. :-) - the two vendors that I know of have not been active in the community. Sam has initiated contact on my behalf with the one vendor that might be willing to talk to us. The other vendor has an established pattern of ignoring all requests. > > >> tcp_output() was previously an internal function of the TCP code, and now > >> the semantics are being exposed to device drivers. Let's not perpetuate > >> poorly documented driver interfaces by adding another one. I think it > >> would be a reasonable expectation of a driver author to have consistent > >> documentation of the life cycle of data structures and objects, locking > >> expectations and requirements, and the semantics for error values from > >> functions. Certainly, they need to look at TCP a fair amount because > >> they'll be pulling things out of inpcb, tcpcb, etc, but I'd rather we limit > >> that requirement to simple things (addresses, socket options) that are > >> relatively static and avoid it being for complex things (locking, error > >> handling) that tend to be more subject to change. Also, if you document > >> what you think the behavior is or should be, we can then check to see if we > >> agree. > > > > To the extent possible, yes. I'm not convinced that anyone person knows what > > all the existing invariants are in the stack as it is now. Do you feel that > > a Stevens'-esque understanding of the environment around the calls is > > necessary? I know it sounds like "other people beat their wives so I can > > too", but even something as well documented as ifnet gives no indication of > > what the locking conventions - e.g. you can't sleep or acquire sx locks in > > if_ioctl. The demands placed should be no greater than those placed on > > existing subsystems and should take into account the hitherto somewhat black > > box nature of TCP. > > Actually, what I was asking for in the omitted context above was something > along the lines of the following, adapted for whatever the reality may be: > > Returning a non-zero value will lead to the software stack beginning a > disconnect. > > Or, say, > > Non-zero return values will be ignored. (*) > > This is not intended as a contrarian point. I'm not looking for a complete > exposition of the behavior of the stack -- rather, basic information that we > should be documenting about a KPI, such as what an error being returned will > do. That is quite reasonable. I perceived your initial request as being entirely too open-ended. -Kip