Skip to contentSkip to conversation

docs: move tracing tools

PATCH NAK Costa Shulyupin 3 participants 3 messages Apr 25, 2023 – Apr 26, 2023 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: move tracing tools

from list of development tools to user tools
because these tools work on running kernel
and are invoked from user mode

---
 Documentation/index.rst       | 1 -
 Documentation/tools/index.rst | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)
Documentation/index.rst +0 -1
index 9dfdc826618c..81e1af951731 100644
@@ -56,7 +56,6 @@ Various other manuals with useful information for all kernel developers.
    dev-tools/index
    dev-tools/testing-overview
    kernel-hacking/index
-   trace/index
    fault-injection/index
    livepatch/index
    rust/index
Documentation/tools/index.rst +1 -0
index 80488e290e10..6a9a44f7f88a 100644
@@ -12,6 +12,7 @@ more additions are needed here:
 
    rtla/index
    rv/index
+   ../trace/index
 
 .. only::  subproject and html
 
Signature · 1 line
2.40.0
#1 lore raw
Quoted 3 lines · On Tue, 25 Apr 2023 16:02:30 +0300 Costa Shulyupin <[email protected]>…

from list of development tools to user tools
because these tools work on running kernel
and are invoked from user mode

Wait what? No!

The trace/ directory has a lot that is kernel internal only. Yes, it may explain how user space can interact with it, but it's also how internal kernel processes can use the ftrace infrastructure, and also explains a lot of the kernel design of that code.

NACK!

-- Steve

Quoted 31 lines
---
 Documentation/index.rst       | 1 -
 Documentation/tools/index.rst | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)
Documentation/index.rst +0 -1
index 9dfdc826618c..81e1af951731 100644
@@ -56,7 +56,6 @@ Various other manuals with useful information for all kernel developers.
    dev-tools/index
    dev-tools/testing-overview
    kernel-hacking/index
-   trace/index
    fault-injection/index
    livepatch/index
    rust/index
Documentation/tools/index.rst +1 -0
index 80488e290e10..6a9a44f7f88a 100644
@@ -12,6 +12,7 @@ more additions are needed here:
 
    rtla/index
    rv/index
+   ../trace/index
 
 .. only::  subproject and html
 
#2 lore raw
Quoted 6 lines · Steven Rostedt
Quoted 3 lines · On Tue, 25 Apr 2023 16:02:30 +0300 Costa Shulyupin <[email protected]>…

from list of development tools to user tools
because these tools work on running kernel
and are invoked from user mode

Quoted 8 lines

Wait what? No!

The trace/ directory has a lot that is kernel internal only. Yes, it may explain how user space can interact with it, but it's also how internal kernel processes can use the ftrace infrastructure, and also explains a lot of the kernel design of that code.

NACK!

NACK++

-- Daniel