<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Programmes

htcacheclean - Nettoyage du cache sur disque

Langues Disponibles:  en  |  fr  |  ko  |  tr 

htcacheclean permet de maintenir la taille de l'espace de stockage r�serv� � mod_disk_cache en dessous d'une limite de taille donn�e ou d'inodes utilis�s. Cet utilitaire peut s'ex�cuter soit manuellement, soit en mode d�mon. Lorsqu'il fonctionne en mode d�mon, il se met en attente en arri�re-plan et recherche � intervalles r�guliers dans le r�pertoire du cache les contenus � supprimer. Pour arr�ter proprement le d�mon, vous pouvez lui envoyer un signal TERM ou INT. Lorsqu'il est lanc� manuellement, une recherche des contenus du cache qui peuvent �tre supprim�s est effectu�e une seule fois. Si une ou plusieurs URLs sont sp�cifi�es, chacune d'entre elles sera supprim�e du cache, si elle est pr�sente.

Voir aussi

top

Syntaxe

htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] [ -Rarrondi ] -pchemin [-llimite| -Llimite]

htcacheclean [ -n ] [ -t ] [ -i ] [ -Pfichier-pid ] [ -Rarrondi ] -dintervalle -pchemin [-llimite| -Llimite]

htcacheclean [ -v ] [ -Rarrondi ] -pchemin [ -a ] [ -A ]

htcacheclean [ -D ] [ -v ] [ -t ] [ -Rarrondi ] -pchemin url

top

Options

-dintervalle
Configure en mode d�mon et planifie le nettoyage du cache toutes les intervalle minutes. Cette option et les options -D, -v et -r s'excluent mutuellement. Pour arr�ter le d�mon proprement, il suffit de lui envoyer un signal SIGTERM ou SIGINT.
-D
Le programme s'ex�cute mais ne supprime aucun contenu ("dry run"). Cette option et l'option -d s'excluent mutuellement. Si ce mode est combin� avec la suppression des r�pertoires avec -t, les inodes signal�s comme supprim�s dans les statistiques ne peuvent pas prendre en compte les r�pertoires supprim�s, et seront marqu�s en tant qu'estimation.
-v
Ex�cution verbeuse et affichage de statistiques. Cette option et l'option -d s'excluent mutuellement.
-r
Nettoyage en profondeur. Le serveur web Apache doit �tre arr�t� (dans le cas contraire, il risque de rester des d�chets dans le cache). Cette option implique l'option -t et s'exclue mutuellement avec l'option -d.
-n
Ex�cution en retrait. L'ex�cution du programme est ralentie en faveur des autres processus. htcacheclean s'interrompt de temps en temps de fa�on � ce que a) les entr�es/sorties disque soient retard�es et b) que le noyau puisse mettre ce temps processeur � disposition des autres processus.
-t
Supprime tous les r�pertoires vides. Par d�faut, seuls les fichiers sont supprim�s du cache ; avec certaines configurations, cependant, un grand nombre de r�pertoires sont cr��s et m�ritent que l'on y pr�te attention. Si votre configuration n�cessite un grand nombre de r�pertoires, au point que le remplissage de la table d'inodes ou d'allocation de fichiers puisse poser probl�me, l'utilisation de cette option est conseill�e.
-pchemin
D�finit chemin comme r�pertoire racine du cache sur disque. Cette valeur doit correspondre � celle sp�cifi�e par la directive CacheRoot.
-Pfichier-pid
Permet de sp�cifier fichier-pid comme nom du fichier dans le lequel sera enregistr� l'identifiant du processus en mode d�mon.
-Rround
Permet de sp�cifier le plus petit commun multiple de la taille du cache, afin de tenir compte de la taille des blocs. D�finir ce param�tre � la taille d'un bloc de la partition du cache.
-llimite
D�finit limite comme la taille maximale du cache sur disque. La valeur s'exprime par d�faut en octets (ou en ajoutant le suffixe B � la valeur). Ajoutez le suffixe K pour KOctets ou M pour MOctets.
-Llimite
Sp�cifie limite comme la limite totale en inodes du cache disque.
-i
Ex�cution intelligente. Le programme ne s'ex�cute que lorsque le cache sur disque a �t� modifi�. Cette option ne peut s'utiliser qu'avec l'option -d.
-a
Affiche la liste des URLs actuellement stock�es dans le cache. Les variantes de la m�me URL seront list�es une seule fois par variante.
-A
Affiche la liste des URLs actuellement stock�es dans le cache, ainsi que leurs attributs dans l'ordre suivant : url, header size, body size, status, entity version, date, expiry, request time, response time, body present, head request.
top

Suppression d'une URL particuli�re

Si une ou plusieurs URLs sont pass�es en argument � htcacheclean, chacune d'entre elles sera supprim�e du cache. S'il existe plusieurs variantes de ces URLs, elles seront toutes supprim�es.

Lorsqu'une URL mandat�e en inverse doit �tre supprim�e, l'URL effective est construite � partir de l'en-t�te Host, du port, du chemin et de la requ�te. Notez que le '?' doit toujours �tre sp�cifi� explicitement dans l'URL, qu'une cha�ne de param�tres soit pr�sente ou non. Par exemple, pour supprimer le chemin / du serveur localhost, l'URL devra �tre sp�cifi�e comme suit : http://localhost:80/?.

top

Affichage des URLs pr�sentes dans le cache

Les options -a ou -A permettent d'afficher les URLs pr�sentes dans le cache telles qu'elles s'y trouvent, une URL par ligne. L'option -A affiche l'entr�e du cache compl�te pour chaque URL, avec ses diff�rents champs dans l'ordre suivant :

url
L'URL de l'entr�e consid�r�e.
header size
La taille de l'en-t�te en octets.
body size
La taille du corps en octets.
status
Etat de la r�ponse en cache.
entity version
Le nombre de fois que cette entr�e a �t� revalid�e sans �tre effac�e.
date
Date de la r�ponse.
expiry
Date d'expiration de la r�ponse.
request time
Date du d�but de la requ�te.
response time
Date de la fin de la requ�te.
body present
Ce champ contient la valeur 0 si aucun corps n'est stock� avec cette requ�te, 1 dans le cas contraire.
head request
Ce champ contient la valeur 1 si l'entr�e comporte une requ�te HEAD en cache sans corps, 0 dans le cas contraire.
top

Valeur renvoy�e

htcacheclean renvoie z�ro ("true") si toutes les op�rations se sont d�roul�es normalement, et 1 dans le cas contraire. Si une URL est sp�cifi�e, et si cette URL �tait pr�sente dans le cache et a �t� supprim�e avec succ�s, htcacheclean renvoie 0, et 2 dans le cas contraire. Si une erreur est survenue au cours de la suppression de l'URL, htcacheclean renvoie 1.

Langues Disponibles:  en  |  fr  |  ko  |  tr 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.