Re: [Qemu-devel] [PATCH V2 RESEND] docs: add PCIe devices placement guidelines

[Andrea Bolognani <abologna@redhat.com>]

On Mon, 2016-10-17 at 16:26 +0200, Laszlo Ersek wrote:
> > > > +2.1 Root Bus (pcie.0)
> > > > +=====================
> > > > +Place only the following kinds of devices directly on the Root Complex:
> > > > +    (1) Devices with dedicated, specific functionality (network card,
> > > > +        graphics card, IDE controller, etc); place only legacy PCI devices on
> > > > +        the Root Complex. These will be considered Integrated Endpoints.
> > > > +        Note: Integrated devices are not hot-pluggable.
> > 
> > s/Integrated devices/Integrated Endpoints/ (which I assume
> > is a Spec-Originated Term) in the last sentence, to be
> > consistent with the one right before it.
> > 
> > I'm also not sure what you mean by devices with "dedicated,
> > specific functionality", and unfortunately the examples don't
> > seem to be helping me.
> 
> That language is from me (I suggested it earlier). It means devices that
> you want to use for some actual task, rather than just to build your PCI
> (Express) hierarchy with them. "Leaf nodes" or whatever. "Everything
> non-bridge".

Isn't that basically the definition of Endpoint? It certainly
is what I convinced myself "Endpoint" means :)

Either way, I think we should spend a few more words there,
for clarity's sake. Rewording the phrase to put more emphasis
on the "legacy PCI devices only" part would probably be
warranted as well.

-- 
Andrea Bolognani / Red Hat / Virtualization