Provided by: manpages-es-extra_0.8a-16_all bug

NOMBRE

       Logrotate  -  cambia,  comprime y envía por correo archivos de registro
       del sistema.

SINOPSIS

       logrotate [-dv] [-s|--archivo de estado] archivo_de_configuracin+

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>