NAME

       heaptrack_print - heap memory profiler for linux, print utility

DESCRIPTION

       heaptrack_print - analyze heaptrack data files.

       heaptrack  is  a  heap memory profiler which records information about calls to heap allocation functions
       such as malloc, operator new etc. pp.  This print utility can then be used to analyze the generated  data
       files.

OPTIONS

       -f [ --file ] arg
              The heaptrack data file to print.

       -d [ --diff ] arg
              Find the differences to this file.

       -t [ --shorten-templates ] [=arg(=1)] (=1)
              Shorten template identifiers.

       -m [ --merge-backtraces ] [=arg(=1)] (=1)
              Merge backtraces.  NOTE: the merged peak consumption is not correct.

       -p [ --print-peaks ] [=arg(=1)] (=1)
              Print backtraces to top allocators, sorted by peak consumption.

       -a [ --print-allocators ] [=arg(=1)] (=1)
              Print backtraces to top allocators, sorted by number of calls to allocation functions.

       -T [ --print-temporary ] [=arg(=1)] (=1)
              Print backtraces to top allocators, sorted by number of temporary allocations.

       -l [ --print-leaks ] [=arg(=1)] (=0)
              Print backtraces to leaked memory allocations.

       -o [ --print-overall-allocated ] [=arg(=1)] (=0) Print top overall allocators, ignoring memory frees.

       -n [ --peak-limit ] [=arg(=10)] (=10)
              Limit the number of reported peaks.

       -s [ --sub-peak-limit ] [=arg(=5)] (=5)
              Limit the number of reported backtraces of merged peak locations.

       -H [ --print-histogram ] arg
              Path to output file where an allocation size histogram will be written to.

       -F [ --print-flamegraph ] arg
              Path  to  output  file where a flame-graph compatible stack file will be written to.  To visualize
              the resulting file, use flamegraph.pl from https://github.com/brendangregg/FlameGraph:

       heaptrack_print heaptrack.someapp.PID.gz -F stacks.txt
              # optionally pass  --reverse  to  flamegraph.pl  flamegraph.pl  --title  "heaptrack:  allocations"
              --colors mem \

       --countname allocations < stacks.txt > heaptrack.someapp.PID.svg
              [firefox|chromium] heaptrack.someapp.PID.svg

       -M [ --print-massif ] arg
              Path to output file where a massif compatible data file will be written to.

       --massif-threshold arg (=1)
              Percentage  of  current  memory  usage,  below  which  allocations  are  aggregated  into a 'below
              threshold' entry.  This is only used in the massif output file so far.

       --massif-detailed-freq arg (=2)
              Frequency of detailed snapshots in the massif output file. Increase this to reduce the file  size.
              You can set the value to zero to disable detailed snapshots.

       --filter-bt-function arg
              Only print allocations where the backtrace contains the given function.

       -h [ --help ]
              Show this help message.

       -v [ --version ]
              Displays version information.

SEE ALSO

       The  full  documentation  for  heaptrack_print  is  maintained  as  a  Texinfo  manual.   If the info and
       heaptrack_print programs are properly installed at your site, the command

              info heaptrack_print

       should give you access to the complete manual.