From: Rafael Antognolli <rafael.antognolli@intel.com>
Date: Thu, 12 Dec 2019 21:55:11 +0000 (-0800)
Subject: vulkan/overlay: Update docs.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=6a3b8811ea556d6ef301ad579c1c92f2c66d90ca;p=mesa.git

vulkan/overlay: Update docs.

Add mention to overlay control socket.

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

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".