linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Matthew Wilcox <willy@infradead.org>
To: Kishon Vijay Abraham I <kishon@ti.com>
Cc: Bjorn Helgaas <bhelgaas@google.com>,
	Jonathan Corbet <corbet@lwn.net>,
	Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>,
	Arnd Bergmann <arnd@arndb.de>, Jon Mason <jdmason@kudzu.us>,
	Dave Jiang <dave.jiang@intel.com>,
	Allen Hubbe <allenbh@gmail.com>, Tom Joseph <tjoseph@cadence.com>,
	Rob Herring <robh@kernel.org>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	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
Date: Thu, 11 Jun 2020 08:13:01 -0700	[thread overview]
Message-ID: <20200611151301.GB8681@bombadil.infradead.org> (raw)
In-Reply-To: <20200611130525.22746-2-kishon@ti.com>

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 <kishon@ti.com>
> +
> +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.

  reply	other threads:[~2020-06-11 15:13 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-06-11 13:05 [PATCH v2 00/14] Implement NTB Controller using multiple PCI EP Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 01/14] Documentation: PCI: Add specification for the *PCI NTB* function device Kishon Vijay Abraham I
2020-06-11 15:13   ` Matthew Wilcox [this message]
2020-06-12  5:30     ` Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 02/14] PCI: endpoint: Make *_get_first_free_bar() take into account 64 bit BAR Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 03/14] PCI: endpoint: Add helper API to get the 'next' unreserved BAR Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 04/14] PCI: endpoint: Make *_free_bar() to return error codes on failure Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 05/14] PCI: endpoint: Remove unused pci_epf_match_device() Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 06/14] PCI: endpoint: Add support to associate secondary EPC with EPF Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 07/14] PCI: endpoint: Add support in configfs to associate two EPCs " Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 08/14] PCI: endpoint: Add pci_epc_ops to map MSI irq Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 09/14] PCI: cadence: Implement ->msi_map_irq() ops Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 10/14] PCI: endpoint: Add EP function driver to provide NTB functionality Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 11/14] PCI: Add TI J721E device to pci ids Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 12/14] NTB: Add support for EPF PCI-Express Non-Transparent Bridge Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 13/14] NTB: tool: Enable the NTB/PCIe link on the local or remote side of bridge Kishon Vijay Abraham I
2020-06-11 13:05 ` [PATCH v2 14/14] Documentation: PCI: Add userguide for PCI endpoint NTB function Kishon Vijay Abraham I

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200611151301.GB8681@bombadil.infradead.org \
    --to=willy@infradead.org \
    --cc=allenbh@gmail.com \
    --cc=arnd@arndb.de \
    --cc=bhelgaas@google.com \
    --cc=corbet@lwn.net \
    --cc=dave.jiang@intel.com \
    --cc=gregkh@linuxfoundation.org \
    --cc=jdmason@kudzu.us \
    --cc=kishon@ti.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-ntb@googlegroups.com \
    --cc=linux-pci@vger.kernel.org \
    --cc=lorenzo.pieralisi@arm.com \
    --cc=robh@kernel.org \
    --cc=tjoseph@cadence.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).