Warning, /sdk/massif-visualizer/README is written in an unsupported language. File is not indexed.

0001 =================
0002 massif-visualizer
0003 =================
0004 
0005 ---------------------------------------------------------
0006 visualizer for Valgrind Massif memory-usage tracking tool
0007 ---------------------------------------------------------
0008 
0009 :Author: Milian Wolff <mail@milianw.de>
0010 :Date: 2011-11-21
0011 :Manual section: 1
0012 
0013 SYNOPSIS
0014 ========
0015 
0016 **massif-visualizer [massif-data-file]**
0017 
0018 DESCRIPTION
0019 ===========
0020 
0021 Massif Visualizer is a tool that visualizes massif data. You run your
0022 application in Valgrind with ``--tool=massif`` and then open the generated
0023 ``massif.out.%pid`` in the visualizer. Gzip or Bzip2 compressed massif files can
0024 also be opened transparently.
0025 
0026 The application consists of three parts:
0027 
0028 **The Overview Chart**
0029 
0030 The first thing you'll notice is a nice chart that displays the same as e.g.
0031 ``ms_print`` does in Ascii-Art: total memory consumption over time.
0032 
0033 Massif-Visualizer goes beyond that by additionally showing the top most
0034 cost-intensive locations in your code as a stacked graph below the total cost.
0035 The graph also reacts on user-interaction.
0036 
0037 This view you can use for:
0038 
0039 - checking whether your application has memory leaks
0040 - finding expensive peaks
0041 - finding locations that significantly contribute to the overall memory
0042   consumption of your application
0043 
0044 **The Snapshot Data Tree**
0045 
0046 Directly next to the above chart, you'll see a tree with all of the massif
0047 data. The tree items are colored depending on their cost, with red opaque being
0048 the most interesting (peak) elements. Green/transparent items are negligible
0049 and don't add significant cost to your application.
0050 
0051 You can also search the tree and when you select something in it, the snapshot
0052 gets highlighted in the overview chart and the call graph gets updated.
0053 
0054 **The Call Graph for Detailed Snapshots**
0055 
0056 Massif generates a few detailed snapshots that essentially make up the tree. If
0057 you want to get an overview in a more comfortable way than the simple tree
0058 view, switch over to the detailed snapshot tab and see the tree visualized as a
0059 call graph. Zoom in, zoom out, use the birds eye view and see what contributes
0060 to a given snapshot. Note that function calls with the same memory cost are
0061 grouped to easily find the interesting parts.
0062 
0063 OPTIONS
0064 =======
0065 
0066 --help         Show help about options
0067 --help-all     Show all options
0068 --author       Show author information
0069 -v, --version  Show version information
0070 --license      Show license information
0071 
0072 AUTHOR
0073 ======
0074 
0075 Written by Milian Wolff.
0076 
0077 REPORTING BUGS
0078 ==============
0079 
0080 Please report bugs on https://bugs.kde.org under the massif-visualizer product.
0081 
0082 COPYRIGHT
0083 =========
0084 
0085 Copyright © 2011 Milian Wolff.
0086 License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.
0087 This is free software: you are free to change and redistribute it.
0088 There is NO WARRANTY, to the extent permitted by law.
0089 
0090 SEE ALSO
0091 ========
0092 
0093 **valgrind(1)**, **ms_print(1)**