IVMCONFIGBASE.XML(5)						File Formats Manual					      IVMCONFIGBASE.XML(5)

NAME

       IvmConfigBase.xml - options affecting the running of ivman(8)

DESCRIPTION

       IvmConfigBase.xml contains a few options which affect the behaviour of ivman(8).

       IvmConfigBase.xml is parsed as an XML file during Ivman's initialisation.  The general form of the file is:

	<?xml version="1.0" encoding="UTF-8"?>
	<ivm:BaseConfig version="0.2" xmlns:ivm="http://www.eikke.com/ivm">

	   <ivm:Option name="optionname1" value="optionvalue1" />
	   <ivm:Option name="optionname2" value="optionvalue2" />
	   ...

	</ivm:BaseConfig>

       An Option element can have any of the following names:

	    fork   Whether  or not Ivman should daemonize itself (run in the background).  Must be "true" or "false".  In general, for an instance
		   of Ivman running as root, you want this to be true, but for an instance of Ivman running as non-root, you want this to be false
		   so the program will close when the user's session ends.

	    debug  Whether or not Ivman should output extra debug information.	Must be "true" or "false".  If Ivman is running in the background,
		   debug messages will go to the system log; otherwise, messages will go to stdout(3).

	    sleep  By default, a system-wide instance of Ivman will wait a short while before mounting any device.  This is to	give  a  user-mode
		   instance  of Ivman, or another volume manager, a change to mount the volume first, since the system-wide instance of Ivman gen-
		   erally has more restrictive permissions set on its mounted volumes.	If you want  to  disable  this	behaviour,  set  sleep	to
		   "false".

	    user   User  account  under  which	Ivman should run.  It is suggested that you create an unprivileged user named 'ivman', and add any
		   commands which need root privileges to ivman's entry in /etc/sudoers .  Note that Ivman should still be started  as	root  when
		   this option is used; it will automatically drop privileges after initialising.

	    group  Group under which Ivman should run.	This should be whatever group is required on your system in order to use the 'pmount' com-
		   mand.  Also, if you have a system-wide and not a per-user instance of Ivman running when a mountable device	is  inserted,  the
		   device  will  be mounted writeable by users of this group.  Note that Ivman should still be started as root when this option is
		   used; it will automatically drop privileges after initialising.

	    mountcommand
		   Command to execute to mount devices.  It is recommended you leave this blank, in which case Ivman will automatically detect the
		   best  method  of  mounting.	Specifically, Ivman tries to use (in the following order): pmount-hal(1), pmount(1), mount(8).	If
		   you specify this option, you must also specify umountcommand.

	    umountcommand
		   Command to execute to unmount devices. It is recommended you leave this blank.  If you specify this option, you must also spec-
		   ify mountcommand.

	    umask  If  neither	of  mountcommand  or  umountcommand  are specified, and Ivman is running as a system-wide instance, and pmount was
		   detected, then volumes will be mounted using this umask.  When not using pmount, umask should be set in fstab(5), or set in HAL
		   policy files if fstab-sync is being used.  If ommitted, defaults to 022 (rwxr-xr-x).

       mountcommand  and  umountcommand  support (and, in most cases, will require) substitution of HAL device properties. This is accomplished by
       surrounding the property name with $ symbols. For instance, to use the traditional mount(8) utility for mounting, you would  set  mountcom-
       mand to "mount the characters ' and " are replaced with ?, so you can surround the substitution with quotes without fear.

       Remember  that  this  is  an XML file, which means that characters which have a special meaning in XML (entities) need to be escaped.  Some
       characters which are popular in shell scripting (&, <, >) are among these special characters.  As a quick reference, & becomes  &amp;  ,  <
       becomes &lt; , > becomes &gt; , ' becomes &apos; and " becomes &quot; .

SEE ALSO

       ivman(8), IvmConfigActions.xml(5), IvmConfigConditions.xml(5) IvmConfigProperties.xml(5)

								  6 November 2005					      IVMCONFIGBASE.XML(5)