Whamcloud - gitweb
Merge branch 'maint' into next
[tools/e2fsprogs.git] / misc / logsave.8.in
1 .\" -*- nroff -*-
2 .\" Copyright 2003 by Theodore Ts'o.  All Rights Reserved.
3 .\" This file may be copied under the terms of the GNU Public License.
4 .\"
5 .TH LOGSAVE 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
6 .SH NAME
7 logsave \- save the output of a command in a logfile
8 .SH SYNOPSIS
9 .B logsave
10 [
11 .B \-asv
12 ]
13 .I logfile cmd_prog [ ... ]
14 .SH DESCRIPTION
15 The
16 .B logsave
17 program will execute
18 .I cmd_prog
19 with the specified argument(s), and save a copy of its output to
20 .IR logfile .
21 If the containing directory for
22 .I logfile
23 does not exist,
24 .B logsave
25 will accumulate the output in memory until it can be written out.
26 A copy of the output will also be written to standard output.
27 .PP
28 If
29 .I cmd_prog
30 is a single hyphen ('-'), then instead of executing a program,
31 .B logsave
32 will take its input from standard input and save it in
33 .I logfile
34 .PP
35 .B logsave
36 is useful for saving the output of initial boot scripts
37 until the /var partition is mounted, so the output can be written to
38 /var/log.
39 .SH OPTIONS
40 .TP
41 .B \-a
42 This option will cause the output to be appended to
43 .IR logfile ,
44 instead of replacing its current contents.
45 .TP
46 .B \-s
47 This option will cause
48 .B logsave
49 to skip writing to the log file text which is bracketed with a control-A
50 (ASCII 001 or Start of Header) and control-B (ASCII 002 or Start of
51 Text).  This allows progress bar information to be visible to the user
52 on the console, while not being written to the log file.
53 .TP
54 .B \-v
55 This option will make
56 .B logsave
57 to be more verbose in its output to the user.
58 .SH AUTHOR
59 Theodore Ts'o (tytso@mit.edu)
60 .SH SEE ALSO
61 .BR fsck (8)