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

--strict#: strict patching. Ignored if --patch is not present

--patch-rank <n>#: patch rank. Ignored if --patch is not present

--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