mirror of
https://github.com/varun-r-mallya/sysprof.git
synced 2025-12-31 20:36:25 +00:00
help: update a few docs
This commit is contained in:
@ -39,29 +39,6 @@ results</link> for more guidance.</p>
|
|||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
<section id="existing-process-profiling">
|
|
||||||
<info>
|
|
||||||
<link type="guide" xref="index#profiling"/>
|
|
||||||
</info>
|
|
||||||
<title>Profile an existing process</title>
|
|
||||||
<p>With <app>Sysprof</app>, you can profile one or more existing
|
|
||||||
processes on your system. First, select the <em>profiling target</em>
|
|
||||||
button next to the <em>Record</em> button. Select <em>Existing Process</em>
|
|
||||||
in the popover that is displayed. Next, select as many processes as you'd
|
|
||||||
like to profile. Processes selected for profiling will have a checkmark
|
|
||||||
next to their name.</p>
|
|
||||||
|
|
||||||
<p>After selecting your target processes, click the <em>Record</em>
|
|
||||||
button to start profiling.</p>
|
|
||||||
|
|
||||||
<p>When you have completed, click the <em>Record</em> button again
|
|
||||||
to stop profiling.</p>
|
|
||||||
|
|
||||||
<p>See <link href="profiling#interpreting-results">interpreting
|
|
||||||
results</link> for more guidance.</p>
|
|
||||||
|
|
||||||
</section>
|
|
||||||
|
|
||||||
<section id="new-process-profiling">
|
<section id="new-process-profiling">
|
||||||
<info>
|
<info>
|
||||||
<link type="guide" xref="index#profiling"/>
|
<link type="guide" xref="index#profiling"/>
|
||||||
@ -69,9 +46,10 @@ results</link> for more guidance.</p>
|
|||||||
<title>Profile a new process</title>
|
<title>Profile a new process</title>
|
||||||
|
|
||||||
<p>Often times, you may need to spawn a new process to profile.
|
<p>Often times, you may need to spawn a new process to profile.
|
||||||
First, select the <em>profiling target</em> button next to the
|
First, select the <em>Application</em> button next at the top of the
|
||||||
<em>Record</em> button. Next, select <em>New Process</em> and fill
|
reocrding window. Fill in your command and working directory, and optionally
|
||||||
out the necessary information to spawn the process.</p>
|
specify any environment variables you need. Your process will be started
|
||||||
|
when recording begins.</p>
|
||||||
|
|
||||||
<note>
|
<note>
|
||||||
<p>If you are spawning a process that requires access to your current
|
<p>If you are spawning a process that requires access to your current
|
||||||
@ -92,10 +70,7 @@ command line tool. When run without any arguments, it will record your entire
|
|||||||
system and save the output to <file>capture.syscap</file>. This file can be
|
system and save the output to <file>capture.syscap</file>. This file can be
|
||||||
opened with the <app>Sysprof</app> application to view the callgraph.</p>
|
opened with the <app>Sysprof</app> application to view the callgraph.</p>
|
||||||
|
|
||||||
<p>You can also attach to an existing process using
|
<p>If you would like to spawn a new process, use <cmd>sysprof-cli --
|
||||||
<cmd>sysprof-cli -p pid</cmd>.</p>
|
|
||||||
|
|
||||||
<p>If you would like to spawn a new process, use <cmd>sysprof-cli -c
|
|
||||||
'command'</cmd> to specify a command to be launched. The command will inherit
|
'command'</cmd> to specify a command to be launched. The command will inherit
|
||||||
the current environment.</p>
|
the current environment.</p>
|
||||||
|
|
||||||
@ -126,11 +101,8 @@ stacktrace.</p>
|
|||||||
<p>On the right, are all of the decendants of a selected function. You can
|
<p>On the right, are all of the decendants of a selected function. You can
|
||||||
select a function either from the functions list, or the callers list.</p>
|
select a function either from the functions list, or the callers list.</p>
|
||||||
|
|
||||||
<p>You can jump into a function by activating a row in the tree of descendants
|
|
||||||
with a double-click or by pressing <key>Enter</key> or <key>Spacebar</key>.</p>
|
|
||||||
|
|
||||||
<note>
|
<note>
|
||||||
<p>If you see <em>- - kernel - -</em> in your results, that means that the
|
<p>If you see <em>- - Context Switch - -</em> in your results, that means that the
|
||||||
application transitioned into or from the Linux kernel. There can be many reasons
|
application transitioned into or from the Linux kernel. There can be many reasons
|
||||||
for this such as a <em>syscall</em> or <em>signal</em>.</p>
|
for this such as a <em>syscall</em> or <em>signal</em>.</p>
|
||||||
</note>
|
</note>
|
||||||
|
|||||||
Reference in New Issue
Block a user