From 7274b3c5421eaa4ac8a84207f9319bef3901a82a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mos=C3=A8=20Giordano?= Date: Mon, 3 Oct 2022 13:39:56 +0100 Subject: [PATCH 1/2] [doc] Make it clear logical CPUs refer to threads --- docs/config_reference.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/config_reference.rst b/docs/config_reference.rst index 356a97cec9..63a001f727 100644 --- a/docs/config_reference.rst +++ b/docs/config_reference.rst @@ -1637,7 +1637,7 @@ Processor Info .. versionadded:: 3.5.0 -A *processor info object* in ReFrame's configuration is used to hold information about the processor of a system partition and is made available to the tests through the :attr:`processor ` attribute of the :attr:`current_partition `. +A *processor info object* in ReFrame's configuration is used to hold information about the processor of a system partition and is made available to the tests through the :attr:`processor ` attribute of the :attr:`current_partition `. Note that "logical CPUs" is the number of threads, so for example :attr:`num_cpus_per_core ` can be larger than one if a hyper-threading-like system is enabled. .. attribute:: .arch From f1e47af89ada42da8e4f06b94400d1876a30f59b Mon Sep 17 00:00:00 2001 From: Vasileios Karakasis Date: Tue, 4 Oct 2022 00:18:42 +0200 Subject: [PATCH 2/2] Reprhase and expand note on logical CPUs --- docs/config_reference.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/config_reference.rst b/docs/config_reference.rst index 63a001f727..e38180335c 100644 --- a/docs/config_reference.rst +++ b/docs/config_reference.rst @@ -1637,8 +1637,12 @@ Processor Info .. versionadded:: 3.5.0 -A *processor info object* in ReFrame's configuration is used to hold information about the processor of a system partition and is made available to the tests through the :attr:`processor ` attribute of the :attr:`current_partition `. Note that "logical CPUs" is the number of threads, so for example :attr:`num_cpus_per_core ` can be larger than one if a hyper-threading-like system is enabled. +A *processor info object* in ReFrame's configuration is used to hold information about the processor of a system partition and is made available to the tests through the :attr:`processor ` attribute of the :attr:`current_partition `. +.. note:: + In the following the term *logical CPUs* refers to the smallest processing unit recognized by the OS. + Depending on the microarchitecture, this can either be a core or a hardware thread in processors that support simultaneous multithreading and this feature is enabled. + Therefore, properties such as :attr:`num_cpus_per_core` may have a value greater than one. .. attribute:: .arch