1 '\" te
   2 .\"  Copyright (c) 2000, 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 VOLRMMOUNT 1 "Feb 28, 2007"
   7 .SH NAME
   8 volrmmount \- call rmmount to mount or unmount media
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBvolrmmount\fR [\fB-i\fR | \fB-e\fR] [\fIname\fR | \fInickname\fR]
  13 .fi
  14 
  15 .LP
  16 .nf
  17 \fBvolrmmount\fR [\fB-d\fR]
  18 .fi
  19 
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 The \fBvolrmmount\fR utility calls \fBrmmount\fR(1M) to, in effect, simulate an
  24 insertion (\fB-i\fR) or an ejection (\fB-e\fR). Simulating an insertion often
  25 means that \fBrmmount\fR will mount the media. Conversely, simulating an
  26 ejection often means that \fBrmmount\fR will unmount the media. However, these
  27 actions can vary depending on the \fBrmmount\fR configuration and media type.
  28 .sp
  29 .LP
  30 For example, using default settings, if you insert a music CD, it might not be
  31 mounted. However, you can configure \fBrmmount\fR so that it calls
  32 \fBworkman\fR whenever a music CD is inserted.
  33 .sp
  34 .LP
  35 This command allows you to override volume management's usual handling of media
  36 (see EXAMPLES below).
  37 .SH OPTIONS
  38 .sp
  39 .LP
  40 The following options are supported:
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-i\fR\fR
  45 .ad
  46 .RS 6n
  47 Simulates an insertion of the specified media by calling \fBrmmount\fR.
  48 .RE
  49 
  50 .sp
  51 .ne 2
  52 .na
  53 \fB\fB-e\fR\fR
  54 .ad
  55 .RS 6n
  56 Simulates an ejection of the specified media by calling \fBrmmount\fR.
  57 .RE
  58 
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fB-d\fR\fR
  63 .ad
  64 .RS 6n
  65 Displays the name of the default device for \fBvolrmmount\fR to handle. This
  66 device is used if no \fIname\fR or \fInickname\fR is supplied.
  67 .RE
  68 
  69 .SH OPERANDS
  70 .sp
  71 .LP
  72 The following operands are supported:
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fIname\fR\fR
  77 .ad
  78 .RS 12n
  79 The name that volume management recognizes as the device's name.
  80 .RE
  81 
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fInickname\fR\fR
  86 .ad
  87 .RS 12n
  88 A shortened version of the device's name. Following is the list of recognized
  89 nicknames:
  90 .RE
  91 
  92 .sp
  93 
  94 .sp
  95 .TS
  96 box;
  97 c | c
  98 l | l .
  99 Nickname        Path
 100 _
 101 fd      /dev/rdiskette
 102 _
 103 fd0     /dev/rdiskette
 104 _
 105 fd1     /dev/rdiskette1
 106 _
 107 diskette        /dev/rdiskette
 108 _
 109 diskette0       /dev/rdiskette0
 110 _
 111 diskette1       /dev/rdiskette1
 112 _
 113 rdiskette       /dev/rdiskette
 114 _
 115 rdiskette0      /dev/rdiskette0
 116 _
 117 rdiskette1      /dev/rdiskette1
 118 _
 119 floppy  /dev/rdiskette
 120 _
 121 floppy0 /dev/rdiskette0
 122 _
 123 floppy1 /dev/rdiskette1
 124 _
 125 cdrom0  /dev/rdsk/cXtYdZ/\fIlabel\fR
 126 _
 127 zip0    /dev/rdsk/cXtYdZ/\fIlabel\fR
 128 _
 129 jaz0    /dev/rdsk/cXtYdZ/\fIlabel\fR
 130 _
 131 rmdisk0 /dev/rdsk/cXtYdZ/\fIlabel\fR
 132 .TE
 133 
 134 .SH EXAMPLES
 135 .LP
 136 \fBExample 1 \fRUsing the volrmmount command
 137 .sp
 138 .LP
 139 When volume management finds a floppy that contains a filesystem, it calls
 140 \fBrmmount\fR to mount it. If you wish to run \fBtar\fR(1) or \fBcpio\fR(1) on
 141 that floppy, it must first be unmounted. To unmount the floppy use:
 142 
 143 .sp
 144 .in +2
 145 .nf
 146 example% \fBvolrmmount \(mie floppy0\fR
 147 .fi
 148 .in -2
 149 .sp
 150 
 151 .sp
 152 .LP
 153 After \fBvolrmmount\fR unmounts the floppy, if you wish to re-mount it (rather
 154 than ejecting it and reinserting it) use:
 155 
 156 .sp
 157 .in +2
 158 .nf
 159 example% \fBvolrmmount \(mii floppy0\fR
 160 .fi
 161 .in -2
 162 .sp
 163 
 164 .sp
 165 .LP
 166 Notice that if you are using a named floppy, you can use its name in place of
 167 \fBfloppy0\fR.
 168 
 169 .SH FILES
 170 .sp
 171 .ne 2
 172 .na
 173 \fB\fB/dev/volctl\fR\fR
 174 .ad
 175 .RS 15n
 176 volume management control port
 177 .RE
 178 
 179 .SH SEE ALSO
 180 .sp
 181 .LP
 182 \fBcpio\fR(1), \fBeject\fR(1), \fBtar\fR(1), \fBrmmount\fR(1M),
 183 \fBattributes\fR(5)