From patchwork Sat Sep 14 11:08:37 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 20315 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qa0-f72.google.com (mail-qa0-f72.google.com [209.85.216.72]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id EAED4248D3 for ; Sat, 14 Sep 2013 11:09:41 +0000 (UTC) Received: by mail-qa0-f72.google.com with SMTP id j7sf133178qaq.3 for ; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-unsubscribe:content-type :content-transfer-encoding; bh=Tjf87KfNe7LBV0XejNSTWGxSsDGH6EDImERX1Q/6YIo=; b=Pfhz3jiz0dQASO06OkNa35IKRJHUrLI/Opjt7zbTypim1u7wkdR3xAZGomgQ/bTy/D Kac3zrXlp+IURsP8Ab1MPCJutc3QhPLz3xgCESIq21BSFn7Q020Rxkvv6OZ66ukQSw10 oX6DfTahWZkmS6YmTjPIRMy6xe2gPndvI2nL5XBBylwUVW98H9BFhZwJD6PAKd1BBKAf g/+c6+4MPvUWVRENT7re/kXVpDOXkCo56n6m6pLjFywCAt2dwyS8nBgBeGROI752q52J 5qJ3QSQWYlyw/CA+DAq5zcT91jVzlLNKggtS+9yv4qJjp2MtnkwlEKQPoH+icRW12lSr fk3w== X-Gm-Message-State: ALoCoQmJv+hDFKZXZ6Cm8ySMKHV248kB8dNjc75BIRYYSvb/qaTX1JO9i6YlmDtFf+HXsS2Rp/cG X-Received: by 10.236.147.18 with SMTP id s18mr3904254yhj.28.1379156981763; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.49.48.41 with SMTP id i9ls1467072qen.44.gmail; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) X-Received: by 10.221.51.206 with SMTP id vj14mr16708305vcb.17.1379156981677; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) Received: from mail-vc0-f180.google.com (mail-vc0-f180.google.com [209.85.220.180]) by mx.google.com with ESMTPS id 10si4547607vcs.30.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 14 Sep 2013 04:09:41 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.180 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.220.180; Received: by mail-vc0-f180.google.com with SMTP id gf11so1724079vcb.11 for ; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) X-Received: by 10.58.46.229 with SMTP id y5mr9224406vem.15.1379156981593; Sat, 14 Sep 2013 04:09:41 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.220.174.196 with SMTP id u4csp7147vcz; Sat, 14 Sep 2013 04:09:40 -0700 (PDT) X-Received: by 10.67.14.231 with SMTP id fj7mr20517454pad.115.1379156980559; Sat, 14 Sep 2013 04:09:40 -0700 (PDT) Received: from mail-pa0-f42.google.com (mail-pa0-f42.google.com [209.85.220.42]) by mx.google.com with ESMTPS id hg4si10938310pbc.255.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 14 Sep 2013 04:09:40 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.42 is neither permitted nor denied by best guess record for domain of anup.patel@linaro.org) client-ip=209.85.220.42; Received: by mail-pa0-f42.google.com with SMTP id lj1so3572408pab.1 for ; Sat, 14 Sep 2013 04:09:40 -0700 (PDT) X-Received: by 10.66.234.193 with SMTP id ug1mr20512127pac.92.1379156980149; Sat, 14 Sep 2013 04:09:40 -0700 (PDT) Received: from pnqlab006.amcc.com ([182.73.239.130]) by mx.google.com with ESMTPSA id xe9sm24434350pab.0.1969.12.31.16.00.00 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 14 Sep 2013 04:09:39 -0700 (PDT) From: Anup Patel To: kvmarm@lists.cs.columbia.edu Cc: linux-arm-kernel@lists.infradead.org, linaro-kernel@lists.linaro.org, patches@linaro.org, marc.zyngier@arm.com, christoffer.dall@linaro.org, Anup Patel , Pranavkumar Sawargaonkar Subject: =?UTF-8?q?=5BPATCH=20v2=204/4=5D=20KVM=3A=20Add=20documentation=20for=20KVM=5FARM=5FPREFERRED=5FTARGET=20ioctl?= Date: Sat, 14 Sep 2013 16:38:37 +0530 Message-Id: <1379156917-17497-5-git-send-email-anup.patel@linaro.org> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1379156917-17497-1-git-send-email-anup.patel@linaro.org> References: <1379156917-17497-1-git-send-email-anup.patel@linaro.org> MIME-Version: 1.0 X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: anup.patel@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.220.180 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , To implement CPU=Host we have added KVM_ARM_PREFERRED_TARGET ioctl which provides information to user space required for creating VCPU matching underlying Host. This patch adds info related to this new KVM_ARM_PREFERRED_TARGET ioctl in the KVM API documentation. Signed-off-by: Anup Patel Signed-off-by: Pranavkumar Sawargaonkar --- Documentation/virtual/kvm/api.txt | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt index ef925ea..85f8026 100644 --- a/Documentation/virtual/kvm/api.txt +++ b/Documentation/virtual/kvm/api.txt @@ -2303,8 +2303,27 @@ Possible features: - KVM_ARM_VCPU_EL1_32BIT: Starts the CPU in a 32bit mode. Depends on KVM_CAP_ARM_EL1_32BIT (arm64 only). +4.83 KVM_ARM_PREFERRED_TARGET -4.83 KVM_GET_REG_LIST +Capability: basic +Architectures: arm, arm64 +Type: vcpu ioctl +Parameters: struct struct kvm_vcpu_init (out) +Returns: 0 on success; -1 on error +Errors: +  EINVAL:    no preferred target available for the host + +This queries KVM for preferred CPU target type which can be emulated +by KVM on underlying host. + +The ioctl returns struct kvm_vcpu_init instance containing information +about preferred CPU target type and optional features available for it. + +The information returned by this ioctl can be used to prepare instance +of struct kvm_vcpu_init for KVM_ARM_VCPU_INIT ioctl which will result +in VCPU matching underlying host. + +4.84 KVM_GET_REG_LIST Capability: basic Architectures: arm, arm64 @@ -2323,8 +2342,7 @@ struct kvm_reg_list { This ioctl returns the guest registers that are supported for the KVM_GET_ONE_REG/KVM_SET_ONE_REG calls. - -4.84 KVM_ARM_SET_DEVICE_ADDR +4.85 KVM_ARM_SET_DEVICE_ADDR Capability: KVM_CAP_ARM_SET_DEVICE_ADDR Architectures: arm, arm64 @@ -2362,7 +2380,7 @@ must be called after calling KVM_CREATE_IRQCHIP, but before calling KVM_RUN on any of the VCPUs. Calling this ioctl twice for any of the base addresses will return -EEXIST. -4.85 KVM_PPC_RTAS_DEFINE_TOKEN +4.86 KVM_PPC_RTAS_DEFINE_TOKEN Capability: KVM_CAP_PPC_RTAS Architectures: ppc