granicus.if.org Git - apache/blob - docs/manual/mod/mod_systemd.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_systemd - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  21 <p class="apache">Apache HTTP Server Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Apache Module mod_systemd</h1>
  28 <div class="toplang">
  29 <p><span>Available Languages: </span><a href="../en/mod/mod_systemd.html" title="English">&nbsp;en&nbsp;</a></p>
  30 </div>
  31 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides better support for systemd integration</td></tr>
  32 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  33 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>systemd_module</td></tr>
  34 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_systemd.c</td></tr></table>
  35 <h3>Summary</h3>
  36
  37     <p>This module provides support for systemd integration. It allows
  38     starting httpd as a service with systemd <code>Type=notify</code>
  39     (see systemd.service(5) manual page for more information). It also
  40     provides statistics in <code>systemctl status</code> output and adds
  41     various directives useful for systemd integration.
  42     </p>
  43 </div>
  44 <div id="quickview"><h3 class="directives">Directives</h3>
  45 <ul id="toc">
  46 <li><img alt="" src="../images/down.gif" /> <a href="#idleshutdown">IdleShutdown</a></li>
  47 </ul>
  48 <h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_systemd">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_systemd">Report a bug</a></li></ul><h3>See also</h3>
  49 <ul class="seealso">
  50 <li><a href="#comments_section">Comments</a></li></ul></div>
  51
  52 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  53 <div class="directive-section"><h2><a name="IdleShutdown" id="IdleShutdown">IdleShutdown</a> <a name="idleshutdown" id="idleshutdown">Directive</a></h2>
  54 <table class="directive">
  55 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable shutting down the httpd when it is idle for some time.</td></tr>
  56 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>IdleShutdown seconds</code></td></tr>
  57 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>IdleShutdown 0</code></td></tr>
  58 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
  59 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  60 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_systemd</td></tr>
  61 </table>
  62     <p>The <code class="directive">IdleShutdown</code> directive enables shutting
  63     down the httpd when it is idle for some time. The idleness is based on
  64     bytes served, so if there are no bytes sent for some time defined by this
  65     directive, httpd will shutdown. By default, IdleShutdown is set to 0
  66     meaning this feature is disabled.
  67     </p>
  68
  69     <p>This feature is useful in a combination with systemd socket activation
  70     (see systemd.socket(5) manual page). When httpd is started by systemd on
  71     some request, using this directive you can stop the httpd automatically
  72     when all the requests are served.
  73     </p>
  74
  75     <div class="warning"><h3>Implementation warning</h3><p>
  76     Because of implementation details, idleness is checked only every 10
  77     seconds. That means that if you specify <code>IdleShutdown 14</code>,
  78     httpd will stop itself after 20 seconds of idleness.
  79     </p></div>
  80
  81 </div>
  82 </div>
  83 <div class="bottomlang">
  84 <p><span>Available Languages: </span><a href="../en/mod/mod_systemd.html" title="English">&nbsp;en&nbsp;</a></p>
  85 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
  86 <script type="text/javascript"><!--//--><![CDATA[//><!--
  87 var comments_shortname = 'httpd';
  88 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_systemd.html';
  89 (function(w, d) {
  90     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
  91         d.write('<div id="comments_thread"><\/div>');
  92         var s = d.createElement('script');
  93         s.type = 'text/javascript';
  94         s.async = true;
  95         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
  96         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
  97     }
  98     else {
  99         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 100     }
 101 })(window, document);
 102 //--><!]]></script></div><div id="footer">
 103 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 104 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 105 if (typeof(prettyPrint) !== 'undefined') {
 106     prettyPrint();
 107 }
 108 //--><!]]></script>
 109 </body></html>