NAME

       hotswaprc - configuration file for  hotswap

DESCRIPTION

       /etc/hotswaprc is the global configuration file for the hotswap utility.

       It  allows  system  administrators  to  specify  arbitrary shell scripts to be run after a
       device is inserted, as well as before and  after  it  is  removed.  Scripts  are  selected
       according  to  the  model name retrieved from the device. This is particularly helpful for
       automatic configuration of CD-RW drives, which require SCSI emulation  and  bypass  normal
       access via the IDE subsystem.

       hotswaprc  is  implemented  as  an  Extensible  Mark-up  Language  (XML) application.  XML
       documents are structured using elements of  the  form  <tag-name>  content  <tag-name>.  A
       Document Type Definition (DTD) describes the possible content of each element.

       Please  refer to the XML specification for more information. The hotswap distribution also
       contains  an  example  file,  doc/hotswaprc.example,  which  includes  the  DTD  for   the
       configuration file format.

ELEMENTS

       <hotswap>
              This is the root element of the document. Each valid hotswaprc must contain exactly
              one <hotswap> element. The <hotswap> element may contain  an  arbitrary  number  of
              <device> elements.

       <device>
              The  configuration  file  contains  one <device> element for every device for which
              scripts are defined. The <device> element is composed of the following elements  in
              this  order: <name>, <post-insert>, <pre-remove>, <post-remove>. All but <name> are
              optional.

       <name> The content of this element is the model identification string of  the  IDE  device
              the current <device> element refers to.

       <post-insert>
              Contains the shell script that is to be executed after the device has been inserted
              and registered with the kernel.

       <pre-remove>
              Contains the shell script that is to be run before hotswap attempts  to  unregister
              the device.

       <post-remove>
              Contains the shell script that is to be run after the device had been unregistered.

REPORT BUGS

       Report bugs to t.stadelmann1@physics.ox.ac.uk.

AUTHOR

       Written by Tim Stadelmann.

SEE ALSO

       hotswap(1), xhotswap(1).

COPYRIGHT

       Copyright (c) 2002-2003 Tim Stadelmann.

       Permission  is  granted to copy, distribute and/or modify this document under the terms of
       the GNU General Public License (GPL), Version 2 or any later version published by the Free
       Software Foundation.

                                        26th November 2002                           HOTSWAPRC(5)