From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id DDEEDC47247 for ; Thu, 30 Apr 2020 16:18:56 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B6719208C3 for ; Thu, 30 Apr 2020 16:18:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1588263536; bh=tiWe5FzyBY3lLv+S2h54s5pLwV8IMienneyPdC0ziM0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=JbfSVlIV51WD+o6jrvyU6Hy7l779fWNgLddgPHD8EKAyZhJw2XInT9a+O+/0V9Ktj sNVjlRNOemEO7M89AAFKKAvLR1O+8b3W6GtbRYhClNleNOrItZS53rugwrzLSML07K UtD+zbDyYR+SJ4cQbjTDQFMZtlCS7COVXVY8RvaM= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728308AbgD3QSz (ORCPT ); Thu, 30 Apr 2020 12:18:55 -0400 Received: from mail.kernel.org ([198.145.29.99]:58762 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728147AbgD3QSk (ORCPT ); Thu, 30 Apr 2020 12:18:40 -0400 Received: from mail.kernel.org (ip5f5ad5c5.dynamic.kabel-deutschland.de [95.90.213.197]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 30D042496C; Thu, 30 Apr 2020 16:18:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1588263518; bh=tiWe5FzyBY3lLv+S2h54s5pLwV8IMienneyPdC0ziM0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QQzB+7vUTuW9wjsCOgHMPqeovDDNfA+m7xF1BW0InEv5jHQnf72IjygJhTq+ev5k0 TTS4mG3g3f0SqX+Xu5AEU3/DLp+O+SDHOJemu40XNW9HfNZABHGncejPR9ZR8ErOKz Mfk3GAbg2BwiVClBnCRpw5C+BT32B97nEJ85XNQc= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jUBtU-00Axhr-Ay; Thu, 30 Apr 2020 18:18:36 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Yoshinori Sato , Rich Felker , linux-sh@vger.kernel.org Subject: [PATCH v4 16/19] docs: sh: convert register-banks.txt to ReST Date: Thu, 30 Apr 2020 18:18:30 +0200 Message-Id: X-Mailer: git-send-email 2.25.4 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org - Add a SPDX header; - Adjust document title to follow ReST style; - Add blank lines to make ReST markup happy - Add it to sh/index.rst. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sh/index.rst | 1 + .../sh/{register-banks.txt => register-banks.rst} | 13 ++++++++++--- arch/sh/Kconfig.cpu | 2 +- 3 files changed, 12 insertions(+), 4 deletions(-) rename Documentation/sh/{register-banks.txt => register-banks.rst} (88%) diff --git a/Documentation/sh/index.rst b/Documentation/sh/index.rst index 56c08790265d..580f3b17e841 100644 --- a/Documentation/sh/index.rst +++ b/Documentation/sh/index.rst @@ -8,6 +8,7 @@ SuperH Interfaces Guide :maxdepth: 1 new-machine + register-banks Memory Management ================= diff --git a/Documentation/sh/register-banks.txt b/Documentation/sh/register-banks.rst similarity index 88% rename from Documentation/sh/register-banks.txt rename to Documentation/sh/register-banks.rst index a6719f2f6594..2bef5c8fcbbc 100644 --- a/Documentation/sh/register-banks.txt +++ b/Documentation/sh/register-banks.rst @@ -1,5 +1,8 @@ - Notes on register bank usage in the kernel - ========================================== +.. SPDX-License-Identifier: GPL-2.0 + +========================================== +Notes on register bank usage in the kernel +========================================== Introduction ------------ @@ -23,11 +26,15 @@ Presently the kernel uses several of these registers. - r0_bank, r1_bank (referenced as k0 and k1, used for scratch registers when doing exception handling). + - r2_bank (used to track the EXPEVT/INTEVT code) + - Used by do_IRQ() and friends for doing irq mapping based off of the interrupt exception vector jump table offset + - r6_bank (global interrupt mask) + - The SR.IMASK interrupt handler makes use of this to set the interrupt priority level (used by local_irq_enable()) + - r7_bank (current) - diff --git a/arch/sh/Kconfig.cpu b/arch/sh/Kconfig.cpu index 4a4edc7e03d4..07ad7597cbe7 100644 --- a/arch/sh/Kconfig.cpu +++ b/arch/sh/Kconfig.cpu @@ -94,7 +94,7 @@ config CPU_HAS_SR_RB that are lacking this bit must have another method in place for accomplishing what is taken care of by the banked registers. - See for further + See for further information on SR.RB and register banking in the kernel in general. config CPU_HAS_PTEAEX -- 2.25.4