xref: /illumos-gate/usr/src/man/man1/volrmmount.1 (revision 2bbdd445a21f9d61f4a0ca0faf05d5ceb2bd91f3)
te
Copyright (c) 2000, 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]
VOLRMMOUNT 1 "Feb 28, 2007"
NAME
volrmmount - call rmmount to mount or unmount media
SYNOPSIS

volrmmount [-i | -e] [name | nickname]

volrmmount [-d]
DESCRIPTION

The volrmmount utility calls rmmount(1M) to, in effect, simulate an insertion (-i) or an ejection (-e). Simulating an insertion often means that rmmount will mount the media. Conversely, simulating an ejection often means that rmmount will unmount the media. However, these actions can vary depending on the rmmount configuration and media type.

For example, using default settings, if you insert a music CD, it might not be mounted. However, you can configure rmmount so that it calls workman whenever a music CD is inserted.

This command allows you to override volume management's usual handling of media (see EXAMPLES below).

OPTIONS

The following options are supported: -i

Simulates an insertion of the specified media by calling rmmount.

-e

Simulates an ejection of the specified media by calling rmmount.

-d

Displays the name of the default device for volrmmount to handle. This device is used if no name or nickname is supplied.

OPERANDS

The following operands are supported: name

The name that volume management recognizes as the device's name.

nickname

A shortened version of the device's name. Following is the list of recognized nicknames:

Nickname Path
fd /dev/rdiskette
fd0 /dev/rdiskette
fd1 /dev/rdiskette1
diskette /dev/rdiskette
diskette0 /dev/rdiskette0
diskette1 /dev/rdiskette1
rdiskette /dev/rdiskette
rdiskette0 /dev/rdiskette0
rdiskette1 /dev/rdiskette1
floppy /dev/rdiskette
floppy0 /dev/rdiskette0
floppy1 /dev/rdiskette1
cdrom0 /dev/rdsk/cXtYdZ/label
zip0 /dev/rdsk/cXtYdZ/label
jaz0 /dev/rdsk/cXtYdZ/label
rmdisk0 /dev/rdsk/cXtYdZ/label
EXAMPLES

Example 1 Using the volrmmount command

When volume management finds a floppy that contains a filesystem, it calls rmmount to mount it. If you wish to run tar(1) or cpio(1) on that floppy, it must first be unmounted. To unmount the floppy use:

example% volrmmount -e floppy0

After volrmmount unmounts the floppy, if you wish to re-mount it (rather than ejecting it and reinserting it) use:

example% volrmmount -i floppy0

Notice that if you are using a named floppy, you can use its name in place of floppy0.

FILES
/dev/volctl

volume management control port

SEE ALSO

cpio(1), eject(1), tar(1), rmmount(1M), attributes(5)