Differential D28940 Diff 84801 usr.sbin/newsyslog/newsyslog.conf.5

Changeset View

Standalone View

usr.sbin/newsyslog/newsyslog.conf.5

	Show All 15 Lines
	.\" this permission notice appear in supporting documentation,			.\" this permission notice appear in supporting documentation,
	.\" and that the names of M.I.T. and the M.I.T. S.I.P.B. not be			.\" and that the names of M.I.T. and the M.I.T. S.I.P.B. not be
	.\" used in advertising or publicity pertaining to distribution			.\" used in advertising or publicity pertaining to distribution
	.\" of the software without specific, written prior permission.			.\" of the software without specific, written prior permission.
	.\" M.I.T. and the M.I.T. S.I.P.B. make no representations about			.\" M.I.T. and the M.I.T. S.I.P.B. make no representations about
	.\" the suitability of this software for any purpose. It is			.\" the suitability of this software for any purpose. It is
	.\" provided "as is" without express or implied warranty.			.\" provided "as is" without express or implied warranty.
	.\"			.\"
	.Dd August 21, 2018			.Dd February 26, 2021
	.Dt NEWSYSLOG.CONF 5			.Dt NEWSYSLOG.CONF 5
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm newsyslog.conf			.Nm newsyslog.conf
	.Nd			.Nd
	.Xr newsyslog 8			.Xr newsyslog 8
	configuration file			configuration file
	.Sh DESCRIPTION			.Sh DESCRIPTION
	▲ Show 20 Lines • Show All 247 Lines • ▼ Show 20 Lines
	indicates that			indicates that
	.Xr newsyslog 8			.Xr newsyslog 8
	should set the			should set the
	.Dv UF_NODUMP			.Dv UF_NODUMP
	flag when creating a new version of			flag when creating a new version of
	this log file.			this log file.
	This option would affect how the			This option would affect how the
	.Xr dump 8			.Xr dump 8
	command treats the log file when making a file system backup.			command treats the log file when making a file system backup.
				.It Cm E
				indicates that the log file should not be rotated when its
				size is zero.
				markjUnsubmitted Done Inline Actions I'd suggest adding a sentence noting that this option is not very useful without 'B'. It would be cool if we could also avoid rotation if the file only contains the message from the previous rotation, but I'm not sure how best to approach that. markj: I'd suggest adding a sentence noting that this option is not very useful without 'B'. It would…
				otisAuthorUnsubmitted Done Inline Actions I'd suggest adding a sentence noting that this option is not very useful without 'B'. It would be cool if we could also avoid rotation if the file only contains the message from the previous rotation, but I'm not sure how best to approach that. A mention of `B` has been added I was thinking about it, it can be subject to another RR in near future. otis: > I'd suggest adding a sentence noting that this option is not very useful without 'B'. > > It…
				dvlUnsubmitted Done Inline Actions Perhaps also mention: don't use compression. e.g. JXYZ dvl: Perhaps also mention: don't use compression. e.g. JXYZ
				otisAuthorUnsubmitted Done Inline Actions Perhaps also mention: don't use compression. e.g. JXYZ As has been mentioned on IRC, compression does not matter in this case, as `B` ensures that the new file is empty and rotated file can be compressed anyway. otis: > Perhaps also mention: don't use compression. e.g. JXYZ As has been mentioned on IRC…
				The
				.Cm E
				flag is mostly useful in conjunction with
				.Cm B
				flag to prevent
				.Xr newsyslog 8
				from inserting an informational
				.Tn ASCII
				message into the new file.
	.It Cm G			.It Cm G
				markjUnsubmitted Done Inline Actions New sentences should start on new lines. markj: New sentences should start on new lines.
	indicates that the specified			indicates that the specified
	.Ar logfile_name			.Ar logfile_name
	is a shell pattern, and that			is a shell pattern, and that
	.Xr newsyslog 8			.Xr newsyslog 8
	should archive all filenames matching that pattern using the			should archive all filenames matching that pattern using the
	other options on this line.			other options on this line.
	See			See
	.Xr glob 3			.Xr glob 3
	▲ Show 20 Lines • Show All 126 Lines • Show Last 20 Lines