.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "KAS-MENU" "1" "Apr 10, 2024" "4.3.2" "kas"
.SH NAME
kas-menu \- kas menu plugin
.sp
This plugin implements the \fBkas menu\fP command.
.sp
When this command is executed, kas will open a configuration menu as
described by a Kconfig file. It processes any pre\-existing configuration
file with saved settings, stores the final selections and invokes the build
plugin if requested by the user.
.sp
To make use of this plugin, a \fBKconfig\fP file has to be provided. The
menu can define these types of configuration variables that the plugin
will translate into a kas configuration:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
kas configuration files that will be included when building the
generated configuration. Those are picked up from kconfig string
variables that have the name prefix \fBKAS_INCLUDE_\fP\&.
.IP \(bu 2
bitbake targets that shall be built via the generated configuration.
Those are picked up from kconfig string variables that have the name
prefix \fBKAS_TARGET_\fP\&.
.IP \(bu 2
The \fBbuild_system\fP that will used. The static kconfig string variable
\fBKAS_BUILD_SYSTEM\fP defines this value which must be \fBopenembedded\fP,
\fBoe\fP or \fBisar\fP is set.
.IP \(bu 2
bitbake configuration variables that will be added to the
\fBlocal_conf_header\fP section of the generated configuration. All other
active kconfig string, integer or hex variables are treated as such.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
See \fI\%https://www.kernel.org/doc/html/latest/kbuild/kconfig\-language.html\fP
for a complete documentation of the Kconfig language.
.sp
The menu plugin writes the selected configuration to a \fB\&.config.yaml\fP
file in the kas work directory and also reads previous selection from such
a file if it exists. The \fB\&.config.yaml\fP both contains the selected
configuration in the \fBmenu_configuration\fP key and also the effective
settings that can be used to invoke \fBkas build\fP or other kas commands.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
usage: kas menu [\-h] [kconfig]
.EE
.UNINDENT
.UNINDENT
.SH POSITIONAL ARGUMENTS
.INDENT 0.0
.TP
.B kconfig
Kconfig file
.sp
Default: \(dqKconfig\(dq
.UNINDENT
.SH KAS
.sp
Part of the \fBkas(1)\fP suite.
.SH AUTHOR
Daniel Wagner, Jan Kiszka, Claudius Heine
.SH COPYRIGHT
Siemens AG, 2017-2024
.\" Generated by docutils manpage writer.
.