On Tue, 15 Apr 2025 10:46:13 +0700
Bagas Sanjaya <bagasdotme@xxxxxxxxx> wrote:
>
> Hi Steven,
>
> I remove your Acked-by: since I massage the patch description. Would you mind
> to re-add yours?
Sure, I do have one comment below.
>
> Thanks.
>
> Documentation/trace/index.rst | 94 +++++++++++++++++++++++++++++------
> 1 file changed, 79 insertions(+), 15 deletions(-)
>
> diff --git a/Documentation/trace/index.rst b/Documentation/trace/index.rst
> index fecc4adf70a830..5ddd47ee781211 100644
> --- a/Documentation/trace/index.rst
> +++ b/Documentation/trace/index.rst
> @@ -1,39 +1,103 @@
> -==========================
> -Linux Tracing Technologies
> -==========================
> +================================
> +Linux Tracing Technologies Guide
> +================================
> +
> +Tracing in the Linux kernel is a powerful mechanism that allows
> +developers and system administrators to analyze and debug system
> +behavior. This guide provides documentation on various tracing
> +frameworks and tools available in the Linux kernel.
> +
> +Introduction to Tracing
> +-----------------------
> +
> +This section provides an overview of Linux tracing mechanisms
> +and debugging approaches.
>
> .. toctree::
> :maxdepth: 1
>
> - ftrace-design
> + debugging
> + tracepoints
> tracepoint-analysis
> + ring-buffer-map
> +
> +Core Tracing Frameworks
> +-----------------------
> +
> +The following are the primary tracing frameworks integrated into
> +the Linux kernel.
> +
> +.. toctree::
> + :maxdepth: 1
> +
> ftrace
> + ftrace-design
> ftrace-uses
> - fprobe
> kprobes
> kprobetrace
> uprobetracer
I think the uprobetracer can go into the user space tracing below.
As uprobes attaches to user space programs.
> fprobetrace
> - tracepoints
> + fprobe
> + ring-buffer-design
> +
[..]
> +
> +User-Space Tracing
> +------------------
> +
> +These tools allow tracing user-space applications and
> +interactions.
> +
> +.. toctree::
> + :maxdepth: 1
> +
> + user_events
uprobetracer
-- Steve
> +
> +Additional Resources
> +--------------------
> +
> +For more details, refer to the respective documentation of each
> +tracing tool and framework.
> +
> +.. only:: subproject and html
> +
> + Indices
> + =======
> +
> + * :ref:`genindex`
> \ No newline at end of file
