78 lines
3.0 KiB
Groff
78 lines
3.0 KiB
Groff
'\" -*- coding: UTF-8 -*-
|
|
.\" Copyright (C) 1998-2003 Miquel van Smoorenburg.
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation; either version 2 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" This program 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 General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License
|
|
.\" along with this program; if not, write to the Free Software
|
|
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
.\"
|
|
.TH BOOTLOGD 8 "Jul 21, 2003" "" "Linux System Administrator's Manual"
|
|
.SH NAME
|
|
bootlogd \- record boot messages
|
|
.SH SYNOPSIS
|
|
.B /sbin/bootlogd
|
|
.RB [ \-c ]
|
|
.RB [ \-d ]
|
|
.RB [ \-r ]
|
|
.RB [ \-s ]
|
|
.RB [ \-v ]
|
|
.RB [ " -l logfile " ]
|
|
.RB [ " -p pidfile " ]
|
|
.SH DESCRIPTION
|
|
\fBBootlogd\fP runs in the background and copies all strings sent to the
|
|
\fI/dev/console\fP device to a logfile. If the logfile is not accessible,
|
|
the messages will be kept in memory until it is.
|
|
.SH OPTIONS
|
|
.IP \fB\-d\fP
|
|
Do not fork and run in the background.
|
|
.IP \fB\-c\fP
|
|
Attempt to write to the logfile even if it does not yet exist.
|
|
Without this option,
|
|
.B bootlogd
|
|
will wait for the logfile to appear before attempting to write to it.
|
|
This behavior prevents bootlogd from creating logfiles under mount points.
|
|
.IP \fB\-r\fP
|
|
If there is an existing logfile called \fIlogfile\fP rename it to
|
|
\fIlogfile~\fP unless \fIlogfile~\fP already exists.
|
|
.IP \fB\-s\fP
|
|
Ensure that the data is written to the file after each line by calling
|
|
.BR fdatasync (3).
|
|
This will slow down a
|
|
.BR fsck (8)
|
|
process running in parallel.
|
|
.IP \fB\-v\fP
|
|
Show version.
|
|
.IP "\fB\-l\fP \fIlogfile\fP"
|
|
Log to this logfile. The default is \fI/var/log/boot\fP.
|
|
.IP "\fB\-p\fP \fIpidfile\fP"
|
|
Put process-id in this file. The default is no pidfile.
|
|
.SH NOTES
|
|
bootlogd saves log data which includes control characters. The log is
|
|
technically a text file, but not very easy for humans to read. To address
|
|
this the readbootlog(1) command can be used to display the boot log
|
|
without the control characters.
|
|
.SH BUGS
|
|
Bootlogd works by redirecting the console output from the console device.
|
|
(Consequently \fBbootlogd\fP requires PTY support in the kernel configuration.)
|
|
It copies that output to the real console device and to a log file.
|
|
There is no standard way of ascertaining the real console device
|
|
if you have a new-style \fI/dev/console\fP device (major 5, minor 1)
|
|
so \fBbootlogd\fP parses the kernel command line looking for
|
|
\fBconsole=...\fP lines and deduces the real console device from that.
|
|
If that syntax is ever changed by the kernel, or a console type is used that
|
|
\fBbootlogd\fP does not know about then \fBbootlogd\fP will not work.
|
|
|
|
.SH AUTHOR
|
|
Miquel van Smoorenburg, miquels@cistron.nl
|
|
.SH "SEE ALSO"
|
|
.BR dmesg (8), fdatasync (3), readbootlog(1).
|