vold.conf(4)

NAME

vold.conf − Volume Management configuration file

SYNOPSIS

/etc/vold.conf

DESCRIPTION

The vold.conf file contains the Volume Management configuration information 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 files systems that are unsafe to eject without unmounting.

Modify vold.conf to specify which program should be called first when media events happen (actions) or when you need to add another device to your system. See the example section for more information on adding devices.

If you modify vold.conf, you must tell vold to reread vold.conf by sending an HUP signal. Use

# ps -ef | grep vold

# kill -HUP vold_pid

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.

Here are the explanations of the syntax for the Devices to use field.

device The type of removable media device to be used. Legal values are cdrom and floppy.

type The specific capabilities of the device. Legal value is drive.

special Pathname of the device 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.

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.

program The full path name of an executable program to be run when regex is match.

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 dos label_dos.so floppy
label cdrom label_cdrom.so cdrom
label sun label_sun.so floppy
# Devices to use
use cdrom drive /dev/dsk/c0t6 dev_cdrom.so cdrom0
use floppy drive /dev/diskette dev_floppy.so floppy0
# Actions
insert /vol∗/dev/fd[0-9]/∗ user=root /usr/sbin/rmmount
insert /vol∗/dev/dsk/∗ user=root /usr/sbin/rmmount
eject /vol∗/dev/fd[0-9]/∗ user=root /usr/sbin/rmmount
eject /vol∗/dev/dsk/∗ user=root /usr/sbin/rmmount
notify /vol∗/rdsk/∗ group=tty /usr/lib/vold/volmissing -c
# List of file system types unsafe to eject
unsafe ufs hsfs pcfs

EXAMPLES

To add a secondary CD-ROM drive to the vold.conf file, copy the existing Devices to use CD-ROM line and modify it to reflect the new drive and its target number special and the mount point for files systems found on media in the new drive symname:

use cdrom drive /dev/dsk/c0t6 dev_cdrom.so cdrom0
use cdrom drive /dev/dsk/c0t5 dev_cdrom.so cdrom1

Museum