X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-socket-proxyd.xml;h=fcf4aafd60d2d5df9081a5bdffb753c3df581404;hb=102d8f8169427cb68cdebf5ee0f0e07788e9c2b2;hp=87122f5381bac7b7539ba383adda97f52684c0a7;hpb=464b3d64419808b7334563e907d172337cc9d718;p=elogind.git
diff --git a/man/systemd-socket-proxyd.xml b/man/systemd-socket-proxyd.xml
index 87122f538..fcf4aafd6 100644
--- a/man/systemd-socket-proxyd.xml
+++ b/man/systemd-socket-proxyd.xml
@@ -39,19 +39,17 @@
systemd-socket-proxyd
- Inherit a socket. Bidirectionally
- proxy.
+ Bidirectionally proxy local sockets to another (possibly remote) socket.systemd-socket-proxyd
- OPTIONS
- HOSTNAME-OR-IP
- PORT-OR-SERVICE
+ OPTIONS
+ HOST:PORTsystemd-socket-proxyd
- OPTIONS
+ OPTIONSUNIX-DOMAIN-SOCKET-PATH
@@ -59,15 +57,22 @@
Description
- systemd-socket-proxyd provides a proxy
- to socket-activate services that do not yet support
- native socket activation. On behalf of the daemon,
- the proxy inherits the socket from systemd, accepts
- each client connection, opens a connection to the server
- for each client, and then bidirectionally forwards
- data between the two.
+ systemd-socket-proxyd is a generic
+ socket-activated network socket forwarder proxy daemon
+ for IPV4, IPv6 and UNIX stream sockets. It may be used
+ to bi-directionally forward traffic from a local listening socket to a
+ local or remote destination socket.
+
+ One use of this tool is to provide
+ socket-activation support for services that do not
+ natively support socket activation. On behalf of the
+ service to activate, the proxy inherits the socket
+ from systemd, accepts each client connection, opens a
+ connection to a configured server for each client, and
+ then bidirectionally forwards data between the
+ two.This utility's behavior is similar to
- socat1.
+ socat1.
The main differences for systemd-socket-proxyd
are support for socket activation with
Accept=false and an event-driven
@@ -93,24 +98,11 @@
string and exits.
-
-
-
- Skips verification of
- the expected PID and file
- descriptor numbers. Use if
- invoked indirectly, for
- example with a shell script
- rather than with
-
-
-
- Exit status
- On success 0 is returned, a non-zero failure
+ On success, 0 is returned, a non-zero failure
code otherwise.
@@ -153,9 +145,9 @@ server {
-
@@ -205,7 +197,7 @@ while [ ! -f /tmp/nginx.pid ]
do
/usr/bin/inotifywait /tmp/nginx.pid
done
-/usr/bin/systemd-socket-proxyd --ignore-env localhost 8080]]>
+exec /usr/bin/systemd-socket-proxyd localhost 8080]]>
@@ -221,9 +213,9 @@ server {
-
@@ -232,23 +224,11 @@ $ curl http://localhost:80/]]>
See Also
-
-
- systemd.service
- 5
- ,
-
-
- systemd.socket
- 5
- ,
-
- systemctl
- 1
- ,
-
- socat
- 1
-
+ systemd1,
+ systemd.socket5,
+ systemd.service5,
+ systemctl1,
+ socat1
+