diff options
Diffstat (limited to 'usr.sbin/newsyslog/newsyslog.8')
-rw-r--r-- | usr.sbin/newsyslog/newsyslog.8 | 44 |
1 files changed, 23 insertions, 21 deletions
diff --git a/usr.sbin/newsyslog/newsyslog.8 b/usr.sbin/newsyslog/newsyslog.8 index e6286c9..c805197 100644 --- a/usr.sbin/newsyslog/newsyslog.8 +++ b/usr.sbin/newsyslog/newsyslog.8 @@ -1,7 +1,7 @@ .\" This file contains changes from the Open Software Foundation. .\" .\" from: @(#)newsyslog.8 -.\" $Id: newsyslog.8,v 1.7 1997/05/06 23:11:05 brian Exp $ +.\" $Id: newsyslog.8,v 1.8 1997/06/23 04:03:49 steve Exp $ .\" .\" Copyright 1988, 1989 by the Massachusetts Institute of Technology .\" @@ -33,7 +33,7 @@ is a program that should be scheduled to run periodically by .Xr cron 8 . When it is executed it archives log files if necessary. If a log file is determined to require archiving, -.Nm newsyslog +.Nm rearranges the files so that ``logfile'' is empty, ``logfile.0'' has the last period's logs in it, ``logfile.1'' has the next to last period's logs in it, and so on, up to a user-specified number of @@ -43,14 +43,14 @@ space. A log can be archived because of two reasons. The log file can have grown bigger than a preset size in kilobytes, or a preset number of hours may have elapsed since the last log archive. The granularity of -.Nm newsyslog +.Nm is dependent on how often it is scheduled to run by .Xr cron 8 . Since the program is quite fast, it may be scheduled to run every hour without any ill effects. .Pp When starting up, -.Nm newsyslog +.Nm reads in a configuration file to determine which logs should be looked at. By default, this configuration file is .Pa /etc/newsyslog.conf . @@ -62,11 +62,11 @@ whitespace separating each field. Blank lines or lines beginning with ``#'' are ignored. The fields of the configuration file are as follows: .Pp -.Bl -tag -width logfile_namexxxx +.Bl -tag -width indent .It Ar logfile_name Name of the system log file to be archived. .It Ar owner.group -Specifies the owner and group for the archive file. +Specify the owner and group for the archive file. The "." is essential, even if the .Ar owner or @@ -75,11 +75,11 @@ field is left blank. The field may be numeric, or a name which is present in .Pa /etc/passwd or -.Pa /etc/group. +.Pa /etc/group . .It Ar mode -Specifies the mode of the log file and archives. +Specify the mode of the log file and archives. .It Ar count -Specifies the number of archive files to be kept +Specify the number of archive files to be kept besides the log file itself. .It Ar size When the size of the log file reaches @@ -108,7 +108,8 @@ using .Xr gzip 1 . The .Ar B -flag means that the file is a binary file, and so the ASCII +flag means that the file is a binary file, and so the +.Tn ASCII message which .Nm inserts to indicate the fact that the logs have been @@ -128,40 +129,41 @@ properly. The following options can be used with newsyslog: .Bl -tag -width indent .It Fl f Ar config_file -instructs newsyslog to use +Instruct newsyslog to use .Ar config_file instead of .Pa /etc/newsyslog.conf for its configuration file. .It Fl v -places -.Nm newsyslog +Place +.Nm in verbose mode. In this mode it will print out each log and its reasons for either trimming that log or skipping it. .It Fl n -causes -.Nm newsyslog +Cause +.Nm not to trim the logs, but to print out what it would do if this option were not specified. .It Fl r -removes the restriction that -.Nm newsyslog +Remove the restriction that +.Nm must be running as root. Of course, -.Nm newsyslog +.Nm will not be able to send a HUP signal to .Xr syslogd 8 so this option should only be used in debugging. .El .Sh FILES -.Bl -tag -width /etc/newsyslog.confxxxx -comapct +.Bl -tag -width /etc/newsyslog.confxxxx -compact .It Pa /etc/newsyslog.conf -.Nm newsyslog +.Nm configuration file. .El .Sh BUGS Doesn't yet automatically read the logs to find security breaches. .Sh AUTHOR -Theodore Ts'o, MIT Project Athena +.An Theodore Ts'o , +MIT Project Athena .Pp Copyright 1987, Massachusetts Institute of Technology .Sh "SEE ALSO" |