systemd-bootchart.xml revision ccc9a4f9ffdab069b0b785627c48962fdadf6d46
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok This file is part of systemd.
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok Copyright 2012 Intel Corporation
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok Auke Kok <auke-jan.h.kok@intel.com>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok systemd is free software; you can redistribute it and/or modify it
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok under the terms of the GNU Lesser General Public License as published by
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok the Free Software Foundation; either version 2.1 of the License, or
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok (at your option) any later version.
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok systemd is distributed in the hope that it will be useful, but
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok WITHOUT ANY WARRANTY; without even the implied warranty of
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok Lesser General Public License for more details.
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok You should have received a copy of the GNU Lesser General Public License
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok along with systemd; If not, see <http://www.gnu.org/licenses/>.
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <refentryinfo>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <authorgroup>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </authorgroup>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refentryinfo>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <refnamediv>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <refpurpose>Boot performance analysis graphing tool</refpurpose>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refnamediv>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <para>Systemd-bootchart is an boot time analysis tool. It represents
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok various aspects of the system as graph elements. These graph
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok elements allow the user to determine resource usage, efficiency
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok and performance issues.</para>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refsect1>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <para>systemd-bootchart can be invoked in several different ways:</para>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <varlistentry>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <listitem><para>The kernel can invoke systemd-bootchart
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok instead of the init process. In itself, systemd-bootchart
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok will invoke <filename>/sbin/init</filename> if invoked in
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </varlistentry>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <varlistentry>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <listitem><para>One can execute systemd-bootchart as
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok normal application from the commandline. In this mode
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok it is highly recommended to pass the "-r" flag in order
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok to not graph the time elapsed since boot and before
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok systemd-bootchart was started, as it may result in
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok extremely large graphs.
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </varlistentry>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </variablelist>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refsect1>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <para>Please read systemd-bootchart --help or the bootchart.conf manual
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok page for information about the various options that influence how
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok systemd-bootchart operates.</para>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refsect1>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <para>Systemd-bootchart generates SVG graphs. In order to render these
1959c6ce940786d33f91e19c41441bf4c9f6a768Thomas Hindoe Paaboel Andersen on a graphical display any SVG capable viewer can be used. It should be
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok noted that the SVG render engines in most browsers (including Chrome
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok and Firefox) are many times faster than dedicated graphical applications
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok like Gimp and Inkscape. Just point your browser at "file:///var/log"!
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refsect1>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok <citerefentry><refentrytitle>bootchart.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
83fdc450aa8f79941bec84488ffd5bf8eadab18eAuke Kok </refsect1>