• M
    ivshmem: Split ivshmem-plain, ivshmem-doorbell off ivshmem · 5400c02b
    Markus Armbruster 提交于
    ivshmem can be configured with and without interrupt capability
    (a.k.a. "doorbell").  The two configurations have largely disjoint
    options, which makes for a confusing (and badly checked) user
    interface.  Moreover, the device can't tell the guest whether its
    doorbell is enabled.
    
    Create two new device models ivshmem-plain and ivshmem-doorbell, and
    deprecate the old one.
    
    Changes from ivshmem:
    
    * PCI revision is 1 instead of 0.  The new revision is fully backwards
      compatible for guests.  Guests may elect to require at least
      revision 1 to make sure they're not exposed to the funny "no shared
      memory, yet" state.
    
    * Property "role" replaced by "master".  role=master becomes
      master=on, role=peer becomes master=off.  Default is off instead of
      auto.
    
    * Property "use64" is gone.  The new devices always have 64 bit BARs.
    
    Changes from ivshmem to ivshmem-plain:
    
    * The Interrupt Pin register in PCI config space is zero (does not use
      an interrupt pin) instead of one (uses INTA).
    
    * Property "x-memdev" is renamed to "memdev".
    
    * Properties "shm" and "size" are gone.  Use property "memdev"
      instead.
    
    * Property "msi" is gone.  The new device can't have MSI-X capability.
      It can't interrupt anyway.
    
    * Properties "ioeventfd" and "vectors" are gone.  They're meaningless
      without interrupts anyway.
    
    Changes from ivshmem to ivshmem-doorbell:
    
    * Property "msi" is gone.  The new device always has MSI-X capability.
    
    * Property "ioeventfd" defaults to on instead of off.
    
    * Property "size" is gone.  The new device can only map all the shared
      memory received from the server.
    
    Guests can easily find out whether the device is configured for
    interrupts by checking for MSI-X capability.
    
    Note: some code added in sub-optimal places to make the diff easier to
    review.  The next commit will move it to more sensible places.
    Signed-off-by: NMarkus Armbruster <armbru@redhat.com>
    Reviewed-by: NMarc-André Lureau <marcandre.lureau@redhat.com>
    Message-Id: <1458066895-20632-37-git-send-email-armbru@redhat.com>
    5400c02b
qemu-doc.texi 95.8 KB