blob: 6a7ee806e5e2b6ae6ad3f482c6849405012ff044 [file]
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - Nettoyage du cache sur disque - Serveur HTTP Apache Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.5</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Nettoyage du cache sur disque</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/programs/htcacheclean.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a></p>
</div>
<p><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de maintenir la taille de
l'espace de stockage r&eacute;serv&eacute; &agrave; <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> en
dessous d'une limite de taille donn&eacute;e ou d'inodes utilis&eacute;s. Cet
utilitaire peut s'ex&eacute;cuter
soit manuellement, soit en mode d&eacute;mon. Lorsqu'il fonctionne en mode
d&eacute;mon, il se met en attente en arri&egrave;re-plan et recherche &agrave;
intervalles r&eacute;guliers dans le r&eacute;pertoire du cache les contenus &agrave;
supprimer. Pour arr&ecirc;ter proprement le d&eacute;mon, vous pouvez lui envoyer
un signal TERM ou INT. Lorsqu'il est lanc&eacute; manuellement, une
recherche des contenus du cache qui peuvent &ecirc;tre supprim&eacute;s est
effectu&eacute;e une seule fois. Si une ou plusieurs URLs sont sp&eacute;cifi&eacute;es,
chacune d'entre elles sera supprim&eacute;e du cache, si elle est pr&eacute;sente.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif"> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#delete">Suppression d'une URL particuli&egrave;re</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#list">Affichage des URLs pr&eacute;sentes dans le cache</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#exit">Valeur renvoy&eacute;e</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#files">Fichiers</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="synopsis">Syntaxe <a title="Lien permanent" href="#synopsis" class="permalink">&para;</a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>r</strong> ]
[ -<strong>n</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
[ -<strong>l</strong><var>limite</var> ]
[ -<strong>L</strong><var>limite</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>n</strong> ]
[ -<strong>t</strong> ]
[ -<strong>i</strong> ]
[ -<strong>P</strong><var>fichier-pid</var> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>d</strong><var>intervalle</var>
-<strong>p</strong><var>chemin</var>
[ -<strong>l</strong><var>limite</var> ]
[ -<strong>L</strong><var>limite</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>v</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
<var>url</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="options">Options <a title="Lien permanent" href="#options" class="permalink">&para;</a></h2>
<dl>
<dt><code>-d<var>intervalle</var></code></dt>
<dd>Configure en mode d&eacute;mon et planifie le nettoyage du cache toutes
les <var>intervalle</var> minutes. Cette option et les options
<code>-D</code>, <code>-v</code> et <code>-r</code> s'excluent
mutuellement. Pour arr&ecirc;ter le d&eacute;mon proprement, il suffit de lui
envoyer un signal <code>SIGTERM</code> ou <code>SIGINT</code>.</dd>
<dt><code>-D</code></dt>
<dd>Le programme s'ex&eacute;cute mais ne supprime aucun contenu ("dry run"). Cette
option et l'option <code>-d</code> s'excluent mutuellement. Si ce mode
est combin&eacute; avec la suppression des r&eacute;pertoires avec
<code>-t</code>, les inodes signal&eacute;s comme supprim&eacute;s dans les
statistiques ne peuvent pas prendre en compte les r&eacute;pertoires
supprim&eacute;s, et seront marqu&eacute;s en tant qu'estimation.</dd>
<dt><code>-v</code></dt>
<dd>Ex&eacute;cution verbeuse et affichage de statistiques. Cette
option et l'option <code>-d</code> s'excluent mutuellement.</dd>
<dt><code>-r</code></dt>
<dd>Nettoyage en profondeur. Le serveur web Apache doit &ecirc;tre arr&ecirc;t&eacute;
(dans le cas contraire, il risque de rester des d&eacute;chets dans le
cache). Cette option implique l'option <code>-t</code> et s'exclue
mutuellement avec l'option <code>-d</code>.</dd>
<dt><code>-n</code></dt>
<dd>Ex&eacute;cution en retrait. L'ex&eacute;cution du programme est ralentie en
faveur des autres processus. <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> s'interrompt
de temps en temps de fa&ccedil;on &agrave; ce que a) les entr&eacute;es/sorties disque
soient retard&eacute;es et b) que le noyau puisse mettre ce temps
processeur &agrave; disposition des autres processus.</dd>
<dt><code>-t</code></dt>
<dd>Supprime tous les r&eacute;pertoires vides. Par d&eacute;faut, seuls les
fichiers sont supprim&eacute;s du cache ; avec certaines configurations,
cependant, un grand nombre de r&eacute;pertoires sont cr&eacute;&eacute;s et m&eacute;ritent que
l'on y pr&ecirc;te attention. Si votre configuration n&eacute;cessite un grand
nombre de r&eacute;pertoires, au point que le remplissage de la table
d'inodes ou d'allocation de fichiers puisse poser probl&egrave;me,
l'utilisation de cette option est conseill&eacute;e.</dd>
<dt><code>-p<var>chemin</var></code></dt>
<dd>D&eacute;finit <var>chemin</var> comme r&eacute;pertoire racine du cache sur
disque. Cette valeur doit correspondre &agrave; celle sp&eacute;cifi&eacute;e par la
directive <code class="directive"><a href="../mod/mod_disk_cache.html#cacheroot">CacheRoot</a></code>.</dd>
<dt><code>-P<var>fichier-pid</var></code></dt>
<dd>Permet de sp&eacute;cifier <var>fichier-pid</var> comme nom du fichier
dans le lequel sera enregistr&eacute; l'identifiant du processus en mode
d&eacute;mon.</dd>
<dt><code>-R<var>round</var></code></dt>
<dd>Permet de sp&eacute;cifier le plus petit commun multiple de la taille
du cache, afin de tenir compte de la taille des blocs. D&eacute;finir ce
param&egrave;tre &agrave; la taille d'un bloc de la partition du cache.</dd>
<dt><code>-l<var>limite</var></code></dt>
<dd>D&eacute;finit <var>limite</var> comme la taille maximale du cache sur
disque. La valeur s'exprime par d&eacute;faut en octets (ou en ajoutant le
suffixe <code>B</code> &agrave; la valeur). Ajoutez le suffixe
<code>K</code> pour Ko, <code>M</code> pour Mo ou <code>G</code>
pour Go.</dd>
<dt><code>-L<var>limite</var></code></dt>
<dd>Sp&eacute;cifie <var>limite</var> comme la limite totale en inodes du
cache disque. L&agrave; aussi, on peut ajouter le suffixe
<code>K</code> pour Ko, <code>M</code> pour Mo ou <code>G</code>
pour Go.</dd>
<dt><code>-i</code></dt>
<dd>Ex&eacute;cution intelligente. Le programme ne s'ex&eacute;cute que lorsque le
cache sur disque a &eacute;t&eacute; modifi&eacute;. Cette option ne peut s'utiliser
qu'avec l'option <code>-d</code>.</dd>
<dt><code>-a</code></dt>
<dd>Affiche la liste des URLs actuellement stock&eacute;es dans le cache.
Les variantes de la m&ecirc;me URL seront list&eacute;es une seule fois par
variante.</dd>
<dt><code>-A</code></dt>
<dd>Affiche la liste des URLs actuellement stock&eacute;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.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="delete">Suppression d'une URL particuli&egrave;re <a title="Lien permanent" href="#delete" class="permalink">&para;</a></h2>
<p>Si une ou plusieurs URLs sont pass&eacute;es en argument &agrave;
<code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code>, chacune d'entre elles sera supprim&eacute;e du
cache. S'il existe plusieurs variantes de ces URLs, elles seront
toutes supprim&eacute;es.</p>
<p>Lorsqu'une URL mandat&eacute;e en inverse doit &ecirc;tre supprim&eacute;e, l'URL
effective est construite &agrave; partir de l'en-t&ecirc;te
<strong>Host</strong>, du <strong>port</strong>, du
<strong>chemin</strong> et de la <strong>requ&ecirc;te</strong>. Notez que
le '?' doit toujours &ecirc;tre sp&eacute;cifi&eacute; explicitement dans l'URL, qu'une
cha&icirc;ne de param&egrave;tres soit pr&eacute;sente ou non. Par exemple, pour
supprimer le chemin <strong>/</strong> du serveur
<strong>localhost</strong>, l'URL devra &ecirc;tre sp&eacute;cifi&eacute;e comme suit :
<strong>http://localhost:80/?</strong>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="list">Affichage des URLs pr&eacute;sentes dans le cache <a title="Lien permanent" href="#list" class="permalink">&para;</a></h2>
<p>Les options <code>-a</code> ou <code>-A</code> permettent
d'afficher les URLs pr&eacute;sentes dans le cache telles qu'elles s'y
trouvent, une URL par ligne. L'option <code>-A</code> affiche
l'entr&eacute;e du cache compl&egrave;te pour chaque URL, avec ses diff&eacute;rents
champs dans l'ordre suivant :</p>
<dl>
<dt>url</dt><dd>L'URL de l'entr&eacute;e consid&eacute;r&eacute;e.</dd>
<dt>header size</dt><dd>La taille de l'en-t&ecirc;te en octets.</dd>
<dt>body size</dt><dd>La taille du corps en octets.</dd>
<dt>status</dt><dd>Etat de la r&eacute;ponse en cache.</dd>
<dt>entity version</dt><dd>Le nombre de fois que cette entr&eacute;e a
&eacute;t&eacute; revalid&eacute;e sans &ecirc;tre effac&eacute;e.</dd>
<dt>date</dt><dd>Horodatage de la r&eacute;ponse en microsecondes.</dd>
<dt>expiry</dt><dd>Horodatage de l'expiration de la r&eacute;ponse en microsecondes.</dd>
<dt>request time</dt><dd>Horodatage du d&eacute;but de la requ&ecirc;te en microsecondes.</dd>
<dt>response time</dt><dd>Horodatage de la fin de la requ&ecirc;te en microsecondes.</dd>
<dt>body present</dt><dd>Ce champ contient la valeur 0 si aucun
corps n'est stock&eacute; avec cette requ&ecirc;te, 1 dans le cas contraire.</dd>
<dt>head request</dt><dd>Ce champ contient la valeur 1 si
l'entr&eacute;e comporte une requ&ecirc;te HEAD en cache sans corps, 0 dans
le cas contraire.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="exit">Valeur renvoy&eacute;e <a title="Lien permanent" href="#exit" class="permalink">&para;</a></h2>
<p><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> renvoie z&eacute;ro ("true") si toutes les
op&eacute;rations se sont d&eacute;roul&eacute;es normalement, et <code>1</code> dans le
cas contraire. Si une URL est sp&eacute;cifi&eacute;e, et si cette URL &eacute;tait
pr&eacute;sente dans le cache et a &eacute;t&eacute; supprim&eacute;e avec succ&egrave;s,
<code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> renvoie <code>0</code>, et <code>2</code>
dans le cas contraire. Si une erreur est survenue au cours de la
suppression de l'URL, <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> renvoie
<code>1</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="files">Fichiers <a title="Lien permanent" href="#files" class="permalink">&para;</a></h2>
<p>Le r&eacute;pertoire racine du cache est sp&eacute;cifi&eacute; en tant qu&rsquo;argument de la ligne de
commande et doit correspondre &agrave; la directive <code>CacheRoot</code> de la
configuration globale du serveur.</p>
<dl>
<dt><var>chemin</var></dt>
<dd>Le r&eacute;pertoire racine du cache sur disque &agrave; nettoyer.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/programs/htcacheclean.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '&#9776;';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>