Utilities

All the utilities start with the letters kunf for easier identification. You should find them in /usr/bin.

kunfcat

kunfcat lists the entire configuration database to stdout. There are several formatting options: An optional filename lets the user choose a particular configuration file.

kunfenv

kunfenv can be used to place selected entries into the environment using shell constructs such as eval. This makes it possible for shell scripts to acquire configuration information. One or more arguments of the form section:subsection:...:name have to be supplied to extract an entry from the database. If a header is matched (argument of the form section:subsection:...:lastsection) instead of an entry then all entries in that section are printed (this is non-recursive, only that section will be printed, not subsections contained in it).

Several options let you control the format of the output (to make provisions for different shells/interpreters).

A -f filename option lets you specify a particular configuration file.

kunfedit

kunfedit can be used to modify configuration settings. This program only has one option - a -f filename option lets you specify a particular configuration file. Interactive usage of the editor should be straightforward - you navigate each level in the directory tree by using the UP and DOWN arrow keys. To select an entry or subsection you strike the ENTER key. To leave an entry or subsection strike the ESCAPE key. To write modifications to file use the w key.

kunfedit uses the kunf database to store its own colour scheme. You can change this scheme (in section administration:kunf:edit) and use CONTROL L to redraw the editor in the new colour scheme.


kunflint

kunflint checks configuration files for dubious constructs. It should be used when parts of the configuration database have been edited by hand.

By supplying one or more -v options you can increase the verbosity of the output. Conversely a -q suppresses most of the output. A -f filename option lets you specify a particular configuration file (by default the entire database is checked).


Next: The Structure and Syntax of kunf files