focal (8) switchconf.8.gz

Provided by: switchconf_0.0.16-1_all bug

NAME

       switchconf - Change system configuration to one of many predefined

SYNOPSIS

       switchconf [ -f conf_file ] -help | -list | config_scheme

DESCRIPTION

       switchconf is a command line tool that helps nomad laptop users to easily change their configuration.

OPTIONS

       switchconf  takes only one mandatory argument. If this argument is -help, the command synopsis is output.
       If it is -list, a list of all known configuration schemes is returned  for  the  current  set  (found  in
       $conf_top_dirs).  If  the argument is a configuration scheme, this configuration will be installed on the
       laptop.

       switchconf can take an optional argument, which must be first, flagged by -f.   This  argument  specifies
       the  set  of  configuration  schemes  to work with.  It names a configuration file, with format described
       below, located on the  current  directory.   If  no  optional  argument  is  present,  the  default  file
       /etc/switchconf/conf is used.

CONFIGURATION FILE

       The configuration file (default /etc/switchconf/conf) is simple.  The following entries are defined:

       conf_top_dirs
              This specify where are located the configurations schemes.

       dest_dir
              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.

       exec_dir_before, exec_dir_after
              This specify the name of the exec directory : all files included will be executed before or  after
              configuration changes

       run_parts
              This  specifies  the path to the run-parts command which is used to execute the scripts.  Leave it
              empty to use the internal implementation of run-parts.

       config_method
              This specify the method to use to  copy  the  configuration  files,  to  their  places:  softlink,
              hardlink, copy

       /etc/switchconf/conf  should  be  written so it is parsable as a shell script - There should be no spaces
       between the variable name and its value.

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., /etc/switchconf/home/etc/network/interfaces for /etc/network/interfaces).

       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, /etc/switchconf.

       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.

FILES

       /etc/switchconf/conf
              Configuration file.

       /var/lib/misc/switchconf.lastcfg
              Memory file, has the name of the current active scheme

       /var/lock/switchconf
              Lock file.

BUGS

       Actually no bugs are reported.

AUTHOR

       switchconf was written by Sebastien J. Gross  <seb@sjgross.org>  switchconf  was  contributed  by  Julien
       Ducros <jul@chezwam.org> switchconf was maintained by Jose Calhariz <jose.calhariz@tagus.ist.utl.pt>