DOKK / manpages / debian 13 / kas / kas-shell.1.en
KAS-SHELL(1) kas KAS-SHELL(1)

kas-shell - kas shell plugin

kas shell [-h] [--skip STEP] [--force-checkout] [--update] [-E] [-k]


          [-c COMMAND]


          [config]


Run a shell in the build environment.

This plugin implements the kas shell command.

When this command is executed, kas will checkout repositories, setup the build environment and then start a shell in the build environment. This can be used to manually run bitbake with custom command line options or to execute other commands such as runqemu.

For example, to start a shell in the build environment for the file kas-project.yml you could run:

kas shell kas-project.yml


Or to invoke qemu to test an image which has been built:

kas shell kas-project.yml -c 'runqemu'


Positional Arguments

Config file(s), separated by colon. Using .config.yaml in KAS_WORK_DIR if none is specified.

Named Arguments

Skip build steps. To skip more than one step, use this argument multiple times.

Possible choices: setup_dir, setup_home, init_setup_repos, repo_setup_loop, finish_setup_repos, repos_checkout, repos_check_signatures, repos_apply_patches, setup_environ, write_bbconfig

Always checkout the desired commit/branch/tag of each repository, discarding any local changes
Pull new upstream changes to the desired branch even if it is already checked out locally
Keep current user environment block
Skip steps that change the configuration
Run command

Part of the kas(1) suite.

Daniel Wagner, Jan Kiszka, Claudius Heine

Siemens and contributors, 2017-2025

June 17, 2025 4.8.1