On 01/04/2021 15:49, Matthew Auld wrote:
On Wed, 31 Mar 2021 at 10:12, Tvrtko Ursulin
<tvrtko.ursulin@xxxxxxxxxxxxxxx> wrote:
From: Tvrtko Ursulin <tvrtko.ursulin@xxxxxxxxx>
Put a note on how to use JSON output into the man page.
Signed-off-by: Tvrtko Ursulin <tvrtko.ursulin@xxxxxxxxx>
References: https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/issues/100
---
man/intel_gpu_top.rst | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/man/intel_gpu_top.rst b/man/intel_gpu_top.rst
index f6d74852558b..94fdc6520fd3 100644
--- a/man/intel_gpu_top.rst
+++ b/man/intel_gpu_top.rst
@@ -81,6 +81,11 @@ Filter types: ::
pci pci:[vendor=%04x/name][,device=%04x][,card=%d]
vendor is hex number or vendor name
+JSON OUTPUT
+===========
+
+To parse the JSON as output by the tool the consumer should wrap its entirety into square brackets ([ ]). This will make each sample point an JSON array element and will avoid "Multiple root elements" JSON validation error.
+
a JSON array element
It could be argued that this should go into LIMITATIONS?
Hm yes, 50-50 or you lean more towards limitations? Otherwise inertia
says it can also stay as is.
Regards,
Tvrtko
Acked-by: Matthew Auld <matthew.auld@xxxxxxxxx>
LIMITATIONS
===========
--
2.27.0
_______________________________________________
igt-dev mailing list
igt-dev@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/igt-dev
_______________________________________________
Intel-gfx mailing list
Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
