gnome-volcheck(1) User Commands gnome-volcheck(1)
NAME
gnome-volcheck - monitors removable media
SYNOPSIS
gnome-volcheck [-i time] [-z time] [-m media-types]
DESCRIPTION
The gnome-volcheck daemon monitors removable media for GNOME. gnome-volcheck is launched as a child process of gnome-session.
gnome-volcheck performs the following functions:
o Removes any existing notification pipe used by gnome-volcheck to communicate with Action File Manager, as configured by
rmmount.conf(4).
o Creates a new notification pipe to which Action File Manager writes.
o Listens on the notification pipe and interprets the data received.
o Launches the appropriate applications based on the data sent by Action File Manager.
EXTENDED DESCRIPTION
gnome-volcheck listens to the events generated by Action File Manager, but only processes the media insert events. When an insert event
occurs, gnome-volcheck may perform a number of actions. These actions are based on the contents of the data files in the /tmp/.removable
directory, as follows:
o If a data file contains the text password_protected, gnome-volcheck launches the GNOME protect media application to protect the corre-
sponding media.
o If a data file contains the text unformatted_media, gnome-volcheck launches the GNOME format media application to format the corre-
sponding media.
o If a data file contains the text audio_only, gnome-volcheck launches GNOME CD Player.
o If a data file does not contain any of the above, gnome-volcheck launches Nautilus file manager to handle the corresponding media. For
multisegment media, gnome-volcheck launches a single file-manager view, instead of a file-manager view per segment.
OPTIONS
The following options are supported:
-i time Specifies the number of seconds to wait before starting the file manager.
The minimum value is 0 seconds. The maximum value is 65535 seconds. The default value is 30 seconds. If the specified
value is close to the minimum or maximum value, the removable media feature may not work. If the specified value is outside
the permitted range, the default value is used.
If the file manager is in the user's session, the delay will ensure that the file manager desktop view is started instead
of the file manager view, if any media is present in the drive during login. If the file manager is not in the user's ses-
sion, the delay will minimize the impact of run-time load on the system.
-z time Specifies the number of seconds to wait before checking the notification file.
The minimum value is 0 seconds. The maximum value is 65535 seconds. The default value is 3 seconds. If the specified value
is close to the minimum or maximum value, the removable media feature may not work. If the specified value is outside the
permitted range, the default value is used.
This option is needed for multisegment media. Action File Manager creates an insert event per segment. After 3 seconds
sleep, gnome-volcheck checks to see whether there are additional insert events. This check is necessary to ensure that
gnome-volcheck can handle correctly all events generated by Action File Manager.
-m media Specifies the media types to be monitored. The supported values are cdrom, floppy, zip, jaz, and dvdrom. If the -m option
is not specified, all media types are monitored.
EXAMPLES
Example 1: Monitoring Several Removable Media With gnome-volcheck
example% gnome-volcheck -i 40 -z 4 -m cdrom,zip,jaz,dvdrom
This example shows how to run gnome-volcheck with an initial sleep time of 40 seconds, and with 4 seconds of wait time before reading data
files, to monitor the CD-ROM, Zip, Jaz, and DVD--ROM media types.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables that affect the execution of gnome-volcheck: NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
2 Application failed to read from or write to /tmp/.removable
3 Application failed to create notification pipe
FILES
The following files are used by this application:
/usr/bin/gnome-volcheck The command-line executable for the application.
/usr/dt/config/Xinitrc.SThegSuneGNOMEfXsession startup configuration script.
/tmp/.removable/notifypiThe notification pipe.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgnome-removable-media |
+-----------------------------+-----------------------------+
|Interface stability |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO
nautilus(1), vold(1M), rmmount(1M), rmmount.conf(4)
NOTES
gnome-volcheck is a system administration program. It must be invoked as a child of gnome-session. If invoked in any other way, gnome-
volcheck behavior is not predictable.
Written by Ghee Teo, Sun Microsystems Inc., 2003.
SunOS 5.10 2 Apr 2003 gnome-volcheck(1)