share/man/man8/rmvolmgr.8

   1 '\" te
   2 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH RMVOLMGR 8 "Nov 28, 2006"
   7 .SH NAME
   8 rmvolmgr \- HAL-aware removable volume manager
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/rmvolmgr\fR [\fB-chns\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBrmvolmgr\fR command is a volume manager that can automatically mount and
  19 unmount removable media and hot-pluggable storage. The default mount point is
  20 \fB/media\fR.
  21 .sp
  22 .LP
  23 \fBrmvolmgr\fR is one of a number of Hardware Abstraction Layer (HAL)-aware
  24 tools that are shipped with the Solaris operating system. See \fBhald\fR(8).
  25 .sp
  26 .LP
  27 Multiple instances of \fBrmvolmgr\fR can be run simultaneously. A system
  28 instance of \fBrmvolmgr\fR runs by default as a service management facility
  29 (SMF) service (see \fBsmf\fR(5)). Its fault management resource identifier
  30 (FMRI) is:
  31 .sp
  32 .in +2
  33 .nf
  34 svc:/system/filesystem/rmvolmgr
  35 .fi
  36 .in -2
  37 .sp
  38
  39 .sp
  40 .LP
  41 You can run your own instance of \fBrmvolmgr\fR by adding it to the
  42 \fB\&.xinitrc\fR file or a similar session startup script. In such a case, the
  43 \fBsystem\fR \fBrmvolmgr\fR instance will not manage volumes that belong to
  44 you, the owner of the startup script. For example, a user logged on to the
  45 workstation console (\fB/dev/console\fR) who invokes his own instance of
  46 \fBrmvolmgr\fR will own locally connected devices, such as CD-ROM drives and
  47 devices connected to the local USB or FireWire ports.
  48 .sp
  49 .LP
  50 In addition to mounting volumes under \fB/media\fR, \fBrmvolmgr\fR also creates
  51 legacy symbolic links under \fB/cdrom\fR, \fB/floppy\fR, and \fB/rmdisk\fR.
  52 .sp
  53 .LP
  54 \fBrmvolmgr\fR also provides backwards compatibility with CDE removable media
  55 interfaces by maintaining notification files under \fB/tmp/.removable\fR. This
  56 functionality can be disabled by using the \fB-c\fR option.
  57 .sp
  58 .LP
  59 The \fB-c\fR and \fB-n\fR options can also be specified as SMF properties. See
  60 "Examples."
  61 .SH OPTIONS
  62 .sp
  63 .LP
  64 The following options are supported:
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fB-c\fR\fR
  69 .ad
  70 .RS 6n
  71 Disable CDE compatibility.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-h\fR\fR
  78 .ad
  79 .RS 6n
  80 Display help information and exit.
  81 .RE
  82
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fB-n\fR\fR
  87 .ad
  88 .RS 6n
  89 Do not create legacy mountpoint symbolic links.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fB-s\fR\fR
  96 .ad
  97 .RS 6n
  98 Invoke in system instance mode.
  99 .RE
 100
 101 .SH EXAMPLES
 102 .LP
 103 \fBExample 1 \fRUsing SMF Properties to Set Options
 104 .sp
 105 .LP
 106 The following \fBsvccfg\fR(8) command and subcommands use SMF properties to
 107 set the \fB-c\fR and \fB-n\fR options.
 108
 109 .sp
 110 .in +2
 111 .nf
 112 example# \fBsvccfg\fR
 113 svc:> \fBselect rmvolmgr\fR
 114 svc:/system/filesystem/rmvolmgr> \fBlistprop rmvolmgr/*\fR
 115 rmvolmgr/legacy_mountpoints     boolean  true
 116 rmvolmgr/cde_compatible         boolean  true
 117 svc:/system/filesystem/rmvolmgr> \fBsetprop \e
 118   rmvolmgr/legacy_mountpoints=false\fR
 119 svc:/system/filesystem/rmvolmgr> \fBsetprop rmvolmgr/cde_compatible=false\fR
 120 svc:/system/filesystem/rmvolmgr> \fBexit\fR
 121 example#
 122 .fi
 123 .in -2
 124 .sp
 125
 126 .SH ATTRIBUTES
 127 .sp
 128 .LP
 129 See \fBattributes\fR(5) for descriptions of the following attributes:
 130 .sp
 131
 132 .sp
 133 .TS
 134 box;
 135 c | c
 136 l | l .
 137 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 138 _
 139 Interface Stability     Volatile
 140 .TE
 141
 142 .SH SEE ALSO
 143 .sp
 144 .LP
 145 \fBhald\fR(8), \fBsvccfg\fR(8), \fBattributes\fR(5), \fBhal\fR(5),
 146 \fBsmf\fR(5)