X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-socket-proxyd.xml;h=8061466d8f832ebfaa12db1e10135cc6594ce8fe;hb=099524d7b0df690e3361ffc3fe3c6aed0558b4fc;hp=ffa94f4c1b56940380762be4b506f0f3f346abf7;hpb=07504d6b152084040e48f7657b0f56f364003334;p=elogind.git
diff --git a/man/systemd-socket-proxyd.xml b/man/systemd-socket-proxyd.xml
index ffa94f4c1..8061466d8 100644
--- a/man/systemd-socket-proxyd.xml
+++ b/man/systemd-socket-proxyd.xml
@@ -35,7 +35,7 @@
systemd-socket-proxyd
- 1
+ 8
systemd-socket-proxyd
@@ -108,34 +108,30 @@
Examples
- Direct-Use Example
+ Simple Example
Use two services with a dependency
and no namespace isolation.
-
- /etc/systemd/system/proxy-to-nginx.socket
-
-
+ proxy-to-nginx.socket
+
-
+WantedBy=sockets.target]]>
-
- /etc/systemd/system/proxy-to-nginx.service
-
-
+ proxy-to-nginx.service
+
-
+ExecStart=/usr/lib/systemd/systemd-socket-proxyd /tmp/nginx.sock
+PrivateTmp=yes
+PrivateNetwork=yes]]>
-
- /etc/nginx/nginx.conf
+
+ nginx.conf
-
-
-
+ Enabling the proxy
+
-
+$ curl http://localhost:80/]]>
- Indirect-Use Example
- Use a shell script to isolate the
- service and proxy into the same namespace.
- This is particularly useful for running
- TCP-only daemons without the daemon
- affecting ports on regular
- interfaces.
-
-
-
- /etc/systemd/system/proxy-with-nginx.socket
-
-Namespace Example
+ Similar as above, but runs the socket
+ proxy and the main service in the same private
+ namespace, assuming that
+ nginx.service has
+ PrivateTmp= and
+ PrivateNetwork= set,
+ too.
+
+ proxy-to-nginx.socket
+
-
+WantedBy=sockets.target]]>
-
-
-
- /etc/systemd/system/proxy-with-nginx.service
-
-
+ proxy-to-nginx.service
+
-
+ExecStart=/usr/lib/systemd/systemd-socket-proxyd 127.0.0.1:8080
+PrivateTmp=yes
+PrivateNetwork=yes]]>
-
-
- /usr/bin/socket-proxyd-nginx.sh
-
-
-
-
-
-
- /etc/nginx/nginx.conf
-
-
+ nginx.conf
+
-
+ [...]]]>
-
-
-
-
+
+ Enabling the proxy
+
@@ -226,7 +198,9 @@ $ curl http://localhost:80/]]>
systemd.socket5,
systemd.service5,
systemctl1,
- socat1
+ socat1,
+ nginx1,
+ curl1