Provided by: hotswap-text_0.4.0-11_i386 bug

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)