shtool-rotate – En ligne dans le Cloud

PROGRAMME:

Nom

shtool-rotate - Rotation du fichier journal GNU shtool

SYNOPSIS

tabouret tourner [-v|--verbeux] [-t|--tracer] [-f|--Obliger] [-n|--num-fichiers compter] [-s|--Taille
longueur du câble] [-c|--copie] [-r|--supprimer] [-a|--archive-rép dir] [-z|--compresse [outil:]niveau]
[-b|--Contexte] [-d|--retard] [-p|--tampon len] [-m|--mode mode] [-o|--propriétaire propriétaire]
[-g|--grouper groupe] [-M|--émigrer cmd] [-P|--prologue cmd] [-E|--épilogue cmd] filet [filet ...]

DESCRIPTION

Cette commande fait pivoter un fichier journal filet en créant par la suite jusqu'à compter (éventuellement
(archives compressées). Les archives sont nommées « filet.nombre[[compresser-suffixe]"
où nombre est le numéro de version, 0 étant le plus récent et "compter-1" le plus ancien.

Une étape de rotation comprend les étapes suivantes

1. supprimer le dernier fichier d'archive 2. décaler les numéros de fichiers d'archive 3. créer le fichier d'archive 0 à partir de
filet 4. tronquer/recréer filet

OPTIONS

Les options de ligne de commande suivantes sont disponibles.

-v, --verbeux
Afficher des informations de traitement.

-t, --tracer
Activez la sortie des commandes shell essentielles qui sont exécutées.

-f, --Obliger
Forcer la création silencieuse du répertoire d'archives s'il n'existe pas. Ignorer également les éléments manquants.
fichiers journaux intermédiaires lors de l'étape de rotation. Par défaut, la sortie génère une erreur dans les deux cas.
Cas. FIXME

-n, --num-fichiers compter
Créer compter fichiers d'archive. La valeur par défaut est 10.

-s, --Taille longueur du câble
Faire pivoter uniquement si le fichier journal dépasse longueur du câble. L'argument longueur du câble peut également être spécifié avec le
unités de queue « K » (kilo), « M » (méga) ou « G » (giga). Le « prologue » et l'« épilogue » sont
exécuté uniquement si la rotation a effectivement lieu.

-c, --copie
Copier filet pour archiver puis tronquer l'original. La valeur par défaut est de déplacer filet archiver.

À moins qu’une application ne rouvre son fichier journal, elle continuera à écrire dans le même fichier.
Dans le cas de déplacement par défaut, l'application écrira dans l'archive qu'elle avait
précédemment ouvert comme filet. Dans le cas d'une copie, l'application écrira sur l'original
filetL'inconvénient de l'approche de copie est que les entrées du fichier journal sont perdues lorsqu'elles sont
écrite à filet entre l'exécution de la copie et l'opération de troncature.
L'inconvénient de l'approche de déplacement est que l'application doit détecter le déplacement ou doit
être déclenché pour rouvrir son journal (c'est-à-dire via l'épilogue).

-r, --supprimer
Supprime filet après la rotation au lieu de fournir un nouveau fichier vide.

-a, --archive-rép dir
Spécifiez le répertoire d'archivage. Par défaut, les archives sont créées dans le même répertoire que
filet est situé.

-z, --compresse [outil:]niveau
Permet la compression des fichiers d'archive avec le niveau de compression niveau Par défaut, le
les outils bzip2(1), gzipde Géographie (1) et avec la compresser(1) sont recherchés dans $PATH, mais on peut aussi
remplacez cela en préfixant le niveau de compression avec l'un des trois outils particuliers
des noms.

-b, --Contexte
Activer la compression en arrière-plan.

-d, --retard
Retarde la compression du fichier d'archive numéro 0. Ceci est utile si ``-c'' n'est pas utilisé,
car une application pourrait continuer à écrire dans le fichier d'archive 0 via un fichier déjà existant
ouvrir le handle du fichier.

-p, --tampon len
Active le remplissage avec des zéros non significatifs dans le nombre une partie du nom de fichier
"filet.numbercompress-suffix". Le remplissage par défaut len est 1. C'est intéressant si
plus de 10 fichiers d'archives sont utilisés, car cela conduit à un répertoire toujours trié
Les listes.

-m, --mode mode
Le mode de fichier appliqué aux fichiers créés, voir chmod(1). Le réglage du mode sur « - » permet d'ignorer
cette étape et laisse le système d'exploitation par défaut qui est généralement basé sur umask (1).
Certains modes de fichiers nécessitent des privilèges de superutilisateur. La valeur par défaut est 0755.

-o, --propriétaire propriétaire
Le nom ou l'ID du propriétaire du fichier appliqué aux fichiers créés, voir chown(1). Cette option
nécessite des privilèges de superutilisateur pour s'exécuter. La valeur par défaut est d'ignorer cette étape et de laisser le
défaut du système d'exploitation qui est généralement basé sur l'UID d'exécution ou le parent
répertoire setuid.

-g, --grouper groupe
Le nom ou l'ID du groupe de fichiers appliqué aux fichiers créés, voir chgrp(1). Cette option
nécessite des privilèges de superutilisateur pour s'exécuter au maximum, sinon le choix
of groupe est limité sur la plupart des systèmes d'exploitation. La valeur par défaut est d'ignorer cette étape et de quitter
la valeur par défaut du système d'exploitation qui est généralement basée sur le gid d'exécution ou le parent
répertoire setgid.

-M, --émigrer cmd
Exécutez une commande de « migration » juste avant le numéro du fichier d'archive compter-1 est supprimé
du système de fichiers. Le fichier spécifié cmd reçoit le nom du fichier d'archive en tant que ligne de commande
argument.

-P, --prologue cmd
Exécutez une commande « prologue » avant l'étape de rotation. Utile en conjonction avec -s.

-E, --épilogue cmd
Exécutez une commande « épilogue » après l'étape de rotation. Utile en conjonction avec -s.

EXEMPLE

# script shell
shtool rotation -n10 -s1M -zbzip2:9 -d -r /var/log/ap.access.log
shtool rotation -n5 -s128K -zbzip2:9 -d -r /var/log/ap.error.log
apachectl gracieux

HISTOIRE

Le manuel de formation GNU tabouret tourner La commande a été écrite à l'origine par Ralf S. Engelschall
<[email protected]> en 2001 pour GNU tabouretSon développement a été motivé par la nécessité de
disposer d'une fonction de rotation flexible des fichiers journaux dans le OpenPKG .

Utilisez shtool-rotate en ligne avec les services onworks.net