Skip to content
Snippets Groups Projects
Commit 5ea3206a authored by Simon McVittie's avatar Simon McVittie
Browse files

Update documentation to reflect removal of Steam Runtime 1½ 'heavy'

parent b9823992
No related branches found
No related tags found
No related merge requests found
......@@ -78,8 +78,8 @@ This uses **$SHELL** if available in the container, falling back to
that is running inside a Steam Linux Runtime container, so that
the *COMMAND* is run outside the container in approximately the
same execution environment as the script that launches the Steam client.
The Steam Runtime 1 'scout' and Steam Runtime 1½ 'heavy' library
stacks that are used to run major components of the Steam client will
The Steam Runtime 1 'scout' library stack that is
used to run major components of the Steam client will
usually **not** be present in the **LD_LIBRARY_PATH** for commands
run like this.
......
......@@ -26,16 +26,10 @@ Steam games:
- The [traditional Steam Runtime][ldlp],
implemented in terms of `LD_LIBRARY_PATH`.
Instances of this can be found in
`~/.steam/root/ubuntu12_32/steam-runtime` and
`~/.steam/root/ubuntu12_64/steam-runtime-heavy` in a working Steam
installation.
In a working Steam installation,
`~/.steam/root/ubuntu12_32/steam-runtime` provides
[Steam Runtime 1 'scout'][scout],
based on Ubuntu 12.04.
`~/.steam/root/ubuntu12_64/steam-runtime-heavy` provides
[Steam Runtime 1½ 'heavy'][heavy],
based on Debian 8.
based on Ubuntu 12.04, as a `LD_LIBRARY_PATH` runtime.
- The [container runtime framework][container runtime],
implemented in terms of containers launched by the pressure-vessel tool.
......@@ -317,7 +311,7 @@ single `ld.so.cache`.
The operating system should not edit the Steam Runtime in-place or
attempt to disable it.
For the `LD_LIBRARY_PATH`-based 'scout' and 'heavy' runtimes, the
For the `LD_LIBRARY_PATH`-based 'scout' runtime, the
operating system may provide shared libraries that are newer than
the corresponding libraries in the Steam Runtime, backwards-compatible
with the Steam Runtime libraries, and have the same `DT_SONAME` ELF header.
......@@ -467,7 +461,7 @@ On entry to Steam code, the following environment variables should
* `STEAM_RUNTIME` *(debug) (internal)*
* `STEAM_RUNTIME_SCOUT` *(debug)*
* `STEAM_RUNTIME_HEAVY` *(debug)*
* `STEAM_RUNTIME_HEAVY` *(debug) (obsolete)*
* `STEAM_RUNTIME_DEBUG` *(debug)*
* `STEAM_RUNTIME_DEBUG_DIR` *(debug)*
* `STEAM_RUNTIME_LIBRARY_PATH` *(internal)*
......@@ -666,7 +660,6 @@ container runtime on a new distribution, in particular:
[bubblewrap]: https://github.com/containers/bubblewrap
[container runtime]: container-runtime.md
[eudev]: https://github.com/eudev-project/eudev
[heavy]: https://gitlab.steamos.cloud/steamrt/steamrt/-/blob/steamrt/heavy/README.md
[ldlp]: ld-library-path-runtime.md
[libcapsule]: https://gitlab.collabora.com/vivek/libcapsule
[libudev0-shim]: https://github.com/archlinux/libudev0-shim
......
......@@ -101,15 +101,10 @@ recorded at FOSDEM 2020: [Containers and Steam][].
## The `heavy` runtime
The `steamwebhelper` component that is used for the Steam user interface
requires newer libraries than the ones available in `scout`.
To avoid destabilizing `scout`, it has its own set of libraries,
Historically, the `steamwebhelper` component that is used for the Steam
user interface used a newer `LD_LIBRARY_PATH` runtime,
referred to as Steam Runtime 1½ `heavy`.
This behaves in the same way as the `scout` runtime, but it contains
fewer libraries (only the ones that are needed for the `steamwebhelper`),
and it is newer than `scout` (it's based on Debian 8 instead of
Ubuntu 12.04).
It is now obsolete and is no longer included in Steam.
Documentation in the `steamrt` "metapackage" provides
[more information about heavy][heavy].
......
......@@ -59,7 +59,3 @@ in scout, which are pretty old.
The scout build environment has backports of Python 3.5 and Meson, so we
can rely on those at build-time.
If we gain a dependency on glibc 2.19 or other newer libraries, we'll have
to increase the build environment to SteamRT 1½ 'heavy', and backport
Python 3.5 and Meson to 'heavy'.
......@@ -15,7 +15,7 @@ How this fits into the overall Steam Runtime project
<https://repo.steampowered.com/steamrt-images-scout/snapshots/latest-container-runtime-depot/sources/>.
This is not part of this git repository.
2. For `scout` and `heavy` only: Put together the .deb packages into the
2. For `scout` only: Put together the .deb packages into the
`LD_LIBRARY_PATH`-based Steam Runtime.
This git repository is not relevant for this step.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment