From patchwork Wed Jan 14 12:53:49 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Julien Grall X-Patchwork-Id: 43103 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-wi0-f198.google.com (mail-wi0-f198.google.com [209.85.212.198]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 919B420D60 for ; Wed, 14 Jan 2015 12:56:37 +0000 (UTC) Received: by mail-wi0-f198.google.com with SMTP id n3sf5054806wiv.1 for ; Wed, 14 Jan 2015 04:56:36 -0800 (PST) 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:date:message-id:cc:subject :precedence:list-id:list-unsubscribe:list-post:list-help :list-subscribe:mime-version:content-type:content-transfer-encoding :sender:errors-to:x-original-sender :x-original-authentication-results:mailing-list:list-archive; bh=87nOMOwTqAhbL8taYYKVpuCTBu77kNEHVAmFn2Mkjzg=; b=eNrdfQMGqWOM6aWmf8akyXyxS6E/3tEF3hSpZnqPhqpO8mjOdMvVW/f7xF5+Z0n3c/ zL1bJxcuTWceFxo/MK+59jQbpkWqpZkIP9/3AuyTZXsLaWm47/kz9zTnrrEwxeIAKB5f CsRbGTs4OUIlv74JXGYymenVN3cW0wUwjLpC6WXObkw/HsosQCNU9iKE4B2uPhtVfj1Z eKtSAFAYoC9fMl2g+ZTW7l7lYLWFMQVxbr79JCTUsRmp7kQxTdNu8PjcbMgzdmosUfxw UUyIiu2a4KXv7V+yP7JELLVwFDU3DhakpYN+xf25fT7b51AV9ohBRFlemXwMEnt7lKWE co9w== X-Gm-Message-State: ALoCoQlRU9thYRO4sA2xpFHLRF7IkOTHF0IKtFzTOSlc5P02+ideOLAmcCQESnpNskWKaWo8TbVK X-Received: by 10.152.7.99 with SMTP id i3mr88950laa.9.1421240196861; Wed, 14 Jan 2015 04:56:36 -0800 (PST) X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.18.134 with SMTP id w6ls107095lad.63.gmail; Wed, 14 Jan 2015 04:56:36 -0800 (PST) X-Received: by 10.152.5.132 with SMTP id s4mr3755360las.39.1421240196648; Wed, 14 Jan 2015 04:56:36 -0800 (PST) Received: from mail-la0-f52.google.com (mail-la0-f52.google.com. [209.85.215.52]) by mx.google.com with ESMTPS id s8si5886535lae.16.2015.01.14.04.56.36 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 14 Jan 2015 04:56:36 -0800 (PST) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.52 as permitted sender) client-ip=209.85.215.52; Received: by mail-la0-f52.google.com with SMTP id hs14so7913051lab.11 for ; Wed, 14 Jan 2015 04:56:36 -0800 (PST) X-Received: by 10.152.115.146 with SMTP id jo18mr3854289lab.9.1421240196512; Wed, 14 Jan 2015 04:56:36 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.9.200 with SMTP id c8csp1687189lbb; Wed, 14 Jan 2015 04:56:35 -0800 (PST) X-Received: by 10.224.45.195 with SMTP id g3mr6118896qaf.59.1421240195022; Wed, 14 Jan 2015 04:56:35 -0800 (PST) Received: from lists.xen.org (lists.xen.org. [50.57.142.19]) by mx.google.com with ESMTPS id 96si30803141qgi.114.2015.01.14.04.56.34 (version=TLSv1 cipher=RC4-SHA bits=128/128); Wed, 14 Jan 2015 04:56:35 -0800 (PST) Received-SPF: none (google.com: xen-devel-bounces@lists.xen.org does not designate permitted sender hosts) client-ip=50.57.142.19; Received: from localhost ([127.0.0.1] helo=lists.xen.org) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1YBNSo-0002Gt-1Q; Wed, 14 Jan 2015 12:54:22 +0000 Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1YBNSm-0002Go-UJ for xen-devel@lists.xenproject.org; Wed, 14 Jan 2015 12:54:21 +0000 Received: from [85.158.139.211] by server-14.bemta-5.messagelabs.com id 56/CE-19763-CF666B45; Wed, 14 Jan 2015 12:54:20 +0000 X-Env-Sender: julien.grall@linaro.org X-Msg-Ref: server-8.tower-206.messagelabs.com!1421240059!14072390!1 X-Originating-IP: [209.85.212.171] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 6.12.5; banners=-,-,- X-VirusChecked: Checked Received: (qmail 1079 invoked from network); 14 Jan 2015 12:54:19 -0000 Received: from mail-wi0-f171.google.com (HELO mail-wi0-f171.google.com) (209.85.212.171) by server-8.tower-206.messagelabs.com with RC4-SHA encrypted SMTP; 14 Jan 2015 12:54:19 -0000 Received: by mail-wi0-f171.google.com with SMTP id bs8so27928076wib.4 for ; Wed, 14 Jan 2015 04:54:19 -0800 (PST) X-Received: by 10.194.187.79 with SMTP id fq15mr7294145wjc.2.1421240059222; Wed, 14 Jan 2015 04:54:19 -0800 (PST) Received: from chilopoda.uk.xensource.com. ([185.25.64.249]) by mx.google.com with ESMTPSA id gf9sm11071672wjc.0.2015.01.14.04.54.17 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 14 Jan 2015 04:54:18 -0800 (PST) From: Julien Grall To: xen-devel@lists.xenproject.org Date: Wed, 14 Jan 2015 12:53:49 +0000 Message-Id: <1421240029-9478-1-git-send-email-julien.grall@linaro.org> X-Mailer: git-send-email 2.1.4 Cc: Keir Fraser , ian.campbell@citrix.com, tim@xen.org, Julien Grall , Ian Jackson , stefano.stabellini@citrix.com, Jan Beulich Subject: [Xen-devel] [PATCH] xen/arm: Update documentation in the public header arch-arm.h X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Post: , List-Help: , List-Subscribe: , MIME-Version: 1.0 Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: julien.grall@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.52 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Archive: Minor updates to the documentation in xen/include/public/arch-arm.h: - Comments coding style fix - Typoes - Update the list of supported hypercalls by ARM - Remove uncessary comment about 64bit. Signed-off-by: Julien Grall Cc: Ian Jackson Cc: Jan Beulich Cc: Keir Fraser --- I'm not sure if we usually backport documentation. If so, I'd like to request backporting for Xen 4.5. --- xen/include/public/arch-arm.h | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/xen/include/public/arch-arm.h b/xen/include/public/arch-arm.h index 72d641f..ae294fa 100644 --- a/xen/include/public/arch-arm.h +++ b/xen/include/public/arch-arm.h @@ -87,15 +87,10 @@ * unavailable/unsupported. * * HYPERVISOR_memory_op - * All generic sub-operations. - * - * In addition the following arch specific sub-ops: - * * XENMEM_add_to_physmap - * * XENMEM_add_to_physmap_batch + * All generic sub-operations * * HYPERVISOR_domctl * All generic sub-operations, with the exception of: - * * XEN_DOMCTL_iomem_permission (not yet implemented) * * XEN_DOMCTL_irq_permission (not yet implemented) * * HYPERVISOR_sched_op @@ -183,7 +178,7 @@ * XEN_GUEST_HANDLE represents a guest pointer, when passed as a field * in a struct in memory. On ARM is always 8 bytes sizes and 8 bytes * aligned. - * XEN_GUEST_HANDLE_PARAM represent a guest pointer, when passed as an + * XEN_GUEST_HANDLE_PARAM represents a guest pointer, when passed as an * hypercall argument. It is 4 bytes on aarch and 8 bytes on aarch64. */ #define __DEFINE_XEN_GUEST_HANDLE(name, type) \ @@ -192,7 +187,6 @@ #define DEFINE_XEN_GUEST_HANDLE(name) __DEFINE_XEN_GUEST_HANDLE(name, name) #define __XEN_GUEST_HANDLE(name) __guest_handle_64_ ## name #define XEN_GUEST_HANDLE(name) __XEN_GUEST_HANDLE(name) -/* this is going to be changed on 64 bit */ #define XEN_GUEST_HANDLE_PARAM(name) __guest_handle_ ## name #define set_xen_guest_handle_raw(hnd, val) \ do { \ @@ -318,7 +312,7 @@ typedef uint64_t xen_callback_t; #if defined(__XEN__) || defined(__XEN_TOOLS__) -/* PSR bits (CPSR, SPSR)*/ +/* PSR bits (CPSR, SPSR) */ #define PSR_THUMB (1<<5) /* Thumb Mode enable */ #define PSR_FIQ_MASK (1<<6) /* Fast Interrupt mask */ @@ -374,7 +368,8 @@ typedef uint64_t xen_callback_t; /* Physical Address Space */ -/* vGIC mappings: Only one set of mapping is used by the guest. +/* + * vGIC mappings: Only one set of mapping is used by the guest. * Therefore they can overlap. */ @@ -394,7 +389,8 @@ typedef uint64_t xen_callback_t; #define GUEST_GICV3_GICR0_BASE 0x03020000ULL /* vCPU0 - vCPU7 */ #define GUEST_GICV3_GICR0_SIZE 0x00100000ULL -/* 16MB == 4096 pages reserved for guest to use as a region to map its +/* + * 16MB == 4096 pages reserved for guest to use as a region to map its * grant table in. */ #define GUEST_GNTTAB_BASE 0x38000000ULL