Bug 262646

Summary: New bullet-point to 6.1 microbenchmaring
Product: Documentation Reporter: Poul-Henning Kamp <phk>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me CC: bcr, freebsd, pauamma
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
patch for developer handbook none

Description Poul-Henning Kamp freebsd_committer freebsd_triage 2022-03-18 12:48:48 UTC
Please add:

* Disable "Turbo-modes".  Turbo-mode make the clock frequency explicitly depend on the environment.  This means that benchmark runs on 100% identical code, may depend on time of day, coffee vs soda or even how many other people are in the office.
Comment 1 Pau Amma 2022-03-19 00:42:56 UTC
Is this about documentation/content/en/books/developers-handbook/testing/_index.adoc in the Developer's Handbook?
Comment 2 Chris Moerz 2024-02-17 12:58:35 UTC
Created attachment 248531 [details]
patch for developer handbook

If I read this right, this is what was meant? Not sure, if it wouldn't help to improve the reasoning or link to supporting documentation that outlines why turbo mode does that?

When I'm thinking of turbo mode, I'm thinking 286, 386 computers with turbo buttons on the outside?
Comment 3 commit-hook freebsd_committer freebsd_triage 2024-05-29 19:25:01 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=fd25efa62a92d2abdeec0493fba2d30a68ce43db

commit fd25efa62a92d2abdeec0493fba2d30a68ce43db
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2024-05-29 19:21:31 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2024-05-29 19:21:31 +0000

    Add bullet-point about disabling "Turbo-modes"

    Elaborate on this point a bit how and why they interfere with
    microbenchmarking.

    PR:     262646

 .../content/en/books/developers-handbook/testing/_index.adoc          | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2024-05-29 19:26:16 UTC
Patch (plus your additional comments) committed. Thanks for the addition to the developers-handbook.