unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



File Formats                                      rmmount.conf(4)



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 identify-
     ing and mounting them. The rmmount.conf file is also used to
     share file systems on removable media. It  can  also  direct
     the  rmmount utility to run fsck on one or more file systems
     before mounting them, with the  fsck  command  line  options
     specified in rmmount.conf.

     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 applica-
     tions  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 a medium 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 medium,
     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

     # Mount command options
     mount media_or_file_system [file_system_spec] -o mount_command_options

     # Optionally fsck command options
     fsck media_type filesystem_type -o fsck_command_options

     Explanations of the syntax for the File  system  identifica-
     tion fields are as follows:

     filesystem_type



SunOS 5.9           Last change: 18 Feb 2003                    1






File Formats                                      rmmount.conf(4)



           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 medium where  this  file  system  resides.
           Legal values are cdrom, floppy, jaz, rmdisk, and zip.

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

     media_type
           Type of medium. 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 medium or the specific file  system
           to share.

     share_command_options
           Options of the share command. See share(1M)  for  more
           information about these options.

     Explanations of the syntax for  the  Mount  command  options
     fields are as follows:

     media_or_file_system
           Either the type of medium or the specific file  system
           to share.




SunOS 5.9           Last change: 18 Feb 2003                    2






File Formats                                      rmmount.conf(4)



     file_system_spec
           Specifies one or more file systems to which this  line
           applies. Defaults to "all" file system types.

     mount_command_options
           One or more options to be passed to the mount command.
           Multiple options require a space delimiter.

     Explanations of the syntax  for  the  fsck  command  options
     fields are as follows:

     media_type
           The type of removable medium. A Bourne  shell  regular
           expression  that  matches  names  of file system media
           whose aliases are listed under /vol/dev/aliases. Exam-
           ples  include  cdrom0, cdrom1, cdrom*, jaz0, jaz1, and
           jaz*.

     filesystem_type
           The type of file system, for  example,  ufs  or  hsfs,
           that resides on the medium specified in media_type.

     fsck_command_options
           One or more options to be passed to fsck(1M). Multiple
           options must be separated by spaces.

     The algorithm for the fsck configuration line is as follows:

     1. The fsck configuration line tells rmmount to run fsck  on
        filesystem_type,  as described above. The filesystem_type
        must be correct for the media_type specified.

     2. If filesystem_type is not present, rmmount runs  fsck  on
        all file systems on all media that match media_type.

     3. If rmmount.conf contains no fsck  configuration  line  or
        contains  an  fsck  configuration  line with a media_type
        that does not match a medium's alias,  rmmount  does  not
        run  fsck  on  the removable medium's file system, unless
        mount reports that the file system's dirty bit is set.

  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 rmdisk pcmem
     ident pcfs ident_pcfs.so floppy rmdisk pcmem



SunOS 5.9           Last change: 18 Feb 2003                    3






File Formats                                      rmmount.conf(4)



     ident udfs ident_udfs.so cdrom floppy

     # Actions
     action cdrom action_filemgr.so
     action floppy action_filemgr.so
     action rmdisk action_filemgr.so

EXAMPLES
     Example 1: Sharing of Various File Systems

     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  res-
           trictions.

     share solaris_2.x*
           Shares CD-ROMs named solaris_2.x* with no access  res-
           trictions.

     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  res-
           trictions  and  with the description that it is a dis-
           tribution CD-ROM.

     share floppy0
           Shares the file system of  any  floppy  inserted  into
           floppy drive 0.

     share jaz0
           Shares the file system on Jaz drive 0.

     Example 2: Customizing mount Operations

     The following examples  show  how  different  mount  options
     could be used to customize how rmmount mounts various media:

     mount cdrom* hsfs -o nrr
           Mounts all High Sierra CD-ROMs with the nrr  (no  Rock
           Ridge extensions) option (see mount_hsfs(1M)).

     mount floppy1 -o ro
           Will always mount the  second  floppy  disk  read-only
           (for all file system types).

     mount floppy1 -o ro foldcase



SunOS 5.9           Last change: 18 Feb 2003                    4






File Formats                                      rmmount.conf(4)



           Will always mount the  second  floppy  disk  read-only
           (for  all  file  system  types)  and pass the foldcase
           mount option.

     mount jaz1 -o ro
           Mounts the medium in Jaz drive 1  read-only,  for  all
           file system types.

     Example 3: Telling rmmount  to  Check  File  Systems  Before
     Mounting Them

     The following examples show how to  tell  rmmount  to  check
     file  systems  with  fsck  before  mounting them, and how to
     specify the command line options to be used with fsck:

     fsck floppy* ufs -o f
           Performs a full file system check on any UFS floppies,
           ignoring the clean flag, before mounting them.

     fsck floppy* ufs -o p
           Uses the fsck p (preen) flag for all UFS floppies.

     fsck cdrom* -o f
           Tells rmmount to run fsck  before  mounting  any  file
           system on CD-ROM.

     fsck jaz* ufs -o f
           Tells rmmount to perform a full file system  check  on
           any  UFS  Jaz  media,  ignoring the clean flag, before
           mounting them.

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

NOTES
     When using the mount options line, verify that the specified
     options  will work with the specified file system types. The
     mount command will fail if an  incorrect  mount  option/file
     system  combination  is  specified.  Multiple  mount options
     require a space delimiter.













SunOS 5.9           Last change: 18 Feb 2003                    5