summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoe Orton <jorton@redhat.com>2017-11-03 16:52:50 +0000
committerJoe Orton <jorton@redhat.com>2017-11-03 16:52:50 +0000
commit9c91812414ae30246f37b11c46ba579f89ab3ecb (patch)
tree5548336e628a465259b9a0b10efcab61abe1712c
parent16b03b20d8a2c18913e94ab6653c66deb5922ace (diff)
downloadhttpd-9c91812414ae30246f37b11c46ba579f89ab3ecb.tar.gz
httpd-9c91812414ae30246f37b11c46ba579f89ab3ecb.tar.xz
httpd-9c91812414ae30246f37b11c46ba579f89ab3ecb.zip
Add docs on using socket activation.master
-rw-r--r--httpd.service.xml26
1 files changed, 26 insertions, 0 deletions
diff --git a/httpd.service.xml b/httpd.service.xml
index 4402ed5..b8fe7b3 100644
--- a/httpd.service.xml
+++ b/httpd.service.xml
@@ -221,6 +221,31 @@ Wants=network-online.target</programlisting>
</refsect2>
+ <refsect2>
+ <title>Socket activation</title>
+
+ <para>Socket activation (see
+ <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ for more information) can be used with <command>httpd</command>
+ by enabling the <command>httpd.socket</command> unit. The
+ <command>httpd</command> listener configuration must exactly
+ match the <literal>ListenStream</literal> options configured for
+ the <command>httpd.socket</command> unit. The default
+ <command>httpd.socket</command> has a
+ <literal>ListenStream=80</literal> and, if mod_ssl is installed,
+ <literal>ListenStream=443</literal> by a drop-in file. If
+ additional <literal>Listen</literal> directives are added to the
+ httpd configuration, corresponding
+ <literal>ListenStream</literal> options should be added via
+ drop-in files, for example via <command>systemctl edit
+ httpd.socket</command>.</para>
+
+ <para>If using socket activation with httpd, only one listener
+ on any given TCP port is supported; a configuration with both
+ "<literal>Listen 127.0.0.1:80</literal>" and "<literal>Listen
+ 192.168.1.2:80</literal>" will not work.</para>
+ </refsect2>
+
</refsect1>
<refsect1>
@@ -240,6 +265,7 @@ Wants=network-online.target</programlisting>
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>httpd_selinux</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>semanage</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>