fa124114ae
Cleaned up some output from readbootlog. Added -e flg to bootlogd. When -e is used, data saved to the boot log file does not have escape characters removed. This means colour and cursor movement codes stay in the log file. The may then look nicer when read with "less -R', but may appear cluttered or out of alignment when viewed with other, plain-text tools.
83 lines
3.3 KiB
Groff
83 lines
3.3 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 [ \-e ]
|
|
.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\-e\fP
|
|
Print escape characters to the boot log file. This turns off filtering of
|
|
escape characters and allows tools like GNU Less to see and use colour control
|
|
characters (show the log in colour).
|
|
.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).
|