From nobody Sun Sep 04 10:52:57 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ML7ls5YzYz4bJqB; Sun, 4 Sep 2022 10:52:57 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ML7ls52vyz49RW; Sun, 4 Sep 2022 10:52:57 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1662288777; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nW0hLVJ5LFrQsxAoRWIwpvnL2cJUe6R9zoLqPv88FEk=; b=bS9LBw6bKD2GB+ZLFOmNk1ZVCVJHWEXAMjSOR0Ze1GijDV435gSAO5iIfs7y/xehEP+03U S4LptoFGPGqf15JsdKZYSc3Zn3XOOSzOK91x5nZYqo3dg1qvE+F/VR41FDldJ59CRxzTtu P/138dm8PCXhSUMd3Iq4KLukXBKAsBmx6YcD6V/nJftcQoTPhs+jc/UDOhmahNCsE1ru3U FOu/TXrwmMuJJ3X2E95ky3BlU3MKV2+Sk5KTzHFfGXx2s1FMKlngZFBUBw7BzJvAUiZVE2 lmN5ZSZGXlZUGG+iArBWvbQfMD/rSvZGQR2cD49EwfxVfPVwXk2HWF6s78XT2g== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ML7ls46Y8zSQd; Sun, 4 Sep 2022 10:52:57 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 284AqvFo007703; Sun, 4 Sep 2022 10:52:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 284Aqvu2007702; Sun, 4 Sep 2022 10:52:57 GMT (envelope-from git) Date: Sun, 4 Sep 2022 10:52:57 GMT Message-Id: <202209041052.284Aqvu2007702@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Gordon Bergling Subject: git: f0d4c2afd65f - main - pmc(3): Correct some typos in event descriptions List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gbe X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f0d4c2afd65f821b8983152848f4005239ff975a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1662288777; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nW0hLVJ5LFrQsxAoRWIwpvnL2cJUe6R9zoLqPv88FEk=; b=vrc7DEECtmNDn+UwBZiCLkNExV3P59Axze1xFibSiW5gtvhGVgLrOlkwZuDhzihiJll3Bn 4FjaIJpkN4U1Yrsr+Urv7Rpz06nxkuhlem6Qr6EIbN2odFNB9+dETtSbi7S966A0dAv0bE wKncazpmxQy+4Q+lvZlqadG2iqrDry/Mycgxq3G52ZicWWAtGmv5FYDKXlRcHStmhnrIK9 uQ717m4mxhNm+qLBaE3aF+6kwmGBSVFcNQUWbRuGwHMmhCG5+sbqafJwDdAEWv5uplIodG RBMYt6YUzScvRpF4VslPm3JNU4jzNBflF4Buok20IaeVprzv/cGLuvUU1hx4Cg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1662288777; a=rsa-sha256; cv=none; b=Q1sqtr61fPXzep6LUZN8v/ueZRnTXCxQaAUFDHSvrYTRyjoV+Kxb7e/L9NJZXNxKLP8tis PJe/OpaENfsokeNFGSDh37QhWm6SVj8R+h8esyGr1UFlze6nQhDYO4Vx2KxSPvQHpxLgeS nP8jZx1tP7ZnkBh5RXiSqBHyw3UWiu3qoyrGwII0IlbVBmX0liErQwsyLutaGYs0LnwxMu KCQiJumIGVA5jmXVVDyiQDaO0iD8Y+XpzjfwN56NP8uCppHHWBmwJ6FAE87RhGx794HK6X +OQI4ve6UV/ubOu2s0gaLzgH/faMzql2qtKBjaqxoQnBRC5spGF4GwnCMHNiaA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gbe (doc committer): URL: https://cgit.FreeBSD.org/src/commit/?id=f0d4c2afd65f821b8983152848f4005239ff975a commit f0d4c2afd65f821b8983152848f4005239ff975a Author: Gordon Bergling AuthorDate: 2022-09-04 10:52:38 +0000 Commit: Gordon Bergling CommitDate: 2022-09-04 10:52:38 +0000 pmc(3): Correct some typos in event descriptions - s/occured/occurred/ - s/the the/the/ MFC after: 3 days --- lib/libpmc/pmu-events/arch/x86/broadwell/pipeline.json | 4 ++-- lib/libpmc/pmu-events/arch/x86/broadwellde/pipeline.json | 4 ++-- lib/libpmc/pmu-events/arch/x86/broadwellx/pipeline.json | 4 ++-- lib/libpmc/pmu-events/arch/x86/cascadelakex/uncore-other.json | 2 +- lib/libpmc/pmu-events/arch/x86/silvermont/pipeline.json | 4 ++-- lib/libpmc/pmu-events/arch/x86/skylakex/uncore-other.json | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/lib/libpmc/pmu-events/arch/x86/broadwell/pipeline.json b/lib/libpmc/pmu-events/arch/x86/broadwell/pipeline.json index 18d21b94a4b9..6044773c1e9a 100644 --- a/lib/libpmc/pmu-events/arch/x86/broadwell/pipeline.json +++ b/lib/libpmc/pmu-events/arch/x86/broadwell/pipeline.json @@ -624,7 +624,7 @@ "CounterHTOff": "0,1,2,3,4,5,6,7", "EventCode": "0x87", "EventName": "ILD_STALL.LCP", - "PublicDescription": "This event counts stalls occured due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", + "PublicDescription": "This event counts stalls occurred due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", "SampleAfterValue": "2000003", "UMask": "0x1" }, @@ -1377,4 +1377,4 @@ "SampleAfterValue": "2000003", "UMask": "0x1" } -] \ No newline at end of file +] diff --git a/lib/libpmc/pmu-events/arch/x86/broadwellde/pipeline.json b/lib/libpmc/pmu-events/arch/x86/broadwellde/pipeline.json index 7580b8af0d13..1c93482e9205 100644 --- a/lib/libpmc/pmu-events/arch/x86/broadwellde/pipeline.json +++ b/lib/libpmc/pmu-events/arch/x86/broadwellde/pipeline.json @@ -624,7 +624,7 @@ "CounterHTOff": "0,1,2,3,4,5,6,7", "EventCode": "0x87", "EventName": "ILD_STALL.LCP", - "PublicDescription": "This event counts stalls occured due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", + "PublicDescription": "This event counts stalls occurred due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", "SampleAfterValue": "2000003", "UMask": "0x1" }, @@ -1378,4 +1378,4 @@ "SampleAfterValue": "2000003", "UMask": "0x1" } -] \ No newline at end of file +] diff --git a/lib/libpmc/pmu-events/arch/x86/broadwellx/pipeline.json b/lib/libpmc/pmu-events/arch/x86/broadwellx/pipeline.json index 18d21b94a4b9..6044773c1e9a 100644 --- a/lib/libpmc/pmu-events/arch/x86/broadwellx/pipeline.json +++ b/lib/libpmc/pmu-events/arch/x86/broadwellx/pipeline.json @@ -624,7 +624,7 @@ "CounterHTOff": "0,1,2,3,4,5,6,7", "EventCode": "0x87", "EventName": "ILD_STALL.LCP", - "PublicDescription": "This event counts stalls occured due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", + "PublicDescription": "This event counts stalls occurred due to changing prefix length (66, 67 or REX.W when they change the length of the decoded instruction). Occurrences counting is proportional to the number of prefixes in a 16B-line. This may result in the following penalties: three-cycle penalty for each LCP in a 16-byte chunk.", "SampleAfterValue": "2000003", "UMask": "0x1" }, @@ -1377,4 +1377,4 @@ "SampleAfterValue": "2000003", "UMask": "0x1" } -] \ No newline at end of file +] diff --git a/lib/libpmc/pmu-events/arch/x86/cascadelakex/uncore-other.json b/lib/libpmc/pmu-events/arch/x86/cascadelakex/uncore-other.json index aa460d0c4851..59ab88de1b37 100644 --- a/lib/libpmc/pmu-events/arch/x86/cascadelakex/uncore-other.json +++ b/lib/libpmc/pmu-events/arch/x86/cascadelakex/uncore-other.json @@ -1923,7 +1923,7 @@ "EventCode": "0x25", "EventName": "UNC_UPI_RxL0P_POWER_CYCLES", "PerPkg": "1", - "PublicDescription": "Counts cycles when the the receive side (Rx) of the Intel Ultra Path Interconnect(UPI) is in L0p power mode. L0p is a mode where we disable 60% of the UPI lanes, decreasing our bandwidth in order to save power.", + "PublicDescription": "Counts cycles when the receive side (Rx) of the Intel Ultra Path Interconnect(UPI) is in L0p power mode. L0p is a mode where we disable 60% of the UPI lanes, decreasing our bandwidth in order to save power.", "Unit": "UPI LL" }, { diff --git a/lib/libpmc/pmu-events/arch/x86/silvermont/pipeline.json b/lib/libpmc/pmu-events/arch/x86/silvermont/pipeline.json index 03a4c7f26698..5cc383f87448 100644 --- a/lib/libpmc/pmu-events/arch/x86/silvermont/pipeline.json +++ b/lib/libpmc/pmu-events/arch/x86/silvermont/pipeline.json @@ -257,7 +257,7 @@ "Counter": "0,1", "EventCode": "0xCA", "EventName": "NO_ALLOC_CYCLES.NOT_DELIVERED", - "PublicDescription": "The NO_ALLOC_CYCLES.NOT_DELIVERED event is used to measure front-end inefficiencies, i.e. when front-end of the machine is not delivering micro-ops to the back-end and the back-end is not stalled. This event can be used to identify if the machine is truly front-end bound. When this event occurs, it is an indication that the front-end of the machine is operating at less than its theoretical peak performance. Background: We can think of the processor pipeline as being divided into 2 broader parts: Front-end and Back-end. Front-end is responsible for fetching the instruction, decoding into micro-ops (uops) in machine understandable format and putting them into a micro-op queue to be consumed by back end. The back-end then takes these micro-ops, allocates the required resources. When all resources are ready, micro-ops are executed. If the back-end is not ready to accept micro-ops from the front-end, then we do not want to count these as front-end bottlen ecks. However, whenever we have bottlenecks in the back-end, we will have allocation unit stalls and eventually forcing the front-end to wait until the back-end is ready to receive more UOPS. This event counts the cycles only when back-end is requesting more uops and front-end is not able to provide them. Some examples of conditions that cause front-end efficiencies are: Icache misses, ITLB misses, and decoder restrictions that limit the the front-end bandwidth.", + "PublicDescription": "The NO_ALLOC_CYCLES.NOT_DELIVERED event is used to measure front-end inefficiencies, i.e. when front-end of the machine is not delivering micro-ops to the back-end and the back-end is not stalled. This event can be used to identify if the machine is truly front-end bound. When this event occurs, it is an indication that the front-end of the machine is operating at less than its theoretical peak performance. Background: We can think of the processor pipeline as being divided into 2 broader parts: Front-end and Back-end. Front-end is responsible for fetching the instruction, decoding into micro-ops (uops) in machine understandable format and putting them into a micro-op queue to be consumed by back end. The back-end then takes these micro-ops, allocates the required resources. When all resources are ready, micro-ops are executed. If the back-end is not ready to accept micro-ops from the front-end, then we do not want to count these as front-end bottlen ecks. However, whenever we have bottlenecks in the back-end, we will have allocation unit stalls and eventually forcing the front-end to wait until the back-end is ready to receive more UOPS. This event counts the cycles only when back-end is requesting more uops and front-end is not able to provide them. Some examples of conditions that cause front-end efficiencies are: Icache misses, ITLB misses, and decoder restrictions that limit the front-end bandwidth.", "SampleAfterValue": "200003", "UMask": "0x50" }, @@ -313,4 +313,4 @@ "SampleAfterValue": "2000003", "UMask": "0x1" } -] \ No newline at end of file +] diff --git a/lib/libpmc/pmu-events/arch/x86/skylakex/uncore-other.json b/lib/libpmc/pmu-events/arch/x86/skylakex/uncore-other.json index aa0f67613c4a..0c96e6924d62 100644 --- a/lib/libpmc/pmu-events/arch/x86/skylakex/uncore-other.json +++ b/lib/libpmc/pmu-events/arch/x86/skylakex/uncore-other.json @@ -1852,7 +1852,7 @@ "EventCode": "0x25", "EventName": "UNC_UPI_RxL0P_POWER_CYCLES", "PerPkg": "1", - "PublicDescription": "Counts cycles when the the receive side (Rx) of the Intel Ultra Path Interconnect(UPI) is in L0p power mode. L0p is a mode where we disable 60% of the UPI lanes, decreasing our bandwidth in order to save power.", + "PublicDescription": "Counts cycles when the receive side (Rx) of the Intel Ultra Path Interconnect(UPI) is in L0p power mode. L0p is a mode where we disable 60% of the UPI lanes, decreasing our bandwidth in order to save power.", "Unit": "UPI LL" }, {