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