summaryrefslogtreecommitdiff
path: root/man/bst-shell.1
blob: 7c53ff1dc10558635298c85fa1c3cafed64c9c20 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.TH "BST SHELL" "1" "10-Sep-2017" "" "bst shell Manual"
.SH NAME
bst\-shell \- Shell into an element's sandbox environment
.SH SYNOPSIS
.B bst shell
[OPTIONS] TARGET [COMMAND]...
.SH DESCRIPTION
Run a command in the target element's sandbox environment

This will first 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 with `sh -i`.
.SH OPTIONS
.TP
\fB\-b,\fP \-\-build
Create a build sandbox
.TP
\fB\-s,\fP \-\-sysroot DIRECTORY
An existing sysroot
.TP
\fB\-\-variant\fP TEXT
A variant of the specified target