From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alex Williamson Subject: [PATCH 2/4] kvm: Add missing KVM_IRQFD API documentation Date: Fri, 22 Jun 2012 16:15:50 -0600 Message-ID: <20120622221541.9858.37619.stgit@bling.home> References: <20120622220040.9858.43665.stgit@bling.home> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Cc: kvm@vger.kernel.org, linux-kernel@vger.kernel.org, jan.kiszka@siemens.com, mst@redhat.com To: avi@redhat.com Return-path: In-Reply-To: <20120622220040.9858.43665.stgit@bling.home> Sender: linux-kernel-owner@vger.kernel.org List-Id: kvm.vger.kernel.org Signed-off-by: Alex Williamson --- Documentation/virtual/kvm/api.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt index 310fe50..9b4cb2b 100644 --- a/Documentation/virtual/kvm/api.txt +++ b/Documentation/virtual/kvm/api.txt @@ -1965,6 +1965,23 @@ return the hash table order in the parameter. (If the guest is using the virtualized real-mode area (VRMA) facility, the kernel will re-create the VMRA HPTEs on the next KVM_RUN of any vcpu.) +4.76 KVM_IRQFD + +Capability: KVM_CAP_IRQFD +Architectures: x86 +Type: vm ioctl +Parameters: struct kvm_irqfd (in) +Returns: 0 on success, -1 on error + +Allows setting an eventfd to directly trigger a guest interrupt +kvm_irqfd.fd specifies the file descriptor to use as the eventfd and +kvm_irqfd.gsi specifies the irqchip pin toggled by this event. By +default this interface only supports edge triggered interrupts, +meaning the specified gsi is asserted and immediately de-asserted +when the eventfd is triggered. Specifying KVM_IRQFD_FLAG_DEASSIGN +removes the previously set irqfd matching both kvm_irqfd.fd and +kvm_irqfd.gsi. + 5. The kvm_run structure ------------------------