.TH switchconf 8 "April 2002" "Version 0.0.1"
.UC 8
.SH "NAME"
switchconf \- Change system configuration to one of many predefined
.SH SYNOPSIS
.sp
\fBswitchconf\fR [ \fI-list\fR | \fIconfig_scheme\fR ]
.SH "DESCRIPTION"
.PP
\fBswitchconf\fR is a command line tool that helps nomad laptop users
to easily change their configuration.
.SH "OPTIONS"
.PP
\fBswitchconf\fR takes only one argument. If this argument is
\fI-list\fR, a list of all known configuration schemes is returned
(found in $conf_top_dirs). If the argument is a configuration scheme,
this configuration will be installed on the laptop.
.SH "CONFIGURATION FILE"
.PP
The configuration file (\fI/etc/switchconf/conf\fR) is simple.
The following entries are defined:
.TP
\fIconf_top_dirs\fR
This specify where are located the configurations schemes.
.TP
\fIdest_dir\fR
This specify in which top directory you want to install the new
configuration. This option is pretty useful if you want to debug your
configuration without overwritting the actual one.
.TP
\fIexec_dir_before\fR, \fIexec_dir_after\fR
This specify the name of the exec directory : all files included will 
be executed before or after configuration changes
.TP
\fIrun_parts\fR
This specify the path to the run-parts command, that is used to
execute the scripts.  Leave it empty to use the internal
implementation of run-parts.
.TP
\fIconfig_method\fR 
This specify the method to use to copy the configuration files, to their 
places: softlink, hardlink, copy
.PP
\fI/etc/switchconf/conf\fR should be written so it is parsable as a
shell script - There should be no spaces between the variable name and
its value.
.SH "SCHEMES"
You should create a directory for each configuration scheme you
define, including all the files it should set in the system. Inside
/etc/switchconf the directories you should create the files including
the full path (i.e., \fI/etc/switchconf/home/etc/network/interfaces\fR
for \fI/etc/network/interfaces\fR).
.PP
No scheme should be named as either the exec_dir_before or the
exec_dir_after, unless the conf_top_dirs is moved out of its default
directory, \fI/etc/switchconf\fI.
.PP
Although it is not really necessary, you should probably ensure that
all the files existing in one of the schemes exist on every other
scheme, in order to ensure you do not end up in a hybrid state.
.SH "FILES"
.TP
\fB\fI/etc/switchconf/conf\fB\fR
Configuration file.
.TP
\fB\fI/var/lib/misc/switchconf.lastcfg\fB\fR
Memory file, has the name of the current active scheme
.SH "BUGS"
Actually no bugs are reported.
.SH "AUTHOR"
.PP
\fBswitchconf\fR was written by Sebastien J. Gross <seb@sjgross.org>
\fBswitchconf\fR was contributed by Julien Ducros <jul@chezwam.org>
\fBswitchconf\fR was maintained by Jose Calhariz <jose.calhariz@tagus.ist.utl.pt>