From: William Lallemand <wlallemand@haproxy.com>
Date: Fri, 16 Dec 2016 15:38:58 +0000 (+0100)
Subject: DOC: cli: show cli sockets
X-Git-Tag: v1.8-dev1~267
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=511321658317b079eee5c2e380cc904959a53653;p=thirdparty%2Fhaproxy.git

DOC: cli: show cli sockets

Add documentation for 'show cli sockets' on the CLI.
---

diff --git a/doc/management.txt b/doc/management.txt
index f95dab234e..683b997901 100644
--- a/doc/management.txt
+++ b/doc/management.txt
@@ -1674,6 +1674,23 @@ set weight <backend>/<server> <weight>[%]
   "admin". Both the backend and the server may be specified either by their
   name or by their numeric ID, prefixed with a sharp ('#').
 
+show cli sockets
+  List CLI sockets. The output format is composed of 3 fields separated by
+  spaces. The first field is the socket address, it can be a unix socket, a
+  ipv4 address:port couple or a ipv6 one. Socket of other types won't be dump.
+  The second field describe the level of the socket: 'admin', 'user' or
+  'operator'. The last field list the processes on which the socket is bound,
+  separated by commas, it can be numbers or 'all'.
+
+  Example :
+
+     $ echo 'show cli sockets' | socat stdio /tmp/sock1
+     # socket lvl processes
+     /tmp/sock1 admin all
+     127.0.0.1:9999 user 2,3,4
+     127.0.0.2:9969 user 2
+     [::1]:9999 operator 2
+
 show env [<name>]
   Dump one or all environment variables known by the process. Without any
   argument, all variables are dumped. With an argument, only the specified