NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO
The rmmount utility is a removable media mounter that is executed by Volume Management whenever a CD-ROM or floppy is inserted. The Volume Management daemon, vold(1M), manages CD-ROM and floppy devices. rmmount is also called by volrmmount(1), and by device allocation clean scripts invoked by the allocate(1) command.
If the media is read-only (either CD-ROM or floppy with write-protect tab set), the file system is mounted read-only.
If a file system is not identified, rmmount does not mount a file system. See the System Administration Guide, Volume 1 for more information on the location of CD-ROM and floppy media without file systems. Also see volfs(7FS).
If a file system type has been determined, it is then checked to see that it is "clean." If the file system is "dirty," fsck -p (see fsck(1M)) is run in an attempt to clean it. If fsck fails, the file system is mounted read-only.
After the mount is complete, "actions" associated with the media type are executed. These actions allow for the notification to other programs that new media are available. These actions are shared objects and are described in the configuration file, /etc/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 applications are executed.
In order to execute an action, rmmount performs a dlopen(3DL) on the shared object and calls the action function defined within it. The
definition of the interface to actions can be found in /usr/include/rmmount.h. The actions are run in the rmmount process, that is, at label ADMIN_LOW
, with a UID of 0, and with the privileges
of rmmount (see SUMMARY OF TRUSTED SOLARIS CHANGES). If an action does not require privileges, it should fork a child process to do the work of the action, and the child process whould change its effective UID. For example, if the action should run as the user logged in on the console, the process UID should
be set to the UID of /dev/console.
File systems mounted by rmmount are always mounted with the nosuid flag set, thereby disabling set-uid programs and access to block or character devices in that file system. Upon ejection, rmmount unmounts mounted file systems and executes actions associated with the media type. If a file system is "busy" (that is, it contains the current working directory of a live process), the ejection will fail.
Several environment variables must be passed to rmmount.
The event type to be handled. The event types are insert, remount, clear_mounts, eject, and unmount.
The type of media be mounted or unmounted, for example, cdrom or floppy
A name for the mounted media. This is typically the volume name taken from the media's label.
Pathname of the device special file for the device on which the filesystem resides.
Symbolic name of the device containing the volume, for example, cdrom0 or floppy0.
Two other environment variables may optionally be passed to rmmount.
Partition letter for a PCFS file system.
Mount mode. If not supplied, the default mode is "r" for read-only file systems, and "rw" for others.
The rmmount command mounts the media on device $VOLUME_PATH
at the mount point /$VOLUME_MEDIATYPE/$VOLUME_NAME. It also creates a symbolic link $VOLUME_MEDIATYPE/$VOLUME_SYMDEV pointing to the /$VOLUME_MEDIATYPE/$VOLUME_NAME mount point.
With the values of the environment variables passed by vold(1M), the file system is mounted in one of the following locations:
State of Media
symbolic link to mounted floppy in local floppy drive
mounted named floppy
mounted unnamed floppy
symbolic link to mounted CD-ROM in local CD-ROM drive
mounted named CD-ROM
mounted named CD-ROM with partitioned file system
mounted unnamed CD-ROM
removable media mounter configuration file.
shared objects used by rmmount.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWvolu |
The rmmount command must inherit the file_chown
, file_dac_read
, file_dac_write
, file_mac_read
, file_mac_write
, file_owner
, file_setdac
, and sys_mount
privileges.
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO