165 lines
7.7 KiB
XML
165 lines
7.7 KiB
XML
<?xml version='1.0'?> <!--*-nxml-*-->
|
|
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
|
|
<!--
|
|
This file is part of systemd.
|
|
|
|
Copyright 2012 Intel Corporation
|
|
|
|
Authors:
|
|
Auke Kok <auke-jan.h.kok@intel.com>
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
systemd is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
-->
|
|
|
|
<refentry id="bootchart.conf" conditional='ENABLE_BOOTCHART'>
|
|
<refentryinfo>
|
|
<title>bootchart.conf</title>
|
|
<productname>systemd</productname>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<contrib>Developer</contrib>
|
|
<firstname>Auke</firstname>
|
|
<surname>Kok</surname>
|
|
<email>auke-jan.h.kok@intel.com</email>
|
|
</author>
|
|
</authorgroup>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>bootchart.conf</refentrytitle>
|
|
<manvolnum>5</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>bootchart.conf</refname>
|
|
<refpurpose>Boot performance analysis graphing tool configuration file</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><filename>/etc/systemd/bootchart.conf</filename></para>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>When starting, systemd-bootchart will read the
|
|
configuration file <filename>bootchart.conf</filename>.
|
|
This configuration file determines logging parameters and
|
|
graph output.</para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Options</title>
|
|
|
|
<variablelist class='bootchart-directives'>
|
|
|
|
<varlistentry>
|
|
<term><varname>Samples=500</varname></term>
|
|
<listitem><para>Configure the amount of samples to
|
|
record in total before bootchart exits. Each sample will
|
|
record at intervals defined by Frequency=.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>Frequency=25</varname></term>
|
|
<listitem><para>Configure the sample log frequency.
|
|
This can be a fractional number, but must be larger than
|
|
0.0. Most systems can cope with values under 25-50 without
|
|
impacting boot time severely.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>Relative=no</varname></term>
|
|
<listitem><para>Configures whether the left axis of the
|
|
output graph equals time=0.0 (<constant>CLOCK_MONOTONIC</constant> start). This
|
|
is useful for using bootchart at post-boot time to profile
|
|
an already booted system, otherwise the graph would become
|
|
extremely large. If set to yes, the horizontal axis starts
|
|
at the first recorded sample instead of time=0.0.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>Filter=no</varname></term>
|
|
<listitem><para>Configures whether the resulting graph
|
|
should omit tasks that did not contribute significantly
|
|
to the boot. Processes that are too short-lived (only
|
|
seen in one sample) or that do not consume any significant
|
|
CPU time (less than 0.001sec) will not be displayed in
|
|
the output graph.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>Output=[path]</varname></term>
|
|
<listitem><para>Configures the output directory for writing
|
|
the graphs. By default, bootchart writes the graphs to
|
|
<filename>/run/log</filename>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>Init=[path]</varname></term>
|
|
<listitem><para>Configures bootchart to run a non-standard
|
|
binary instead of <filename>/sbin/init</filename>. This
|
|
option is only relevant if bootchart was invoked from the
|
|
kernel command line with
|
|
init=/usr/lib/systemd/systemd-bootchart.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>PlotMemoryUsage=no</varname></term>
|
|
<listitem><para>If set to yes, enables logging and graphing
|
|
of processes' PSS memory consumption.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>PlotEntropyGraph=no</varname></term>
|
|
<listitem><para>If set to yes, enables logging and graphing
|
|
of the kernel random entropy pool size.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>ScaleX=100</varname></term>
|
|
<listitem><para>Horizontal scaling factor for all variable
|
|
graph components.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>ScaleY=20</varname></term>
|
|
<listitem><para>Vertical scaling factor for all variable
|
|
graph components.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>ControlGroup=no</varname></term>
|
|
<listitem><para>Display process control group.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd-bootchart</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|