From patchwork Wed Sep 25 09:26:03 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 20561 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qa0-f69.google.com (mail-qa0-f69.google.com [209.85.216.69]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 3EAA725E71 for ; Wed, 25 Sep 2013 09:27:16 +0000 (UTC) Received: by mail-qa0-f69.google.com with SMTP id cm18sf4359243qab.8 for ; Wed, 25 Sep 2013 02:27:16 -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=NuHN7UgbdRKRYOJ57WtUqhAGzA0zy7zy55Eaare0+pE=; b=UlqxVQAngvx+Kytjh6tYG3qQESPGdaphApLRFgYe9lpdNEBR4SVxNjj+jlLOO99c6O oJreMgY7UGBaOkeIr7NabJCo+L8GlXn17EizOK21iccZmKXToS4EqaW+fvVTyY1of7Np v4U2ZQOSTkZ++et9wOTX4SIhAE56Wzbl45TAa8Lc2ezHQuYx0S3calOUpHbEn3AUZ5P4 C1RQZCn/Rs+HuIjdESxzm1Ah+dkoPkiOSzp6RHQ28NszgRNnrJ8/C+CRp5sgF3Gw6Ghq DSqeao+XDBbFyiTAMca+fzKiIV0bEY674hgF+cpL/SmmZ+04IOkzshkteBJygkXu1ioK fVTA== X-Gm-Message-State: ALoCoQldwfjJh5JWfK7542rhRa2JvYMiSYMC+KF4n7ytmO1s3O7jeDeEOrU5XfcExX03ZiB95BNB X-Received: by 10.224.5.5 with SMTP id 5mr15291832qat.4.1380101236119; Wed, 25 Sep 2013 02:27:16 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.49.99.106 with SMTP id ep10ls291114qeb.59.gmail; Wed, 25 Sep 2013 02:27:16 -0700 (PDT) X-Received: by 10.220.94.206 with SMTP id a14mr5546965vcn.19.1380101236022; Wed, 25 Sep 2013 02:27:16 -0700 (PDT) Received: from mail-vc0-f172.google.com (mail-vc0-f172.google.com [209.85.220.172]) by mx.google.com with ESMTPS id nr7si9582720vec.27.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 25 Sep 2013 02:27:16 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.172 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.172; Received: by mail-vc0-f172.google.com with SMTP id hu8so4180852vcb.17 for ; Wed, 25 Sep 2013 02:27:15 -0700 (PDT) X-Received: by 10.58.117.71 with SMTP id kc7mr32132976veb.16.1380101235924; Wed, 25 Sep 2013 02:27:15 -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 u4csp294134vcz; Wed, 25 Sep 2013 02:27:15 -0700 (PDT) X-Received: by 10.66.163.199 with SMTP id yk7mr16151355pab.136.1380101234696; Wed, 25 Sep 2013 02:27:14 -0700 (PDT) Received: from mail-pa0-f53.google.com (mail-pa0-f53.google.com [209.85.220.53]) by mx.google.com with ESMTPS id ar2si7228552pbc.142.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 25 Sep 2013 02:27:14 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.53 is neither permitted nor denied by best guess record for domain of anup.patel@linaro.org) client-ip=209.85.220.53; Received: by mail-pa0-f53.google.com with SMTP id kq14so4914889pab.40 for ; Wed, 25 Sep 2013 02:27:14 -0700 (PDT) X-Received: by 10.66.65.108 with SMTP id w12mr9989710pas.183.1380101234290; Wed, 25 Sep 2013 02:27:14 -0700 (PDT) Received: from pnqlab006.amcc.com ([182.73.239.130]) by mx.google.com with ESMTPSA id k4sm46364649pbd.11.1969.12.31.16.00.00 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 25 Sep 2013 02:27:13 -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, pranavkumar@linaro.org, Anup Patel Subject: =?UTF-8?q?=5BPATCH=20v4=204/4=5D=20KVM=3A=20Add=20documentation=20for=20KVM=5FARM=5FPREFERRED=5FTARGET=20ioctl?= Date: Wed, 25 Sep 2013 14:56:03 +0530 Message-Id: <1380101163-20028-5-git-send-email-anup.patel@linaro.org> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1380101163-20028-1-git-send-email-anup.patel@linaro.org> References: <1380101163-20028-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.172 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 vm 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 vm ioctl in the KVM API documentation. Signed-off-by: Anup Patel Signed-off-by: Pranavkumar Sawargaonkar --- Documentation/virtual/kvm/api.txt | 27 +++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt index 858aecf..f31e6e8 100644 --- a/Documentation/virtual/kvm/api.txt +++ b/Documentation/virtual/kvm/api.txt @@ -2303,8 +2303,28 @@ 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: vm ioctl +Parameters: struct struct kvm_vcpu_init (out) +Returns: 0 on success; -1 on error +Errors: +  ENODEV:    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 target specific 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 +2343,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 +2381,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