Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp2701512yba; Mon, 6 May 2019 10:11:33 -0700 (PDT) X-Google-Smtp-Source: APXvYqxuIUY+R0rf33IFZy/SaR6eIkQdIv2Pv0sYYqxzGnzVZTlleUxn2TWYFDxoSRrOrk4gkBnh X-Received: by 2002:a63:5d3:: with SMTP id 202mr32492881pgf.363.1557162693805; Mon, 06 May 2019 10:11:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1557162693; cv=none; d=google.com; s=arc-20160816; b=F5EvN68jNHdzimJ+3ej4JJp8gYt2/oVwM+lbaPANpn/AIidlUsZbPqXAEDfygUVMGB 2x5/4q0Sax0ped5MAPkfwWgbag6xTnMK7t8n25j2wPTc2zBZeojKYxJ8XDYXF0+CMhQN /Ye1ySGiCxeCDouQBCOw1gmeoOSlUel86GjhW2kLVMyCV0ANv/6DNFWvkSYvB2jl5LQn uOUCpuLhQqqpGMh3+P5+Dxyv7CuOpAIC/kogtRg/DCuA9XeH5gxlgbnqPFEXdUc3SMsf kP13YKYv93qMdRVbciQFjZN/PBYm6DbZ0Xpk//FVHv1ZFIqfr7lhOFAqVQfVPB4s5Due 6JWw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=N/f/jIMsYHsxInKx5Thoz667919hjo32hAsH6s5W2Nc=; b=yCHkaaUsit7kCj2Fd26sIuY+meUbc26v+gb1TW3y0/Fg8UlvGUWLcBxC8GuesL9sCE xNJM7a7ebIXJFbYsIfZOkvdoHnphk7HptmtprgGh6owFkVe0c0nPmx1AY3WcyaKts+VI hIykpkJi0lWchZ8hW1Fe2BZcn5qjHCHzm8p9d3vzR83UspYx4VqHgLq+L7ojKxq6B9DD 6Ek+rjMTbjESZPlI3i12CFkC1Mb2iMY+/JsLXwW8oF9970FvudXEI2+g/GwCmC5mdEfw 1t3uIhKmjLCbvkhb/cWEpwAKAcUvBP1QlFwhf56CZUYE8msECnXbMetm4vRb3mJ6UE06 dUeQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=bz8cgoJ4; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a25si14971884pff.119.2019.05.06.10.11.17; Mon, 06 May 2019 10:11:33 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=bz8cgoJ4; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727223AbfEFRKJ (ORCPT + 99 others); Mon, 6 May 2019 13:10:09 -0400 Received: from mail-pl1-f195.google.com ([209.85.214.195]:46646 "EHLO mail-pl1-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727198AbfEFRKI (ORCPT ); Mon, 6 May 2019 13:10:08 -0400 Received: by mail-pl1-f195.google.com with SMTP id bi2so6662990plb.13; Mon, 06 May 2019 10:10:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=N/f/jIMsYHsxInKx5Thoz667919hjo32hAsH6s5W2Nc=; b=bz8cgoJ4IL+PnO8LTT+P4gz3bGjO1o3W9Ds357BZFcZOGSazV6u6u5nlYfrsVgIkFb jQliTMbWhSjrr+r4ub42Bcxz4WeYzqwHLDHhTBwfQ0YIbIT5nF7Jz71rfmUdRsFsLNWM k/Sn/aWT82OVzxiMdoYFV9AikNSFY8kVX7a1nnmJ9sN/T0D6WzM5rfSANxK0EsMYjduK gWGIVca39TlaEa5pSBHGs10R8WgPl1R+niA36zkBih3e1XP9HmiNyJcdFM2sJhLC5KBH Gi5iprZbDLUAZePFKip7sLeKvmNObCJLvoWHwhalb1bsAuDHpMmJ8Rk9/c4KyJ5NR2lP PPxA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=N/f/jIMsYHsxInKx5Thoz667919hjo32hAsH6s5W2Nc=; b=GitJDKtJGxeMkzsY4UDkgmi8ffKoTudpeVkCFfqNg6G9oO1/q1U1tsqE3uIrL9RdfU 9fsDp+sj9V8ed4bsZ/nhb5PdStKHswKAgLIQ3FrXtgTmUJsZ9NzkySWZ2lo8QTJ1JYHO UN9SmK/eQ4IE5mnBp0hWYCo/+At4DLZZglhp3TLqOaGCPw2qtGvHkjo+85bg8yTc1RL+ CxS1NZqxloinLt4VAuf/5gjKTItPMeU/F/TMkAFnfMx1FANmVzRcg2dDiZdsFhEzBsez N9kkxOabp89qpmPoIkD6Cm8eiGqzce/5h77Ry/1IDuVICGQojQuslh0UPERppsaBAgha Rf3g== X-Gm-Message-State: APjAAAV/vT6krCPxjX0m9vlsSIzmaoIQ4HrKUwQABySiKA1GZdc/Un2B QebwyrEkpv3Xv2ftyIun5gM= X-Received: by 2002:a17:902:2862:: with SMTP id e89mr34248560plb.203.1557162607460; Mon, 06 May 2019 10:10:07 -0700 (PDT) Received: from localhost.localdomain ([104.238.181.70]) by smtp.gmail.com with ESMTPSA id h13sm11045680pgk.55.2019.05.06.10.10.02 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Mon, 06 May 2019 10:10:06 -0700 (PDT) From: Changbin Du To: corbet@lwn.net, tglx@linutronix.de, mingo@redhat.com, bp@alien8.de Cc: x86@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Changbin Du , Mauro Carvalho Chehab Subject: [PATCH v3 05/27] Documentation: x86: convert kernel-stacks to reST Date: Tue, 7 May 2019 01:09:01 +0800 Message-Id: <20190506170923.7117-6-changbin.du@gmail.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190506170923.7117-1-changbin.du@gmail.com> References: <20190506170923.7117-1-changbin.du@gmail.com> 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 This converts the plain text documentation to reStructuredText format and add it to Sphinx TOC tree. No essential content change. Signed-off-by: Changbin Du Reviewed-by: Mauro Carvalho Chehab --- Documentation/x86/index.rst | 1 + .../x86/{kernel-stacks => kernel-stacks.rst} | 20 ++++++++++++------- 2 files changed, 14 insertions(+), 7 deletions(-) rename Documentation/x86/{kernel-stacks => kernel-stacks.rst} (92%) diff --git a/Documentation/x86/index.rst b/Documentation/x86/index.rst index c855b730bab4..f6f4e0fc79f2 100644 --- a/Documentation/x86/index.rst +++ b/Documentation/x86/index.rst @@ -11,3 +11,4 @@ x86-specific Documentation boot topology exception-tables + kernel-stacks diff --git a/Documentation/x86/kernel-stacks b/Documentation/x86/kernel-stacks.rst similarity index 92% rename from Documentation/x86/kernel-stacks rename to Documentation/x86/kernel-stacks.rst index 9a0aa4d3a866..c7c7afce086f 100644 --- a/Documentation/x86/kernel-stacks +++ b/Documentation/x86/kernel-stacks.rst @@ -1,5 +1,11 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============= +Kernel Stacks +============= + Kernel stacks on x86-64 bit ---------------------------- +=========================== Most of the text from Keith Owens, hacked by AK @@ -57,7 +63,7 @@ IST events with the same code to be nested. However in most cases, the stack size allocated to an IST assumes no nesting for the same code. If that assumption is ever broken then the stacks will become corrupt. -The currently assigned IST stacks are :- +The currently assigned IST stacks are: * DOUBLEFAULT_STACK. EXCEPTION_STKSZ (PAGE_SIZE). @@ -98,7 +104,7 @@ For more details see the Intel IA32 or AMD AMD64 architecture manuals. Printing backtraces on x86 --------------------------- +========================== The question about the '?' preceding function names in an x86 stacktrace keeps popping up, here's an indepth explanation. It helps if the reader @@ -108,7 +114,7 @@ arch/x86/kernel/dumpstack.c. Adapted from Ingo's mail, Message-ID: <20150521101614.GA10889@gmail.com>: We always scan the full kernel stack for return addresses stored on -the kernel stack(s) [*], from stack top to stack bottom, and print out +the kernel stack(s) [1]_, from stack top to stack bottom, and print out anything that 'looks like' a kernel text address. If it fits into the frame pointer chain, we print it without a question @@ -136,6 +142,6 @@ that look like kernel text addresses, so if debug information is wrong, we still print out the real call chain as well - just with more question marks than ideal. -[*] For things like IRQ and IST stacks, we also scan those stacks, in - the right order, and try to cross from one stack into another - reconstructing the call chain. This works most of the time. +.. [1] For things like IRQ and IST stacks, we also scan those stacks, in + the right order, and try to cross from one stack into another + reconstructing the call chain. This works most of the time. -- 2.20.1