Skip to content

Commit 85c1f39

Browse files
authored
Update linaro-uenv.md (#104)
1 parent 685a045 commit 85c1f39

File tree

1 file changed

+20
-27
lines changed

1 file changed

+20
-27
lines changed

docs/software/devtools/linaro-uenv.md

Lines changed: 20 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,10 @@ The Linaro [uenv][ref-uenv] is named `linaro-forge`, and the available versions
2121
```console
2222
$ uenv image find linaro-forge
2323
uenv arch system id size(MB) date
24-
linaro-forge/24.1.1:v1 gh200 daint e0e79f5c3e6a8ee0 365 2025-02-12
24+
linaro-forge/24.1.2:v1 gh200 daint b9c8487cf183a16a 365 2025-04-15
2525

26-
$ uenv image pull linaro-forge/24.1.1:v1
27-
pulling e0e79f5c3e6a8ee0 100.00% --- 365/365 (0.00 MB/s)
26+
$ uenv image pull linaro-forge/24.1.2:v1
27+
pulling b9c8487cf183a16a 100.00% --- 365/365 (0.00 MB/s)
2828
```
2929

3030
This uenv is configured to be mounted in the `/user-tools` path so that they can be used alongside application and development uenv mounted at `/user-environment`.
@@ -33,33 +33,26 @@ When using alongside another uenv, start a uenv session with both uenv.
3333
In the following example, the `prgenv-gnu` and `linaro-forge` uenv will be mounted at `/user-environment` and `/user-tools` respectively:
3434

3535
```console
36-
$ uenv start prgenv-gnu/24.11,linaro-forge/24.1.1 \
37-
--view=prgenv-gnu:default,forge
36+
$ uenv start prgenv-gnu/24.11:v2,linaro-forge/24.1.2:v1 \
37+
--view=prgenv-gnu:default # (1)!
38+
$ source /user-tools/activate
3839

39-
$ uenv status # (1)!
40+
$ uenv status # (2)!
4041

41-
$ ddt --version # (2)!
42+
$ ddt --version # (3)!
4243
Linaro DDT Part of Linaro Forge.
43-
Copyright (c) 2023-2024 Linaro Limited. All rights reserved.
44-
Version: 24.1.1
44+
Copyright (c) 2023-2025 Linaro Limited. All rights reserved.
45+
Version: 24.1.2
4546
```
4647

47-
1. Test that everything has been mounted correctly by looking at `uenv status`.
48+
1. Loading the `activate` script instead of loading a view for the linaro-forge uenv allows to keep using the compilers from the prgenv-gnu uenv.
49+
2. Test that everything has been mounted correctly by looking at `uenv status`.
4850
There will be warnings if there are problems.
49-
2. Check that the [DDT debugger][ref-devtools-ddt] is in the path.
51+
3. Check that the [DDT debugger][ref-devtools-ddt] is in the path.
5052

5153
!!! note
5254
The `linaro-forge` uenv is always mounted at the `/user-tools` mount point, and a script `/user-tools/activate` is provided to load both ddt and map into your environment, without needing to use a view.
5355

54-
```console
55-
$ uenv start linaro-forge/14.1.1
56-
$ source /user-tools/activate
57-
$ ddt --version
58-
Linaro DDT Part of Linaro Forge.
59-
Copyright (c) 2023-2024 Linaro Limited. All rights reserved.
60-
Version: 24.1.1
61-
```
62-
6356
### Install and configure the Linaro client on your local machine
6457

6558
We recommend installing the [Linaro desktop client] on your local workstation or laptop.
@@ -73,7 +66,7 @@ It can be downloaded for a selection of operating systems.
7366
Mismatches between the client and the uenv version will lead to the following error when trying to establish a remote connection:
7467

7568
```
76-
The local version of Linaro DDT (24.0.6) is not compatible with the remote version (24.1.1).
69+
The local version of Linaro DDT (24.0.6) is not compatible with the remote version (24.1.2).
7770
```
7871

7972
The client can be configured to connect with the debug jobs running on [Alps][ref-alps], offering a better user experience compared to running with X11 forwarding.
@@ -88,7 +81,7 @@ First, start the client on your laptop:
8881
The path will change if you have installed a different version, or if it has been installed in a non-standard installation location.
8982

9083
```bash
91-
$HOME/linaro/forge/24.1.1/bin/ddt
84+
$HOME/linaro/forge/24.1.2/bin/ddt
9285
```
9386

9487
=== "macOS"
@@ -99,7 +92,7 @@ First, start the client on your laptop:
9992
Please use the appropriate path and version for your installation.
10093

10194
```bash
102-
open /Applications/Linaro\ Forge\ Client\ 24.1.1.app/
95+
open /Applications/Linaro\ Forge\ Client\ 24.1.2.app/
10396
```
10497

10598
Next, configure a connection to the target system.
@@ -117,7 +110,7 @@ Examples of the settings are below.
117110
| ----------- | --------------------------------------- |
118111
| Connection | `daint` |
119112
120-
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
113+
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
121114
| Private Key | `~/.ssh/cscs-key` |
122115

123116
=== "Santis"
@@ -132,7 +125,7 @@ Examples of the settings are below.
132125
| ----------- | --------------------------------------- |
133126
| Connection | `santis` |
134127
135-
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
128+
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
136129
| Private Key | `~/.ssh/cscs-key` |
137130

138131
=== "Clariden"
@@ -147,7 +140,7 @@ Examples of the settings are below.
147140
| ----------- | --------------------------------------- |
148141
| Connection | `clariden` |
149142
150-
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
143+
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
151144
| Private Key | `~/.ssh/cscs-key` |
152145

153146
=== "Eiger"
@@ -162,7 +155,7 @@ Examples of the settings are below.
162155
| ----------- | --------------------------------------- |
163156
| Connection | `eiger` |
164157
165-
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
158+
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
166159
| Private Key | `~/.ssh/cscs-key` |
167160

168161
!!! tip

0 commit comments

Comments
 (0)