rez-env¶
Usage¶
rez env [-h] [--shell {bash,csh,pwsh,sh,tcsh,zsh}] [--rcfile RCFILE]
[--norc] [-c COMMAND] [-s] [--ni] [--nl] [-b] [--paths PATHS]
[-t TIME] [--max-fails N] [--time-limit SECS] [-o FILE]
[-i FILE] [--exclude RULE [RULE ...]]
[--include RULE [RULE ...]] [--no-filters] [-p] [--strict]
[--patch-rank N] [--no-cache] [-q] [--fail-graph]
[--new-session] [--detached] [--no-passive] [--stats]
[--no-pkg-cache] [-v]
[PKG ...]
description¶
Open a rez-configured shell, possibly interactive.
Options¶
- --shell¶
target shell type (default: “bash”)
Choices: bash, csh, pwsh, sh, tcsh, zsh
- --rcfile¶
source this file instead of the target shell’s standard startup scripts, if possible
- --norc¶
skip loading of startup scripts
- -c, --command¶
execute command within rez environment and exit, instead of starting an interactive shell. Alternatively, list command after a ‘--’. The command and arguments passed to ‘-c’ must be passed in as a single shell argument, whereas the command and arguments after ‘--’ may be passed in as several shell arguments.
- -s, --stdin¶
read commands from standard input
- --ni, --no-implicit¶
don’t add implicit packages to the request
- --nl, --no-local¶
don’t load local packages
- -b, --build¶
create a build environment
- --paths¶
set package search path (use ‘:’ separator)
- -t, --time¶
ignore packages released after the given time. Supported formats are: epoch time (eg 1393014494), or relative time (eg -10s, -5m, -0.5h, -10d)
- --max-fails <n>¶
abort if the number of failed configuration attempts exceeds N
- --time-limit <secs>¶
abort if the resolve time exceeds SECS
- -o, --output <file>¶
store the context into an rxt file, instead of starting an interactive shell. Note that this will also store a failed resolve. If you use the special value ‘-’, the context is written to stdout.
- -i, --input <file>¶
use a previously saved context. Resolve settings, such as PKG,
--ni
etc are ignored in this case
- --exclude <rule>¶
add package exclusion filters, eg ‘*.beta’. Note that these are added to the globally configured exclusions
- --include <rule>¶
add package inclusion filters, eg ‘mypkg’, ‘boost-*’. Note that these are added to the globally configured inclusions
- --no-filters¶
turn off package filters. Note that any filters specified with
--exclude
/--include
are still applied
- -p, --patch¶
patch the current context to create a new context
- --no-cache¶
do not fetch cached resolves
- -q, --quiet¶
run in quiet mode (hides welcome message)
- --fail-graph¶
if the build environment fails to resolve due to a conflict, display the resolve graph as an image.
- --new-session¶
start the shell in a new process group
- --detached¶
open a separate terminal
- --no-passive¶
only print actions that affect the solve (has an effect only when verbosity is enabled)
- --stats¶
print advanced solver stats
- --no-pkg-cache¶
Disable package caching
- -v, --verbose¶
verbose mode, repeat for more verbosity