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