[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL v5 43/44] docs/devel: Added cache plugin to the plugins docs
From: |
Alex Bennée |
Subject: |
[PULL v5 43/44] docs/devel: Added cache plugin to the plugins docs |
Date: |
Wed, 14 Jul 2021 16:00:35 +0100 |
From: Mahmoud Mandour <ma.mandourr@gmail.com>
Signed-off-by: Mahmoud Mandour <ma.mandourr@gmail.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20210628053808.17422-1-ma.mandourr@gmail.com>
Message-Id: <20210709143005.1554-40-alex.bennee@linaro.org>
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index 179867e9c1..7e54f12837 100644
--- a/docs/devel/tcg-plugins.rst
+++ b/docs/devel/tcg-plugins.rst
@@ -344,3 +344,62 @@ which will output an execution trace following this
structure::
0, 0xd32, 0xf9893014, "adds r0, #0x14"
0, 0xd34, 0xf9c8f000, "bl #0x10c8"
0, 0x10c8, 0xfff96c43, "ldr r3, [r0, #0x44]", load, 0x200000e4, RAM
+
+- contrib/plugins/cache
+
+Cache modelling plugin that measures the performance of a given cache
+configuration when a given working set is run::
+
+ qemu-x86_64 -plugin ./contrib/plugins/libcache.so \
+ -d plugin -D cache.log ./tests/tcg/x86_64-linux-user/float_convs
+
+will report the following::
+
+ Data accesses: 996479, Misses: 507
+ Miss rate: 0.050879%
+
+ Instruction accesses: 2641737, Misses: 18617
+ Miss rate: 0.704726%
+
+ address, data misses, instruction
+ 0x424f1e (_int_malloc), 109, movq %rax, 8(%rcx)
+ 0x41f395 (_IO_default_xsputn), 49, movb %dl, (%rdi, %rax)
+ 0x42584d (ptmalloc_init.part.0), 33, movaps %xmm0, (%rax)
+ 0x454d48 (__tunables_init), 20, cmpb $0, (%r8)
+ ...
+
+ address, fetch misses, instruction
+ 0x4160a0 (__vfprintf_internal), 744, movl $1, %ebx
+ 0x41f0a0 (_IO_setb), 744, endbr64
+ 0x415882 (__vfprintf_internal), 744, movq %r12, %rdi
+ 0x4268a0 (__malloc), 696, andq $0xfffffffffffffff0, %rax
+ ...
+
+The plugin has a number of arguments, all of them are optional:
+
+ * arg="limit=N"
+
+ Print top N icache and dcache thrashing instructions along with their
+ address, number of misses, and its disassembly. (default: 32)
+
+ * arg="icachesize=N"
+ * arg="iblksize=B"
+ * arg="iassoc=A"
+
+ Instruction cache configuration arguments. They specify the cache size, block
+ size, and associativity of the instruction cache, respectively.
+ (default: N = 16384, B = 64, A = 8)
+
+ * arg="dcachesize=N"
+ * arg="dblksize=B"
+ * arg="dassoc=A"
+
+ Data cache configuration arguments. They specify the cache size, block size,
+ and associativity of the data cache, respectively.
+ (default: N = 16384, B = 64, A = 8)
+
+ * arg="evict=POLICY"
+
+ Sets the eviction policy to POLICY. Available policies are: :code:`lru`,
+ :code:`fifo`, and :code:`rand`. The plugin will use the specified policy for
+ both instruction and data caches. (default: POLICY = :code:`lru`)
--
2.20.1
- [PULL v5 23/44] tests/docker: expand ubuntu1804 package list, (continued)
- [PULL v5 23/44] tests/docker: expand ubuntu1804 package list, Alex Bennée, 2021/07/14
- [PULL v5 36/44] tcg/plugins: enable by default for most TCG builds, Alex Bennée, 2021/07/14
- [PULL v5 44/44] MAINTAINERS: Added myself as a reviewer for TCG Plugins, Alex Bennée, 2021/07/14
- [PULL v5 34/44] configure: add an explicit static and plugins check, Alex Bennée, 2021/07/14
- [PULL v5 26/44] tests/vm: update NetBSD to 9.2, Alex Bennée, 2021/07/14
- [PULL v5 24/44] tests/docker: expand ubuntu2004 package list, Alex Bennée, 2021/07/14
- [PULL v5 40/44] plugins: Added a new cache modelling plugin, Alex Bennée, 2021/07/14
- [PULL v5 22/44] tests/docker: expand fedora package list, Alex Bennée, 2021/07/14
- [PULL v5 30/44] meson.build: move TCG plugin summary output, Alex Bennée, 2021/07/14
- [PULL v5 20/44] tests/docker: remove mingw packages from Fedora, Alex Bennée, 2021/07/14
- [PULL v5 43/44] docs/devel: Added cache plugin to the plugins docs,
Alex Bennée <=
- [PULL v5 41/44] plugins/cache: Enable cache parameterization, Alex Bennée, 2021/07/14
- [PULL v5 31/44] meson.build: relax the libdl test to one for the function dlopen, Alex Bennée, 2021/07/14
- [PULL v5 33/44] configure: don't allow plugins to be enabled for a non-TCG build, Alex Bennée, 2021/07/14
- [PULL v5 19/44] tests/docker: fix mistakes in ubuntu package lists, Alex Bennée, 2021/07/14
- [PULL v5 25/44] tests/docker: expand opensuse-leap package list, Alex Bennée, 2021/07/14
- [PULL v5 21/44] tests/docker: expand centos8 package list, Alex Bennée, 2021/07/14
- [PULL v5 29/44] plugins: fix-up handling of internal hostaddr for 32 bit, Alex Bennée, 2021/07/14
- [PULL v5 15/44] tests/docker: remove FEATURES env var from templates, Alex Bennée, 2021/07/14
- [PULL v5 27/44] tests/vm: update openbsd to release 6.9, Alex Bennée, 2021/07/14
- [PULL v5 18/44] tests/docker: fix mistakes in fedora package list, Alex Bennée, 2021/07/14