Skip to content

Commit 5249fb5

Browse files
committed
Update WindowsPerf install guide for version 4.0.0
1 parent d117234 commit 5249fb5

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

content/install-guides/wperf.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ additional_search_terms:
1818
minutes_to_complete: 15
1919

2020
### Link to official documentation
21-
official_docs: https://github.com/arm-developer-tools/windowsperf/blob/main/INSTALL.md
21+
official_docs: https://gitlab.com/Linaro/WindowsPerf/windowsperf/blob/main/INSTALL.md
2222

2323
author: Jason Andrews
2424

@@ -30,7 +30,7 @@ multitool_install_part: false # Set to true if a sub-page of a multi-page arti
3030
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
3131
---
3232

33-
WindowsPerf is a Linux Perf-inspired Windows on Arm performance profiling tool. Profiling is based on the Arm AArch64 PMU and its hardware counters. WindowsPerf supports the counting model for obtaining aggregate counts of occurrences of PMU events, and the sampling model for determining the frequencies of event occurrences produced by program locations at the function, basic block, and instruction levels. WindowsPerf is an open-source project hosted on [GitHub](https://github.com/arm-developer-tools/windowsperf).
33+
WindowsPerf is a Linux Perf-inspired Windows on Arm performance profiling tool. Profiling is based on the Arm AArch64 PMU and its hardware counters. WindowsPerf supports the counting model for obtaining aggregate counts of occurrences of PMU events, and the sampling model for determining the frequencies of event occurrences produced by program locations at the function, basic block, and instruction levels. WindowsPerf is an open-source project hosted on [GitLab](https://gitlab.com/Linaro/WindowsPerf/windowsperf/)
3434

3535
WindowsPerf consists of a kernel-mode driver and a user-space command-line tool. You can seamlessly integrate the WindowsPerf command line tool with both the [WindowsPerf Visual Studio Extension](#vs2022) and the [WindowsPerf VS Code Extension](#vscode). These extensions, which you can download from the Visual Studio Marketplace, enhance the functionality of WindowsPerf by providing a user-friendly interface, and additional features for performance analysis and debugging. This integration allows developers to efficiently analyze and optimize their applications directly within their preferred development environment.
3636

@@ -49,30 +49,30 @@ See also the [Visual Studio for Windows on Arm install guide](/install-guides/vs
4949

5050
## Download WindowsPerf
5151

52-
You can download the latest release package, `windowsperf-bin-<version>.zip` from the Arm GitHub repository:
52+
You can download the latest release package, `windowsperf-bin-<version>.zip` from the Linaro GitLab repository:
5353
```url
54-
https://github.com/arm-developer-tools/windowsperf/releases
54+
https://gitlab.com/Linaro/WindowsPerf/windowsperf/-/releases
5555
```
5656

5757
To download directly from command prompt, use:
5858

5959
```console
60-
mkdir windowsperf-bin-3.8.0
61-
cd windowsperf-bin-3.8.0
62-
curl -L -O https://github.com/arm-developer-tools/windowsperf/releases/download/3.8.0/windowsperf-bin-3.8.0.zip
60+
mkdir windowsperf-bin-4.0.0
61+
cd windowsperf-bin-4.0.0
62+
curl -L -O https://gitlab.com/api/v4/projects/40381146/packages/generic/windowsperf/4.0.0/windowsperf-bin-4.0.0.zip
6363
```
6464

6565
Unzip the package:
6666

6767
```console
68-
tar -xmf windowsperf-bin-3.8.0.zip
68+
tar -xmf windowsperf-bin-4.0.0.zip
6969
```
7070

7171
## Install wperf driver
7272

7373
You can install the kernel driver using the supplied `wperf-devgen` installer.
7474

75-
The [wperf-devgen](https://github.com/arm-developer-tools/windowsperf/blob/main/wperf-devgen/README.md) tool has been designated as the preferred installer and uninstaller for the WindowsPerf Kernel Driver in the latest release. This tool offers a simple process for managing the installation and removal of the driver.
75+
The [wperf-devgen](https://gitlab.com/Linaro/WindowsPerf/windowsperf/-/tree/main/wperf-devgen/README.md) tool has been designated as the preferred installer and uninstaller for the WindowsPerf Kernel Driver in the latest release. This tool offers a simple process for managing the installation and removal of the driver.
7676

7777
{{% notice Note%}}
7878
You must install the driver as `Administrator`.
@@ -83,7 +83,7 @@ Open a **Windows Command Prompt** terminal with **Run as administrator** selecte
8383
Make sure you are in the `windowsperf-bin-<version>` directory:
8484

8585
```command
86-
cd windowsperf-bin-3.8.0
86+
cd windowsperf-bin-4.0.0
8787
```
8888

8989
### Install with wperf-devgen {#devgen_install}
@@ -123,8 +123,8 @@ You see output similar to:
123123
```output
124124
Component Version GitVer FeatureString
125125
========= ======= ====== =============
126-
wperf 3.8.0 6d15ddfc +etw-app
127-
wperf-driver 3.8.0 6d15ddfc +etw-drv
126+
wperf 4.0.0 6d15ddfc +etw-app
127+
wperf-driver 4.0.0 6d15ddfc +etw-drv
128128
129129
```
130130
## Uninstall wperf driver
@@ -138,7 +138,7 @@ You must uninstall the driver as `Administrator`.
138138
### Uninstall with wperf-devgen {#devgen_uninstall}
139139

140140
```command
141-
cd windowsperf-bin-3.8.0\wperf-driver
141+
cd windowsperf-bin-4.0.0\wperf-driver
142142
wperf-devgen uninstall
143143
```
144144

@@ -162,7 +162,7 @@ Install by opening **Extensions** menu, click **Manage Extensions**, and click *
162162
In order to set the path to the `wperf.exe` executable, go to **Tools** -> **Options** -> **WindowsPerf** -> **WindowsPerf Path** and set the absolute path to the wperf.exe executable and then click on the **Validate** button.
163163
{{% /notice %}}
164164

165-
Also, visit WindowsPerf GUI project website on [GitHub](https://github.com/arm-developer-tools/windowsperf-vs-extension) for more details and latest updates.
165+
Also, visit WindowsPerf GUI project website on [GitLab](https://gitlab.com/Linaro/WindowsPerf/vs-extension) for more details and latest updates.
166166

167167
## Install WindowsPerf VS Code Extension (optional) {#vscode}
168168

@@ -180,7 +180,7 @@ If using a non-Windows on Arm host, you can import and analyze `WindowsPerf` JSO
180180
You do not need to install `wperf` on non-Windows on Arm devices.
181181
{{% /notice %}}
182182

183-
## Further reading
183+
## Read related resources
184184

185185
### WindowsPerf
186186

0 commit comments

Comments
 (0)