man IvmConfigBase.xml (Formats) - options affecting the running of ivman(8)
NAME
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 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.
- 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 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 " .