Mesa (master): vulkan/overlay: Update docs.

[GitLab Mirror]

Module: Mesa
Branch: master
Commit: 6a3b8811ea556d6ef301ad579c1c92f2c66d90ca
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=6a3b8811ea556d6ef301ad579c1c92f2c66d90ca

Author: Rafael Antognolli <rafael.antognolli at intel.com>
Date:   Thu Dec 12 13:55:11 2019 -0800

vulkan/overlay: Update docs.

Add mention to overlay control socket.

Reviewed-by: Lionel Landwerlin <lionel.g.landwerlin at intel.com>

---

 src/vulkan/overlay-layer/README | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/src/vulkan/overlay-layer/README b/src/vulkan/overlay-layer/README
index 660ab94a715..20ab73103e7 100644
--- a/src/vulkan/overlay-layer/README
+++ b/src/vulkan/overlay-layer/README
@@ -15,3 +15,38 @@ VK_INSTANCE_LAYERS=VK_LAYER_MESA_overlay VK_LAYER_MESA_OVERLAY_CONFIG=submit,dra
 Position the layer :
 
 VK_INSTANCE_LAYERS=VK_LAYER_MESA_overlay VK_LAYER_MESA_OVERLAY_CONFIG=submit,draw,pipeline_graphics,position=top-right /path/to/my_vulkan_app
+
+Dump statistics into a file:
+
+VK_INSTANCE_LAYERS=VK_LAYER_MESA_overlay VK_LAYER_MESA_OVERLAY_CONFIG=position=top-right,output_file=/tmp/output.txt /path/to/my_vulkan_app
+
+Dump statistics into a file, controlling when such statistics will start
+to be captured:
+
+VK_INSTANCE_LAYERS=VK_LAYER_MESA_overlay VK_LAYER_MESA_OVERLAY_CONFIG=position=top-right,output_file=/tmp/output.txt,control=mesa_overlay /path/to/my_vulkan_app
+
+The above command will open a unix socket with abstract path
+'mesa_overlay'.  Once a client connects to the socket, the overlay layer
+will immediately send the following commands to the client:
+
+:MesaOverlayControlVersion=1;
+:DeviceName=<device name>;
+:MesaVersion=<mesa version>;
+
+The client connected to the overlay layer can enable statistics
+capturing by sending the command:
+
+:capture=1;
+
+And disable it by emitting
+
+:capture=0;
+
+By default, capture is enabled when an output_file is specified, but it
+will be disabled by default when a control socket is in use. In the
+latter case, it needs to be explicitly enabled through the sockets, by
+using the commands above.
+
+The provided script overlay-control.py can be used to start/stop
+capture. The --path option can be used to specify the socket path. By
+default, it will try to connect to a path named "mesa_overlay".