apache2ctl - L'interface de contr�le du serveur HTTP Apache
apache2ctl 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 httpd.
Le script apache2ctl poss�de deux modes de
fonctionnement. Il peut fonctionner en tant que simple frontal
de la commande httpd et ne fait alors que
d�finir toute variable d'environnement n�cessaire, puis invoque
httpd 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
start, restart et stop, et
traduisant ce dernier en signaux appropri�s pour le d�mon
httpd.
Si votre installation d'Apache utilise des chemins non
standards, vous devrez �diter le script apache2ctl afin
de d�finir les chemins appropri�s pour le binaire
httpd. Vous pouvez aussi sp�cifier tout argument
de ligne de commande de httpd n�cessaire. Voir
les commentaires dans le script pour plus de d�tails.
Le script apache2ctl 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.
Voir aussi
R�sum�
En mode frontal (pass-through), apache2ctl peut sp�cifier
tous les arguments qu'accepte le binaire httpd.
apache2ctl [ argument-httpd ]
En mode script d'initialisation SysV, apache2ctl
n'accepte qu'un seul des arguments d�finis ci-dessous.
apache2ctl commande
Options
Seules les options du style initialisation SysV sont d�crites ici.
Les autres arguments sont d�crits dans la page de manuel de
httpd.
start- D�marre le d�mon Apache
httpd. Renvoie une erreur s'il est d�j� en cours d'ex�cution. �quivalent �apache2ctl -k start. stop- Arr�te le d�mon Apache
httpd. �quivalent �apache2ctl -k stop. restart- Red�marre le d�mon Apache
httpd. 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'optionconfigtest) avant de lancer le red�marrage, afin d'�tre s�r que le fonctionnement du d�mon ne sera pas compromis. Equivalent �apache2ctl -k restart. fullstatus- Affiche le rapport d'�tat complet du module
mod_status. Pour que ceci fonctionne,mod_statusdoit �tre activ� dans votre serveur et vous devez disposer d'un navigateur en mode texte tel quelynxsur votre syst�me. L'URL utilis�e pour acc�der au rapport d'�tat peut �tre modifi�e en d�finissant la variableSTATUSURLdans le script. status- Affiche un rapport d'�tat succinct. Similaire � l'option
fullstatus, except� que la liste des requ�tes en cours de traitement est omise. graceful- Red�marre le d�mon Apache
httpden 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'optionconfigtest) avant de lancer le red�marrage, afin d'�tre s�r que le fonctionnement du d�mon ne sera pas compromis. �quivalent �apache2ctl -k graceful. graceful-stop- Arr�te le d�mon Apache
httpden 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 �apache2ctl -k graceful-stop. configtest- Effectue une v�rification de la syntaxe du fichier de configuration.
Avec cette option, le script parcourt le fichier de configuration et
renvoie soit
Syntax Ok, soit des informations d�taill�es � propos des �ventuelles erreurs de syntaxe. Equivalent �apache2ctl -t.
Les options suivantes �taient disponibles dans les anciennes versions et ont �t� supprim�es.
startssl- Pour d�marrer
httpdavec le support SSL, vous devez �diter votre fichier de configuration et y inclure les directives appropri�es, puis utiliser la commande de d�marrage normaleapache2ctl start.