131 lines
2.7 KiB
Groff
131 lines
2.7 KiB
Groff
|
.\" @(#)man/man8/savelog.an 1.2 24 Oct 1990 05:18:46
|
||
|
|
.de pP
|
||
|
|
.if n .sp 1
|
||
|
|
.if t .sp .4
|
||
|
|
..
|
||
|
|
.de tP
|
||
|
|
.pP
|
||
|
|
.ta \\n(pDu
|
||
|
|
.ti -\\n(pDu
|
||
|
|
..
|
||
|
|
.TH SAVELOG X_MAN8_EXT_X "31 January 1988" "Local"
|
||
|
|
.SH NAME
|
||
|
|
savelog \- cycle and truncate log files
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.na
|
||
|
|
.B X_UTIL_BIN_DIR_X/savelog
|
||
|
|
[
|
||
|
|
.B \-m
|
||
|
|
.I mode
|
||
|
|
] [
|
||
|
|
.B \-u
|
||
|
|
.I user
|
||
|
|
] [
|
||
|
|
.B \-g
|
||
|
|
.I group
|
||
|
|
] [
|
||
|
|
.B \-c
|
||
|
|
.I cycle
|
||
|
|
] [
|
||
|
|
.B \-t
|
||
|
|
] [
|
||
|
|
.B \-l
|
||
|
|
]
|
||
|
|
.I logfile
|
||
|
|
.br
|
||
|
|
.ad
|
||
|
|
.SH DESCRIPTION
|
||
|
|
The
|
||
|
|
.I savelog
|
||
|
|
command renames and optionally compresses a log file and cycles it
|
||
|
|
through a set of names based on the original log file, removing the
|
||
|
|
last name in the cycle.
|
||
|
|
.SH OPTIONS
|
||
|
|
The
|
||
|
|
.I savelog
|
||
|
|
command accepts the following options:
|
||
|
|
.TP
|
||
|
|
\fB\-m\fP \fImode\fP
|
||
|
|
Change the permissions mode for renamed log files to
|
||
|
|
.IR mode .
|
||
|
|
By default the mode is unchanged.
|
||
|
|
.TP
|
||
|
|
\fB\-u\fP \fIuser\fP
|
||
|
|
Change the owner for renamed log files to
|
||
|
|
.IR user .
|
||
|
|
By default the owner is unchanged.
|
||
|
|
.TP
|
||
|
|
\fB\-g\fP \fIgroup\fP
|
||
|
|
Change the group for renamed log files to
|
||
|
|
.IR group .
|
||
|
|
By default the group is unchanged.
|
||
|
|
.TP
|
||
|
|
\fB\-c\fP \fIcycle\fP
|
||
|
|
Save
|
||
|
|
.I cycle
|
||
|
|
versions of the logfile, where
|
||
|
|
.I cycle
|
||
|
|
is a decimal number. The default value is 7.
|
||
|
|
.TP
|
||
|
|
.B \-l
|
||
|
|
Do not compress log files. By default, a compression program is used,
|
||
|
|
if one is available.
|
||
|
|
.TP
|
||
|
|
.B \-t
|
||
|
|
Ensure that a new logfile exists when the savelog operation is
|
||
|
|
complete. Use of
|
||
|
|
.BR \-m ,
|
||
|
|
.BR \-u
|
||
|
|
or
|
||
|
|
.BR \-g
|
||
|
|
imply this, ensuring that the logfile will have the designated mode.
|
||
|
|
.SH "OPERATION"
|
||
|
|
The given logfile is cycled through files named:
|
||
|
|
.RS
|
||
|
|
|
||
|
|
OLD/\fIfile\fP.\fInumber\fP
|
||
|
|
|
||
|
|
.RE
|
||
|
|
where
|
||
|
|
.I file
|
||
|
|
is the basename for the logfile and where
|
||
|
|
.I number
|
||
|
|
ranges from 0 to one less then the
|
||
|
|
.I cycle
|
||
|
|
count specified for the command.
|
||
|
|
The
|
||
|
|
.I OLD
|
||
|
|
dirctory is created, as necessary, and is under the same directory as
|
||
|
|
the logfile itself.
|
||
|
|
.PP
|
||
|
|
This cycle operation is accomplished by renaming the file numbered
|
||
|
|
.IR cycle -2
|
||
|
|
to a file numbered
|
||
|
|
.IR cycle -1
|
||
|
|
and so on until the file numbered 0 is renamed to the file numbered 1.
|
||
|
|
If compression is being used, the first cycle file is compressed after
|
||
|
|
being renamed to cycle 1. After the cycle files are moved through the
|
||
|
|
various names, the filefile itself is moved to the cycle 0 file.
|
||
|
|
This cycle normally occurs once every time
|
||
|
|
.I savelog
|
||
|
|
is executed.
|
||
|
|
If the log file does not exist, savelog ignores it and does
|
||
|
|
not cycle the OLD files.
|
||
|
|
.PP
|
||
|
|
If compression is being used, then compressed log files will have an
|
||
|
|
additional suffix appropriate for the compression program that is
|
||
|
|
used.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.IR smail (X_MAN5_EXT_X)
|
||
|
|
and
|
||
|
|
.IR smail (X_MAN8_EXT_X).
|
||
|
|
.SH COPYRIGHT
|
||
|
|
Copyright(C)1987, 1988 Ronald S. Karr and Landon Curt Noll
|
||
|
|
.br
|
||
|
|
See a file COPYING,
|
||
|
|
distributed with the source code,
|
||
|
|
or type
|
||
|
|
.I "smail \-bc"
|
||
|
|
for distribution rights and restrictions
|
||
|
|
associated with this software.
|