Received: by 2002:a5d:9c59:0:0:0:0:0 with SMTP id 25csp574995iof; Mon, 6 Jun 2022 08:45:56 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwi8+exMeQtqUMk/FWDQbimIzLoLMMq6bcpwD7SrNrJw+kpbYz2WewWImCowmKoa8vPcRkv X-Received: by 2002:a17:90a:eb17:b0:1e2:f569:6b60 with SMTP id j23-20020a17090aeb1700b001e2f5696b60mr27221671pjz.48.1654530355865; Mon, 06 Jun 2022 08:45:55 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1654530355; cv=none; d=google.com; s=arc-20160816; b=VQhwCYnaIjXAAuErSOBIVKROmyu8oOfdMez0LmA8z4JXdUlwnLrqHL90Xd6saPLpHg p7PtWuGxCOSKgPV5Qzkiz55NhvffCZflHZEGqV19iGq7hI4wHaPNb9DEk4dL9XQEoRlA UZ8XohVZxBTBRZAv3+VvfNCq8kaILPwNOrlAepYUV0fF1swZ/7I/URdhtGkCJtsE+Ko8 CNf29q+HBa5bie6xZOF6l+pWKd3gtbFYxeBl6PH9QG4il4pDM9dXFgZfg52hESfogcB8 19RKAstAGkJuwE30JpFArKgdLVWsHH+EIaqXYGVVwPhejBRCsbS4NJ/QrBCKFZRTbb90 k6+g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=K5Vorvc9GgBkBmv+jM3YHqU00e13uWVJC0oc1wHPQDU=; b=TJNI72m14o0r4phx91dIbm3F831sZTwWddjcqC/uGK1bEmP92AB6Ze08yaYCt9RM61 y10Y/lAJRPUcUZImUMEPSqxYkXZimtJFUZnZPYnxu0JpkSwU6YXXK233x8mXViKtBSNU XWRaLjaPDE8ng3DKgnYiDFua9zOZyYQ0+2HQXpoRVctWsrnL1Os5p8lXrwLFUd4RUWE/ 9W08lbjrLc3euIsYZLaRTkDJ5w1ZkeGfUXOXhuluh9JgM/DNU7o8+Si6Zv7mvf7bTnfc ujshSkPGuEKIGlAUYxknVxXkIVunYfTrzDyZtnNSla3HluvcpnZdVrh0D/Rsl8aI0zvF oK+A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=dX+T7VFP; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [2620:137:e000::1:18]) by mx.google.com with ESMTPS id cn6-20020a056a00340600b0051bc4d20274si7568536pfb.23.2022.06.06.08.45.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jun 2022 08:45:55 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) client-ip=2620:137:e000::1:18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=dX+T7VFP; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 9A8C733E21; Mon, 6 Jun 2022 08:29:12 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240803AbiFFP1m (ORCPT + 99 others); Mon, 6 Jun 2022 11:27:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46290 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240609AbiFFPZy (ORCPT ); Mon, 6 Jun 2022 11:25:54 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6BDE81CD36D; Mon, 6 Jun 2022 08:25:52 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id E41DA61543; Mon, 6 Jun 2022 15:25:50 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 0DE74C36B0A; Mon, 6 Jun 2022 15:25:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1654529149; bh=DzHfRfTMaClgF8h/YljWNP6KKXvsPbgn8IYgJ+ecyLY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=dX+T7VFPPiYzevrey6Yv6HxUX0A5+Jn8bgmc2SKEiNoNcGAFI4mXwiMIxx4k0TuZS r+/9I7OOWyDfmtatc0tBfwZ3f/WjO48KeqicPQ2Fs3R1Ll21geyT1yDtPik1TsW3oP ViYlPW2j3RH3R8eAJ1bl2YeQBc1oiPorFY0Zz4PjmySDhU5qWn4sNai4Ut3LSbVYos kZr7eLdjgPWCueKcl+0IylJyBd9ROkukLpIh48/W8b/UXcIsOPcxf5Bnnpm4aJ/I8h eVFl1d9Tx+qFQiwN6S9JNbCPfD2jX++K72zYnsm8rn9WTqIqMCx1LzlRw3qdqncs01 zHizbdCmKssZQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1nyEby-0012Q0-Ex; Mon, 06 Jun 2022 16:25:46 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "H. Peter Anvin" , "Mauro Carvalho Chehab" , Andrew Morton , Borislav Petkov , Dan Williams , Daniel Latypov , Dave Hansen , Ingo Molnar , Isabella Basso , Josh Poimboeuf , Kees Cook , Masami Hiramatsu , Miroslav Benes , Nathan Chancellor , Peter Zijlstra , Rasmus Villemoes , Thomas Gleixner , Vlastimil Babka , linux-kernel@vger.kernel.org, x86@kernel.org Subject: [PATCH 21/23] objtool: update objtool.txt references Date: Mon, 6 Jun 2022 16:25:43 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-3.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, RDNS_NONE,SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Changeset a8e35fece49b ("objtool: Update documentation") renamed: tools/objtool/Documentation/stack-validation.txt to: tools/objtool/Documentation/objtool.txt. Update the cross-references accordingly. Fixes: a8e35fece49b ("objtool: Update documentation") Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH 00/23] at: https://lore.kernel.org/all/cover.1654529011.git.mchehab@kernel.org/ Documentation/x86/orc-unwinder.rst | 2 +- include/linux/objtool.h | 2 +- lib/Kconfig.debug | 2 +- tools/include/linux/objtool.h | 2 +- tools/objtool/check.c | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/x86/orc-unwinder.rst b/Documentation/x86/orc-unwinder.rst index 9a66a88be765..cdb257015bd9 100644 --- a/Documentation/x86/orc-unwinder.rst +++ b/Documentation/x86/orc-unwinder.rst @@ -140,7 +140,7 @@ Unwinder implementation details Objtool generates the ORC data by integrating with the compile-time stack metadata validation feature, which is described in detail in -tools/objtool/Documentation/stack-validation.txt. After analyzing all +tools/objtool/Documentation/objtool.txt. After analyzing all the code paths of a .o file, it creates an array of orc_entry structs, and a parallel array of instruction addresses associated with those structs, and writes them to the .orc_unwind and .orc_unwind_ip sections diff --git a/include/linux/objtool.h b/include/linux/objtool.h index 6491fa8fba6d..6f89471005ee 100644 --- a/include/linux/objtool.h +++ b/include/linux/objtool.h @@ -62,7 +62,7 @@ struct unwind_hint { * It should only be used in special cases where you're 100% sure it won't * affect the reliability of frame pointers and kernel stack traces. * - * For more information, see tools/objtool/Documentation/stack-validation.txt. + * For more information, see tools/objtool/Documentation/objtool.txt. */ #define STACK_FRAME_NON_STANDARD(func) \ static void __used __section(".discard.func_stack_frame_non_standard") \ diff --git a/lib/Kconfig.debug b/lib/Kconfig.debug index 2e24db4bff19..79a71eb96111 100644 --- a/lib/Kconfig.debug +++ b/lib/Kconfig.debug @@ -498,7 +498,7 @@ config STACK_VALIDATION runtime stack traces are more reliable. For more information, see - tools/objtool/Documentation/stack-validation.txt. + tools/objtool/Documentation/objtool.txt. config NOINSTR_VALIDATION bool diff --git a/tools/include/linux/objtool.h b/tools/include/linux/objtool.h index 6491fa8fba6d..6f89471005ee 100644 --- a/tools/include/linux/objtool.h +++ b/tools/include/linux/objtool.h @@ -62,7 +62,7 @@ struct unwind_hint { * It should only be used in special cases where you're 100% sure it won't * affect the reliability of frame pointers and kernel stack traces. * - * For more information, see tools/objtool/Documentation/stack-validation.txt. + * For more information, see tools/objtool/Documentation/objtool.txt. */ #define STACK_FRAME_NON_STANDARD(func) \ static void __used __section(".discard.func_stack_frame_non_standard") \ diff --git a/tools/objtool/check.c b/tools/objtool/check.c index 864bb9dd3584..970844ceecdc 100644 --- a/tools/objtool/check.c +++ b/tools/objtool/check.c @@ -3190,7 +3190,7 @@ static struct instruction *next_insn_to_validate(struct objtool_file *file, * Follow the branch starting at the given instruction, and recursively follow * any other branches (jumps). Meanwhile, track the frame pointer state at * each instruction and validate all the rules described in - * tools/objtool/Documentation/stack-validation.txt. + * tools/objtool/Documentation/objtool.txt. */ static int validate_branch(struct objtool_file *file, struct symbol *func, struct instruction *insn, struct insn_state state) -- 2.36.1