[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    rmmount.conf(4) manual page Table of Contents

Name

rmmount.conf - removable media mounter configuration file

Synopsis

/etc/rmmount.conf

Description

The rmmount.conf file contains the rmmount(1M) configuration information. This file describes where to find shared objects that perform actions on file systems after identifying and mounting them. The rmmount.conf file is also used to share CD-ROM and floppy file systems.

Actions are executed in the order in which they appear in the configuration file. The action function can return either 1 or 0. If it returns 0, no further actions will be executed. This allows the function to control which applications are executed. For example, action_filemgr always returns 0 if the File Manager is running, thereby preventing subsequent actions from being executed.

To execute an action after media has been inserted and while the File Manager is not running, list the action after action_filemgr in the rmmount.conf file. To execute an action before the File Manager becomes aware of the media, list the action before action_filemgr in the rmmount.conf file.

The syntax for the rmmount.conf file is as follows.

# File system identification

ident filesystem_type shared_object media_type [media_type ...]
# Actions

action media_type shared_object args_to_so
# File system sharing

share media_or_file_system share_command_options

Explanations of the syntax for the ‘File system identification’ fields are as follows.

filesystem_type
An ASCII string used as the file system type flag of the mount command (see the -F option of mount(1M) ). It is also used to match names passed to rmmount(1M) from Volume Management.
shared_object
Programs that identify file systems and perform actions. This shared_object is found at /usr/lib/fs/filesystem_type/shared_object.
media_type
The type of media where this file system resides. Legal values are cdrom and floppy.

Explanations of the syntax for the ‘Actions’ fields are as follows.

media_type
Type of media. This argument is passed in from Volume Management as VOLUME_TYPE .
shared_object
Programs that identify file systems and perform actions. If shared_object starts with ‘/’ (slash), the full path name is used;
otherwise, /usr/lib/rmmount is prepended to the name.
args_to_so
Arguments passed to the shared_object. These arguments are passed in as an argc and argv[].

The definition of the interface to ‘Actions’ is located in /usr/include/rmmount.h.

Explanations of the syntax for the ‘File system sharing’ fields are as follows.

media_or_file_system
Either the type of media (CD-ROM or floppy) or the specific file system to share.
share_command_options
Options of the share command. See share(1M) for more information about these options.

Default Values

The following is an example of an rmmount.conf file.


#
# Removable Media Mounter configuration file.
#


# File system identification
ident hsfs ident_hsfs.so cdrom
ident ufs ident_ufs.so cdrom floppy
ident pcfs ident_pcfs.so floppy
# Actions
action cdrom action_filemgr.so
action floppy action_filemgr.so

Examples

The following examples show how various file systems are shared using the share syntax for the rmmount.conf file. These lines are added after the Actions entries.

share cdrom*
Shares all CD-ROMs via NFS and applies no access restrictions.
share solaris_2.x*
Shares CD-ROMs named solaris_2.x* with no access restrictions.
share cdrom* -o ro=engineering
Shares all CD-ROMs via NFS but exports only to the "engineering" netgroup.
share solaris_2.x* -d "distribution CD"
Shares CD-ROMs named solaris_2.x* with no access restrictions and with the description that it is a distribution CD-ROM.
share floppy0
Shares any floppy inserted into floppy drive 0.

See Also

volcancel(1) , volcheck(1) , volmissing(1) , mount(1M) , rmmount(1M) , share(1M) , vold(1M) , vold.conf(4) , volfs(7FS)


Table of Contents