vold.conf(4) File Formats vold.conf(4)NAMEvold.conf - volume management configuration file
SYNOPSIS
/etc/vold.conf
DESCRIPTION
The vold.conf file contains the removable media configuration informa‐
tion used by vold(1M). This information includes the database to use,
labels that are supported, devices to use, actions to take when certain
media events occur, and the list of file systems that are unsafe to
eject without unmounting.
Modify vold.conf to specify which program should be called when media
events (actions) occur or when you need to add another device to your
system. See EXAMPLES for more information on adding devices.
If you modify vold.conf, you must tell vold to reread vold.conf by
sending a HUP signal. Use the following command:
# kill -HUP `pgrep vold`
File Format
The syntax for the vold.conf file is shown here.
# Database to use
db database
# Labels supported
label label_type shared_object device
# Devices to use
use device type special shared_object symname [ options ]
# Actions
insert regex [ options ] program program args
eject regex [ options ] program program args
notify regex [ options ] program program args
# List of file system types unsafe to eject
unsafe fs_type fs_type
Of these syntax fields, you can safely modify Devices to use and
Actions. Do not modify the db line.
Devices to Use Field
All use device statements must be grouped together by device type. (For
example, all use cdrom statements must be grouped together and all use
floppy statements must be grouped together.) The explanations of the
syntax for the Devices to use field are as follows:
device The type of removable media device to be used.
Legal values are cdrom, floppy, pcmem and
rmdisk.
type The specific capabilities of the device. Legal
value is drive.
special This sh(1) expression specifies the device or
devices to be used. Path usually begins with
/dev.
shared_object The name of the program that manages this
device. vold(1M) expects to find this program
in /usr/lib/vold.
symname The symbolic name that refers to this device.
The symname is placed in the device directory.
options The user, group, and mode permissions for the
media inserted (optional).
The special and symname parameters are related. If special contains any
shell wildcard characters (that is, has one or more asterisks or ques‐
tion marks in it), then the syname must end with"%d". In this case, the
devices that are found to match the regular expression are sorted, then
numbered. The first device will have a zero filled in for the "%d", the
second device found will have a one, and so on.
If the special specification does not have any shell wildcard charac‐
ters then the symname parameter must explicitly specify a number at its
end (see EXAMPLES below).
Actions Field
Here are the explanations of the syntax for the Actions field.
insert|eject|notify The media event prompting the event.
regex This sh(1) regular expression is matched
against each entry in the /vol file system that
is being affected by this event.
options You can specify what user or group name that
this event is to run as (optional).
program The full path name of an executable program to
be run when regex is matched.
program args Arguments to the program.
Default Values
The default vold.conf file is shown here.
# Volume Daemon Configuration file
#
# Database to use (must be first)
db db_mem.so
# Labels supported
label cdrom label_cdrom.so cdrom
label dos label_dos.so floppy rmdisk pcmem
label sun label_sun.so floppy rmdisk pcmem
# Devices to use
use cdrom drive /dev/rdsk/c*s2 dev_cdrom.so cdrom%d
use floppy drive /dev/rdiskette[0-9] dev_floppy.so floppy%d
use pcmem drive /dev/rdsk/c*s2 dev_pcmem.so pcmem%d forceload=true
use rmdisk drive /dev/rdsk/c*s2 dev_rmdisk.so rmdisk%d
# Actions
eject dev/diskette[0-9]/* user=root /usr/sbin/rmmount
eject dev/dsk/* user=root /usr/sbin/rmmount
insert dev/diskette[0-9]/* user=root /usr/sbin/rmmount
insert dev/dsk/* user=root /usr/sbin/rmmount
notify rdsk/* group=tty user=root /usr/lib/vold/volmissing -p
remount dev/diskette[0-9]/* user=root /usr/sbin/rmmount
remount dev/dsk/* user=root /usr/sbin/rmmount
# List of file system types unsafe to eject
unsafe ufs hsfs pcfs udfs
EXAMPLES
Example 1: A sample vold.conf file.
To add a CD-ROM drive to the vold.conf file that does not match the
default regular expression (/dev/rdsk/c*s2), you must explicitly list
its device path and what symbolic name (with %d) you want the device
path to have. For example, to add a CD-ROM drive that has the path
/dev/rdsk/my/cdroms? (where s? are the different slices), add the fol‐
lowing line to vold.conf (all on one line):
use cdrom drive /dev/rdsk/my/cdroms2 dev_cdrom.so cdrom%d
Then, when media is inserted in this CD-ROM drive, vold assigns it the
next symbolic name. For example, if two CD-ROMs match the default regu‐
lar expression, they would be named cdrom0 and cdrom1. And, any that
match the added regular expression would be named starting with cdrom2.
For a diskette that does not match the vold.conf default regular
expression (vol/dev/aliases/floppy[0-9]), a similar line would have to
be added. For example, to add a diskette whose path was /dev/my/fd0,
you would add the following to vold.conf:
use floppy drive /dev/my/fd0 dev_floppy.so floppy%d
SEE ALSOsh(1), volcancel(1), volcheck(1), volmissing(1), rmmount(1M),
rpc.smserverd(1M), vold(1M), rmmount.conf(4), volfs(7FS)NOTES
vold manages both the block and character device for removable media.
However, to make the configuration file easier to set up and scan, only
one of these devices needs to be specified. If you follow the conven‐
tions specified below, vold figures out both device names if only one
of them is specified. For example, if you specify the block device, it
figures out the pathname to the character device; if you specify the
pathname to the character device, it figures out the block device.
CD-ROM Naming Conventions
The CD-ROM pathname must have a directory component of rdsk (for the
character device) and dsk for the block device. For example, if you
specify the character device using the line:
use cdrom drive /dev/rdsk/my/cdroms2 dev_cdrom.so cdrom%d
then it is assumed that the block device is at
/dev/dsk/my/cdroms2
Diskette Naming Conventions
For diskettes, vold requires that the device pathnames end in either
rfd[0-9] or rdiskette[0-9] for the character device, and fd[0-9] or
diskette[0-9] for the block device. As with the CD-ROM, it generates
either the block name given the character name, or the character name
given the block name.
SunOS 5.10 21 Jun 2002 vold.conf(4)
