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:
- -i: Indented formatting - entries are indented in accordance with their depth.
- -l: Line formatting - each line contains section, name and value.
This format could make automated processing easier.
- -p: Plain formatting - each section and name is joined with an underscore and only values are escaped. This vaguely resembles the format of kunfenv.
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).
- -b: Formats output using a Bourne Shell syntax (also usable by
bash, zsh and ash and pdksh). This is the default format.
- -B: Formats output using a Bourne Shell syntax for placing into
the environment (instead of keeping it local to the shell).
- -c: Formats output using a C Shell syntax (also usable by
tcsh).
- -C: Formats output using a C Shell syntax for placing into
the environment (instead of keeping it local to the shell).
- -P: Formats output using a PERL syntax.
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