xref: /illumos-gate/usr/src/man/man1/volcheck.1 (revision bbf21555)
te
Copyright (c) 1997, 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]
VOLCHECK 1 "Feb 28, 2007"
NAME
volcheck - checks for media in a drive and by default checks all floppy media
SYNOPSIS

volcheck [-v] [-i secs] [-t secs] pathname
DESCRIPTION

The volcheck utility tells volume management to look at each dev/pathname in sequence and determine if new media has been inserted in the drive.

The default action is to volcheck all checkable media managed by volume management.

OPTIONS

The following options are supported: -i secs

Set the frequency of device checking to secs seconds. The default is 2 seconds. The minimum frequency is 1 second.

-t secs

Check the named device(s) for the next secs seconds. The maximum number of seconds allowed is 28800, which is 8 hours. The frequency of checking is specified by -i. There is no default total time.

-v

Verbose.

OPERANDS

The following operands are supported: pathname

The path name of a media device.

EXAMPLES

Example 1 A sample of the volcheck command.

The following example

 example% volcheck -v /dev/diskette
 /dev/diskette has media

asks volume management to examine the floppy drive for new media.

The following example

 example% volcheck -i 2 -t 600 /dev/diskette1 &

asks volume management if there is a floppy in the floppy drive every 2 seconds for 600 seconds (10 minutes).

FILES
/dev/volctl

volume management control port

SEE ALSO

eject (1), attributes (7), rmmount (8)

WARNINGS

Due to a hardware limitation in many floppy drives, the act of checking for media causes mechanical action in the floppy drive. Continuous polling of the floppy drive will cause the drive to wear out. It is recommended that polling the drive only be performed during periods of high use.