source: general/prog/sysprof.xml@ b7e2ce4

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since b7e2ce4 was b7e2ce4, checked in by Bruce Dubbs <bdubbs@…>, 19 months ago

Add --buildtype=release for all packages that need it through Chapter 13.

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY sysprof-download-http "&gnome-download-http;/sysprof/&gnome-minor-40;/sysprof-&sysprof-version;.tar.xz">
8 <!ENTITY sysprof-download-ftp "&gnome-download-ftp;/sysprof/&gnome-minor-40;/sysprof-&sysprof-version;.tar.xz">
9 <!ENTITY sysprof-md5sum "05d1399cb3ab923b03603b10acd8d40e">
10 <!ENTITY sysprof-size "460 KB">
11 <!ENTITY sysprof-buildsize "20 MB">
12 <!ENTITY sysprof-time "0.1 SBU (using parallelism=4)">
13
14]>
15
16<sect1 id="sysprof" xreflabel="sysprof-&sysprof-version;">
17 <?dbhtml filename="sysprof.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Sysprof-&sysprof-version;</title>
24
25 <indexterm zone="sysprof">
26 <primary sortas="a-sysprof">sysprof</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Sysprof</title>
31
32 <para>
33 The <application>sysprof</application> package contains a statistical and
34 system-wide profiler for Linux.
35 </para>
36
37 &lfs101_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&sysprof-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&sysprof-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &sysprof-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &sysprof-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &sysprof-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &sysprof-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Sysprof Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="gtk3"/>,
78 <xref linkend="json-glib"/>,
79 <xref linkend="libdazzle"/>, <phrase revision="systemd">and</phrase>
80 <xref linkend="polkit"/> <phrase revision="sysv">, and</phrase>
81 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <ulink url="http://www.nongnu.org/libunwind">libunwind</ulink>
87 </para>
88
89 <para condition="html" role="usernotes">
90 User Notes: <ulink url="&blfs-wiki;/sysprof"/>
91 </para>
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of Sysprof</title>
96
97 <para>
98 Install <application>Sysprof</application> by running the following
99 commands:
100 </para>
101
102<screen revision="sysv"><userinput>mkdir build &amp;&amp;
103cd build &amp;&amp;
104
105meson --prefix=/usr --buildtype=release -Dsystemdunitdir=/tmp .. &amp;&amp;
106ninja</userinput></screen>
107
108<screen revision="systemd"><userinput>mkdir build &amp;&amp;
109cd build &amp;&amp;
110
111meson --prefix=/usr .. &amp;&amp;
112ninja</userinput></screen>
113
114 <para>
115 To test the results, issue: <command>ninja test</command>.
116 </para>
117
118 <para>
119 Now, as the <systemitem class="username">root</systemitem> user:
120 </para>
121
122<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
123rm -v /tmp/*.service</userinput></screen>
124
125<screen role="root" revision="systemd"><userinput>ninja install</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands" revision="sysv">
130 <title>Command Explanations</title>
131
132 <para>
133 <command>rm -v /tmp/*.service</command>: This command removes
134 systemd units which have no use on SysV systems.
135 </para>
136
137 <para>
138 <parameter>-Dsystemdunitdir=/tmp</parameter>: This parameter puts systemd
139 units in /tmp on SysV systems so that they can be removed. It also bypasses
140 a check for systemd <!-- for sd-bus --> in the meson.build file.
141 </para>
142
143 </sect2>
144
145 <sect2 role="content">
146 <title>Contents</title>
147
148 <segmentedlist>
149 <segtitle>Installed Programs</segtitle>
150 <segtitle>Installed Libraries</segtitle>
151 <segtitle>Installed Directories</segtitle>
152
153 <seglistitem>
154 <seg>
155 sysprof and sysprof-cli
156 </seg>
157 <seg>
158 libsysprof-4.so,
159 libsysprof-capture-4.a, <!-- is required -->
160 libsysprof-memory-4.so,
161 libsysprof-speedtrack-4.so, and
162 libsysprof-ui-4.so
163 </seg>
164 <seg>
165 /usr/include/sysprof-4 and
166 /usr/share/help/*/sysprof
167 </seg>
168 </seglistitem>
169 </segmentedlist>
170
171 <variablelist>
172 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
173 <?dbfo list-presentation="list"?>
174 <?dbhtml list-presentation="table"?>
175
176 <varlistentry id="sysprof-prog">
177 <term><command>sysprof</command></term>
178 <listitem>
179 <para>
180 is a graphical interface to sysprof
181 </para>
182 <indexterm zone="sysprof sysprof-prog">
183 <primary sortas="b-sysprof">sysprof</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="sysprof-cli">
189 <term><command>sysprof-cli</command></term>
190 <listitem>
191 <para>
192 is a command line interface to sysprof
193 </para>
194 <indexterm zone="sysprof sysprof-cli">
195 <primary sortas="b-sysprof-cli">sysprof-cli</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="libsysprof-4">
201 <term><filename class="libraryfile">libsysprof-4.so</filename></term>
202 <listitem>
203 <para>
204 provides API functions for profiling processes running on a system
205 </para>
206 <indexterm zone="sysprof libsysprof-4">
207 <primary sortas="c-libsysprof">libsysprof-4.so</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <!-- static library is required for capture stats from a process -->
213 <varlistentry id="libsysprof-capture-4">
214 <term><filename class="libraryfile">libsysprof-capture-4.a</filename></term>
215 <listitem>
216 <para>
217 provides a hook used to capture statistics from a process
218 </para>
219 <indexterm zone="sysprof libsysprof-capture-4">
220 <primary sortas="c-libsysprof-capture">libsysprof-capture-4.a</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libsysprof-memory-4">
226 <term><filename class="libraryfile">libsysprof-memory-4.so</filename></term>
227 <listitem>
228 <para>
229 provides API functions for capturing memory statistics
230 </para>
231 <indexterm zone="sysprof libsysprof-memory-4">
232 <primary sortas="c-libsysprof-memory">libsysprof-memory-4.so</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="libsysprof-speedtrack-4">
238 <term><filename class="libraryfile">libsysprof-speedtrack-4.so</filename></term>
239 <listitem>
240 <para>
241 provides API functions for tracking the speed of a running process
242 </para>
243 <indexterm zone="sysprof libsysprof-speedtrack-4">
244 <primary sortas="c-libsysprof-speedtrack">libsysprof-speedtrack-4.so</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libsysprof-ui-4">
250 <term><filename class="libraryfile">libsysprof-ui-4.so</filename></term>
251 <listitem>
252 <para>
253 provides API functions for the sysprof GUI
254 </para>
255 <indexterm zone="sysprof libsysprof-ui-4">
256 <primary sortas="c-libsysprof-ui">libsysprof-ui-4.so</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260 </variablelist>
261 </sect2>
262
263</sect1>
Note: See TracBrowser for help on using the repository browser.