trace-cmd-hist(1) — Linux manual page

TRACE-CMD-HIST(1)           libtracefs Manual           TRACE-CMD-HIST(1)

NAME         top

       trace-cmd-hist - show histogram of events in trace.dat file

SYNOPSIS         top

       trace-cmd hist [OPTIONS][input-file]

DESCRIPTION         top

       The trace-cmd(1) hist displays a histogram form from the trace.dat
       file. Instead of showing the events as they were ordered, it
       creates a histogram that can be displayed per task or for all
       tasks where the most common events appear first. It uses the
       function tracer and call stacks that it finds to try to put
       together a call graph of the events.

OPTIONS         top

       -i input-file
           By default, trace-cmd hist will read the file trace.dat. But
           the -i option open up the given input-file instead. Note, the
           input file may also be specified as the last item on the
           command line.

       -P
           To compact all events and show the call graphs by ignoring
           tasks and different PIDs, add the -P to do so. Instead of
           showing the task name, it will group all chains together and
           show "<all pids>".

SEE ALSO         top

       trace-cmd(1), trace-cmd-record(1), trace-cmd-report(1),
       trace-cmd-start(1), trace-cmd-stop(1), trace-cmd-extract(1),
       trace-cmd-reset(1), trace-cmd-split(1), trace-cmd-listen(1)

AUTHOR         top

       Written by Steven Rostedt, <rostedt@goodmis.org[1]>

RESOURCES         top

       https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/ 

COPYING         top

       Copyright (C) 2010 Red Hat, Inc. Free use of this software is
       granted under the terms of the GNU Public License (GPL).

NOTES         top

        1. rostedt@goodmis.org
           mailto:rostedt@goodmis.org

COLOPHON         top

       This page is part of the trace-cmd (a front-end for Ftrace)
       project.  Information about the project can be found at 
       ⟨https://www.trace-cmd.org/⟩.  If you have a bug report for this
       manual page, see ⟨https://www.trace-cmd.org/⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git⟩ on
       2025-08-11.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-08-01.)  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

libtracefs                      09/24/2023              TRACE-CMD-HIST(1)

Pages that refer to this page: trace-cmd(1),  trace-cmd-mem(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.