Provided by: ifscheme_1.7-3ubuntu1_all bug

NAME

       ifscheme - scheme control for network interfaces

SYNOPSIS

       ifscheme [-v] [[-s] newscheme]

       mapping <interface> script ifscheme-mapping

DESCRIPTION

       ifscheme allows you to change network configuraton schemes or query the
       current  scheme.  It  integrates   with   the   ifup(8)   command   and
       interfaces(5).   For example, you might use this program to configure a
       "home" scheme and a "work" scheme for a network  device  on  a  laptop.
       When  you  move between home and work, a simple command can reconfigure
       your networking.

       If you run the program with  no  parameters,  it  will  tell  what  the
       current network scheme is.

       The  ifscheme-mapping  utility  is  used  to  tell  the ifup and ifdown
       utilities about the current scheme.

OPTIONS

       -v

       --verbose
              Run in verbose mode. This is passed in to the  ifup  and  ifdown
              programs as well.

       -l

       --list list all schemes available/defined in /etc/network/interfaces.

       newscheme

       -s newscheme

       --scheme newscheme
              Change  to  a new network configuration scheme.  When the scheme
              is changed, network interfaces that were using  the  old  scheme
              will  be  taken  down  and  brought  back  up  to  use  the  new
              configuration scheme. -s or --scheme are mandatory if  newscheme
              begins with a -.

CONFIGURATION

       To  make  the program do anything useful when a scheme is selected, you
       must edit /etc/network/interfaces to add a mapping  for  the  interface
       (or  interfaces)  that can be controlled on a per-scheme basis. Suppose
       you want to control eth0 in this way. You might have an  existing  eth0
       configuraton in there, such as:

         auto eth0

         iface eth0 inet static
            address 192.168.1.5
            netmask 255.255.255.0
            gateway 192.168.1.1

       To  change  this  so  you  can  chose  between static routing and dhcp,
       replace it with the following (it helps to ifdown the interface first).

         auto eth0

         mapping eth0
            script ifscheme-mapping

         iface eth0-home inet static
            address 192.168.1.5
            netmask 255.255.255.0
            gateway 192.168.1.1

         iface eth0-work inet dhcp

       Now if you run "ifscheme home" and ifup the interface, you'll  get  the
       eth0-home  configuration stanza. If you run "ifscheme work", it will be
       changed to the eth0-work stanza. You  can  add  additional  stanzas  as
       desired,   but   the  label  must  always  be  of  the  form  <hardware
       interface>-<scheme name>.

       If you have a second interface (perhaps  a  wireless  network  card  on
       eth1),  you  can  duplicate  the above for that interface, changing the
       eth0 and the configuration details as appropriate, but remember to  add
       an iface stanza for every scheme name for the second interface.

FILES

       /etc/network/interfaces
              the interfaces definition file

       /etc/network/run/scheme
              the current scheme

       /etc/network/run/ifstate
              a record of the current state of the interfaces, managed by ifup
              and ifdown

BUGS

       All schemed interfaces will have the same scheme.

       Any schemed interface which does not have  an  entry  for  the  current
       scheme  and  is  not  configured when the scheme is changed will not be
       successfully configured when it is brought up.

SEE ALSO

       interfaces(5) ifup(8) ifdown(8)

DISTRIBUTION

       Redistribution is subject to the GNU public license.

AUTHORS

       Joey Hess <joey@kitenet.net>, Peter Wilson <pwilson@cs.hmc.edu>

                                                                   IFSCHEME(8)