From patchwork Fri Dec 6 00:31:00 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 848417 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8E606405FB; Fri, 6 Dec 2024 00:31:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733445071; cv=none; b=BtDeF8c+ATl8UoAhqjNeQ7E+k0nerFSqZ4H1h7X6Pl/Pq+jO6oVSadb7kPHitmpd2DgZWq2Gj/ItYKCI6THzmKY7ZmZcoLt9bq3DXY0msBt49jHQSlA0nJkDeXNt77yHsiay7oYXsgDhiU2fwPe+dO5X0dg2ChSi3JyMK94R1Zg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733445071; c=relaxed/simple; bh=jS10g8MDrG/6Q3xY7k4NsUpYW297zr6gFX6tg2hzwTI=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=Lzrtf0rJfxXvQheeEhD3Qmuqk5IpQVHZ7aXXnfhqsPRxoNGyW1RnAY3OceXXrBqDqC6dDCLbU245shx8PgLL7EApNCg1qX+yUG/Uvn30bg4zSunzYySFKsoVS3HSQUzfBwiG6XQB/WoCbysFJ+e+5nFP/Ow6S3zLHYF0mnAiLR0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=2Px4gFdH; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="2Px4gFdH" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=Na6pnlklJTA1xNU44wRBfwwfuxFdNDpARjvimFThkjw=; b=2Px4gFdHWZQt7NnF1mG2vxWvZf tOnXDgZkAAMp1JowFHc9Wp9x3Y13VV7DZKQ/omSbTAaNqMBS58RPxf78hAexZ3mevs5CJose11QAx nRg3lov+vEp/u7BWR8u0KcZSr6f2MpgJKrOyTC2FV546GMzTTmLDm9sS/RcuNmgF8Gv4YkworMEeF 0FBKXIIvRoO2BbPQG755jXeuubcmIloHm+9sIwm+XZCyUUYLB0lHM4gkEyeeDHstjNZ4gnE1VSBBg SvGTD7rJFCyhWH9Ajdedg1EyNoGkfQy969GrN/o7vglUkE9ZfmCbNcwExDD3NYV5/So2TmuFy+XR9 HIZb9PYQ==; Received: from [50.53.2.24] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98 #2 (Red Hat Linux)) id 1tJMFL-000000005HF-0UgE; Fri, 06 Dec 2024 00:31:03 +0000 From: Randy Dunlap To: linux-doc@vger.kernel.org Cc: Randy Dunlap , Sebastian Fricke , Jonathan Corbet , workflows@vger.kernel.org, Jason Wessel , Daniel Thompson , Douglas Anderson , linux-debuggers@vger.kernel.org, kgdb-bugreport@lists.sourceforge.net, Alex Shi , Yanteng Si , Hu Haowen <2023002089@link.tyut.edu.cn>, Andrew Morton , Greg Kroah-Hartman , linux-serial@vger.kernel.org Subject: [PATCH v2] Documentation: move dev-tools debugging files to process/debugging/ Date: Thu, 5 Dec 2024 16:31:00 -0800 Message-ID: <20241206003100.38142-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.47.1 Precedence: bulk X-Mailing-List: linux-serial@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Move gdb and kgdb debugging documentation to the dedicated debugging directory (Documentation/process/debugging/). Adjust the index.rst files to follow the file movement. Adjust files that refer to these moved files to follow the file movement. Update location of kgdb.rst in MAINTAINERS file. Note: translations are not updated. Signed-off-by: Randy Dunlap Cc: Sebastian Fricke Cc: Jonathan Corbet Cc: workflows@vger.kernel.org Cc: Jason Wessel Cc: Daniel Thompson Cc: Douglas Anderson Cc: linux-debuggers@vger.kernel.org Cc: kgdb-bugreport@lists.sourceforge.net Cc: Doug Anderson Cc: Alex Shi Cc: Yanteng Si Cc: Hu Haowen <2023002089@link.tyut.edu.cn> Cc: Andrew Morton Cc: Greg Kroah-Hartman Cc: linux-serial@vger.kernel.org --- v2: Make process/debugging/index alpha by filename. Update references to the moved files. Documentation/admin-guide/README.rst | 4 ++-- Documentation/dev-tools/index.rst | 2 -- .../{dev-tools => process/debugging}/gdb-kernel-debugging.rst | 0 Documentation/process/debugging/index.rst | 2 ++ Documentation/{dev-tools => process/debugging}/kgdb.rst | 0 MAINTAINERS | 2 +- include/linux/tty_driver.h | 2 +- lib/Kconfig.debug | 2 +- lib/Kconfig.kgdb | 2 +- 9 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/admin-guide/README.rst b/Documentation/admin-guide/README.rst index f2bebff6a733..eb9452668909 100644 --- a/Documentation/admin-guide/README.rst +++ b/Documentation/admin-guide/README.rst @@ -356,5 +356,5 @@ instructions at 'Documentation/admin-guide/reporting-issues.rst'. Hints on understanding kernel bug reports are in 'Documentation/admin-guide/bug-hunting.rst'. More on debugging the kernel -with gdb is in 'Documentation/dev-tools/gdb-kernel-debugging.rst' and -'Documentation/dev-tools/kgdb.rst'. +with gdb is in 'Documentation/process/debugging/gdb-kernel-debugging.rst' and +'Documentation/process/debugging/kgdb.rst'. diff --git a/Documentation/dev-tools/index.rst b/Documentation/dev-tools/index.rst index 3c0ac08b2709..c1e73e75f551 100644 --- a/Documentation/dev-tools/index.rst +++ b/Documentation/dev-tools/index.rst @@ -27,8 +27,6 @@ Documentation/dev-tools/testing-overview.rst kmemleak kcsan kfence - gdb-kernel-debugging - kgdb kselftest kunit/index ktap diff --git a/Documentation/dev-tools/gdb-kernel-debugging.rst b/Documentation/process/debugging/gdb-kernel-debugging.rst similarity index 100% rename from Documentation/dev-tools/gdb-kernel-debugging.rst rename to Documentation/process/debugging/gdb-kernel-debugging.rst diff --git a/Documentation/process/debugging/index.rst b/Documentation/process/debugging/index.rst index f6e4a00dfee3..387d33d16f5e 100644 --- a/Documentation/process/debugging/index.rst +++ b/Documentation/process/debugging/index.rst @@ -11,6 +11,8 @@ general guides :maxdepth: 1 driver_development_debugging_guide + gdb-kernel-debugging + kgdb userspace_debugging_guide .. only:: subproject and html diff --git a/Documentation/dev-tools/kgdb.rst b/Documentation/process/debugging/kgdb.rst similarity index 100% rename from Documentation/dev-tools/kgdb.rst rename to Documentation/process/debugging/kgdb.rst diff --git a/MAINTAINERS b/MAINTAINERS index 1e930c7a58b1..1753fe792d04 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -12809,7 +12809,7 @@ L: kgdb-bugreport@lists.sourceforge.net S: Maintained W: http://kgdb.wiki.kernel.org/ T: git git://git.kernel.org/pub/scm/linux/kernel/git/jwessel/kgdb.git -F: Documentation/dev-tools/kgdb.rst +F: Documentation/process/debugging/kgdb.rst F: drivers/misc/kgdbts.c F: drivers/tty/serial/kgdboc.c F: include/linux/kdb.h diff --git a/include/linux/tty_driver.h b/include/linux/tty_driver.h index dd4b31ce6d5d..d4cdc089f6c3 100644 --- a/include/linux/tty_driver.h +++ b/include/linux/tty_driver.h @@ -320,7 +320,7 @@ struct serial_struct; * * @poll_init: ``int ()(struct tty_driver *driver, int line, char *options)`` * - * kgdboc support (Documentation/dev-tools/kgdb.rst). This routine is + * kgdboc support (Documentation/process/debugging/kgdb.rst). This routine is * called to initialize the HW for later use by calling @poll_get_char or * @poll_put_char. * diff --git a/lib/Kconfig.debug b/lib/Kconfig.debug index f3d723705879..d2cf74cbbe70 100644 --- a/lib/Kconfig.debug +++ b/lib/Kconfig.debug @@ -433,7 +433,7 @@ config GDB_SCRIPTS build directory. If you load vmlinux into gdb, the helper scripts will be automatically imported by gdb as well, and additional functions are available to analyze a Linux kernel - instance. See Documentation/dev-tools/gdb-kernel-debugging.rst + instance. See Documentation/process/debugging/gdb-kernel-debugging.rst for further details. endif # DEBUG_INFO diff --git a/lib/Kconfig.kgdb b/lib/Kconfig.kgdb index 537e1b3f5734..8336b1a489a3 100644 --- a/lib/Kconfig.kgdb +++ b/lib/Kconfig.kgdb @@ -19,7 +19,7 @@ menuconfig KGDB CONFIG_FRAME_POINTER to aid in producing more reliable stack backtraces in the external debugger. Documentation of kernel debugger is available at http://kgdb.sourceforge.net - as well as in Documentation/dev-tools/kgdb.rst. If + as well as in Documentation/process/debugging/kgdb.rst. If unsure, say N. if KGDB