JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
man pages section 1M: System Administration Commands     Oracle Solaris 10 8/11 Information Library
search filter icon
search icon

Document Information

Preface

Introduction

System Administration Commands - Part 1

System Administration Commands - Part 2

System Administration Commands - Part 3

th_define(1M)

th_manage(1M)

tic(1M)

tnamed(1M)

tnchkdb(1M)

tnctl(1M)

tnd(1M)

tninfo(1M)

traceroute(1M)

trapstat(1M)

TSIgfxp_config(1M)

ttyadm(1M)

ttymon(1M)

tunefs(1M)

turnacct(1M)

txzonemgr(1M)

tzreload(1M)

tzselect(1M)

uadmin(1M)

ucodeadm(1M)

ufsdump(1M)

ufsrestore(1M)

umount(1M)

umountall(1M)

unlink(1M)

unshare(1M)

unshareall(1M)

unshare_nfs(1M)

update_drv(1M)

updatehome(1M)

updatemanager(1M)

updatemedia(1M)

useradd(1M)

userdel(1M)

usermod(1M)

utmp2wtmp(1M)

utmpd(1M)

uucheck(1M)

uucico(1M)

uucleanup(1M)

uucpd(1M)

uusched(1M)

Uutry(1M)

uutry(1M)

uuxqt(1M)

virtinfo(1M)

vmstat(1M)

vntsd(1M)

volcopy(1M)

volcopy_ufs(1M)

vold(1M)

wall(1M)

wanboot_keygen(1M)

wanboot_keymgmt(1M)

wanboot_p12split(1M)

wanbootutil(1M)

wbemadmin(1M)

wbemconfig(1M)

wbemlogviewer(1M)

wcadmin(1M)

whodo(1M)

wracct(1M)

wrsmconf(1M)

wrsmstat(1M)

wtmpfix(1M)

xntpd(1M)

xntpdc(1M)

ypbind(1M)

ypinit(1M)

ypmake(1M)

ypmap2src(1M)

yppasswdd(1M)

yppoll(1M)

yppush(1M)

ypserv(1M)

ypset(1M)

ypstart(1M)

ypstop(1M)

ypupdated(1M)

ypxfr(1M)

ypxfr_1perday(1M)

ypxfr_1perhour(1M)

ypxfr_2perday(1M)

ypxfrd(1M)

zdb(1M)

zdump(1M)

zfs(1M)

zic(1M)

zoneadm(1M)

zoneadmd(1M)

zonecfg(1M)

zpool(1M)

zuludaemon(1M)

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-R, CD-RW, floppies, DVD, and USB and 1394 mass storage 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. Accomplish this rereading by entering:

example# svcadm refresh volfs

To tell vold to clean up and exit, enter:

example# svcadm disable volfs

To reenable:

example# svcadm enable volfs

To specify options (see OPTIONS):

example# svccfg
svc:> select volfs
svc:/system/filesystem/volfs> listprop vold/*
vold/config_file            astring
vold/log_debuglevel         count    0
vold/log_file               astring
vold/log_nfs_trace          boolean  false
vold/log_verbose            boolean  false
vold/never_writeback_label  boolean  false
vold/root_dir               astring
svc:/system/filesystem/volfs> setprop vold/never_writeback_label=true
svc:/system/filesystem/volfs> exit

# svcadm disable volfs
# svcadm enable volfs

vold is hotplug-aware for USB and 1394 mass storage devices, thus there is no need for stopping and restarting vold. It is recommended to eject(1) the “media” before hot-removing a device. The eject command unmounts any filesystems mounted from the media, making it safe to remove the device. (Note that all USB and 1394 devices, regardless of whether they contain removable media, are treated like removable media devices).

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.

-f config-file

Specify an alternate configuration file. The default file is /etc/vold.conf.

-l log-file

Specify an alternate log file. The default log file is /var/adm/vold.log.

-L debug-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, SUNWvolr

See Also

volcancel(1), volcheck(1), volmissing(1), rmmount(1M), rpc.smserverd(1M), rmmount.conf(4), vold.conf(4), attributes(5), smf(5), volfs(7FS), usb(7D), scsa1394(7D)

System Administration Guide: Basic Administration

Notes

The Volume Management daemon and associated commands might not be included in a future Solaris release.