vold(1M) System Administration Commands vold(1M)
NAME
vold - Volume Management daemon to manage removable media devices
SYNOPSIS
/usr/sbin/vold [-n] [-t] [-v] [-f config-file] [-l log-file] [-d root-dir] [-L debug-level]
DESCRIPTION
The Volume Management daemon, vold, creates and maintains a file system image rooted at root-dir that contains symbolic names for removable
media devices. These devices include CD-ROMs, floppies, DVDs, and USB 1394 devices. The default root-dir is set to /vol if no directory is
specified by the -d option.
vold reads the /etc/vold.conf configuration file upon startup. If the configuration file is modified later, vold must be told to reread the
/etc/vold.conf file. Do this by entering:
example# kill -HUP vold_pid
To tell vold to clean up and exit, the SIGTERM signal is used:
example# kill -TERM vold_pid
where vold_pid is the process ID of vold.
A disk storage device can not be removed or inserted while vold is active. To remove or insert a removeable mass storage device such as a
USB memory stick, first stop the daemon by issuing the command /etc/init.d/volmgt stop. After the device has been removed or inserted,
restart the daemon by issuing the command /etc/init.d/volmgt start.
OPTIONS
The following options are supported:
-n Never writeback. Volume Management updates media labels with unique information if labels are not unique. This flag keeps
Volume Management from changing your media. The default setting is FALSE.
-t Dump NFS trace information to the log file. The default setting is FALSE.
-v Provide lots of status information to the log file. The default setting is FALSE (do not provide status info to log file).
-d root-dir Specify an alternate root directory. The default location is /vol. Setting this will also cause other Volume Management
utilities to use this as the default root directory.
-fconfig-file Specify an alternate configuration file. The default file is /etc/vold.conf.
-llog-file Specify an alternate log file. The default log file is /var/adm/vold.log.
-Ldebug-level Change the level (verbosity) of debug messages sent to the log file. The range is 0 to 99 where 0 is nothing and 99 is
everything. The default level is 0.
ENVIRONMENT VARIABLES
vold sets the following environment variables to aid programs which are called when events such as insert, notify, and eject occur:
VOLUME_ACTION Event that caused this program to be executed.
VOLUME_PATH Pathname of the matched regex from the vold.conf file.
VOLUME_DEVICE Device (in /vol/dev) that applies to the media.
VOLUME_NAME Name of the volume in question.
VOLUME_USER User ID of the user causing the event to occur.
VOLUME_SYMNAME Symbolic name of a device containing the volume.
VOLUME_MEDIATYPE Name of the type of media (CD-ROM, floppy or rmdisk)
FILES
/etc/vold.conf Volume Management daemon configuration file. Directs the Volume Management daemon to control certain devices, and
causes events to occur when specific criteria are met.
/usr/lib/vold/*.so.1 Shared objects called by Volume Management daemon when certain actions occur.
/var/adm/vold.log the default log file location (see the -l option for a description).
/vol the default Volume Management root directory.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWvolu |
+-----------------------------+-----------------------------+
SEE ALSO
volcancel(1), volcheck(1), volmissing(1), rmmount(1M), rpc.smserverd(1M), rmmount.conf(4), vold.conf(4), attributes(5), volfs(7FS)
System Administration Guide: Basic Administration
SunOS 5.10 13 Sept 2004 vold(1M)