1 RMMOUNT(1M)                  Maintenance Commands                  RMMOUNT(1M)
   2 
   3 
   4 
   5 NAME
   6        rmmount - removable media mounter for CD-ROM, floppy, Jaz drive, and
   7        others
   8 
   9 SYNOPSIS
  10        /usr/sbin/rmmount [-D]
  11 
  12 
  13 DESCRIPTION
  14        The rmmount utility is a removable media mounter that is executed by
  15        volume management whenever a removable medium, such as a CD-ROM or a
  16        floppy, is inserted. Removable media is managed by an application or a
  17        volume manager.
  18 
  19 
  20        Upon insertion of a medium and following invocation of the volcheck(1)
  21        command, rmmount determines what type of file system (if any) is on
  22        that medium. If a file system is present, rmmount mounts the file
  23        system in one of the locations listed below.
  24 
  25 
  26        For a diskette (floppy):
  27 
  28        /floppy/floppy0
  29                                  symbolic link to mounted floppy in local
  30                                  floppy drive
  31 
  32 
  33        /floppy/floppy_name
  34                                  mounted named floppy
  35 
  36 
  37        /floppy/unnamed_floppy
  38                                  mounted unnamed floppy
  39 
  40 
  41 
  42        For a CD-ROM or a DVD-ROM:
  43 
  44        /cdrom/cdrom0
  45 
  46            symbolic link to mounted CD-ROM in local CD-ROM drive
  47 
  48 
  49        /cdrom/CD-ROM_name
  50 
  51            mounted named CD-ROM
  52 
  53 
  54        /cdrom/CD-ROM_name/partition
  55 
  56            mounted named CD-ROM with partitioned file system
  57 
  58 
  59        /cdrom/unnamed_cdrom
  60 
  61            mounted unnamed CD-ROM
  62 
  63 
  64 
  65        For a Zip drive:
  66 
  67        /rmdisk/zip0
  68                                      symbolic link to mounted Zip medium in
  69                                      local Zip drive
  70 
  71 
  72        /rmdisk/Zip_name
  73                                      mounted named Zip medium
  74 
  75 
  76        /rmdisk/Zip_name/partition
  77                                      mounted named Zip medium with partitioned
  78                                      file system
  79 
  80 
  81        /rmdisk/unnamed_zip
  82                                      mounted unnamed Zip medium
  83 
  84 
  85 
  86        For a Jaz drive:
  87 
  88        /rmdisk/jaz0
  89                                      symbolic link to mounted Jaz medium in
  90                                      local Jaz drive
  91 
  92 
  93        /rmdisk/Jaz_name
  94                                      mounted named Jaz medium
  95 
  96 
  97        /rmdisk/Jaz_name/partition
  98                                      mounted named Jaz medium with partitioned
  99                                      file system
 100 
 101 
 102        /rmdisk/unnamed_Jaz
 103                                      mounted unnamed Jaz medium
 104 
 105 
 106 
 107        For a generic "rmdisk" drive:
 108 
 109        /rmdisk/rmdisk0
 110 
 111            symbolic link to mounted removable medium in local removable medium
 112            drive
 113 
 114 
 115        /rmdisk/rmdisk_name
 116 
 117            mounted named removable medium
 118 
 119 
 120        /rmdisk/rmdisk_name/partition
 121 
 122            mounted named removable medium with partitioned file system
 123 
 124 
 125        /rmdisk/unnamed_rmdisk
 126 
 127            mounted unnamed removable medium
 128 
 129 
 130 
 131        If the media is read-only (for example, a CD-ROM or a floppy with
 132        write-protect tab set), the file system is mounted read-only.
 133 
 134 
 135        If a file system is not identified, rmmount does not mount a file
 136        system.  See the  for more information on the location of CD-ROM,
 137        floppy, and other media without file systems.
 138 
 139 
 140        If a file system type has been determined, it is then checked to see
 141        that it is "clean." If the file system is "dirty," fsck -p (see
 142        fsck(1M)) is run in an attempt to clean it. If fsck fails, the file
 143        system is mounted read-only.
 144 
 145 
 146        After the mount is complete, "actions" associated with the media type
 147        are executed. These actions allow for the notification to other
 148        programs that new media are available.
 149 
 150 
 151        Actions are executed in the order in which they appear in the
 152        configuration file. The action function can return either 1 or 0. If it
 153        returns 0, no further actions will be executed. This allows the
 154        function to control which applications are executed.
 155 
 156 
 157        In order to execute an action, rmmount performs a dlopen(3C) on the
 158        shared object and calls the action function defined within it. The
 159        definition of the interface to actions can be found in
 160        /usr/include/rmmount.h.
 161 
 162 
 163        File systems mounted by rmmount are always mounted with the nosuid flag
 164        set, thereby disabling setuid programs and access to block or character
 165        devices in that file system. Upon ejection, rmmount unmounts mounted
 166        file systems and executes actions associated with the media type. If a
 167        file system is "busy" (that is, it contains the current working
 168        directory of a live process), the ejection will fail.
 169 
 170 OPTIONS
 171        -D
 172              Turn on the debugging output from the rmmount dprintf calls.
 173 
 174 
 175 FILES
 176        /usr/lib/rmmount/*.so.1
 177                                   shared objects used by rmmount.
 178 
 179 
 180 SEE ALSO
 181        volcheck(1), fsck(1M), dlopen(3C), attributes(5)
 182 
 183 
 184 
 185 
 186 
 187                                   May 2, 2014                      RMMOUNT(1M)