Re: [PATCH resend] KVM: Document KVM_IRQFD

[Scott Wood <scottwood@freescale.com>]

On 08/29/2011 07:34 AM, Sasha Levin wrote:
> Cc: Avi Kivity <avi@redhat.com>
> Cc: Marcelo Tosatti <mtosatti@redhat.com>
> Signed-off-by: Sasha Levin <levinsasha928@gmail.com>
> ---
>  Documentation/virtual/kvm/api.txt |   27 +++++++++++++++++++++++++++
>  1 files changed, 27 insertions(+), 0 deletions(-)
> 
> diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt
> index 2d510b6..d1150b6 100644
> --- a/Documentation/virtual/kvm/api.txt
> +++ b/Documentation/virtual/kvm/api.txt
> @@ -1450,6 +1450,33 @@ is supported; 2 if the processor requires all virtual machines to have
>  an RMA, or 1 if the processor can use an RMA but doesn't require it,
>  because it supports the Virtual RMA (VRMA) facility.
>  
> +4.64 KVM_IRQFD
> +
> +Capability: KVM_CAP_IRQFD
> +Architectures: all
> +Type: vm ioctl
> +Parameters: struct kvm_irqfd (in)
> +Returns: 0 on success, !0 on error
> +
> +This ioctl attaches or detaches an eventfd to a GSI within the guest.
> +While the eventfd is assigned to the guest, any write to the eventfd
> +would trigger the GSI within the guest.
> +
> +struct kvm_irqfd {
> +	__u32 fd;
> +	__u32 gsi;
> +	__u32 flags;
> +	__u8  pad[20];
> +};

Should define "gsi" (and how it's used by KVM) somewhere.  AFAICT it's
an ACPI-ism.

-Scott