.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.13 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "SARAH 1" .TH SARAH 1 "2004-02-06" "sarah 0.9.1b" "Syslog Automated Rotation and Archive Handler" .SH "NAME" \&\fBsarah\fR \- Syslog Automated Rotation and Archive Handler .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBsarah\fR [ \fB\-chqrsvV\fR ] [ \fB\-f\fR \fIconfig_file\fR ] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBsarah\fR is an automated log file rotation tool which is meant to replace older, similar tools such as \fInewsyslog\fR\|(8). It should be scheduled to run periodically by \fIcron\fR\|(8). When it is executed it archives log files if necessary. As with \fInewsyslog\fR\|(8), if a log file is determined to require archiving, \fBsarah\fR rearranges the files so that \*(L"logfile\*(R" is empty, and older logfiles are named appropriately to make finding a particular period's entries as simple as possible. Optionally, the archived logs can be compressed to save space. .PP A log may be archived for one or both of two reasons: .IP "1." 4 It is larger than the configured size .IP "2." 4 This is the specific configured date/time for rotation of the log. .PP The granularity of \fBsarah\fR is dependent on how often it is scheduled to run by \fIcron\fR\|(8). Since the program is quite fast, it may be scheduled to run every minute on most machines without any ill effects; rotation by date/time assumes this is the case. .PP When starting up, \fBsarah\fR reads in a configuration file to determine which logs may potentially be archived. By default, this configuration file is \&\fI/usr/local/etc/sarah.conf\fR. .PP On successful termination, \fBsarah\fR will exit with status 0. If some failure occurs, \fBsarah\fR will exit with a non-zero status. On FreeBSD systems, see \&\fIsysexits\fR\|(3). .SH "OPTIONS" .IX Header "OPTIONS" The following command line options may be used with \fBsarah\fR: .IP "\fB\-c\fR" 4 .IX Item "-c" Check the config file for errors and exit. If any errors are detected, \&\fBsarah\fR will indicate what they are. Otherwise it will print a status line indicating all is well. When combined with the \fB\-V\fR option (debug mode), an interpreted version of the config file will be printed to \s-1STDOUT\s0 before exiting. .IP "\fB\-h\fR" 4 .IX Item "-h" Print out a help summary and version information then exit. .IP "\fB\-f\fR \fIconfig_file\fR" 4 .IX Item "-f config_file" Instruct \fBsarah\fR to use \fIconfig_file\fR instead of the default \&\fI/usr/local/etc/sarah.conf\fR for its configuration file. .IP "\fB\-q\fR" 4 .IX Item "-q" Run in quiet mode. \fBsarah\fR will not produce any output; not even errors. If \&\fB\-v\fR or \fB\-V\fR are specified in conjunction with \fB\-q\fR, this option will be ignored. .IP "\fB\-r\fR" 4 .IX Item "-r" Remove the restriction that \fBsarah\fR must be run as root. In this mode \&\fBsarah\fR will not be able to send the \s-1HUP\s0 signal to \fIsyslogd\fR\|(8) so the default signaling action to take on the completion of the rotation of any logfile will become no action. Also, if this option is specified the \fB\-s\fR switch will be ignored. .IP "\fB\-s\fR" 4 .IX Item "-s" Copy all output (including debugging and verbose mode output) to \fIsyslogd\fR\|(8) with the \s-1DAEMON\s0 facility. Ignored if \fB\-r\fR is specified. The \fB\-s\fR switch can be specified in conjunction with \fB\-v\fR or \fB\-V\fR to copy debugging and verbose output to syslog. .IP "\fB\-v\fR" 4 .IX Item "-v" Place \fBsarah\fR into verbose mode. In this mode, it will print out each log and its reasons for either trimming the log or skipping it. .IP "\fB\-V\fR" 4 .IX Item "-V" Place \fBsarah\fR into full debug mode. If both \fB\-v\fR and \fB\-V\fR are specified, \&\fB\-V\fR takes precedence. .SH "CONFIGURATION FILE" .IX Header "CONFIGURATION FILE" The \fBsarah\fR configuration file consists of two general statements: directives and comments. All comments begin with a # character, either at the beginning of a line or at the end of a directive. Any text after a # character on a line is treated as a comment. .PP There are two formats for directives in the \fBsarah\fR configuration file. The first applies to directives that have optional sub\-directives. This type has the general format of the directive, possibly followed by an argument, then any sub-directives enclosed in balanced braces ({}) and terminated by a semicolon (;). .PP The second type of directive does not have any sub-directives (in fact, this type is normally a sub-directive itself). This type consists of the directive followed by some number of arguments which are terminated by a semicolon (;). .PP Unless otherwise noted, directives may appear more than once within either the configuration file, or within their respective configuration block. If such directives appear more than once, the value set by the last use of the directive will supercede any previous uses. All directives, except where otherwise noted, may appear within an \fBoptions\fR block to set defaults. .PP Directives which expect sub-directives may be specified with an empty set of braces in order to unset previous definitions of themselves. Directives which do not expect sub-directives may be followed immediately by a semi-colon in order to do the same. .PP The following directives are supported: .IP "\fBoptions\fR { \fIdirective\fR; [ \fIdirective\fR; ... ] };" 4 .IX Item "options { directive; [ directive; ... ] };" This directive has no options. It contains directives that set global configuration options for the behavior of \fBsarah\fR. Each appearance of the \&\fBoptions\fR directive will extinguish any previously defined \fBoptions\fR. See the \*(L"\s-1CONFIGURATION\s0 \s-1EXAMPLES\s0\*(R" section for a demonstration of this behavior. .Sp The \fBoptions\fR directive may not appear as a sub-directive of itself or any other directive. .IP "\fBinclude\fR { \fIpath\fR; [ \fIpath\fR; ... ] };" 4 .IX Item "include { path; [ path; ... ] };" The \fBinclude\fR directive allows multiple configuration files to be read from within the main configuration file. The \fBinclude\fR directive can contain any number of path names to other config files that should be read. Each path name should be terminated by a semi\-colon. The contents of the included config files will be read and interpreted as if they had been inserted in the main config file at the point of the \fBinclude\fR directive. Any number of \&\fBinclude\fR directives may appear in a config file, but none may appear as a sub-directive of any other directive. A nesting limit of 20 includes deep is imposed to prevent recursive includes. .IP "\fBlog\fR \fIpath\fR { \fIdirective\fR; [ \fIdirective\fR; ... ] };" 4 .IX Item "log path { directive; [ directive; ... ] };" This directive opens a new block defining a new logfile. The required \fIpath\fR argument is the path to the logfile to be rotated. The \fBlog\fR directive may not appear as a sub-directive of itself or any other directive. .IP "\fBsizelogic\fR AND|OR;" 4 .IX Item "sizelogic AND|OR;" This directive sets the logic used in determining whether to rotate a logfile when both a date and size limit have been set for the logfile. If \&\fBsizelogic\fR is set to \s-1AND\s0, then the logfile is only rotated if the size limit of the file is exceeded and the current date/time match the date/time specification for the logfile. If \fBsizelogic\fR is set to \s-1OR\s0, the logfile will be rotated if either or both requirements are met. The default is \s-1AND\s0. The \fBsizelogic\fR directive may only appear within an \fBoptions\fR block. .IP "\fBsizemod\fR B|K|M|G|T;" 4 .IX Item "sizemod B|K|M|G|T;" \&\s-1DEPRECATED:\s0 This directive has been deprecated and will be removed in future versions. See the \fBsize\fR directive. .Sp The \fBsizemod\fR directive sets the modifier used with values in \fBsize\fR directives (below). B sets size modifier to bytes, K to kilobytes, M to megabytes, G to gigabytes, and T to terabytes. The \fBsizemod\fR directive may only appear within an \fBoptions\fR block. .IP "\fBarchivedir\fR \fIpath\fR;" 4 .IX Item "archivedir path;" By default, logfiles are rotated and archived in the same directory where they originated. Using the \fBarchivedir\fR directive, a new directory, specified by the required \fIpath\fR argument, can be specified where archives of the logfile will be stored. This may be useful in situations such as keeping a central repository of old logs, possibly on an \s-1NFS\s0 mounted filesystem. .IP "\fBowner\fR \fIuser\fR;" 4 .IX Item "owner user;" .PD 0 .IP "\fBgroup\fR \fIgroup\fR;" 4 .IX Item "group group;" .PD When logfiles are rotated, the archives are given the same owner and group as the original logfile. Using the \fBowner\fR and \fBgroup\fR directives, you can specify a new owner and/or group for the logfile archives. The required \&\fIuser\fR and \fIgroup\fR arguments may be either numeric, or a name which is present in \fI/etc/passwd\fR or \fI/etc/group\fR. The \fBowner\fR and \fBgroup\fR directives do not affect the ownership of the logfile itself, only its archives. .IP "\fBmode\fR \fImode\fR;" 4 .IX Item "mode mode;" As with ownership, log archives are given the same mode, or permissions, as the original logfile by default. The \fBmode\fR directive may be used to give the archives different permissions. The required \fImode\fR argument must be an absolute (numeric) mode as described by \fIchmod\fR\|(1). As with \fBowner\fR and \&\fBgroup\fR, the \fBmode\fR directive does not affect the permissions of the logfile itself, only its archives. .IP "\fBindex\fR ordinal|date;" 4 .IX Item "index ordinal|date;" The \fBindex\fR directive tells \fBsarah\fR how to name its archive files. If the \&\fBordinal\fR argument is specified (the default) \fBsarah\fR produces numbered archives where the index begins at 0 (zero) with the most recent archive. If the \fBdate\fR argument is specified, \fBsarah\fR produces dated archive files in the format .yyyymmdd\-xx where xx is an index number beginning at 0 (zero) with the first archive rotated on that date. This allows for multiple rotations of any given file in one day. .Sp Sarah will always pad index numbers in such a way that all archives have the same number of digits in their index, but the minimum possible number of digits is used. For example, if there are 10 maillog archives (maillog.0 through maillog.9) then sarah will use single digits; when the 11th archive is created, sarah will change all the indexes to double digits (maillog.00 through maillog.10); when the 101st archive is created, three digits; and so forth. This also applies for date based archive indexing. .IP "\fBkeep\fR \fIinteger\fR;" 4 .IX Item "keep integer;" This configuration directive sets the number of archives to keep for each logfile. The number does not include the logfile itself. If set to 0 (zero) or left undefined, \fBsarah\fR will keep an indefinite number of logfiles (until you run out of disk space). .IP "\fBsize\fR \fIlog_size\fR [b|k|m|g|t];" 4 .IX Item "size log_size [b|k|m|g|t];" The \fBsize\fR directive sets the size limit for a logfile, beyond which the logfile will be rotated. The required \fIlog_size\fR argument is a number in bytes by default, but this may be altered by following the value with an optional magnitude: \fBb\fR for bytes, \fBk\fR for kilobytes, \fBm\fR for megabytes, \&\fBg\fR for gigabytes, or \fBt\fR for terabytes. .Sp Each \fBlog\fR block requires at least one \fBsize\fR or \fBdate\fR directive (below). If neither directive is defined in a \fBlog\fR block, or in the preceding \&\fBoptions\fR block, the logfile will never be rotated. The behavior of \fBsarah\fR when both \fBsize\fR and \fBdate\fR directives are defined is controlled by the \&\fBsizelogic\fR directive. .IP "\fBdate\fR { };" 4 .IX Item "date { };" This directive opens a new block for defining a date/time specification for when the current logfile should be rotated. The \fBdate\fR directive has no parameters, but does have several sub\-directives. Each \fBlog\fR block requires at least one \fBdate\fR directive, or one \fBsize\fR directive (above). If neither directive is defined in a \fBlog\fR block, or in the preceding \fBoptions\fR block, the logfile will never be rotated. The behavior of \fBsarah\fR when both \fBsize\fR and \fBdate\fR directives are defined is controlled by the \fBsizelogic\fR directive. .IP "\fBminute\fR \fItime_spec\fR;" 4 .IX Item "minute time_spec;" .PD 0 .IP "\fBhour\fR \fItime_spec\fR;" 4 .IX Item "hour time_spec;" .IP "\fBdow\fR \fItime_spec\fR;" 4 .IX Item "dow time_spec;" .IP "\fBmonth\fR \fItime_spec\fR;" 4 .IX Item "month time_spec;" .IP "\fBdom\fR \fItime_spec\fR;" 4 .IX Item "dom time_spec;" .PD These five directives \*(-- \fBminute\fR, \fBhour\fR, \fBdow\fR (day of week), \fBmonth\fR, and \fBdom\fR (day of month) define the date/time specification for the rotation of a logfile. The required \fItime_spec\fR arguments for each directive define the various times/dates where a logfile may be rotated. .Sp Permitted values for the directives are as follows: .Sp .Vb 7 \& field allowed values \& ----- -------------- \& minute 0-59 \& hour 0-23 \& dom 0-31 (0 means "last day of the month") \& month 1-12 \& dow 0-7 (0 and 7 are Sunday) .Ve .Sp An argument may be an asterisk (*) which stands for \*(L"first\-last\*(R". .Sp Ranges are allowed. Ranges are two numbers separated by a hyphen. The specified range is inclusive. For example, 8\-11 for the \fBhours\fR directive specifies rotation at 8, 9, 10, and 11. .Sp Lists of numbers are also allowed. A list is a set of numbers (or ranges) separated by commas. Examples: \*(L"1,2,5,9\*(R", \*(L"0\-4,8\-12\*(R" .Sp Step values can be used in conjunction with ranges. Following a range with \&\*(L"/\*(R" specifies skips of the number's value within the range. For example, \*(L"0\-23/2\*(R" can be used in the \fBhours\fR directive to specify rotation every other hour. Expanded to a list, this would be \&\*(L"0,2,4,6,8,10,12,14,16,18,20,22\*(R". Step values can also be used in conjunction with an asterisk. This \fBhours\fR example could be specified \*(L"*/2\*(R". .Sp As soon as one directive in a \fBdate\fR block is defined, the date/time will be taken into account in the rotation of a logfile. Leaving any directives within a \fBdate\fR block undefined equates to entering a * for those directives. .Sp These five directives may only appear within a \fBdate\fR block. .IP "\fBflags\fR [ Z ] [ B ];" 4 .IX Item "flags [ Z ] [ B ];" The \fBflags\fR directive specifies whether any special processing should be done to the archived logfile. The \fIZ\fR flag will make \fBsarah\fR compress the archive files using \fIgzip\fR\|(1) to save space. The \fIB\fR flag means that the file is binary, and so the \s-1ASCII\s0 message which \fBsarah\fR inserts into a rotated logfile to indicate the file has been rotated should not be included. Arguments to the \fBflags\fR directive may be separated by whitespace but this is not required. .IP "\fBpid\fR \fIpath_to_pid_file\fR;" 4 .IX Item "pid path_to_pid_file;" This directive specifies the file to read to find the \s-1PID\s0 of the daemon process that writes to the current logfile. If this is set, then the signal set by the \fBsignal\fR directive is sent to the \s-1PID\s0 read from this file upon completion of the rotation of the current logfile. If the \fBpid\fR directive is not set, the \s-1PID\s0 is read from \fI/var/run/syslog.pid\fR. .IP "\fBsignal\fR \fIsignal_number\fR;" 4 .IX Item "signal signal_number;" This directive sets the signal to be sent to the logging daemon upon completion of the rotation of the current logfile. The required \&\fIsignal_number\fR argument may be either a numeric signal number or its alpha equivalent. By default, a \s-1SIGHUP\s0 will be sent. .SH "CONFIGURATION EXAMPLES" .IX Header "CONFIGURATION EXAMPLES" The \fIcron\fR\|(8) logfile is rotated once a day at midnight and compressed. A week's worth of archives are kept. .PP .Vb 8 \& log /var/cron/log { \& keep 7; \& date { \& minute 0; \& hour 0; \& } \& flags Z; \& } .Ve .PP The mail log is rotated at least every Monday at midnight, but also whenever it exceeds 1 megabyte in size. The archives are stored in a separate location. .PP .Vb 13 \& options { \& sizelogic OR; \& }; \& log /var/log/maillog { \& archivedir /depot/logs; \& keep 7; \& size 1m; \& date { \& minute 0; \& hour 0; \& dow 1; \& }; \& }; .Ve .PP A separate config file is loaded and interpreted before the log block for the web server logs is interpreted. The web server access logs are rotated every hour onto a large filesystem (our hypothetical web server is \fBvery\fR busy). The archive files are dated, old archives are not deleted, and ownership is changed to allow other staff members to read them. The web server daemon is sent a \s-1SIGUSR1\s0 signal. .PP .Vb 15 \& include { \& /usr/local/etc/cust-logs.conf; \& }; \& log /usr/local/www/log/access_log { \& archivedir /depot/logs; \& date { \& minute 0; \& }; \& index date; \& owner daemon; \& group staff; \& mode 0644; \& pid /usr/local/www/log/httpd.pid; \& signal USR1; \& }; .Ve .PP The formatting of the configuration file used here is arbitrary. As long as whitespace is maintained around words, any formatting can be used. The previous example could easily appear like this, if one was so inclined: .PP .Vb 5 \& include{/usr/local/etc/cust-rotation.conf;};log \& /usr/local/www/log/access_log{archivedir /depot/logs; \& date{minute 0;};index date; \& owner daemon;group staff;mode 0644; \& pid /usr/local/www/log/httpd.pid; signal USR1;}; .Ve .PP Sub-directives of the \fBlog\fR directive may also be specified within an \&\fBoptions\fR block to set defaults. In the following example, both log files may be rotated nightly at midnight, but the access_log file will only be rotated if it is also larger than 100 kilobytes. Both log files are indexed by date, with 100 archive files kept. .PP .Vb 11 \& options { \& sizelogic AND; \& date { minute 0; hour 0; }; \& index date; \& keep 100; \& }; \& log /usr/local/www/log/access_log { \& size 100k; \& }; \& log /usr/local/www/log/error_log { \& }; .Ve .PP Each use of the \fBoptions\fR directive will obliterate any options set by previous uses. In the following example, the access_log file is rotated at midnight every day as well as whenever the file size reaches 100K; it is indexed by date, and 100 copies are kept. By contrast, the error_log file is only rotated at midnight when it is at least 200 bytes; it is indexed ordinally, and an indefinite number of copies are kept. .PP .Vb 15 \& options { \& sizelogic OR; \& index date; \& keep 100; \& }; \& log /usr/local/www/log/access_log { \& date { minute 0; hour 0; }; \& size 100k; \& }; \& options { \& size 200k; \& }; \& log /usr/local/www/log/error_log { \& date { minute 0; hour 0; }; \& }; .Ve .PP Sub-directives previously set in the \fBoptions\fR directive, or previously set within the same \fBlog\fR block can be unset by specifying them with no data. In the following example, the web server access log is rotated every night at midnight, and the error log is rotated only when it reaches 100k or more. .PP .Vb 11 \& options { \& sizelogic AND; \& date { minute 0; hour 0; }; \& size 100k; \& }; \& log /usr/local/www/log/access_log { \& size; \& }; \& log /usr/local/www/log/error_log { \& date {}; \& }; .Ve .SH "FILES" .IX Header "FILES" \&\fI/usr/local/etc/sarah.conf\fR \fBsarah\fR configuration file .SH "BUGS" .IX Header "BUGS" .IP "\(bu" 4 A mode to force \fBsarah\fR to trim all logs is missing. .IP "\(bu" 4 A testing mode is required where no log rotation is done, but verbose output indicates whether logfiles would have been rotated. .SH "AUTHORS" .IX Header "AUTHORS" Copyright 2000\-2004 Matthew Pounsett (mattp@conundrum.com) .PP Available at http://prdownloads.sourceforge.net/sarah/ .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIgzip\fR\|(1), \fIsyslog\fR\|(3), \fIsyslogd\fR\|(8), \fIchown\fR\|(8), \fInewsyslog\fR\|(8) .SH "MANUAL VERSION" .IX Header "MANUAL VERSION" .Vb 1 \& $Id: sarah.pod,v 1.7 2004/02/06 06:41:47 succorso Exp $ .Ve