gentoo-overlay/app-admin/sysklogd/files/syslogd-listfiles.8

.\" syslogd-listfiles.8 - generic routine for /etc/syslog.conf
.\" Copyright (c) 1997  Martin Schulze <joey@debian.org>
.\" 
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH SYSLOGD-LISTFILES 8 "1 January 1998" "Debian project" "Debian GNU/Linux"
.SH NAME
syslogd-listfiles \- list system logfiles
.SH SYNOPSIS
.B syslogd-listfiles
.RB [ " \-a " | " \-\-all " ]
.RB [ " \-\-auth " ] 
.RB [ " \-f "
.I config file
]
.RB [ " \-\-news " ]
.RB [ " \-w " | " \-\-weekly " ]
.SH DESCRIPTION
.B Sysklogd
provides a modern mechanism to log system messages.  This mechanism is
controlled by the file
.IR /etc/syslog.conf .
Messages are divided into logfiles which can grow quite big.
Therefore the logfiles need to be rotated once per day, per week or
per month.  On a Debian GNU/Linux system most of the files are rotated
once per week.

This program helps the rotation script to determine which logfiles
need to be rotated and when.  It takes care of news logfiles that are
handled by the
.B news.daily
script from INN.  In conjunction with the scripts in
.IR /etc/cron.daily " and " /etc/cron.weekly
it takes care of files with sensitive information.

By default a list of files for daily rotation is generated.  At the
moment this option only reflects entries that contain "*.*" as
facility.priority.

.SH OPTIONS
.TP
.BR "\-a" ", " "\-\-all"
List all logfiles and ignore all other rules.
.TP
.BI "\-f " "config file"
Specify an alternative configuration file instead of
.IR /etc/syslog.conf ","
which is the default.
.TP
.B "\-\-auth"
Only list files containing sensitive information such as the one
containing auth.*.
.TP
.B "\-\-news"
Don't exclude news logfiles which are normally handled by the
.B news.daily
script from INN.
.TP
.BR "\-w" ", " "\-\-weekly"
Generate the list for weekly rotation.
.LP
.SH SEE ALSO
.BR syslog.conf (5),
.BR syslogd (8),
.BR savelog (8).