| Offset 1, 11 lines modified | Offset 1, 11 lines modified |
| 1 | <FILENAME·filename="index.html"><html><head><title>The·KCachegrind·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="KCachegrind·is·a·profile·data·visualization·tool,·written·using·the·KDE·environment."><meta·name="keywords"·content="KDE,·kdesdk,·Cachegrind,·Callgrind,·Valgrind,·Profiling"><link·rel="home"·href="index.html"·title="The·KCachegrind·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="content"><div·id="header"><div·id="header_content"><div·id="heade·✂ | 1 | <FILENAME·filename="index.html"><html><head><title>The·KCachegrind·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="KCachegrind·is·a·profile·data·visualization·tool,·written·using·the·KDE·environment."><meta·name="keywords"·content="KDE,·kdesdk,·Cachegrind,·Callgrind,·Valgrind,·Profiling"><link·rel="home"·href="index.html"·title="The·KCachegrind·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="content"><div·id="header"><div·id="header_content"><div·id="heade·✂ |
| 2 | <span·class="application">KCachegrind</span>·is·a·profile·data·visualization·tool,·written·using·the·<acronym·class="acronym">KDE</acronym> | 2 | <span·class="application">KCachegrind</span>·is·a·profile·data·visualization·tool,·written·using·the·<acronym·class="acronym">KDE</acronym> |
| 3 | environment. | 3 | environment. |
| 4 | </p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="introduction.html#introduction-profiling">Profiling</a></span></dt><dt><span·class="sect1"><a·href="introduction-methods.html">Profiling·Methods</a></span></dt><dt><span·class="sect1"><a·href="introduction-tools.html">Profiling·Tools</a></span></dt><dt><span·class="sect1"><a·href="introduction-visualization.html">Visualization</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="using-kcachegrind.html">2.·Using·<span·class="application">KCachegrind</span></a></span></dt><dd><dl><dt><span·class="sect1"><a·href="using-kcachegrind.html#using-profile">Generate·Data·to·Visualize</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="using-kcachegrind.html#idp148766648"><span·class="application">Callgrind</span></a></span></dt><dt><span·class="sect2"><a·href="using-kcachegrind.html#idp148783672"·✂ | 4 | </p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="introduction.html#introduction-profiling">Profiling</a></span></dt><dt><span·class="sect1"><a·href="introduction-methods.html">Profiling·Methods</a></span></dt><dt><span·class="sect1"><a·href="introduction-tools.html">Profiling·Tools</a></span></dt><dt><span·class="sect1"><a·href="introduction-visualization.html">Visualization</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="using-kcachegrind.html">2.·Using·<span·class="application">KCachegrind</span></a></span></dt><dd><dl><dt><span·class="sect1"><a·href="using-kcachegrind.html#using-profile">Generate·Data·to·Visualize</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="using-kcachegrind.html#idp148733880"><span·class="application">Callgrind</span></a></span></dt><dt><span·class="sect2"><a·href="using-kcachegrind.html#idp148746808"·✂ |
| 5 | <span·class="application">KCachegrind</span>·is·a·browser·for·data·produced·by·profiling·tools. | 5 | <span·class="application">KCachegrind</span>·is·a·browser·for·data·produced·by·profiling·tools. |
| 6 | This·chapter·explains·what·profiling·is·for,·how·it·is·done,·and | 6 | This·chapter·explains·what·profiling·is·for,·how·it·is·done,·and |
| 7 | gives·some·examples·of·profiling·tools·available. | 7 | gives·some·examples·of·profiling·tools·available. |
| 8 | </p><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="introduction-profiling"></a>Profiling</h2></div></div></div><p> | 8 | </p><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="introduction-profiling"></a>Profiling</h2></div></div></div><p> |
| 9 | When·developing·a·program,·one·of·the·last·steps·often·involves·performance | 9 | When·developing·a·program,·one·of·the·last·steps·often·involves·performance |
| 10 | optimizations.··As·it·makes·no·sense·to·optimize·functions·rarely·used,·because | 10 | optimizations.··As·it·makes·no·sense·to·optimize·functions·rarely·used,·because |
| 11 | that·would·be·a·waste·of·time,·one·needs·to·know·in·which·part·of·a·program·most | 11 | that·would·be·a·waste·of·time,·one·needs·to·know·in·which·part·of·a·program·most |
| Offset 139, 15 lines modified | Offset 139, 15 lines modified |
| 139 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction-tools.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="using-kcachegrind.html">Next</a></td></tr><tr><td·class="prevCell">Profiling·Tools </td><td·class="upCell">Introduction</td><td·class="nextCell"> Using·<span·class="application">KCachegrind</span></td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="index.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="introduction-met·✂ | 139 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction-tools.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="using-kcachegrind.html">Next</a></td></tr><tr><td·class="prevCell">Profiling·Tools </td><td·class="upCell">Introduction</td><td·class="nextCell"> Using·<span·class="application">KCachegrind</span></td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="index.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="introduction-met·✂ |
| 140 | runtime·characteristics·of·an·application,·using·a·profiling·tool.·<span·class="application">KCachegrind</span> | 140 | runtime·characteristics·of·an·application,·using·a·profiling·tool.·<span·class="application">KCachegrind</span> |
| 141 | itself·does·not·include·any·profiling·tool,·but·is·good·in·being·used·together | 141 | itself·does·not·include·any·profiling·tool,·but·is·good·in·being·used·together |
| 142 | with·<span·class="application">Callgrind</span>,·and·by·using·a·converter,·also·can·be·used·to·visualize·data | 142 | with·<span·class="application">Callgrind</span>,·and·by·using·a·converter,·also·can·be·used·to·visualize·data |
| 143 | produced·with·<span·class="application">OProfile</span>.··Although·the·scope·of·this·manual·is·not·to·document | 143 | produced·with·<span·class="application">OProfile</span>.··Although·the·scope·of·this·manual·is·not·to·document |
| 144 | profiling·with·these·tools,·the·next·section·provides·short·quickstart·tutorials | 144 | profiling·with·these·tools,·the·next·section·provides·short·quickstart·tutorials |
| 145 | to·get·you·started. | 145 | to·get·you·started. |
| 146 | </p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148766648"></a><span·class="application">Callgrind</span></h3></div></div></div><p> | 146 | </p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148733880"></a><span·class="application">Callgrind</span></h3></div></div></div><p> |
| 147 | <span·class="application">Callgrind</span>·is·a·part·of·<a·class="ulink"·href="http://valgrind.org"·target="_top"><span·class="application">Valgrind</span></a>. | 147 | <span·class="application">Callgrind</span>·is·a·part·of·<a·class="ulink"·href="http://valgrind.org"·target="_top"><span·class="application">Valgrind</span></a>. |
| 148 | Note·that·it·previously·was·called·<span·class="application">Calltree</span>,·but·that·name·was·misleading. | 148 | Note·that·it·previously·was·called·<span·class="application">Calltree</span>,·but·that·name·was·misleading. |
| 149 | </p><p> | 149 | </p><p> |
| 150 | The·most·common·use·is·to·prefix·the·command·line·to·start·your·application·with | 150 | The·most·common·use·is·to·prefix·the·command·line·to·start·your·application·with |
| 151 | <strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>valgrind</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--tool=callgrind</code></span> | 151 | <strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>valgrind</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--tool=callgrind</code></span> |
| 152 | </code></strong>,·as·in: | 152 | </code></strong>,·as·in: |
| | |
| Offset 174, 15 lines modified | Offset 174, 15 lines modified |
| 174 | </code></strong></p></blockquote></div><p> | 174 | </code></strong></p></blockquote></div><p> |
| | |
| 175 | This·will·produce·multiple·profile·data·files·with·an·additional·sequential | 175 | This·will·produce·multiple·profile·data·files·with·an·additional·sequential |
| 176 | number·at·the·end·of·the·filename.·A·file·without·such·an·number·at·the·end | 176 | number·at·the·end·of·the·filename.·A·file·without·such·an·number·at·the·end |
| 177 | (only·ending·in·the·process·PID)·will·also·be·produced;·by·loading·this·file | 177 | (only·ending·in·the·process·PID)·will·also·be·produced;·by·loading·this·file |
| 178 | into·<span·class="application">KCachegrind</span>,·all·others·are·loaded·too,·and·can·be·seen·in·the | 178 | into·<span·class="application">KCachegrind</span>,·all·others·are·loaded·too,·and·can·be·seen·in·the |
| 179 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts</span></span>·list. | 179 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts</span></span>·list. |
| 180 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148783672"></a><span·class="application">OProfile</span></h3></div></div></div><p> | 180 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148746808"></a><span·class="application">OProfile</span></h3></div></div></div><p> |
| 181 | <span·class="application">OProfile</span>·is·available·from·<a·class="ulink"·href="http://oprofile.sf.net"·target="_top">its·home | 181 | <span·class="application">OProfile</span>·is·available·from·<a·class="ulink"·href="http://oprofile.sf.net"·target="_top">its·home |
| 182 | page</a>.·Follow·the·installation·instructions·on·the·Web·site,·but,·before | 182 | page</a>.·Follow·the·installation·instructions·on·the·Web·site,·but,·before |
| 183 | you·do,·check·whether·your·distribution·does·not·already·provide·it·as·package | 183 | you·do,·check·whether·your·distribution·does·not·already·provide·it·as·package |
| 184 | (like·<acronym·class="acronym"><span·class="trademark">SuSE</span>®</acronym>). | 184 | (like·<acronym·class="acronym"><span·class="trademark">SuSE</span>®</acronym>). |
| 185 | </p><p> | 185 | </p><p> |
| 186 | System-wide·profiling·is·only·permitted·to·the·root·user,·as·all·actions·on·the | 186 | System-wide·profiling·is·only·permitted·to·the·root·user,·as·all·actions·on·the |
| 187 | system·can·be·observed;·therefore,·the·following·has·to·be·done·as·root. | 187 | system·can·be·observed;·therefore,·the·following·has·to·be·done·as·root. |
| Offset 231, 15 lines modified | Offset 231, 15 lines modified |
| 231 | </p><p> | 231 | </p><p> |
| 232 | To·explore·the·<acronym·class="acronym">GUI</acronym>·further,·in·addition·to·this·manual,·also·have·a·look·at | 232 | To·explore·the·<acronym·class="acronym">GUI</acronym>·further,·in·addition·to·this·manual,·also·have·a·look·at |
| 233 | the·documentation·section·<a·class="ulink"·href="http://kcachegrind.sf.net"·target="_top">on·the·Web | 233 | the·documentation·section·<a·class="ulink"·href="http://kcachegrind.sf.net"·target="_top">on·the·Web |
| 234 | site</a>. | 234 | site</a>. |
| 235 | Also,·every·widget·in·<span·class="application">KCachegrind</span>·has·<span·class="quote">“<span·class="quote">What's·this</span>”</span>·help. | 235 | Also,·every·widget·in·<span·class="application">KCachegrind</span>·has·<span·class="quote">“<span·class="quote">What's·this</span>”</span>·help. |
| 236 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-kcachegrind.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="kcachegrind-concepts.html">Next</a></td></tr><tr><td·class="prevCell">Using·<span·class="application">KCachegrind</span> </td><td·class="upCell">Using·<span·class="application">KCachegrind</span></td><td·class="nextCell"> Basic·Concepts</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction-visualization.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td>·✂ | 236 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-kcachegrind.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="kcachegrind-concepts.html">Next</a></td></tr><tr><td·class="prevCell">Using·<span·class="application">KCachegrind</span> </td><td·class="upCell">Using·<span·class="application">KCachegrind</span></td><td·class="nextCell"> Basic·Concepts</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction-visualization.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td>·✂ |
| 237 | terms·used·in·the·interface. | 237 | terms·used·in·the·interface. |
| 238 | </p><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="concepts-model"></a>The·Data·Model·for·Profile·Data</h2></div></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148808632"></a>Cost·Entities</h3></div></div></div><p> | 238 | </p><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="concepts-model"></a>The·Data·Model·for·Profile·Data</h2></div></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148775864"></a>Cost·Entities</h3></div></div></div><p> |
| 239 | Cost·counts·of·event·types·(like·L2·Misses)·are·attributed·to·cost·entities, | 239 | Cost·counts·of·event·types·(like·L2·Misses)·are·attributed·to·cost·entities, |
| 240 | which·are·items·with·relationship·to·source·code·or·data·structures·of·a·given | 240 | which·are·items·with·relationship·to·source·code·or·data·structures·of·a·given |
| 241 | program.·Cost·entities·not·only·can·be·simple·code·or·data·positions,·but·also | 241 | program.·Cost·entities·not·only·can·be·simple·code·or·data·positions,·but·also |
| 242 | position·tuples.·For·example,·a·call·has·a·source·and·a·target,·or·a·data | 242 | position·tuples.·For·example,·a·call·has·a·source·and·a·target,·or·a·data |
| 243 | address·can·have·a·data·type·and·a·code·position·where·its·allocation·happened. | 243 | address·can·have·a·data·type·and·a·code·position·where·its·allocation·happened. |
| 244 | </p><p> | 244 | </p><p> |
| 245 | The·cost·entities·known·to·<span·class="application">KCachegrind</span>·are·given·in·the·following. | 245 | The·cost·entities·known·to·<span·class="application">KCachegrind</span>·are·given·in·the·following. |
| Offset 291, 15 lines modified | Offset 291, 15 lines modified |
| 291 | (Un)conditional·jump·from·source·to·target·instruction. | 291 | (Un)conditional·jump·from·source·to·target·instruction. |
| 292 | </p></li><li·class="listitem"><p> | 292 | </p></li><li·class="listitem"><p> |
| 293 | (Un)conditional·jump·from·source·to·target·line. | 293 | (Un)conditional·jump·from·source·to·target·line. |
| 294 | </p></li></ul></div><p> | 294 | </p></li></ul></div><p> |
| 295 | Jumps·between·functions·are·not·allowed,·as·this·makes·no·sense·in·a·call·graph; | 295 | Jumps·between·functions·are·not·allowed,·as·this·makes·no·sense·in·a·call·graph; |
| 296 | thus,·constructs·like·exception·handling·and·long·jumps·in·C·have·to·be | 296 | thus,·constructs·like·exception·handling·and·long·jumps·in·C·have·to·be |
| 297 | translated·to·popping·the·call·stack·as·needed. | 297 | translated·to·popping·the·call·stack·as·needed. |
| 298 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148826168"></a>Event·Types</h3></div></div></div><p> | 298 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148793400"></a>Event·Types</h3></div></div></div><p> |
| 299 | Arbitrary·event·types·can·be·specified·in·the·profile·data·by·giving·them·a | 299 | Arbitrary·event·types·can·be·specified·in·the·profile·data·by·giving·them·a |
| 300 | name.·Their·cost·related·to·a·cost·entity·is·a·64-bit·integer. | 300 | name.·Their·cost·related·to·a·cost·entity·is·a·64-bit·integer. |
| 301 | </p><p> | 301 | </p><p> |
| 302 | Event·types·whose·costs·are·specified·in·a·profile·data·file·are·called·real | 302 | Event·types·whose·costs·are·specified·in·a·profile·data·file·are·called·real |
| 303 | events.·Additionally,·one·can·specify·formulas·for·event·types·calculated·from | 303 | events.·Additionally,·one·can·specify·formulas·for·event·types·calculated·from |
| 304 | real·events,·which·are·called·inherited·events. | 304 | real·events,·which·are·called·inherited·events. |
| 305 | </p></div></div><FILENAME·filename="concepts-state.html"><html><head><title>Visualization·State</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="keywords"·content="KDE,·kdesdk,·Cachegrind,·Callgrind,·Valgrind,·Profiling"><link·rel="home"·href="index.html"·title="The·KCachegrind·Handbook"><link·rel="up"·href="kcachegrind-concepts.html"·title="Chapter 3. Basic·Concepts"><link·rel="prev"·href="kcachegrind-concepts.html"·title="Chapter 3. Basic·Concepts"><link·rel="next"·href="concepts-guiparts.html"·title="Parts·of·the·GUI"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="c·✂ | 305 | </p></div></div><FILENAME·filename="concepts-state.html"><html><head><title>Visualization·State</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="keywords"·content="KDE,·kdesdk,·Cachegrind,·Callgrind,·Valgrind,·Profiling"><link·rel="home"·href="index.html"·title="The·KCachegrind·Handbook"><link·rel="up"·href="kcachegrind-concepts.html"·title="Chapter 3. Basic·Concepts"><link·rel="prev"·href="kcachegrind-concepts.html"·title="Chapter 3. Basic·Concepts"><link·rel="next"·href="concepts-guiparts.html"·title="Parts·of·the·GUI"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="c·✂ |
| Offset 323, 69 lines modified | Offset 323, 69 lines modified |
| 323 | is·inappropriate·for·a·cost·entity,·it·is·disabled:·when·selecting·<abbr·class="abbrev">e.g.</abbr>·an·<acronym·class="acronym">ELF</acronym> | 323 | is·inappropriate·for·a·cost·entity,·it·is·disabled:·when·selecting·<abbr·class="abbrev">e.g.</abbr>·an·<acronym·class="acronym">ELF</acronym> |
| 324 | object·in·the·group·list,·source·annotation·makes·no·sense. | 324 | object·in·the·group·list,·source·annotation·makes·no·sense. |
| 325 | </p><p> | 325 | </p><p> |
| 326 | For·example,·for·an·active·function,·the·callee·list·shows·all·the·functions | 326 | For·example,·for·an·active·function,·the·callee·list·shows·all·the·functions |
| 327 | called·from·the·active·one:·one·can·select·one·of·these·functions·without·making | 327 | called·from·the·active·one:·one·can·select·one·of·these·functions·without·making |
| 328 | it·active.·Also,·if·the·call·graph·is·shown·beside,·it·will·automatically·select | 328 | it·active.·Also,·if·the·call·graph·is·shown·beside,·it·will·automatically·select |
| 329 | the·same·function. | 329 | the·same·function. |
| 330 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="kcachegrind-concepts.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-guiparts.html">Next</a></td></tr><tr><td·class="prevCell">Basic·Concepts </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Parts·of·the·<acronym·class="acronym">GUI</acronym></td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-guiparts.html"><html><head><title>Parts·of·the·GUI</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href=·✂ | 330 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="kcachegrind-concepts.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-guiparts.html">Next</a></td></tr><tr><td·class="prevCell">Basic·Concepts </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Parts·of·the·<acronym·class="acronym">GUI</acronym></td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-guiparts.html"><html><head><title>Parts·of·the·GUI</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href=·✂ |
| 331 | Sidedocks·are·side·windows·which·can·be·placed·at·any·border·of·a·<span·class="application">KCachegrind</span> | 331 | Sidedocks·are·side·windows·which·can·be·placed·at·any·border·of·a·<span·class="application">KCachegrind</span> |
| 332 | window.·They·always·contain·a·list·of·cost·entities·sorted·in·some·way. | 332 | window.·They·always·contain·a·list·of·cost·entities·sorted·in·some·way. |
| 333 | </p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p> | 333 | </p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p> |
| 334 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Function·Profile</span></span>·is·a·list·of·functions·showing | 334 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Function·Profile</span></span>·is·a·list·of·functions·showing |
| 335 | inclusive·and·exclusive·cost,·call·count,·name·and·position·of·functions. | 335 | inclusive·and·exclusive·cost,·call·count,·name·and·position·of·functions. |
| 336 | </p></li><li·class="listitem"><p> | 336 | </p></li><li·class="listitem"><p> |
| 337 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span> | 337 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span> |
| 338 | </p></li><li·class="listitem"><p> | 338 | </p></li><li·class="listitem"><p> |
| 339 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Call·Stack</span></span> | 339 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Call·Stack</span></span> |
| 340 | </p></li></ul></div><p> | 340 | </p></li></ul></div><p> |
| 341 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148840632"></a>View·Area</h3></div></div></div><p> | 341 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148811960"></a>View·Area</h3></div></div></div><p> |
| 342 | The·view·area,·typically·the·right·part·of·a·<span·class="application">KCachegrind</span>·main·window,·is·made | 342 | The·view·area,·typically·the·right·part·of·a·<span·class="application">KCachegrind</span>·main·window,·is·made |
| 343 | up·of·one·(default)·or·more·tabs,·lined·up·either·horizontally·or·vertically. | 343 | up·of·one·(default)·or·more·tabs,·lined·up·either·horizontally·or·vertically. |
| 344 | Each·tab·holds·different·views·of·only·one·cost·entity·at·a·time. | 344 | Each·tab·holds·different·views·of·only·one·cost·entity·at·a·time. |
| 345 | The·name·of·this·entity·is·given·at·the·top·of·the·tab.·If·there·are·multiple | 345 | The·name·of·this·entity·is·given·at·the·top·of·the·tab.·If·there·are·multiple |
| 346 | tabs,·only·one·is·active.·The·entity·name·in·the·active·tab·is·shown·in·bold, | 346 | tabs,·only·one·is·active.·The·entity·name·in·the·active·tab·is·shown·in·bold, |
| 347 | and·determines·the·active·cost·entity·of·the·<span·class="application">KCachegrind</span>·window. | 347 | and·determines·the·active·cost·entity·of·the·<span·class="application">KCachegrind</span>·window. |
| 348 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148842552"></a>Areas·of·a·Tab</h3></div></div></div><p> | 348 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148813880"></a>Areas·of·a·Tab</h3></div></div></div><p> |
| 349 | Each·tab·can·hold·up·to·four·view·areas,·namely·Top,·Right,·Left,·and·Bottom. | 349 | Each·tab·can·hold·up·to·four·view·areas,·namely·Top,·Right,·Left,·and·Bottom. |
| 350 | Each·area·can·hold·multiple·stacked·views.·The·visible·part·of·an·area·is | 350 | Each·area·can·hold·multiple·stacked·views.·The·visible·part·of·an·area·is |
| 351 | selected·by·a·tab·bar.·The·tab·bars·of·the·top·and·right·area·are·at·the·top; | 351 | selected·by·a·tab·bar.·The·tab·bars·of·the·top·and·right·area·are·at·the·top; |
| 352 | the·tab·bars·of·the·left·and·bottom·area·are·at·the·bottom.·You·can·specify | 352 | the·tab·bars·of·the·left·and·bottom·area·are·at·the·bottom.·You·can·specify |
| 353 | which·kind·of·view·should·go·into·which·area·by·using·the·tabs'·context·menus. | 353 | which·kind·of·view·should·go·into·which·area·by·using·the·tabs'·context·menus. |
| 354 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148843704"></a>Synchronized·View·with·Selected·Entity·in·a·Tab</h3></div></div></div><p> | 354 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148815032"></a>Synchronized·View·with·Selected·Entity·in·a·Tab</h3></div></div></div><p> |
| 355 | Besides·an·active·entity,·each·tab·has·a·selected·entity.·As·most·view·types | 355 | Besides·an·active·entity,·each·tab·has·a·selected·entity.·As·most·view·types |
| 356 | show·multiple·entities·with·the·active·one·somehow·centered,·you·can·change | 356 | show·multiple·entities·with·the·active·one·somehow·centered,·you·can·change |
| 357 | the·selected·item·by·navigating·inside·a·view·(by·clicking·with·the·mouse | 357 | the·selected·item·by·navigating·inside·a·view·(by·clicking·with·the·mouse |
| 358 | or·using·the·keyboard).·Typically,·selected·items·are·shown·in·a·highlighted | 358 | or·using·the·keyboard).·Typically,·selected·items·are·shown·in·a·highlighted |
| 359 | state.·By·changing·the·selected·entity·in·one·of·the·views·of·a·tab,·all·other | 359 | state.·By·changing·the·selected·entity·in·one·of·the·views·of·a·tab,·all·other |
| 360 | views·highlight·the·new·selected·entity·accordingly. | 360 | views·highlight·the·new·selected·entity·accordingly. |
| 361 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148844856"></a>Synchronization·between·Tabs</h3></div></div></div><p> | 361 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148816184"></a>Synchronization·between·Tabs</h3></div></div></div><p> |
| 362 | If·there·are·multiple·tabs,·a·selection·change·in·one·tab·leads·to·an·activation | 362 | If·there·are·multiple·tabs,·a·selection·change·in·one·tab·leads·to·an·activation |
| 363 | change·in·the·next·tab,·be·it·right·of·the·former·or·under·it.·This·kind·of | 363 | change·in·the·next·tab,·be·it·right·of·the·former·or·under·it.·This·kind·of |
| 364 | linkage·should,·for·example,·allow·for·fast·browsing·in·call·graphs. | 364 | linkage·should,·for·example,·allow·for·fast·browsing·in·call·graphs. |
| 365 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148846008"></a>Layouts</h3></div></div></div><p> | 365 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148817336"></a>Layouts</h3></div></div></div><p> |
| 366 | The·layout·of·all·the·tabs·of·a·window·can·be·saved·(<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">View | 366 | The·layout·of·all·the·tabs·of·a·window·can·be·saved·(<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">View |
| 367 | </span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guisubmenu">Layout</span></span>).·After·duplicating·the | 367 | </span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guisubmenu">Layout</span></span>).·After·duplicating·the |
| 368 | current·layout·(<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">View</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guisubmenu">Layout</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Duplicate</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>+</strong></span></strong></span>)) | 368 | current·layout·(<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">View</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guisubmenu">Layout</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Duplicate</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>+</strong></span></strong></span>)) |
| 369 | and·changing·some·sizes·or·moving·a·view·to·another·area·of·a·tab,·you·can | 369 | and·changing·some·sizes·or·moving·a·view·to·another·area·of·a·tab,·you·can |
| 370 | quickly·switch·between·the·old·and·the·new·layout·via·<span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>←</strong></span>·and·<span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>→</strong></span>.·The·set·of·layouts·will·be·stored·between | 370 | quickly·switch·between·the·old·and·the·new·layout·via·<span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>←</strong></span>·and·<span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>→</strong></span>.·The·set·of·layouts·will·be·stored·between |
| 371 | <span·class="application">KCachegrind</span>·sessions·of·the·same·profiled·command.·You·can·make·the·current | 371 | <span·class="application">KCachegrind</span>·sessions·of·the·same·profiled·command.·You·can·make·the·current |
| 372 | set·of·layouts·the·default·one·for·new·<span·class="application">KCachegrind</span>·sessions,·or·restore·the | 372 | set·of·layouts·the·default·one·for·new·<span·class="application">KCachegrind</span>·sessions,·or·restore·the |
| 373 | default·layout·set. | 373 | default·layout·set. |
| 374 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-state.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-sidedocks.html">Next</a></td></tr><tr><td·class="prevCell">Visualization·State </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Sidedocks</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-sidedocks.html"><html><head><title>Sidedocks</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·nam·✂ | 374 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-state.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-sidedocks.html">Next</a></td></tr><tr><td·class="prevCell">Visualization·State </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Sidedocks</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-sidedocks.html"><html><head><title>Sidedocks</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·nam·✂ |
| 375 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Flat·Profile</span></span>·contains·a·group·list·and·a·function·list. | 375 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Flat·Profile</span></span>·contains·a·group·list·and·a·function·list. |
| 376 | The·group·list·contains·all·groups·where·cost·is·spent·in,·depending·on·the | 376 | The·group·list·contains·all·groups·where·cost·is·spent·in,·depending·on·the |
| 377 | chosen·group·type.·The·group·list·is·hidden·when·grouping·is·switched·off. | 377 | chosen·group·type.·The·group·list·is·hidden·when·grouping·is·switched·off. |
| 378 | </p><p> | 378 | </p><p> |
| 379 | The·function·list·contains·the·functions·of·the·selected·group·(or·all·functions | 379 | The·function·list·contains·the·functions·of·the·selected·group·(or·all·functions |
| 380 | if·grouping·is·switched·off),·ordered·by·some·column,·<abbr·class="abbrev">e.g.</abbr>·inclusive·or·self | 380 | if·grouping·is·switched·off),·ordered·by·some·column,·<abbr·class="abbrev">e.g.</abbr>·inclusive·or·self |
| 381 | costs·spent·therein.·There·is·a·maximum·number·of·functions·shown·in·the·list, | 381 | costs·spent·therein.·There·is·a·maximum·number·of·functions·shown·in·the·list, |
| 382 | configurable·in·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Settings</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Configure | 382 | configurable·in·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Settings</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Configure |
| 383 | KCachegrind</span></span>. | 383 | KCachegrind</span></span>. |
| 384 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148869560"></a>Parts·Overview</h3></div></div></div><p> | 384 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148828600"></a>Parts·Overview</h3></div></div></div><p> |
| 385 | In·a·profile·run,·multiple·profile·data·files·can·be·produced,·which·can·be | 385 | In·a·profile·run,·multiple·profile·data·files·can·be·produced,·which·can·be |
| 386 | loaded·together·into·<span·class="application">KCachegrind</span>.·The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span> | 386 | loaded·together·into·<span·class="application">KCachegrind</span>.·The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Parts·Overview</span></span> |
| 387 | sidedock·shows·these,·ordered·horizontally·according·to·creation·time;·the | 387 | sidedock·shows·these,·ordered·horizontally·according·to·creation·time;·the |
| 388 | rectangle·sizes·are·proportional·to·the·cost·spent·each·part.·You·can·select·one | 388 | rectangle·sizes·are·proportional·to·the·cost·spent·each·part.·You·can·select·one |
| 389 | or·several·parts·to·constrain·the·costs·shown·in·the·other·<span·class="application">KCachegrind</span>·views | 389 | or·several·parts·to·constrain·the·costs·shown·in·the·other·<span·class="application">KCachegrind</span>·views |
| 390 | to·these·parts·only. | 390 | to·these·parts·only. |
| 391 | </p><p> | 391 | </p><p> |
| Offset 397, 37 lines modified | Offset 397, 37 lines modified |
| 397 | colored·rectangles·for·each·used·<acronym·class="acronym">ELF</acronym>·object·(shared·library·or·executable), | 397 | colored·rectangles·for·each·used·<acronym·class="acronym">ELF</acronym>·object·(shared·library·or·executable), |
| 398 | sized·according·to·the·cost·spent·therein. | 398 | sized·according·to·the·cost·spent·therein. |
| 399 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Diagram·Mode</span></span></span></dt><dd><p> | 399 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Diagram·Mode</span></span></span></dt><dd><p> |
| 400 | A·rectangle·showing·the·inclusive·cost·of·the·current·active·function·in·the | 400 | A·rectangle·showing·the·inclusive·cost·of·the·current·active·function·in·the |
| 401 | part·is·shown.·This,·again,·is·split·up·to·show·the·inclusive·costs·of·its | 401 | part·is·shown.·This,·again,·is·split·up·to·show·the·inclusive·costs·of·its |
| 402 | callees. | 402 | callees. |
| 403 | </p></dd></dl></div><p> | 403 | </p></dd></dl></div><p> |
| 404 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148876344"></a>Call·Stack</h3></div></div></div><p> | 404 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148847672"></a>Call·Stack</h3></div></div></div><p> |
| 405 | This·is·a·purely·fictional·<span·class="quote">“<span·class="quote">most·probable</span>”</span>·call·stack.·It·is·built | 405 | This·is·a·purely·fictional·<span·class="quote">“<span·class="quote">most·probable</span>”</span>·call·stack.·It·is·built |
| 406 | up·by·starting·with·the·current·active·function,·and·adds·the·callers·and | 406 | up·by·starting·with·the·current·active·function,·and·adds·the·callers·and |
| 407 | callees·with·highest·cost·at·the·top·and·to·bottom. | 407 | callees·with·highest·cost·at·the·top·and·to·bottom. |
| 408 | </p><p> | 408 | </p><p> |
| 409 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Cost</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Calls</span></span>·columns·show·the | 409 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Cost</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Calls</span></span>·columns·show·the |
| 410 | cost·used·for·all·calls·from·the·function·in·the·line·above. | 410 | cost·used·for·all·calls·from·the·function·in·the·line·above. |
| 411 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-guiparts.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-views.html">Next</a></td></tr><tr><td·class="prevCell">Parts·of·the·<acronym·class="acronym">GUI</acronym> </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Views</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-views.html"><html><head><title>Views</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-local·✂ | 411 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-guiparts.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-views.html">Next</a></td></tr><tr><td·class="prevCell">Parts·of·the·<acronym·class="acronym">GUI</acronym> </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Views</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="concepts-views.html"><html><head><title>Views</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-local·✂ |
| 412 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Event·Type</span></span>·list·shows·all·cost·types·available·and·the | 412 | The·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Event·Type</span></span>·list·shows·all·cost·types·available·and·the |
| 413 | corresponding·self·and·inclusive·cost·of·the·current·active·function·for·that | 413 | corresponding·self·and·inclusive·cost·of·the·current·active·function·for·that |
| 414 | event·type. | 414 | event·type. |
| 415 | </p><p> | 415 | </p><p> |
| 416 | By·choosing·an·event·type·from·the·list,·you·change·the·type·of·costs·shown·all | 416 | By·choosing·an·event·type·from·the·list,·you·change·the·type·of·costs·shown·all |
| 417 | over·<span·class="application">KCachegrind</span>·to·the·selected·one. | 417 | over·<span·class="application">KCachegrind</span>·to·the·selected·one. |
| 418 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148882232"></a>Call·Lists</h3></div></div></div><p> | 418 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148853560"></a>Call·Lists</h3></div></div></div><p> |
| 419 | These·lists·show·calls·to·and·from·the·current·active·function.·With | 419 | These·lists·show·calls·to·and·from·the·current·active·function.·With |
| 420 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callers</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callees</span></span>·are·meant | 420 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callers</span></span>·and·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callees</span></span>·are·meant |
| 421 | those·functions·reachable·in·the·caller·and·callee·direction,·even·when·other | 421 | those·functions·reachable·in·the·caller·and·callee·direction,·even·when·other |
| 422 | functions·are·in·between. | 422 | functions·are·in·between. |
| 423 | </p><p> | 423 | </p><p> |
| 424 | Call·list·views·include: | 424 | Call·list·views·include: |
| 425 | </p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>Direct·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callers</span></span></p></li><li·class="listitem"><p>Direct·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callees</span></span></p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callers</span></span></p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callees</span></span></p></li></ul></div><p> | 425 | </p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>Direct·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callers</span></span></p></li><li·class="listitem"><p>Direct·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callees</span></span></p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callers</span></span></p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">All·Callees</span></span></p></li></ul></div><p> |
| 426 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148887864"></a>Maps</h3></div></div></div><p> | 426 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148859192"></a>Maps</h3></div></div></div><p> |
| 427 | A·treemap·view·of·the·primary·event·type,·up·or·down·the·call | 427 | A·treemap·view·of·the·primary·event·type,·up·or·down·the·call |
| 428 | hierarchy.·Each·colored·rectangle·represents·a·function;·its·size·is | 428 | hierarchy.·Each·colored·rectangle·represents·a·function;·its·size·is |
| 429 | approximately·proportional·to·the·cost·spent·therein·while·the·active·function | 429 | approximately·proportional·to·the·cost·spent·therein·while·the·active·function |
| 430 | is·running·(however,·there·are·drawing·constrains). | 430 | is·running·(however,·there·are·drawing·constrains). |
| 431 | </p><p> | 431 | </p><p> |
| 432 | For·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Caller·Map</span></span>,·the·graph·shows·the·nested·hierarchy·of | 432 | For·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Caller·Map</span></span>,·the·graph·shows·the·nested·hierarchy·of |
| 433 | all·callers·of·the·currently·activated·function;·for·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callee | 433 | all·callers·of·the·currently·activated·function;·for·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Callee |
| Offset 441, 37 lines modified | Offset 441, 37 lines modified |
| 441 | Best</span></span>·decides·on·remaining·space·for·each·sibling.·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Ignore | 441 | Best</span></span>·decides·on·remaining·space·for·each·sibling.·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Ignore |
| 442 | Proportions</span></span>·takes·space·for·function·name·drawing·before·drawing | 442 | Proportions</span></span>·takes·space·for·function·name·drawing·before·drawing |
| 443 | children.·Note·that·size·proportions·can·get·heavily·wrong. | 443 | children.·Note·that·size·proportions·can·get·heavily·wrong. |
| 444 | </p><p> | 444 | </p><p> |
| 445 | Keyboard·navigation·is·available·with·the·left·and·right·arrow·keys·for | 445 | Keyboard·navigation·is·available·with·the·left·and·right·arrow·keys·for |
| 446 | traversing·siblings,·and·up·and·down·arrow·keys·to·go·a·nesting·level·up·and | 446 | traversing·siblings,·and·up·and·down·arrow·keys·to·go·a·nesting·level·up·and |
| 447 | down.·<span·class="keycap"><strong>Enter</strong></span>·activates·the·current·item. | 447 | down.·<span·class="keycap"><strong>Enter</strong></span>·activates·the·current·item. |
| 448 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148893240"></a>Call·Graph</h3></div></div></div><p> | 448 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148864568"></a>Call·Graph</h3></div></div></div><p> |
| 449 | This·view·shows·the·call·graph·around·the·active·function.·The·cost·shown·is | 449 | This·view·shows·the·call·graph·around·the·active·function.·The·cost·shown·is |
| 450 | only·the·cost·spent·while·the·active·function·was·actually·running,·<abbr·class="abbrev">i.e.</abbr>·the | 450 | only·the·cost·spent·while·the·active·function·was·actually·running,·<abbr·class="abbrev">i.e.</abbr>·the |
| 451 | cost·shown·for·<code·class="function">main()</code>·(if·it's·visible)·should·be·the·same | 451 | cost·shown·for·<code·class="function">main()</code>·(if·it's·visible)·should·be·the·same |
| 452 | as·the·cost·of·the·active·function,·as·that·is·the·part·of·inclusive·cost·of | 452 | as·the·cost·of·the·active·function,·as·that·is·the·part·of·inclusive·cost·of |
| 453 | <code·class="function">main()</code>·spent·while·the·active·function·was·running. | 453 | <code·class="function">main()</code>·spent·while·the·active·function·was·running. |
| 454 | </p><p> | 454 | </p><p> |
| 455 | For·cycles,·blue·call·arrows·indicate·that·this·is·an·artificial·call,·which | 455 | For·cycles,·blue·call·arrows·indicate·that·this·is·an·artificial·call,·which |
| 456 | never·actually·happened,·added·for·correct·drawing. | 456 | never·actually·happened,·added·for·correct·drawing. |
| 457 | </p><p> | 457 | </p><p> |
| 458 | If·the·graph·is·larger·than·the·drawing·area,·a·bird's·eye·view·is·shown·on·a | 458 | If·the·graph·is·larger·than·the·drawing·area,·a·bird's·eye·view·is·shown·on·a |
| 459 | side.·There·are·view·options·similar·to·those·of·the·call·maps;·the·selected | 459 | side.·There·are·view·options·similar·to·those·of·the·call·maps;·the·selected |
| 460 | function·is·highlighted. | 460 | function·is·highlighted. |
| 461 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148896440"></a>Annotations</h3></div></div></div><p> | 461 | </p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148867768"></a>Annotations</h3></div></div></div><p> |
| 462 | The·annotated·source·or·assembler·lists·show·the·source·lines·or·disassembled | 462 | The·annotated·source·or·assembler·lists·show·the·source·lines·or·disassembled |
| 463 | instructions·of·the·current·active·function·together·with·the·(self)·cost·spent | 463 | instructions·of·the·current·active·function·together·with·the·(self)·cost·spent |
| 464 | executing·the·code·of·a·source·line·or·instruction.·If·there·was·a·call,·lines | 464 | executing·the·code·of·a·source·line·or·instruction.·If·there·was·a·call,·lines |
| 465 | with·details·on·the·call·are·inserted·into·the·source:·the·(inclusive)·cost | 465 | with·details·on·the·call·are·inserted·into·the·source:·the·(inclusive)·cost |
| 466 | spent·inside·of·the·call,·the·number·of·calls·happening,·and·the·call | 466 | spent·inside·of·the·call,·the·number·of·calls·happening,·and·the·call |
| 467 | destination. | 467 | destination. |
| 468 | </p><p> | 468 | </p><p> |
| 469 | Select·such·a·call·information·line·to·activate·the·call·destination. | 469 | Select·such·a·call·information·line·to·activate·the·call·destination. |
| 470 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-sidedocks.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="commands.html">Next</a></td></tr><tr><td·class="prevCell">Sidedocks </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Command·Reference</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-state.html">Next</a></td></tr><tr><td·cl·✂ | 470 | </p></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-sidedocks.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="commands.html">Next</a></td></tr><tr><td·class="prevCell">Sidedocks </td><td·class="upCell">Basic·Concepts</td><td·class="nextCell"> Command·Reference</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="concepts-state.html">Next</a></td></tr><tr><td·cl·✂ |
| 471 | </p><div·class="variablelist"><dl><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">New</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>N</strong></span></strong></span>)</span></dt><dd><p> | 471 | </p><div·class="variablelist"><dl><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">New</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>N</strong></span></strong></span>)</span></dt><dd><p> |
| 472 | <span·class="action">Opens·an·empty·top-level·window</span>·in·which·you·can | 472 | <span·class="action">Opens·an·empty·top-level·window</span>·in·which·you·can |
| 473 | load·profile·data.·This·action·is·not·really·necessary,·as·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Open</span></span>·gives·you·a | 473 | load·profile·data.·This·action·is·not·really·necessary,·as·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Open</span></span>·gives·you·a |
| 474 | new·top-level·window·if·the·current·one·already·shows·some·data. | 474 | new·top-level·window·if·the·current·one·already·shows·some·data. |
| 475 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Open</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>O</strong></span></strong></span>)</span></dt><dd><p> | 475 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Open</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>O</strong></span></strong></span>)</span></dt><dd><p> |
| 476 | <span·class="action">Pops·up·the·<acronym·class="acronym">KDE</acronym>·file·selector</span>·to·choose·a | 476 | <span·class="action">Pops·up·the·<acronym·class="acronym">KDE</acronym>·file·selector</span>·to·choose·a |
| 477 | profile·data·file·to·be·loaded.·If·there·is·some·data·already·shown·in·the | 477 | profile·data·file·to·be·loaded.·If·there·is·some·data·already·shown·in·the |
| Offset 495, 62 lines modified | Offset 495, 62 lines modified |
| 495 | data·file·naming·convention.·For·example,·this·can·be·used·for·side-by-side | 495 | data·file·naming·convention.·For·example,·this·can·be·used·for·side-by-side |
| 496 | comparison. | 496 | comparison. |
| 497 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Reload</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>F5</strong></span></strong></span>)</span></dt><dd><p> | 497 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Reload</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>F5</strong></span></strong></span>)</span></dt><dd><p> |
| 498 | <span·class="action">Reload·the·profile·data</span>.·This·is·useful·when·another·profile | 498 | <span·class="action">Reload·the·profile·data</span>.·This·is·useful·when·another·profile |
| 499 | data·file·was·generated·for·an·already·loaded·application·run. | 499 | data·file·was·generated·for·an·already·loaded·application·run. |
| 500 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Quit</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>Q</strong></span></strong></span>)</span></dt><dd><p><span·class="action">Quits</span>·<span·class="application">KCachegrind</span></p></dd></dl></div><p> | 500 | </p></dd><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Quit</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>Q</strong></span></strong></span>)</span></dt><dd><p><span·class="action">Quits</span>·<span·class="application">KCachegrind</span></p></dd></dl></div><p> |
| 501 | </p></div></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-views.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="faq.html">Next</a></td></tr><tr><td·class="prevCell">Views </td><td·class="upCell"> </td><td·class="nextCell"> Questions·and·Answers</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="faq.html"><html><head><title>Chapter 5. Questions·and·Answers</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·co·✂ | 501 | </p></div></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="concepts-views.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="faq.html">Next</a></td></tr><tr><td·class="prevCell">Views </td><td·class="upCell"> </td><td·class="nextCell"> Questions·and·Answers</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="faq.html"><html><head><title>Chapter 5. Questions·and·Answers</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·co·✂ |
| 502 | You·can·find·the·latest·version·at·<a·class="ulink"·href="http://docs.kde.org/"·target="_top">http://docs.kde.org/</a>.</p><div·class="qandaset"><a·name="faqlist"></a><dl><dt>5.1.·<a·href="faq.html#idp148942392"> | 502 | You·can·find·the·latest·version·at·<a·class="ulink"·href="http://docs.kde.org/"·target="_top">http://docs.kde.org/</a>.</p><div·class="qandaset"><a·name="faqlist"></a><dl><dt>5.1.·<a·href="faq.html#idp148909624"> |
| 503 | What·is·KCachegrind·for?·I·have·no·idea. | 503 | What·is·KCachegrind·for?·I·have·no·idea. |
| 504 | </a></dt><dt>5.2.·<a·href="faq.html#idp148945592"> | 504 | </a></dt><dt>5.2.·<a·href="faq.html#idp148912824"> |
| 505 | What·is·the·difference·between·Incl.·and | 505 | What·is·the·difference·between·Incl.·and |
| 506 | Self? | 506 | Self? |
| 507 | </a></dt><dt>5.3.·<a·href="faq.html#idp148950584">The·toolbar·and·menubar·of·my·KCachegrind·look·spartan.·Is·this | 507 | </a></dt><dt>5.3.·<a·href="faq.html#idp148917816">The·toolbar·and·menubar·of·my·KCachegrind·look·spartan.·Is·this |
| 508 | normal?</a></dt><dt>5.4.·<a·href="faq.html#idp148956728"> | 508 | normal?</a></dt><dt>5.4.·<a·href="faq.html#idp148923960"> |
| 509 | If·I·double-click·on·a·function·down·in·the·Call·Graph | 509 | If·I·double-click·on·a·function·down·in·the·Call·Graph |
| 510 | view,·it·shows·for·function·main()·the·same·cost·as·the | 510 | view,·it·shows·for·function·main()·the·same·cost·as·the |
| 511 | selected·function.·Isn't·this·supposed·to·be·constant·at·100%? | 511 | selected·function.·Isn't·this·supposed·to·be·constant·at·100%? |
| 512 | </a></dt></dl><table·border="0"·width="100%"·summary="Q·and·A·Set"><col·align="left"·width="1%"><col><tbody><tr·class="question"><td·align="left"·valign="top"><a·name="idp148942392"></a><a·name="idp148942648"></a><p><b>5.1.</b></p></td><td·align="left"·valign="top"><p> | 512 | </a></dt></dl><table·border="0"·width="100%"·summary="Q·and·A·Set"><col·align="left"·width="1%"><col><tbody><tr·class="question"><td·align="left"·valign="top"><a·name="idp148909624"></a><a·name="idp148909880"></a><p><b>5.1.</b></p></td><td·align="left"·valign="top"><p> |
| 513 | What·is·<span·class="application">KCachegrind</span>·for?·I·have·no·idea. | 513 | What·is·<span·class="application">KCachegrind</span>·for?·I·have·no·idea. |
| 514 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> | 514 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> |
| 515 | <span·class="application">KCachegrind</span>·is·a·helpful·at·a·late·stage·in·software·development,·called | 515 | <span·class="application">KCachegrind</span>·is·a·helpful·at·a·late·stage·in·software·development,·called |
| 516 | profiling.·If·you·don't·develop·applications,·you·don't·need·<span·class="application">KCachegrind</span>. | 516 | profiling.·If·you·don't·develop·applications,·you·don't·need·<span·class="application">KCachegrind</span>. |
| 517 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148945592"></a><a·name="idp148945848"></a><p><b>5.2.</b></p></td><td·align="left"·valign="top"><p> | 517 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148912824"></a><a·name="idp148913080"></a><p><b>5.2.</b></p></td><td·align="left"·valign="top"><p> |
| 518 | What·is·the·difference·between·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Incl.</span></span>·and | 518 | What·is·the·difference·between·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Incl.</span></span>·and |
| 519 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Self</span></span>? | 519 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Self</span></span>? |
| 520 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p>These·are·cost·attributes·for·functions·regarding·some·event·type.·As | 520 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p>These·are·cost·attributes·for·functions·regarding·some·event·type.·As |
| 521 | functions·can·call·each·other,·it·makes·sense·to·distinguish·the·cost·of·the | 521 | functions·can·call·each·other,·it·makes·sense·to·distinguish·the·cost·of·the |
| 522 | function·itself·(<span·class="quote">“<span·class="quote">Self·Cost</span>”</span>)·and·the·cost·including·all·called | 522 | function·itself·(<span·class="quote">“<span·class="quote">Self·Cost</span>”</span>)·and·the·cost·including·all·called |
| 523 | functions·(<span·class="quote">“<span·class="quote">Inclusive·Cost</span>”</span>).·<span·class="quote">“<span·class="quote">Self</span>”</span>·is·sometimes·also | 523 | functions·(<span·class="quote">“<span·class="quote">Inclusive·Cost</span>”</span>).·<span·class="quote">“<span·class="quote">Self</span>”</span>·is·sometimes·also |
| 524 | referred·to·as·<span·class="quote">“<span·class="quote">Exclusive</span>”</span>·costs. | 524 | referred·to·as·<span·class="quote">“<span·class="quote">Exclusive</span>”</span>·costs. |
| 525 | </p><p> | 525 | </p><p> |
| 526 | So,·for·example,·for·<code·class="function">main()</code>,·you·will·always·have·an | 526 | So,·for·example,·for·<code·class="function">main()</code>,·you·will·always·have·an |
| 527 | inclusive·cost·of·almost·100%,·whereas·the·self·cost·is·negligible·when·the·real | 527 | inclusive·cost·of·almost·100%,·whereas·the·self·cost·is·negligible·when·the·real |
| 528 | work·is·done·in·another·function. | 528 | work·is·done·in·another·function. |
| 529 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148950584"></a><a·name="idp148950840"></a><p><b>5.3.</b></p></td><td·align="left"·valign="top"><p>The·toolbar·and·menubar·of·my·<span·class="application">KCachegrind</span>·look·spartan.·Is·this | 529 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148917816"></a><a·name="idp148918072"></a><p><b>5.3.</b></p></td><td·align="left"·valign="top"><p>The·toolbar·and·menubar·of·my·<span·class="application">KCachegrind</span>·look·spartan.·Is·this |
| 530 | normal?</p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> | 530 | normal?</p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> |
| 531 | <span·class="application">KCachegrind</span>·has·probably·been·installed·incorrectly·on·your·system.·It·is | 531 | <span·class="application">KCachegrind</span>·has·probably·been·installed·incorrectly·on·your·system.·It·is |
| 532 | recommended·to·compile·it·with·the·installation·prefix·set·to·your·system-wide | 532 | recommended·to·compile·it·with·the·installation·prefix·set·to·your·system-wide |
| 533 | <acronym·class="acronym">KDE</acronym>·base·folder,·like·<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>configure | 533 | <acronym·class="acronym">KDE</acronym>·base·folder,·like·<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>configure |
| 534 | <span·class="option"><code·class="option">--prefix=<span·class="replaceable"><em·class="replaceable"><code>/opt/kde4</code></em></span></code></span></strong></span></span>; | 534 | <span·class="option"><code·class="option">--prefix=<span·class="replaceable"><em·class="replaceable"><code>/opt/kde4</code></em></span></code></span></strong></span></span>; |
| 535 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>make·install</strong></span></span></code></strong>. | 535 | <span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>make·install</strong></span></span></code></strong>. |
| 536 | If·you·choose·another·folder,·like·<code·class="filename">$<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="envar"><code·class="envar">HOME</code></span>/kde</code>,·you·should·set·the | 536 | If·you·choose·another·folder,·like·<code·class="filename">$<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="envar"><code·class="envar">HOME</code></span>/kde</code>,·you·should·set·the |
| 537 | environment·variable·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="envar"><code·class="envar">KDEDIR</code></span>·to·this·folder·before·running | 537 | environment·variable·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="envar"><code·class="envar">KDEDIR</code></span>·to·this·folder·before·running |
| 538 | <span·class="application">KCachegrind</span>. | 538 | <span·class="application">KCachegrind</span>. |
| 539 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148956728"></a><a·name="idp148956984"></a><p><b>5.4.</b></p></td><td·align="left"·valign="top"><p> | 539 | </p></td></tr><tr·class="question"><td·align="left"·valign="top"><a·name="idp148923960"></a><a·name="idp148924216"></a><p><b>5.4.</b></p></td><td·align="left"·valign="top"><p> |
| 540 | If·I·double-click·on·a·function·down·in·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Call·Graph</span></span> | 540 | If·I·double-click·on·a·function·down·in·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Call·Graph</span></span> |
| 541 | view,·it·shows·for·function·<code·class="function">main()</code>·the·same·cost·as·the | 541 | view,·it·shows·for·function·<code·class="function">main()</code>·the·same·cost·as·the |
| 542 | selected·function.·Isn't·this·supposed·to·be·constant·at·100%? | 542 | selected·function.·Isn't·this·supposed·to·be·constant·at·100%? |
| 543 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> | 543 | </p></td></tr><tr·class="answer"><td·align="left"·valign="top"></td><td·align="left"·valign="top"><p> |
| 544 | You·have·activated·a·function·below·<code·class="function">main()</code>,·which·obviously | 544 | You·have·activated·a·function·below·<code·class="function">main()</code>,·which·obviously |
| 545 | costs·less·than·<code·class="function">main()</code>·itself.·For·every·function,·it·is | 545 | costs·less·than·<code·class="function">main()</code>·itself.·For·every·function,·it·is |
| 546 | shown·only·the·part·of·the·cost·spent·while·the·<span·class="emphasis"><em>activated</em></span> | 546 | shown·only·the·part·of·the·cost·spent·while·the·<span·class="emphasis"><em>activated</em></span> |
| 547 | function·is·running;·that·is,·the·cost·shown·for·any·function·can·never·be | 547 | function·is·running;·that·is,·the·cost·shown·for·any·function·can·never·be |
| 548 | higher·than·the·cost·of·the·activated·function. | 548 | higher·than·the·cost·of·the·activated·function. |
| 549 | </p></td></tr></tbody></table></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="commands.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="go01.html">Next</a></td></tr><tr><td·class="prevCell">Command·Reference </td><td·class="upCell"> </td><td·class="nextCell"> Glossary</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="go01.html"><html><head><title>Glossary</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="Do·✂ | 549 | </p></td></tr></tbody></table></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="commands.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="go01.html">Next</a></td></tr><tr><td·class="prevCell">Command·Reference </td><td·class="upCell"> </td><td·class="nextCell"> Glossary</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="go01.html"><html><head><title>Glossary</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="Do·✂ |
| 550 | can·be·attributed.·Dimensions·for·cost·entities·are·code·location·(<abbr·class="abbrev">e.g.</abbr>·source | 550 | can·be·attributed.·Dimensions·for·cost·entities·are·code·location·(<abbr·class="abbrev">e.g.</abbr>·source |
| 551 | line,·function),·data·location·(<abbr·class="abbrev">e.g.</abbr>·accessed·data·type,·data·object),·execution | 551 | line,·function),·data·location·(<abbr·class="abbrev">e.g.</abbr>·accessed·data·type,·data·object),·execution |
| 552 | location·(<abbr·class="abbrev">e.g.</abbr>·thread,·process),·and·tuples·or·triples·of·the·aforementioned | 552 | location·(<abbr·class="abbrev">e.g.</abbr>·thread,·process),·and·tuples·or·triples·of·the·aforementioned |
| 553 | positions·(<abbr·class="abbrev">e.g.</abbr>·calls,·object·access·from·statement,·evicted·data·from | 553 | positions·(<abbr·class="abbrev">e.g.</abbr>·calls,·object·access·from·statement,·evicted·data·from |
| 554 | cache).</p></dd><dt><a·name="eventcosts"></a>Event·Costs</dt><dd><p>Sum·of·events·of·some·event·type·occurring·while·the·execution | 554 | cache).</p></dd><dt><a·name="eventcosts"></a>Event·Costs</dt><dd><p>Sum·of·events·of·some·event·type·occurring·while·the·execution |
| 555 | is·related·to·some·cost·entity.·The·cost·is·attributed·to·the | 555 | is·related·to·some·cost·entity.·The·cost·is·attributed·to·the |
| 556 | entity.</p></dd><dt><a·name="eventtype"></a>Event·Type</dt><dd><p>The·kind·of·event·of·which·costs·can·be·attributed·to·a·cost | 556 | entity.</p></dd><dt><a·name="eventtype"></a>Event·Type</dt><dd><p>The·kind·of·event·of·which·costs·can·be·attributed·to·a·cost |