Provided by:
manpages-es-extra_0.8a-17_all 
NOMBRE
Logrotate - cambia, comprime y envia por correo archivos de registro
del sistema.
SINOPSIS
logrotate [-dv] [-s|--archivo de estado] archivo_de_configuraci'on+
DESCRIPCI'ON
Logrotate ha sido disenado para facilitar la administracion de sistemas
que generan gran cantidad de archivos de registro (logs). El programa
permite el cambio, compresion, eliminacion y envio automatico 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 modificara un archivo repetidas veces a no ser que el
criterio para ese archivo se base en el tamano del mismo y logrotate se
ejecute varias veces al dia.
En la linea de comandos pueden indicarse un numero ilimitado de
archivos de configuracion. Mas tarde, estos archivos de configuracion
pueden invalidar las opciones dadas en archivos de configuracion
anteriores, por lo tanto, el orden en que se listan los archivos de
configuracion de logrotate es muy importante. Normalmente, deberia
usarse un solo archivo de configuracion que incluya tantos otros
archivos de configuracion como sean necesarios. Vease mas abajo como
usar la directiva include para conseguirlo. Si se proporciona un nombre
de directorio en la linea de comandos, cada uno de los archivos que se
encuentren en ese directorio se usara como archivo de configuracion.
OPCIONES
-d Activa el modo de depuracion e implica -v. En modo de
depuracion, no se efectuara ningun cambio a los archivos de
registro ni al archivo de estado de logrotate.
--usage
Muestra un pequeno mensaje de uso, version y copyright.
ARCHIVO DE CONFIGURACI'ON
logrotate lee toda la informacion necesaria sobre los archivos de
registro que debe manejar de la serie de archivos de configuracion que
se especifiquen en la linea de comandos. Cada archivo de configuracion
puede establecer opciones globales (las definiciones locales anulan a
las globales, y aquellas definiciones efectuadas en ultimo lugar anulan
siempre a las anteriores) y especificar el archivo de registro que se
ha de cambiar. Un archivo de configuracion simple seria 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 lineas establecen opciones globales; cualquier error que
ocurra durante el procesamiento de los archivos de registro se envia
por correo a sysadmin.org y los archivos de registro se comprimen
despues de ser cambiados. Notese que pueden aparecer comentarios en
cualquier parte del archivo de configuracion siempre y cuando el primer
espacio que no esta en blanco en la linea sea un #.
La siguiente seccion del archivo de configuracion especifica la accion
a realizar sobre el archivo de registro /var/log/messages. El archivo
sufrira cinco cambios semanales antes de ser eliminado. Despues de que
el archivo ha sido modificado (pero antes de haberse comprimido la
version antigua del mismo) se ejecutara el comando /sbin/killall -HUP
syslogd.
La siguiente seccion define los parametros de /var/log/http/access.log.
Este se cambia siempre y cuando excede los 100k de tamano, y los
archivos de registro antiguos se envian (sin comprimir) a www@my.org
despues 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 envia a www@my.org (anulando asi la
directiva global errors)
La ultima seccion define los parametros para todos lo archivos en
/var/log/news. Cada archivo se cambia mensualmente y los errores se
envian a newsadmin@my.org.Esta se considera una directiva de cambio
simple y si ocurre un error para mas de un archivo se envia en un unico
mensaje. En este caso, los archivos de registro no se comprimiran.
A continuacion se proporciona mas informacion sobre las directivas que
se pueden incluir en un archivo de configuracion de logrotate:
compress
Las versiones antiguas de los archivos de registro se comprimen
con gzip. Vease tambien 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
algun programa no se le puede ordenar que cierre su archivo de
registro y por lo tanto podria seguir escribiendo (anadiendo)
continuamente en el archivo de registro anterior. Notese que
transcurre una fraccion de tiempo muy pequena entre el copiado
del archivo y su truncado, por lo que se podrian perder algunos
datos. Cuando se usa esta opcion, no tendra efecto la opcion
create, dado que el archivo antiguo permanecera 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 despues 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
pertenecera el archivo de registro, y group especifica el grupo
al que pertenecera el archivo. Se puede omitir cualquiera de los
atributos del archivo de registro, en cuyo caso, el nuevo
archivo usara los valores del archivo antiguo para aquellos
atributos que se hayan omitido. Esta opcion se puede anular
usando la opcion nocreate.
daily Los archivos de registro se cambian diariamente.
delaycompress
Pospone la compresion del archivo de registro anterior hasta el
siguiente ciclo de rotacion. Solo tiene efecto cuando se usa en
combinacion con compress. Se puede usar cuando no se puede
ordenar a un programa que cierre su archivo de registro y podria
continuar escribiendo en el durante algun tiempo.
errors address
Cualquier error que ocurra durante el procesamiento de los
registros se enviara a la direccion de correo que se
especifique.
ifempty
Cambia el archivo de registro incluso si esta vacio, anulando la
opcion notifempty (opcion 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 mayoria
de los archivos se leen antes de que continue el procesamiento
del archivo en el que se incluyen. Los unicos 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 tabu segun se
especifica en la directiva tabooext. La directiva include puede
no aparecer en la definicion 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 dia del mes).
nocompress
Las versiones antiguas de los archivos de registro no se
comprimen con gzip. Vease tambien compress.
nocopytruncate
No trunca el archivo de registro original en el lugar en el que
se encuentre tras crear una copia. (Esto anula la opcion
copytruncate).
nocreate
No se crean archivos de registro nuevos (esto anula la opcion
create).
nodelaycompress
No pospone la compresion del archivo de registro anterior hasta
el proximo ciclo de cambio (esto anula la opcion delaycompress).
nomail No envian los archivos de registro antiguos a ninguna direccion
de correo.
noolddir
Los archivos se cambian en el mismo directorio en el que el
archivo reside normalmente (esto anula la opcion olddir).
notifempty
No rota el archivo de registro si esta vacio (esto anula la
opcion ifempty).
olddir directory
Los archivos de registro se mueven a directory para su rotacion.
El directory debe encontrarse en el mismo dispositivo fisico que
el archivo de registro que se va a cambiar. Cuando se usa esta
opcion, todas las versiones antiguas del archivo de registro van
a parar a directory. Esta opcion puede anularse por medio de la
opcion noolddir.
postrotate/endscript
Las lineas entre postrotate y endscript (ambas deben aparecer en
lineas por separado) se ejecutan una vez que el archivo de
registro ha sido rotado. Estas directivas solo pueden aparecer
dentro de una definicion de archivo de registro. Vease tambien
prerotate.
prerotate/endscript
Las lineas entre prerotate y endscript (ambas deben aparecer en
lineas por separado) se ejecutan una vez que el archivo de
registro ha sido rotado. Estas directivas solo pueden aparecer
dentro de una definicion de archivo de registro. Vease tambien
postrotate.
rotate count
Los archivos de registro se cambian <count> veces antes de ser
eliminados o enviados a la direccion especificada en una
directiva mail. Si count es 0, las versiones antiguas se
eliminaran en vez de ser cambiadas.
size size
Los archivos de registro se cambian cuando superan el tamano de
size bytes. Si a size le sigue M, se asume que se esta indicando
el tamano en megabytes. Si se usa k, el tamano sera en
kilobytes. Por lo tanto son validos tanto size 100 como size
100k y size 100M.
tabooext [+] list
Se cambia la lista actual de extensiones tabu (vease la
directiva include si se desea informacion sobre las extensiones
tabu). Si un + precede a la lista de extensiones, la lista
actual de extensiones tabu se aumenta, de otro modo se
reemplaza. Al comienzo, la lista de extensiones tabu contiene
.rpmorig, .rpmsave, ,v y ~.
weekly Los archivos de registro se cambian si el dia de la semana
actual es menor que el dia de la semana del ultimo cambio o si
ha pasado mas de una semana desde el ultimo cambio. Normalmente,
esto es lo mismo que cambiar los archivos el primer dia de la
semana, pero funciona mejor si logrotate no se ejecuta todas las
noches.
V'EASE TAMBI'EN
gzip(1)
AUTOR
Erik Troan <ewt@redhat.com>