htcacheclean - Nettoyage du cache sur disque

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

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.

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/?.

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.

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.