IvmConfigBase.xml - options affecting the running of ivman(8)
IvmConfigBase.xml contains a few options which affect the behaviour of
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" />
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 generally 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’ command. 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.
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.
Command to execute to unmount devices. It is recommended
you leave this blank. If you specify this option, you must
also specify 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 mountcommand
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 & , <
becomes < , > becomes > , ’ becomes ' and " becomes " .
ivman(8), IvmConfigActions.xml(5), IvmConfigConditions.xml(5)
6 November 2005