1.\" This file contains changes from the Open Software Foundation.
2.\"
3.\" from: @(#)newsyslog.8
4.\" $FreeBSD: head/usr.sbin/newsyslog/newsyslog.8 208028 2010-05-13 12:08:11Z uqs $
5.\"
6.\" Copyright 1988, 1989 by the Massachusetts Institute of Technology
7.\"
8.\" Permission to use, copy, modify, and distribute this software
9.\" and its documentation for any purpose and without fee is
10.\" hereby granted, provided that the above copyright notice
11.\" appear in all copies and that both that copyright notice and
12.\" this permission notice appear in supporting documentation,
--- 12 unchanged lines hidden (view full) ---
25.Nd maintain system log files to manageable sizes
26.Sh SYNOPSIS
27.Nm
28.Op Fl CFNPnrsv
29.Op Fl R Ar tagname
30.Op Fl a Ar directory
31.Op Fl d Ar directory
32.Op Fl f Ar config_file
33.Op Ar
34.Sh DESCRIPTION
35The
36.Nm
37utility should be scheduled to run periodically by
38.Xr cron 8 .
39When it is executed it archives log files if necessary.
40If a log file
--- 4 unchanged lines hidden (view full) ---
45is empty,
46.Dq Va logfile Ns Li \&.0
47has
48the last period's logs in it,
49.Dq Va logfile Ns Li \&.1
50has the next to last
51period's logs in it, and so on, up to a user-specified number of
52archived logs.
53Optionally the archived logs can be compressed to save
54space.
55.Pp
56A log can be archived for three reasons:
57.Bl -enum -offset indent
58.It
59It is larger than the configured size (in kilobytes).
60.It
--- 75 unchanged lines hidden (view full) ---
136normally signal when rotating a log file.
137For any log file which is rotated, this option will usually also
138mean the rotated log file will not be compressed if there is a
139daemon which would have been signalled without this option.
140However, this option is most likely to be useful when specified
141with the
142.Fl R
143option, and in that case the compression will be done.
144.It Fl C
145If specified once, then
146.Nm
147will create any log files which do not exist, and which have the
148.Sy C
149flag specified in their config file entry.
150If specified multiple times, then
151.Nm
--- 110 unchanged lines hidden ---
2.\"
3.\" from: @(#)newsyslog.8
4.\" $FreeBSD: head/usr.sbin/newsyslog/newsyslog.8 208028 2010-05-13 12:08:11Z uqs $
5.\"
6.\" Copyright 1988, 1989 by the Massachusetts Institute of Technology
7.\"
8.\" Permission to use, copy, modify, and distribute this software
9.\" and its documentation for any purpose and without fee is
10.\" hereby granted, provided that the above copyright notice
11.\" appear in all copies and that both that copyright notice and
12.\" this permission notice appear in supporting documentation,
--- 12 unchanged lines hidden (view full) ---
25.Nd maintain system log files to manageable sizes
26.Sh SYNOPSIS
27.Nm
28.Op Fl CFNPnrsv
29.Op Fl R Ar tagname
30.Op Fl a Ar directory
31.Op Fl d Ar directory
32.Op Fl f Ar config_file
33.Op Ar
34.Sh DESCRIPTION
35The
36.Nm
37utility should be scheduled to run periodically by
38.Xr cron 8 .
39When it is executed it archives log files if necessary.
40If a log file
--- 4 unchanged lines hidden (view full) ---
45is empty,
46.Dq Va logfile Ns Li \&.0
47has
48the last period's logs in it,
49.Dq Va logfile Ns Li \&.1
50has the next to last
51period's logs in it, and so on, up to a user-specified number of
52archived logs.
53Optionally the archived logs can be compressed to save
54space.
55.Pp
56A log can be archived for three reasons:
57.Bl -enum -offset indent
58.It
59It is larger than the configured size (in kilobytes).
60.It
--- 75 unchanged lines hidden (view full) ---
136normally signal when rotating a log file.
137For any log file which is rotated, this option will usually also
138mean the rotated log file will not be compressed if there is a
139daemon which would have been signalled without this option.
140However, this option is most likely to be useful when specified
141with the
142.Fl R
143option, and in that case the compression will be done.
144.It Fl C
145If specified once, then
146.Nm
147will create any log files which do not exist, and which have the
148.Sy C
149flag specified in their config file entry.
150If specified multiple times, then
151.Nm
--- 110 unchanged lines hidden ---