From patchwork Wed Jun 3 12:43:41 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marek Szyprowski X-Patchwork-Id: 1302974 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=pass (p=none dis=none) header.from=samsung.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=samsung.com header.i=@samsung.com header.a=rsa-sha256 header.s=mail20170921 header.b=u4lJjJS1; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 49cTBM74Hfz9sSc for ; Wed, 3 Jun 2020 22:44:25 +1000 (AEST) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 1485D81D4C; Wed, 3 Jun 2020 14:44:14 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=samsung.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=samsung.com header.i=@samsung.com header.b="u4lJjJS1"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 2500881D51; Wed, 3 Jun 2020 14:44:12 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.2 Received: from mailout2.w1.samsung.com (mailout2.w1.samsung.com [210.118.77.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id DC75680476 for ; Wed, 3 Jun 2020 14:44:06 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=samsung.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=m.szyprowski@samsung.com Received: from eucas1p1.samsung.com (unknown [182.198.249.206]) by mailout2.w1.samsung.com (KnoxPortal) with ESMTP id 20200603124405euoutp0276f64776ab75d192ae65226ef127fe90~VCUd3m-Dc2907529075euoutp02B for ; Wed, 3 Jun 2020 12:44:05 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 mailout2.w1.samsung.com 20200603124405euoutp0276f64776ab75d192ae65226ef127fe90~VCUd3m-Dc2907529075euoutp02B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=samsung.com; s=mail20170921; t=1591188245; bh=jRjdnc0IPgVzyJAhO3XxNR7FWhaOHS0zmca5Nj9Igsk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=u4lJjJS1gyF8mPkiu/++MwyOZ9x/3rzCyM7Dmfs3Oh2bks/VIqUXhUvkaAnKrpewa 7cxaa0jxdCvPJkJJakElSN/pd1agOAIlXZvB0Fv2/7vkx1SVOiuG3BnP8eu/bmddSu +nZvap0MHmKMiI2rOHguwXBddQb7n05E1QGcmXIk= Received: from eusmges3new.samsung.com (unknown [203.254.199.245]) by eucas1p2.samsung.com (KnoxPortal) with ESMTP id 20200603124405eucas1p2303898f76e68aeffb61e2c5d7de2480b~VCUdimeMz1241312413eucas1p27; Wed, 3 Jun 2020 12:44:05 +0000 (GMT) Received: from eucas1p2.samsung.com ( [182.198.249.207]) by eusmges3new.samsung.com (EUCPMTA) with SMTP id D3.38.60698.51B97DE5; Wed, 3 Jun 2020 13:44:05 +0100 (BST) Received: from eusmtrp2.samsung.com (unknown [182.198.249.139]) by eucas1p2.samsung.com (KnoxPortal) with ESMTPA id 20200603124405eucas1p22471280b162f8d0e1a863b2c48f122f4~VCUdJUPQ51601316013eucas1p24; Wed, 3 Jun 2020 12:44:05 +0000 (GMT) Received: from eusmgms1.samsung.com (unknown [182.198.249.179]) by eusmtrp2.samsung.com (KnoxPortal) with ESMTP id 20200603124405eusmtrp26cc7b4d3aabb89ad5c7653da59f3cc59~VCUdInXBz0795607956eusmtrp2S; Wed, 3 Jun 2020 12:44:05 +0000 (GMT) X-AuditID: cbfec7f5-a29ff7000001ed1a-e3-5ed79b15ddfb Received: from eusmtip1.samsung.com ( [203.254.199.221]) by eusmgms1.samsung.com (EUCPMTA) with SMTP id 74.BC.08375.41B97DE5; Wed, 3 Jun 2020 13:44:05 +0100 (BST) Received: from AMDC2765.digital.local (unknown [106.120.51.73]) by eusmtip1.samsung.com (KnoxPortal) with ESMTPA id 20200603124404eusmtip132942d6971cfca36525be66e7a8b1f1f~VCUcPynIG1799017990eusmtip1B; Wed, 3 Jun 2020 12:44:04 +0000 (GMT) From: Marek Szyprowski To: u-boot@lists.denx.de Cc: Marek Szyprowski , Matthias Brugger , Tom Rini , Sylwester Nawrocki , Wolfgang Denk , Marek Vasut , Bin Meng , Nicolas Saenz Julienne , Simon Glass , Jaehoon Chung , Bartlomiej Zolnierkiewicz Subject: [PATCH v5 2/6] arm: update comments to the common style Date: Wed, 3 Jun 2020 14:43:41 +0200 Message-Id: <20200603124345.18595-3-m.szyprowski@samsung.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20200603124345.18595-1-m.szyprowski@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrMKsWRmVeSWpSXmKPExsWy7djP87qis6/HGdy8LW+xccZ6VoupPfEW N361sVqsPXKX3eJNWyOjxYLJT1gtts1azmZx+E07q8W3LdsYLaZO2sxu8XZvJ7vF5IevGB14 PGY3XGTxmDfrBIvHzll32T1eHVjF7nH2zg5Gj74tqxg91m+5yuKx+XR1AEcUl01Kak5mWWqR vl0CV8aSE2tZCpaIVnQsmc7cwHhFoIuRk0NCwETi66nX7F2MXBxCAisYJU69WsIC4XxhlHh7 6SYzhPMZyOmcyArT8v3YKiaIxHJGiR9/XjLDtbx6dh2sik3AUKLrbRcbiC0iICHxq/8qI0gR s8AWZolZ894xgySEBRwk9jyYwgRiswioSkz/2cgIYvMK2EosmNLHArFOXmL1hgNg9ZwCdhL/ t21iBRkkIbCOXeL3/QYghwPIcZH4upYZol5Y4tXxLewQtozE/53zmSDqmxklHp5byw7h9DBK XG6awQhRZS1x59wvNpBBzAKaEut36UOEHSW+TPjPBDGfT+LGW0GQMDOQOWnbdGaIMK9ER5sQ RLWaxKzj6+DWHrxwCeocD4kpf8+Dw0RIYCKjxMVP0RMY5Wch7FrAyLiKUTy1tDg3PbXYOC+1 XK84Mbe4NC9dLzk/dxMjMOmc/nf86w7GfX+SDjEKcDAq8fAy1F2PE2JNLCuuzD3EKMHBrCTC 63T2dJwQb0piZVVqUX58UWlOavEhRmkOFiVxXuNFL2OFBNITS1KzU1MLUotgskwcnFINjN2Z Ty9tj3Opy7pg5yEWz/BW3PoZO2vVaq9/OrPKC9YIG9ioWOXozzcOuO9duf6kcVP9zyeWE+Tm /lr3/ebvXbtdjxexFXZzyxYebJrsu2XJl8evt0jeFZyxp+fz102ek4tbeb5Hs/IsvqTUtb1u QoWRl2efuIGBcsux0tqF6mdFmvqntTeXK7EUZyQaajEXFScCAEAa7YQ2AwAA X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmphkeLIzCtJLcpLzFFi42I5/e/4XV3R2dfjDFY9YLXYOGM9q8XUnniL G7/aWC3WHrnLbvGmrZHRYsHkJ6wW22YtZ7M4/Kad1eLblm2MFlMnbWa3eLu3k91i8sNXjA48 HrMbLrJ4zJt1gsVj56y77B6vDqxi9zh7ZwejR9+WVYwe67dcZfHYfLo6gCNKz6Yov7QkVSEj v7jEVina0MJIz9DSQs/IxFLP0Ng81srIVEnfziYlNSezLLVI3y5BL2PJibUsBUtEKzqWTGdu YLwi0MXIySEhYCLx/dgqpi5GLg4hgaWMEn1NL1ghEjISJ6c1QNnCEn+udbFBFH1ilNj6chsT SIJNwFCi6y1IgpNDREBC4lf/VUaQImaBPcwST19fAisSFnCQ2PNgCpjNIqAqMf1nIyOIzStg K7FgSh8LxAZ5idUbDjCD2JwCdhL/t20C2swBtM1W4vxdpwmMfAsYGVYxiqSWFuem5xYb6hUn 5haX5qXrJefnbmIExsC2Yz8372C8tDH4EKMAB6MSDy9D3fU4IdbEsuLK3EOMEhzMSiK8TmdP xwnxpiRWVqUW5ccXleakFh9iNAW6aSKzlGhyPjA+80riDU0NzS0sDc2NzY3NLJTEeTsEDsYI CaQnlqRmp6YWpBbB9DFxcEo1MLZ2/BCqmXe8yqIgK/GpB+M9xbqdO9Z19L5Qazo8a1VbWPi0 jqWLbNpeZGfrxTYUTIy6N8n24IxWjlMPCrXTZRaIvdg2cYJ62OJVl/N7/ui7n7quytx1WrOd Y/7B2fvDdx29vIK/e/Hbm2ftjvQpB1mmbghQnsvmvvAQU/aJz3WSl6e3Xj8mdVaJpTgj0VCL uag4EQBpHsNmlwIAAA== X-CMS-MailID: 20200603124405eucas1p22471280b162f8d0e1a863b2c48f122f4 X-Msg-Generator: CA X-RootMTR: 20200603124405eucas1p22471280b162f8d0e1a863b2c48f122f4 X-EPHeader: CA CMS-TYPE: 201P X-CMS-RootMailID: 20200603124405eucas1p22471280b162f8d0e1a863b2c48f122f4 References: <20200603124345.18595-1-m.szyprowski@samsung.com> X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.30rc1 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.102.2 at phobos.denx.de X-Virus-Status: Clean Update the comments in include/asm/system.h to the common style. Signed-off-by: Marek Szyprowski Reviewed-by: Tom Rini --- arch/arm/include/asm/system.h | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/arch/arm/include/asm/system.h b/arch/arm/include/asm/system.h index 1e3f574..63649ed 100644 --- a/arch/arm/include/asm/system.h +++ b/arch/arm/include/asm/system.h @@ -205,7 +205,7 @@ int __asm_invalidate_l3_icache(void); void __asm_switch_ttbr(u64 new_ttbr); /* - * Switch from EL3 to EL2 for ARMv8 + * armv8_switch_to_el2() - switch from EL3 to EL2 for ARMv8 * * @args: For loading 64-bit OS, fdt address. * For loading 32-bit OS, zero. @@ -220,7 +220,7 @@ void __asm_switch_ttbr(u64 new_ttbr); void __noreturn armv8_switch_to_el2(u64 args, u64 mach_nr, u64 fdt_addr, u64 arg4, u64 entry_point, u64 es_flag); /* - * Switch from EL2 to EL1 for ARMv8 + * armv8_switch_to_el1() - switch from EL2 to EL1 for ARMv8 * * @args: For loading 64-bit OS, fdt address. * For loading 32-bit OS, zero. @@ -246,11 +246,12 @@ void flush_l3_cache(void); void mmu_change_region_attr(phys_addr_t start, size_t size, u64 attrs); /* - *Issue a secure monitor call in accordance with ARM "SMC Calling convention", + * smc_call() - issue a secure monitor call + * + * Issue a secure monitor call in accordance with ARM "SMC Calling convention", * DEN0028A * * @args: input and output arguments - * */ void smc_call(struct pt_regs *args); @@ -519,10 +520,12 @@ enum { #endif /** + * mmu_page_table_flush() - register an update to page tables + * * Register an update to the page tables, and flush the TLB * - * \param start start address of update in page table - * \param stop stop address of update in page table + * @start: start address of update in page table + * @stop: stop address of update in page table */ void mmu_page_table_flush(unsigned long start, unsigned long stop); @@ -582,11 +585,13 @@ s32 psci_features(u32 function_id, u32 psci_fid); void save_boot_params_ret(void); /** + * mmu_set_region_dcache_behaviour() - set cache settings + * * Change the cache settings for a region. * - * \param start start address of memory region to change - * \param size size of memory region to change - * \param option dcache option to select + * @start: start address of memory region to change + * @size: size of memory region to change + * @option: dcache option to select */ void mmu_set_region_dcache_behaviour(phys_addr_t start, size_t size, enum dcache_option option);