<?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">

<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>