From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-0.6 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E1400C433E1 for ; Thu, 11 Jun 2020 15:13:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id BBDA020691 for ; Thu, 11 Jun 2020 15:13:19 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="UtaPwmTz" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728471AbgFKPNS (ORCPT ); Thu, 11 Jun 2020 11:13:18 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38558 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728364AbgFKPNR (ORCPT ); Thu, 11 Jun 2020 11:13:17 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:e::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D41DDC08C5C1; Thu, 11 Jun 2020 08:13:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=In-Reply-To:Content-Type:MIME-Version :References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=w3fBHCM88Jt6cDakKyk4xboQWGAsFcwZYcNUwD/n+nU=; b=UtaPwmTzyZIQm0eT7m6SNXoJB4 VEIPQTkfTTpUfAvEF37o1G0jHd+Y95AGyX9dzVYfoFBWjXPQqXXilnzEKOcByAGTvQgHp9w8nTqO7 QwU9tb6KWeI0n0NbVqy/Hr16C2/p28CsawrQGVa+KMM+AXybJtvEB9SXqJYZhiyS1WGqT3nPV4lyo RDAnri9zQcK1XjCgw6xAnoDbnQWYZQt22FfD98tO6SIoYY6HnWAzOd4zHxUzduoq6ChG6oJO8MfhA 213c7hJBlrrRX/bXaMqCavMXmm6oVJttLCkFhfB5KeGtlWzbPuwfjdaiV1ZXwcX2PI+n/c44fsTcx 6dkEYKAg==; Received: from willy by bombadil.infradead.org with local (Exim 4.92.3 #3 (Red Hat Linux)) id 1jjOt3-0001iB-3j; Thu, 11 Jun 2020 15:13:01 +0000 Date: Thu, 11 Jun 2020 08:13:01 -0700 From: Matthew Wilcox To: Kishon Vijay Abraham I Cc: Bjorn Helgaas , Jonathan Corbet , Lorenzo Pieralisi , Arnd Bergmann , Jon Mason , Dave Jiang , Allen Hubbe , Tom Joseph , Rob Herring , Greg Kroah-Hartman , linux-pci@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-ntb@googlegroups.com Subject: Re: [PATCH v2 01/14] Documentation: PCI: Add specification for the *PCI NTB* function device Message-ID: <20200611151301.GB8681@bombadil.infradead.org> References: <20200611130525.22746-1-kishon@ti.com> <20200611130525.22746-2-kishon@ti.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200611130525.22746-2-kishon@ti.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, Jun 11, 2020 at 06:35:12PM +0530, Kishon Vijay Abraham I wrote: > +++ b/Documentation/PCI/endpoint/pci-ntb-function.rst > @@ -0,0 +1,344 @@ > +.. SPDX-License-Identifier: GPL-2.0 > + > +================= > +PCI NTB Function > +================= > + > +:Author: Kishon Vijay Abraham I > + > +PCI NTB Function allows two different systems (or hosts) to communicate > +with each other by configurig the endpoint instances in such a way that > +transactions from one system is routed to the other system. At no point in this document do you expand "NTB" into Non-Transparent Bridge. The above paragraph probably also needs to say something like "By making each host appear as a device to the other host". Although maybe that's not entirely accurate? It's been a few years since I last played with NTBs. So how about the following opening paragraph: PCI Non Transparent Bridges (NTB) allow two host systems to communicate with each other by exposing each host as a device to the other host. NTBs typically support the ability to generate interrupts on the remote machine, expose memory ranges as BARs and perform DMA. They also support scratchpads which are areas of memory within the NTB that are accessible from both machines. ... feel free to fix that up if my memory is out of date or corrupted.