xref: /illumos-gate/usr/src/man/man8/rmvolmgr.8 (revision cbc1ee82)
te
Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
RMVOLMGR 8 "August 13, 2023"
NAME
rmvolmgr - HAL-aware removable volume manager
SYNOPSIS
/usr/lib/rmvolmgr [-chns]
DESCRIPTION
The rmvolmgr command is a volume manager that can automatically mount and unmount removable media and hot-pluggable storage. The default mount point is /media.

rmvolmgr is one of a number of Hardware Abstraction Layer (HAL)-aware tools that are shipped with the Solaris operating system. See hald(8).

Multiple instances of rmvolmgr can be run simultaneously. A system instance of rmvolmgr runs by default as a service management facility (SMF) service (see smf(7)). Its fault management resource identifier (FMRI) is:

svc:/system/filesystem/rmvolmgr

You can run your own instance of rmvolmgr by adding it to the .xinitrc file or a similar session startup script. In such a case, the system rmvolmgr instance will not manage volumes that belong to you, the owner of the startup script. For example, a user logged on to the workstation console (/dev/console) who invokes his own instance of rmvolmgr will own locally connected devices, such as CD-ROM drives and devices connected to the local USB or FireWire ports.

In addition to mounting volumes under /media, rmvolmgr also creates legacy symbolic links under /cdrom, /floppy, and /rmdisk.

rmvolmgr also provides backwards compatibility with CDE removable media interfaces by maintaining notification files under /tmp/.removable. This functionality can be disabled by using the -c option.

The -c and -n options can also be specified as SMF properties. See "Examples."

OPTIONS
The following options are supported: -c

Disable CDE compatibility.

-h

Display help information and exit.

-n

Do not create legacy mountpoint symbolic links.

-s

Invoke in system instance mode.

EXAMPLES
Example 1 Using SMF Properties to Set Options

The following svccfg(8) command and subcommands use SMF properties to set the -c and -n options.

example# svccfg
svc:> select rmvolmgr
svc:/system/filesystem/rmvolmgr> listprop rmvolmgr/*
rmvolmgr/legacy_mountpoints boolean true
rmvolmgr/cde_compatible boolean true
svc:/system/filesystem/rmvolmgr> setprop \e
 rmvolmgr/legacy_mountpoints=false
svc:/system/filesystem/rmvolmgr> setprop rmvolmgr/cde_compatible=false
svc:/system/filesystem/rmvolmgr> exit
example#
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Volatile
SEE ALSO
attributes (7), hal (7), smf (7), hald (8), svccfg (8)