.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.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 "kw-kernel-config-manager - Kernel config file manager" "" "" ""
.SH Name
kw-kernel-config-manager - Kernel config file manager \- 
.SH SYNOPSIS
.nf
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [(\-s | \-\-save) <name> [(\-d | \-\-description) <description>] [\-f | \-\-force]]
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [\-l | \-\-list]
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [\-\-fetch [(\-o | \-\-output) <filename>] [\-f | \-\-force] [\-\-optimize] [\-\-remote [<remote>:<port>]]]:
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [\-\-get <name> [\-f | \-\-force]]
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [(\-r | \-\-remove) <name> [\-f | \-\-force]]
\fIkw\fP (\fIk\fP | \fIkernel\-config\-manager\fP) [\-\-verbose]]
.fi
.sp
.SH DESCRIPTION
.sp
The \fBkernel\-config\-manager\fP command manages different versions of the project\(aqs \fB\&.config\fP
file. It provides the save, load, remove, and list operations of such files. By
default, if the user does not provide any parameter, the kernel\-config\-manager will list all
configs under \fBkw\fP\(aqs management.
.sp
\fBNote:\fP
.INDENT 0.0
.INDENT 3.5
This feature has interoperability with the kw env feature.
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-save <name> [\-d <description>] [\-f | \-\-force]:
The save option creates a snapshot of the \fB\&.config\fP file in the current
folder in \fBkw\fP\(aqs management system under the specified \fI<name>\fP\&.
Additionally, users can add a description by using the \fB\-d\fP flag. Finally,
if the user tries to add another config with a name that\(aqs already being
managed, \fBkw\fP will issue a warning; \fB\-f\fP will suppress such a warning.
.TP
.B \-l, \-\-list:
Lists all the \fB\&.config\fP file versions available. This is also the default
behavior when no option is specified.
.TP
.B \-\-get <name> [\-f | \-\-force]:
Get a copy of the config file with the provided \fI<name>\fP in the current
directory. As this operation overwrites the current \fB\&.config\fP file a
warning is shown; \fB\-f\fP will suppress such a warning and carry on any
destructive operations.
.TP
.B \-r <name> [\-f | \-\-force], \-\-remove <name> [\-f | \-\-force]:
Remove config labeled with \fI<name>\fP from \fBkw\fP\(aqs management system. As this
operation removes a \fB\&.config\fP file from kw management a warning is shown;
\fB\-f\fP will suppress such a warning and carry on any destructive operations.
.TP
.B \-\-fetch [(\-o | \-\-output) <filename>] [\-f | \-\-force] [\-\-optimize] [\-\-remote [<remote>:<port>]]:
Fetches a \fB\&.config\fP file from a target machine to your current directory.
If another config is found in this directory, then \fBkw\fP will ask you
whether you want to replace it or not; \fB\-f\fP will suppress such a warning
and carry on any destructive operations. \fB\-\-output\fP allows you to specify
the config file name, and \fB\-\-optimize\fP will run \fImake localmodconfig\fP in
order to generate a config that\(aqs optimized for the target machine.
.TP
.B \-\-verbose:
Verbose mode is an option that causes the kw program to display debug messages to track
its progress. This functionality is very useful during the debugging process, allowing
you to identify possible errors more easily.
.UNINDENT
.SH EXAMPLES
.sp
For these examples, we assume that the relevant fields in your configuration
files (located by default in \fB\&.kw/\fP) have already been setup. We recommend
the use of \fBkw config\fP for managing your local and global configurations.
.sp
In case you want \fBkw\fP to save your current \fB\&.config\fP file, you can use:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cd <kernel\-path>
kw k \-\-save my_current_config
.EE
.UNINDENT
.UNINDENT
.sp
You can see the config\(aqs file maintained by \fBkw\fP with:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw k \-\-list
.EE
.UNINDENT
.UNINDENT
.sp
If you want to fetch a config from a remote machine (available at
\fBlocalhost:2222\fP) as root, you can run:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw kernel\-config\-manager \-\-fetch \-\-remote root@localhost:2222
.EE
.UNINDENT
.UNINDENT
.\" End of generated man page.