newsyslog.8 (208028) | newsyslog.8 (210372) |
---|---|
1.\" This file contains changes from the Open Software Foundation. 2.\" 3.\" from: @(#)newsyslog.8 | 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 $ | 4.\" $FreeBSD: head/usr.sbin/newsyslog/newsyslog.8 210372 2010-07-22 11:23:18Z simon $ |
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 | 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 Fl t Ar timefmt |
|
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. | 34.Op Ar 35.Sh DESCRIPTION 36The 37.Nm 38utility should be scheduled to run periodically by 39.Xr cron 8 . 40When it is executed it archives log files if necessary. 41If a log file --- 4 unchanged lines hidden (view full) --- 46is empty, 47.Dq Va logfile Ns Li \&.0 48has 49the last period's logs in it, 50.Dq Va logfile Ns Li \&.1 51has the next to last 52period's logs in it, and so on, up to a user-specified number of 53archived logs. |
54It is also possible to let archived log filenames be created using the 55time the log file was archived instead of the sequential number using 56the 57.Fl t 58option. |
|
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. | 59Optionally the archived logs can be compressed to save 60space. 61.Pp 62A log can be archived for three reasons: 63.Bl -enum -offset indent 64.It 65It is larger than the configured size (in kilobytes). 66.It --- 75 unchanged lines hidden (view full) --- 142normally signal when rotating a log file. 143For any log file which is rotated, this option will usually also 144mean the rotated log file will not be compressed if there is a 145daemon which would have been signalled without this option. 146However, this option is most likely to be useful when specified 147with the 148.Fl R 149option, and in that case the compression will be done. |
150.It Fl t Ar timefmt 151If specified 152.Nm 153will create the 154.Dq rotated 155logfiles using the specified time format instead of the default 156sequential filenames. 157The time format is described in the 158.Xr strftime 3 159manual page. 160If the 161.Ar timefmt 162argument is set to an empty string or the string 163.Dq DEFAULT , 164the default built in time format 165is used. 166If the 167.Ar timefmt 168string is changed the old files created using the previous time format 169will not be be automatically removed (unless the new format is very 170similar to the old format). 171This is also the case when changing from sequential filenames to time 172based file names, and the other way around. 173The time format should contain at least year, month, day, and hour to 174make sure rotating of old logfiles can select the correct logfiles. |
|
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 --- | 175.It Fl C 176If specified once, then 177.Nm 178will create any log files which do not exist, and which have the 179.Sy C 180flag specified in their config file entry. 181If specified multiple times, then 182.Nm --- 110 unchanged lines hidden --- |