summaryrefslogtreecommitdiffstats
path: root/usr.sbin/newsyslog/newsyslog.8
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>1997-10-06 07:46:08 +0000
committercharnier <charnier@FreeBSD.org>1997-10-06 07:46:08 +0000
commit2e4411caecd2d8307c50b7a0d90ee217ec5f84fe (patch)
tree5d785dca98672b2154d60389e481f8cfd11d28e1 /usr.sbin/newsyslog/newsyslog.8
parentecf78217f1acb7d389227c1a7c3d84b9cd1020e0 (diff)
downloadFreeBSD-src-2e4411caecd2d8307c50b7a0d90ee217ec5f84fe.zip
FreeBSD-src-2e4411caecd2d8307c50b7a0d90ee217ec5f84fe.tar.gz
Cosmetic in err() strings.
Diffstat (limited to 'usr.sbin/newsyslog/newsyslog.8')
-rw-r--r--usr.sbin/newsyslog/newsyslog.844
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"
OpenPOWER on IntegriCloud