1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - Nettoyage du cache sur disque - Serveur HTTP Apache Version 2.4</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" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</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="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Nettoyage du cache sur disque</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htcacheclean</code> permet de maintenir la taille de
l'espace de stockage réservé à <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> 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.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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ère</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#list">Affichage des URLs présentes dans le cache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</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><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="synopsis" id="synopsis">Syntaxe</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><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-d<var>intervalle</var></code></dt>
<dd>Configure en mode dé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êter le dé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écute mais ne supprime aucun contenu ("dry run"). Cette
option et l'option <code>-d</code> s'excluent mutuellement. Si ce mode
est combiné avec la suppression des répertoires avec
<code>-t</code>, 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.</dd>
<dt><code>-v</code></dt>
<dd>Exé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 être arrêté
(dans le cas contraire, il risque de rester des dé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écution en retrait. L'exécution du programme est ralentie en
faveur des autres processus. <code>htcacheclean</code> 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.</dd>
<dt><code>-t</code></dt>
<dd>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.</dd>
<dt><code>-p<var>chemin</var></code></dt>
<dd>Définit <var>chemin</var> comme répertoire racine du cache sur
disque. Cette valeur doit correspondre à celle spécifié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écifier <var>fichier-pid</var> comme nom du fichier
dans le lequel sera enregistré l'identifiant du processus en mode
démon.</dd>
<dt><code>-R<var>round</var></code></dt>
<dd>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.</dd>
<dt><code>-l<var>limite</var></code></dt>
<dd>Définit <var>limite</var> comme la taille maximale du cache sur
disque. La valeur s'exprime par défaut en octets (ou en ajoutant le
suffixe <code>B</code> à 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écifie <var>limite</var> comme la limite totale en inodes du cache
disque. Là 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é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 <code>-d</code>.</dd>
<dt><code>-a</code></dt>
<dd>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.</dd>
<dt><code>-A</code></dt>
<dd>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.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="delete" id="delete">Suppression d'une URL particulière</a></h2>
<p>Si une ou plusieurs URLs sont passées en argument à
<code>htcacheclean</code>, chacune d'entre elles sera supprimée du
cache. S'il existe plusieurs variantes de ces URLs, elles seront
toutes supprimées.</p>
<p>Lorsqu'une URL mandatée en inverse doit être supprimée, l'URL
effective est construite à partir de l'en-tête
<strong>Host</strong>, du <strong>port</strong>, du
<strong>chemin</strong> et de la <strong>requête</strong>. 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 <strong>/</strong> du serveur
<strong>localhost</strong>, l'URL devra être spécifié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><a name="list" id="list">Affichage des URLs présentes dans le cache</a></h2>
<p>Les options <code>-a</code> ou <code>-A</code> permettent
d'afficher les URLs présentes dans le cache telles qu'elles s'y
trouvent, une URL par ligne. L'option <code>-A</code> affiche
l'entrée du cache complète pour chaque URL, avec ses différents
champs dans l'ordre suivant :</p>
<dl>
<dt>url</dt><dd>L'URL de l'entrée considérée.</dd>
<dt>header size</dt><dd>La taille de l'en-tête en octets.</dd>
<dt>body size</dt><dd>La taille du corps en octets.</dd>
<dt>status</dt><dd>Etat de la réponse en cache.</dd>
<dt>entity version</dt><dd>Le nombre de fois que cette entrée a
été revalidée sans être effacée.</dd>
<dt>date</dt><dd>Date de la réponse.</dd>
<dt>expiry</dt><dd>Date d'expiration de la réponse.</dd>
<dt>request time</dt><dd>Date du début de la requête.</dd>
<dt>response time</dt><dd>Date de la fin de la requête.</dd>
<dt>body present</dt><dd>Ce champ contient la valeur 0 si aucun
corps n'est stocké avec cette requête, 1 dans le cas contraire.</dd>
<dt>head request</dt><dd>Ce champ contient la valeur 1 si
l'entrée comporte une requê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><a name="exit" id="exit">Valeur renvoyée</a></h2>
<p><code>htcacheclean</code> renvoie zéro ("true") si toutes les
opérations se sont déroulées normalement, et <code>1</code> 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,
<code>htcacheclean</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>htcacheclean</code> renvoie
<code>1</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htcacheclean.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autorisé sous <a href="http://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/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
|
