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
|
<?xml version="1.0" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1174747 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="apachectl.xml.meta">
<parentdocument href="./">Programmes</parentdocument>
<title>apachectl - L'interface de contrôle du serveur HTTP
Apache</title>
<summary>
<p><code>apachectl</code> est un frontal pour le serveur HTTP
Apache. Il a été conçu pour aider l'administrateur à contrôler le
fonctionnement du démon Apache <program>httpd</program>.</p>
<p>Le script <code>apachectl</code> possède deux modes de
fonctionnement. Il peut fonctionner en tant que simple frontal
de la commande <program>httpd</program> et ne fait alors que
définir toute variable d'environnement nécessaire, puis invoque
<program>httpd</program> en lui passant tout argument de ligne de
commande souhaité. Il peut aussi fonctionner en tant que script
d'initialisation SysV n'acceptant qu'un seul argument tel que
<code>start</code>, <code>restart</code> et <code>stop</code>, et
traduisant ce dernier en signaux appropriés pour le démon
<program>httpd</program>.</p>
<p>Si votre installation d'Apache utilise des chemins non
standards, vous devrez éditer le script <code>apachectl</code> afin
de définir les chemins appropriés pour le binaire
<program>httpd</program>. Vous pouvez aussi spécifier tout argument
de ligne de commande de <program>httpd</program> nécessaire. Voir
les commentaires dans le script pour plus de détails.</p>
<p>Le script <code>apachectl</code> renvoie une valeur égale à 0 en
cas de succès, et une valeur supérieure à 0 en cas de problème.
Voir les commentaires dans le script pour plus de détails.</p>
</summary>
<seealso><a href="../invoking.html">Démarrer Apache</a></seealso>
<seealso><a href="../stopping.html">Arrêter Apache</a></seealso>
<seealso><a href="../configuring.html">Fichiers de
configuration</a></seealso>
<seealso><a href="../platform/">Documentation spécifique aux
plates-formes</a></seealso>
<seealso><program>httpd</program></seealso>
<section id="synopsis"><title>Résumé</title>
<p>En mode frontal (pass-through), <code>apachectl</code> peut spécifier
tous les arguments qu'accepte le binaire <program>httpd</program>.</p>
<p><code><strong>apachectl</strong> [ <var>argument-httpd</var> ]</code></p>
<p>En mode script d'initialisation SysV, <code>apachectl</code>
n'accepte qu'un seul des arguments définis ci-dessous.</p>
<p><code><strong>apachectl</strong> <var>commande</var></code></p>
</section>
<section id="options"><title>Options</title>
<p>Seules les options du style initialisation SysV sont décrites ici.
Les autres arguments sont décrits dans la page de manuel de
<program>httpd</program>.</p>
<dl>
<dt><code>start</code></dt>
<dd>Démarre le démon Apache <program>httpd</program>. Renvoie une erreur
s'il est déjà en cours d'exécution. Équivalent à <code>apachectl -k
start</code>.</dd>
<dt><code>stop</code></dt>
<dd>Arrête le démon Apache <program>httpd</program>. Équivalent à
<code>apachectl -k stop</code>.</dd>
<dt><code>restart</code></dt>
<dd>Redémarre le démon Apache <program>httpd</program>. Si le démon
n'est pas en cours d'exécution, il est démarré. Cette option vérifie
automatiquement les fichiers de configuration (de la même manière que
l'option <code>configtest</code> ) avant de lancer le redémarrage, afin
d'être sûr que le fonctionnement du démon ne sera pas compromis.
Equivalent à <code>apachectl -k restart</code>.</dd>
<dt><code>fullstatus</code></dt>
<dd>Affiche le rapport d'état complet du module
<module>mod_status</module>. Pour que ceci fonctionne,
<module>mod_status</module> doit être activé dans votre serveur et vous
devez disposer d'un navigateur en mode texte tel que <code>lynx</code>
sur votre système. L'URL utilisée pour accéder au rapport d'état peut
être modifiée en définissant la variable <code>STATUSURL</code> dans le
script.</dd>
<dt><code>status</code></dt>
<dd>Affiche un rapport d'état succinct. Similaire à l'option
<code>fullstatus</code>, excepté que la liste des requêtes en cours de
traitement est omise.</dd>
<dt><code>graceful</code></dt>
<dd>Redémarre le démon Apache <program>httpd</program> en douceur. Si le
démon n'est pas en cours d'exécution, il est démarré. À la différence
d'un redémarrage normal, les connexions en cours ne sont pas fermées.
Comme effet de bord, les anciens fichiers journaux ne seront pas fermés
immédiatement. Cela signifie que si l'on utilise un script de rotation
des journaux, un délai suffisant sera nécessaire afin d'être sûr que les
fichiers journaux seront bien fermés avant leur traitement par le script
de rotation. Cette option vérifie
automatiquement les fichiers de configuration (de la même manière que
l'option <code>configtest</code> ) avant de lancer le redémarrage, afin
d'être sûr que le fonctionnement du démon ne sera pas compromis.
Équivalent à <code>apachectl -k graceful</code>.</dd>
<dt><code>graceful-stop</code></dt>
<dd>Arrête le démon Apache <program>httpd</program> en douceur. À la
différence d'un arrêt normal, les connexions en cours ne sont pas
fermées. Comme effet de bord, les anciens fichiers journaux ne seront
pas fermés immédiatement. Équivalent à <code>apachectl -k
graceful-stop</code>.</dd>
<dt><code>configtest</code></dt>
<dd>Effectue une vérification de la syntaxe du fichier de configuration.
Avec cette option, le script parcourt le fichier de configuration et
renvoie soit <code>Syntax Ok</code>, soit des informations détaillées à
propos des éventuelles erreurs de syntaxe. Equivalent à <code>apachectl
-t</code>.</dd>
</dl>
<p>Les options suivantes étaient disponibles dans les anciennes versions
et ont été supprimées.</p>
<dl>
<dt><code>startssl</code></dt>
<dd>Pour démarrer <program>httpd</program> avec le support SSL, vous
devez éditer votre fichier de configuration et y inclure les
directives appropriées, puis utiliser la commande de démarrage normale
<code>apachectl start</code>.</dd>
</dl>
</section>
</manualpage>
|
