BST SHELL(1)

NAME
bst-shell - Shell into an element's sandbox environment

SYNOPSIS
bst shell [OPTIONS] ELEMENT [COMMAND]...

DESCRIPTION
Run a command in the target element's sandbox environment

This will stage a temporary sysroot for running the target element, assuming it has already been built and all required artifacts are in the local cache.

Use the --build option to create a temporary sysroot for building the element instead.

Use the --sysroot option with an existing failed build directory or with a checkout of the given target, in order to use a specific sysroot.

If no COMMAND is specified, the default is to attempt to run an interactive shell.

OPTIONS

-b, --build
    Stage dependencies and sources to build

-s, --sysroot DIRECTORY
    An existing sysroot

--mount HOSTPATH PATH
    Mount a file or directory into the sandbox

--isolate
    Create an isolated build sandbox