From: Rob Bradford Date: Tue, 31 Oct 2023 15:37:17 +0000 (+0000) Subject: docs/about/deprecated: Document RISC-V "pmu-num" deprecation X-Git-Tag: pull-xenfv.for-upstream-20231107~15^2 X-Git-Url: https://www.infradead.org/git/?a=commitdiff_plain;h=bc5e8445342fee35b35f2ed9a9f2249e060b8776;p=users%2Fdwmw2%2Fqemu.git docs/about/deprecated: Document RISC-V "pmu-num" deprecation This has been replaced by a "pmu-mask" property that provides much more flexibility. Signed-off-by: Rob Bradford Acked-by: LIU Zhiwei Reviewed-by: Alistair Francis Reviewed-by: Atish Patra Message-ID: <20231031154000.18134-6-rbradford@rivosinc.com> Signed-off-by: Alistair Francis --- diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst index ecccd5d3fc..78550c07bf 100644 --- a/docs/about/deprecated.rst +++ b/docs/about/deprecated.rst @@ -413,6 +413,18 @@ Specifying the iSCSI password in plain text on the command line using the used instead, to refer to a ``--object secret...`` instance that provides a password via a file, or encrypted. +CPU device properties +''''''''''''''''''''' + +``pmu-num=n`` on RISC-V CPUs (since 8.2) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In order to support more flexible counter configurations this has been replaced +by a ``pmu-mask`` property. If set of counters is continuous then the mask can +be calculated with ``((2 ^ n) - 1) << 3``. The least significant three bits +must be left clear. + + Backwards compatibility -----------------------