1 files changed, 88 insertions, 0 deletions
diff --git a/man/bootchart.conf.5 b/man/bootchart.conf.5
new file mode 100644
index 0000000000..901d343cd4
--- /dev/null
+++ b/man/bootchart.conf.5
@@ -0,0 +1,88 @@
+'\" t
+.TH "BOOTCHART\&.CONF" "5" "" "systemd 208" "bootchart.conf"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+bootchart.conf \- Boot performance analysis graphing tool configuration file
+.SH "SYNOPSIS"
+.PP
+/etc/systemd/bootchart\&.conf
+.SH "DESCRIPTION"
+.PP
+When starting, systemd\-bootchart will read the configuration file
+bootchart\&.conf\&. This configuration file determines logging parameters and graph output\&.
+.SH "OPTIONS"
+.PP
+\fISamples=500\fR
+.RS 4
+Configure the amount of samples to record in total before bootchart exits\&. Each sample will record at intervals defined by Frequency=\&.
+.RE
+.PP
+\fIFrequency=25\fR
+.RS 4
+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\&.
+.RE
+.PP
+\fIRelative=no\fR
+.RS 4
+Configures whether the left axis of the output graph equals time=0\&.0 (\fBCLOCK_MONOTONIC\fR
+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\&.
+.RE
+.PP
+\fIFilter=no\fR
+.RS 4
+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\&.
+.RE
+.PP
+\fIOutput=[path]\fR
+.RS 4
+Configures the output directory for writing the graphs\&. By default, bootchart writes the graphs to
+/run/log\&.
+.RE
+.PP
+\fIInit=[path]\fR
+.RS 4
+Configures bootchart to run a non\-standard binary instead of
+/sbin/init\&. This option is only relevant if bootchart was invoked from the kernel command line with init=/usr/lib/systemd/systemd\-bootchart\&.
+.RE
+.PP
+\fIPlotMemoryUsage=no\fR
+.RS 4
+If set to yes, enables logging and graphing of processes\*(Aq PSS memory consumption\&.
+.RE
+.PP
+\fIPlotEntropyGraph=no\fR
+.RS 4
+If set to yes, enables logging and graphing of the kernel random entropy pool size\&.
+.RE
+.PP
+\fIScaleX=100\fR
+.RS 4
+Horizontal scaling factor for all variable graph components\&.
+.RE
+.PP
+\fIScaleY=20\fR
+.RS 4
+Vertical scaling factor for all variable graph components\&.
+.RE
+.SH "SEE ALSO"
+.PP
+\fBsystemd-bootchart\fR(1),
+\fBsystemd.directives\fR(7)