Blame - misc/logsave.8.in - platform/external/e2fsprogs

blob: cc3ffde3fb0ff8bc2b4078958e4c187b85af6bd3 [file] [log] [blame]

Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	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.
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	4	.\"
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	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	[
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	11	.B \-asv
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	12	]
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	13	.I logfile cmd_prog [ ... ]
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	14	.SH DESCRIPTION
				15	The
				16	.B logsave
				17	program will execute
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	18	.I cmd_prog
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	19	with the specified argument(s), and save a copy of its output to
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	20	.IR logfile .
				21	If the containing directory for
				22	.I logfile
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	23	does not exist,
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	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
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	28	If
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	29	.I cmd_prog
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	30	is a single hyphen ('-'), then instead of executing a program,
				31	.B logsave
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	32	will take its input from standard input and save it in
				33	.I logfile
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	34	.PP
				35	.B logsave
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	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
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	38	/var/log.
				39	.SH OPTIONS
				40	.TP
				41	.B \-a
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	42	This option will cause the output to be appended to
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	43	.IR logfile ,
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	44	instead of replacing its current contents.
				45	.TP
				46	.B \-s
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	47	This option will cause
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	48	.B logsave
Theodore Ts'o	d04ad32	2017-08-04 01:51:50 -0400	[diff] [blame]	49	to skip writing to the log file text which is bracketed with a control-A
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	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.
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	53	.TP
				54	.B \-v
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	55	This option will make
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	56	.B logsave
Theodore Ts'o	bc34d6b	2003-04-16 14:05:06 -0400	[diff] [blame]	57	to be more verbose in its output to the user.
Theodore Ts'o	f9ddad5	2003-04-14 18:05:12 -0400	[diff] [blame]	58	.SH AUTHOR
				59	Theodore Ts'o (tytso@mit.edu)
				60	.SH SEE ALSO
				61	.BR fsck (8)