-
Simon McVittie authored
This avoids the man pages misrendering on Gitlab when a definition list item has more than one paragraph. Signed-off-by:
Simon McVittie <smcv@collabora.com>
Simon McVittie authoredThis avoids the man pages misrendering on Gitlab when a definition list item has more than one paragraph. Signed-off-by:
Simon McVittie <smcv@collabora.com>
title: pressure-vessel-unruntime
section: 1
NAME
pressure-vessel-unruntime - run Steam games in a bubblewrap container
SYNOPSIS
pressure-vessel-unruntime [OPTIONS] [--] COMMAND [ARGUMENTS...]
DESCRIPTION
pressure-vessel-unruntime escapes from the Steam Runtime to run pressure-vessel-wrap with its own bundled libraries.
OPTIONS
All options are passed directly to pressure-vessel-wrap(1). One option is special:
-
--batch
-
If present, the test-UI will not be run.
ENVIRONMENT
-
LD_LIBRARY_PATH
-
Unset, and passed to pressure-vessel-wrap via the
--env-if-host
option so that it will be reinstated if the game is run with the host/usr
. -
LD_PRELOAD
-
Unset, and passed to pressure-vessel-wrap via the
--env-if-host
option so that it will be reinstated if the game is run with the host/usr
. Individual items are also passed to pressure-vessel-wrap via the --host-ld-preload option, so thatLD_PRELOAD
modules can be made available read-only in the container. -
PATH
-
Reset to a sensible default, and passed to pressure-vessel-wrap via the
--env-if-host
option so that it will be reinstated if the game is run with the host/usr
. -
PRESSURE_VESSEL_BATCH
-
If set to 1, it is equivalent to
--batch
. -
STEAM_RUNTIME
-
Unset.
-
SYSTEM_LD_LIBRARY_PATH
-
Used to reset
LD_LIBRARY_PATH
to the value it had on entry to Steam. -
SYSTEM_PATH
-
Used to reset
PATH
to the value it had on entry to Steam.
SIGNALS
The pressure-vessel-unruntime process replaces itself with pressure-vessel-wrap, so signal handling is the same as for pressure-vessel-wrap.
EXIT STATUS
The same as pressure-vessel-wrap, or nonzero for an internal error in pressure-vessel-unruntime.
EXAMPLE
$ steam steam://install/1070560 # Steam Linux Runtime 1.0 (scout)
$ steam steam://install/302380 # Floating Point, a small free game
$ rm -fr ~/tmp/scout
$ mkdir -p ~/tmp/scout
$ tar \
-C ~/tmp/scout \
-xzvf ~/.steam/steamapps/common/SteamLinuxRuntime/com.valvesoftware.SteamRuntime.Platform-amd64,i386-scout-runtime.tar.gz
In Steam, disable all Steam compatibility tools for Floating Point, and set its launch options to:
/path/to/pressure-vessel/bin/pressure-vessel-unruntime \
--runtime ~/tmp/scout/files \
--shell=instead \
-- \
%command%