Provided by:
manpages-es-extra_0.8a-16_all 
NOMBRE
Logrotate - cambia, comprime y envÃa por correo archivos de registro
del sistema.
SINOPSIS
logrotate [-dv] [-s|--archivo de estado] archivo_de_configuración+
DESCRIPCIÓN
Logrotate ha sido diseñado para facilitar la administración de sistemas
que generan gran cantidad de archivos de registro (logs). El programa
permite el cambio, compresión, eliminación y envÃo automático por
correo de los archivos de registro. Cada archivo puede ser tratado
diariamente, semanalmente, mensualmente o siempre que se haga demasiado
grande.
Normalmente, logrotate se ejecuta como tarea diaria de tipo cron. El
programa no modificará un archivo repetidas veces a no ser que el
criterio para ese archivo se base en el tamaño del mismo y logrotate se
ejecute varias veces al dÃa.
En la lÃnea de comandos pueden indicarse un número ilimitado de
archivos de configuración. Más tarde, estos archivos de configuración
pueden invalidar las opciones dadas en archivos de configuración
anteriores, por lo tanto, el orden en que se listan los archivos de
configuración de logrotate es muy importante. Normalmente, deberÃa
usarse un sólo archivo de configuración que incluya tantos otros
archivos de configuración como sean necesarios. Véase más abajo cómo
usar la directiva include para conseguirlo. Si se proporciona un nombre
de directorio en la lÃnea de comandos, cada uno de los archivos que se
encuentren en ese directorio se usará como archivo de configuración.
OPCIONES
-d Activa el modo de depuración e implica -v. En modo de
depuración, no se efectuará ningún cambio a los archivos de
registro ni al archivo de estado de logrotate.
--usage
Muestra un pequeño mensaje de uso, versión y copyright.
ARCHIVO DE CONFIGURACIÓN
logrotate lee toda la información necesaria sobre los archivos de
registro que debe manejar de la serie de archivos de configuración que
se especifiquen en la lÃnea de comandos. Cada archivo de configuración
puede establecer opciones globales (las definiciones locales anulan a
las globales, y aquellas definiciones efectuadas en último lugar anulan
siempre a las anteriores) y especificar el archivo de registro que se
ha de cambiar. Un archivo de configuración simple serÃa el siguiente:
# sample logrotate configuration file
errors sysadmin@my.org
compress
/var/log/messages {
rotate 5
weekly
postrotate
/sbin/killall -HUP syslogd
endscript
}
/var/log/httpd/access.log {
rotate 5
mail www@my.org
errors www@my.org
size=100k
postrotate
/sbin/killall -HUP httpd
endscript
}
/var/log/news/* {
monthly
rotate 2
errors newsadmin@my.org
postrotate
kill -HUP ‘cat /var/run/inn.pid‘
endscript
nocompress
}
Las primeras lÃneas establecen opciones globales; cualquier error que
ocurra durante el procesamiento de los archivos de registro se envÃa
por correo a sysadmin.org y los archivos de registro se comprimen
después de ser cambiados. Nótese que pueden aparecer comentarios en
cualquier parte del archivo de configuración siempre y cuando el primer
espacio que no está en blanco en la lÃnea sea un #.
La siguiente sección del archivo de configuración especifica la acción
a realizar sobre el archivo de registro /var/log/messages. El archivo
sufrirá cinco cambios semanales antes de ser eliminado. Después de que
el archivo ha sido modificado (pero antes de haberse comprimido la
versión antigua del mismo) se ejecutará el comando /sbin/killall -HUP
syslogd.
La siguiente sección define los parámetros de /var/log/http/access.log.
Éste se cambia siempre y cuando excede los 100k de tamaño, y los
archivos de registro antiguos se envÃan (sin comprimir) a www@my.org
después de haber sufrido cinco cambios, en vez de ser eliminados. Del
mismo modo, cualquier error que pueda ocurrir durante el procesamiento
del archivo de registro se envÃa a www@my.org (anulando asà la
directiva global errors)
La última sección define los parámetros para todos lo archivos en
/var/log/news. Cada archivo se cambia mensualmente y los errores se
envÃan a newsadmin@my.org.Ésta se considera una directiva de cambio
simple y si ocurre un error para más de un archivo se envÃa en un único
mensaje. En este caso, los archivos de registro no se comprimirán.
A continuación se proporciona más información sobre las directivas que
se pueden incluir en un archivo de configuración de logrotate:
compress
Las versiones antiguas de los archivos de registro se comprimen
con gzip. Véase también nocompress.
copytruncate
Trunca el archivo de registro original en el lugar en el que se
encuentre tras crear una copia, en vez de mover el archivo
antiguo y crear una nuevo opcionalmente. Se puede usar cuando a
algún programa no se le puede ordenar que cierre su archivo de
registro y por lo tanto podrÃa seguir escribiendo (añadiendo)
continuamente en el archivo de registro anterior. Nótese que
transcurre una fracción de tiempo muy pequeña entre el copiado
del archivo y su truncado, por lo que se podrÃan perder algunos
datos. Cuando se usa esta opción, no tendrá efecto la opción
create, dado que el archivo antiguo permanecerá en su lugar.
create mode owner group
Se crea el archivo de registro (con el mismo nombre del archivo
de registro que se acaba de rotar) inmediatamente después del
cambio (antes de que se ejecute el script postrotate). mode
especifica el modo del archivo de registro en octal (al igual
que chmod (2)), owner especifica el nombre del usuario al que
pertenecerá el archivo de registro, y group especifica el grupo
al que pertenecerá el archivo. Se puede omitir cualquiera de los
atributos del archivo de registro, en cuyo caso, el nuevo
archivo usará los valores del archivo antiguo para aquellos
atributos que se hayan omitido. Esta opción se puede anular
usando la opción nocreate.
daily Los archivos de registro se cambian diariamente.
delaycompress
Pospone la compresión del archivo de registro anterior hasta el
siguiente ciclo de rotación. Sólo tiene efecto cuando se usa en
combinación con compress. Se puede usar cuando no se puede
ordenar a un programa que cierre su archivo de registro y podrÃa
continuar escribiendo en él durante algún tiempo.
errors address
Cualquier error que ocurra durante el procesamiento de los
registros se enviará a la dirección de correo que se
especifique.
ifempty
Cambia el archivo de registro incluso si está vacÃo, anulando la
opción notifempty (opción por defecto).
include file_or_directory
Lee el archivo dado como argumento como si se incluyese donde
aparece la directiva include. Si se da un directorio, la mayorÃa
de los archivos se leen antes de que continúe el procesamiento
del archivo en el que se incluyen. Los únicos archivos que se
ignoran son archivos que no son corrientes (tales como
directorios y pipes con nombre) y aquellos archivos cuyos
nombres terminan con una de las extensiones tabú según se
especifica en la directiva tabooext. La directiva include puede
no aparecer en la definición de un archivo de registro.
monthly
Los archivos de registro se cambian la primera vez que se
ejecuta logrotate en un mes (normalmente el primer dÃa del mes).
nocompress
Las versiones antiguas de los archivos de registro no se
comprimen con gzip. Véase también compress.
nocopytruncate
No trunca el archivo de registro original en el lugar en el que
se encuentre tras crear una copia. (Esto anula la opción
copytruncate).
nocreate
No se crean archivos de registro nuevos (esto anula la opción
create).
nodelaycompress
No pospone la compresión del archivo de registro anterior hasta
el próximo ciclo de cambio (esto anula la opción delaycompress).
nomail No envÃan los archivos de registro antiguos a ninguna dirección
de correo.
noolddir
Los archivos se cambian en el mismo directorio en el que el
archivo reside normalmente (esto anula la opción olddir).
notifempty
No rota el archivo de registro si está vacÃo (esto anula la
opción ifempty).
olddir directory
Los archivos de registro se mueven a directory para su rotación.
El directory debe encontrarse en el mismo dispositivo fÃsico que
el archivo de registro que se va a cambiar. Cuando se usa esta
opción, todas las versiones antiguas del archivo de registro van
a parar a directory. Esta opción puede anularse por medio de la
opción noolddir.
postrotate/endscript
Las lÃneas entre postrotate y endscript (ambas deben aparecer en
lÃneas por separado) se ejecutan una vez que el archivo de
registro ha sido rotado. Estas directivas sólo pueden aparecer
dentro de una definición de archivo de registro. Véase también
prerotate.
prerotate/endscript
Las lÃneas entre prerotate y endscript (ambas deben aparecer en
lÃneas por separado) se ejecutan una vez que el archivo de
registro ha sido rotado. Estas directivas sólo pueden aparecer
dentro de una definición de archivo de registro. Véase también
postrotate.
rotate count
Los archivos de registro se cambian <count> veces antes de ser
eliminados o enviados a la dirección especificada en una
directiva mail. Si count es 0, las versiones antiguas se
eliminarán en vez de ser cambiadas.
size size
Los archivos de registro se cambian cuando superan el tamaño de
size bytes. Si a size le sigue M, se asume que se está indicando
el tamaño en megabytes. Si se usa k, el tamaño será en
kilobytes. Por lo tanto son válidos tanto size 100 como size
100k y size 100M.
tabooext [+] list
Se cambia la lista actual de extensiones tabú (véase la
directiva include si se desea información sobre las extensiones
tabú). Si un + precede a la lista de extensiones, la lista
actual de extensiones tabú se aumenta, de otro modo se
reemplaza. Al comienzo, la lista de extensiones tabú contiene
.rpmorig, .rpmsave, ,v y ~.
weekly Los archivos de registro se cambian si el dÃa de la semana
actual es menor que el dÃa de la semana del último cambio o si
ha pasado más de una semana desde el último cambio. Normalmente,
esto es lo mismo que cambiar los archivos el primer dÃa de la
semana, pero funciona mejor si logrotate no se ejecuta todas las
noches.
VÉASE TAMBIÉN
gzip(1)
AUTOR
Erik Troan <ewt@redhat.com>