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)