| <?xml version="1.0" ?> | |
| <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> | |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> | |
| <!-- English Revision: 1933949:1939427 (outdated) --> | |
| <!-- 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><program>apachectl</program> 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 <program>apachectl</program> 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 <program>apachectl</program> 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 <program>apachectl</program> 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), <program>apachectl</program> 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, <program>apachectl</program> | |
| 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> | |
| <section id="files"><title>Fichiers</title> | |
| <p>Les chemins de fichiers listés ci-après peuvent être modifiés à la | |
| compilation. Consultez votre installation locale pour les emplacements réels.</p> | |
| <dl> | |
| <dt><code>/usr/local/apache2/bin/envvars</code></dt> | |
| <dd>Fichier de définitions de variables d’environnement alimenté au démarrage.</dd> | |
| <dt><code>/usr/local/apache2/bin/httpd</code></dt> | |
| <dd>Le binaire httpd invoqué par apachectl.</dd> | |
| </dl> | |
| </section> | |
| </manualpage> |