.TH KCONF2 1 "2023" "Version 1.0" "KylinSoft Configuration Tool"

.SH NAME
kconf2 \- KylinSoft configuration management tool

.SH SYNOPSIS
.B kconf2
COMMAND [ARGS...]

.SH DESCRIPTION
.B kconf2
is a command-line tool for managing and manipulating configuration files. It allows users to view, modify, monitor, and reset schema-based configuration items.

.SH COMMANDS

.TP
.B help [COMMAND]
Show help information. If COMMAND is specified, show detailed help for that command.

.TP
.B list-keys SCHEMA[:VERSION]
List all keys in the specified schema.

.TP
.B list-children SCHEMA[:VERSION]
List all child objects in the specified schema.

.TP
.B list-recursively SCHEMA[:VERSION]
Recursively list keys and values. If no SCHEMA is given, list all keys.

.TP
.B range SCHEMA[:VERSION] KEY
Query the range of valid values for the key.

.TP
.B describe SCHEMA[:VERSION] KEY
Query the description of the key.

.TP
.B get SCHEMA[:VERSION] KEY
Get the value of the key.

.TP
.B set SCHEMA[:VERSION] KEY VALUE
Set the value of the key.

.TP
.B reset SCHEMA[:VERSION] KEY
Reset the key's value to its default.

.TP
.B writable SCHEMA[:VERSION] KEY
Check if the key is writable.

.TP
.B monitor SCHEMA[:VERSION] [KEY]
Watch for changes to the KEY. If no KEY is specified, all keys in the schema are monitored. Use ^C to stop monitoring.

.TP
.B reload
Reload configuration file, retain user configuration.

.TP
.B save PATH
Save user configuration in target folder.

.TP
.B list-schemas [APP] [VERSION]
List installed schemas. If APP and VERSION are specified, only list matching schemas.

.SH ARGUMENTS

.TP
.I SCHEMA
The name of the schema

.TP
.I VERSION
Specify the version of the schema

.TP
.I KEY
Key in the schema

.TP
.I VALUE
The value to set

.TP
.I PATH
The destination folder path

.TP
.I APP
The name of the application

.SH EXAMPLES

List all keys in a schema:
.RS
.nf
kconf2 list-keys org.example.app
.fi
.RE

Get a configuration value:
.RS
.nf
kconf2 get org.example.app:key1
.fi
.RE

Set a configuration value:
.RS
.nf
kconf2 set org.example.app:key1 newvalue
.fi
.RE

Monitor a specific key for changes:
.RS
.nf
kconf2 monitor org.example.app key1
.fi
.RE

Save user configuration:
.RS
.nf
kconf2 save /home/user/configs
.fi
.RE

.SH AUTHOR
KylinSoft Co., Ltd.

.SH COPYRIGHT
Copyright (C) 2023, KylinSoft Co., Ltd.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.