From patchwork Wed Sep 11 12:59:53 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 19971 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qc0-f200.google.com (mail-qc0-f200.google.com [209.85.216.200]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id D61B4248D9 for ; Wed, 11 Sep 2013 13:00:51 +0000 (UTC) Received: by mail-qc0-f200.google.com with SMTP id x20sf10510483qcv.3 for ; Wed, 11 Sep 2013 06:00:51 -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=SXEx6hDTtcXq7Ym2UoezG8DL7ng+Ig2GvOWgU21BReQ=; b=BkO9qzJyWyldSHs3pTqiY6QpGG4HthlDLWqRrUpSz+eSJI4jejuVVgeauC5PdXevzc iI1GTKEzC2Hav14IPl4td2pidPrXY37S2qsdheZPm//PWj04sFIgfIhUSbvjcWiZKv0m 5PeFXiCmAD3unxLbVEXjs6LzBonmqQ5XobDrqTw596Kb5ZAs4UzZK/ToRm19gAL4ecLB P3XjdrCO2/qKJweqtwK434Oo+XVvpxCMuVXz0P182zHe8N15iXsdXHE/oSGeQbRd2JZT 0osXLxN0vQkUJ4JGsTMqim3ESSejBmogurE58lGkdtweQIMkUo2TiBPSzCAdJaWTRmGI AD6g== X-Received: by 10.236.18.196 with SMTP id l44mr610941yhl.52.1378904451680; Wed, 11 Sep 2013 06:00:51 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.49.121.104 with SMTP id lj8ls244526qeb.11.gmail; Wed, 11 Sep 2013 06:00:51 -0700 (PDT) X-Received: by 10.220.164.70 with SMTP id d6mr1141818vcy.19.1378904451428; Wed, 11 Sep 2013 06:00:51 -0700 (PDT) Received: from mail-vc0-f171.google.com (mail-vc0-f171.google.com [209.85.220.171]) by mx.google.com with ESMTPS id gq6si5971155veb.53.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 11 Sep 2013 06:00:51 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.171 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.171; Received: by mail-vc0-f171.google.com with SMTP id ij15so6072725vcb.16 for ; Wed, 11 Sep 2013 06:00:51 -0700 (PDT) X-Gm-Message-State: ALoCoQkitZISuQiR0PnbRqFJsbgNHOBR5NzE+htK1HnSdbbdhjMvVNiLeC9kk5l35OTLay0fJtFg X-Received: by 10.58.133.66 with SMTP id pa2mr1178167veb.18.1378904451335; Wed, 11 Sep 2013 06:00:51 -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 u4csp54884vcz; Wed, 11 Sep 2013 06:00:50 -0700 (PDT) X-Received: by 10.68.197.200 with SMTP id iw8mr1510315pbc.197.1378904450226; Wed, 11 Sep 2013 06:00:50 -0700 (PDT) Received: from mail-pd0-f175.google.com (mail-pd0-f175.google.com [209.85.192.175]) by mx.google.com with ESMTPS id sl4si2294689pac.329.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 11 Sep 2013 06:00:50 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.192.175 is neither permitted nor denied by best guess record for domain of anup.patel@linaro.org) client-ip=209.85.192.175; Received: by mail-pd0-f175.google.com with SMTP id q10so9110249pdj.6 for ; Wed, 11 Sep 2013 06:00:49 -0700 (PDT) X-Received: by 10.67.4.197 with SMTP id cg5mr3534651pad.10.1378904449743; Wed, 11 Sep 2013 06:00:49 -0700 (PDT) Received: from pnqlab006.amcc.com ([182.73.239.130]) by mx.google.com with ESMTPSA id ef10sm3494780pac.1.1969.12.31.16.00.00 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 11 Sep 2013 06:00:48 -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 Subject: =?UTF-8?q?=5BPATCH=202/2=5D=20KVM=3A=20Add=20documentation=20for=20KVM=5FARM=5FSUITABLE=5FTARGET=20ioctl?= Date: Wed, 11 Sep 2013 18:29:53 +0530 Message-Id: <1378904393-29101-3-git-send-email-anup.patel@linaro.org> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1378904393-29101-1-git-send-email-anup.patel@linaro.org> References: <1378904393-29101-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.171 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_SUITABLE_TARGET ioctl which provides a CPU target type to user space for creating VCPU matching underlying Host. This patch adds info related to this new KVM_ARM_SUITABLE_TARGET ioctl in the KVM API documentation. Signed-off-by: Anup Patel Signed-off-by: Pranavkumar Sawargaonkar + --- Documentation/virtual/kvm/api.txt | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt index ef925ea..1ae9721 100644 --- a/Documentation/virtual/kvm/api.txt +++ b/Documentation/virtual/kvm/api.txt @@ -2283,7 +2283,7 @@ current state. "addr" is ignored. Capability: basic Architectures: arm, arm64 Type: vcpu ioctl -Parameters: struct struct kvm_vcpu_init (in) +Parameters: struct kvm_vcpu_init (in) Returns: 0 on success; -1 on error Errors:  EINVAL:    the target is unknown, or the combination of features is invalid. @@ -2303,8 +2303,24 @@ 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_SUITABLE_TARGET -4.83 KVM_GET_REG_LIST +Capability: basic +Architectures: arm, arm64 +Type: vcpu ioctl +Parameters: None +Returns: 0 on success; -1 on error +Errors: +  EINVAL:    no suitable target available for the host + +This queries KVM for suitable CPU target type which can be emulated by +KVM on underlying host. This is not a mandatory API and could be used +to create VCPUs matching underlying host. + +The ioctl returns a target type which can be directly passed-back to +the KVM_ARM_VCPU_INIT ioctl. + +4.84 KVM_GET_REG_LIST Capability: basic Architectures: arm, arm64 @@ -2323,8 +2339,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 +2377,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