blob: 01cf472aed9e07da0679e32af7ded84994740fc7 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1873889 -->
<!-- French translation : Lucien GENTIS -->
<!--
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.
-->
<modulesynopsis metafile="mod_systemd.xml.meta">
<name>mod_systemd</name>
<description>Fournit un support amélioré pour l'intégration de systemd</description>
<status>Extension</status>
<sourcefile>mod_systemd.c</sourcefile>
<identifier>systemd_module</identifier>
<compatibility>Disponible à partir de la version 2.4.42 du serveur HTTP Apache</compatibility>
<summary>
<p>Ce module implémente le support de l'intégration de systemd. Il
permet d'utiliser httpd en temps que service avec le paramètre de
systemd <code>Type=notify</code> (voir la page de manuel
<a
href="https://www.freedesktop.org/software/systemd/man/systemd.service.html">systemd.service(5)</a>
pour plus de détails). Le module est activé s'il est chargé.</p>
<example>
<title>Exemple basique d'unité de service systemd (à étoffer pour un système en
production)</title>
<pre>
[Unit]
Description=The Apache HTTP Server
After=network.target
[Service]
Type=notify
ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start
ExecReload=/usr/local/apache2/bin/httpd -k graceful
KillMode=mixed
[Install]
WantedBy=multi-user.target
</pre>
</example>
<p>Si vous utilisez <code>ExecStop</code> et/ou <code>KillMode</code>, vous
devez prêter une attention particulière à leur configuration pour ce service.
Si elle est présente, une commande <code>ExecStop</code> doit être une
<em>operation synchrone</em> qui se termine elle-même en même temps que le
démon. Cette condition n'est pas satisfaite si vous exécutez la commande
<code>httpd -k stop</code> de manière <em>asynchrone</em>, car elle initie
l'arrêt du démon. L'exemple ci-dessus utilise <code>KillMode=mixed</code>
afin que systemd envoie <code>SIGTERM</code> au processus parent (et
seulement à ce dernier) pour lui indiquer qu'il doit s'arrêter. Les processus
encore en cours d'exécution après un temps égal à <code>TimeoutStopSec</code>
recevront alors le signal <code>SIGKILL</code>. Voir <a
href="https://www.freedesktop.org/software/systemd/man/systemd.kill.html">systemd.kill(5)</a>
pour plus d'informations.</p>
<p>Ce module ne fournit pas le support de l'activation du socket Systemd.</p>
<p><directive module="core">ExtendedStatus</directive> est activé par défaut
si le module est chargé. Si <directive
module="core">ExtendedStatus</directive> n'est pas explicitement désactivé
dans le fichier de configuration, les statistiques à propos de la charge et
des requêtes pendant l'exécution apparaîtront dans la sortie de la commande
<code>systemctl status</code>.</p>
</summary>
</modulesynopsis>