UDISKS-GLUE.CONF(5) udisks-glue Manual UDISKS-GLUE.CONF(5)
NAME
udisks-glue.conf - udisks-glue configuration file format
SYNOPSIS
~/.udisks-glue.conf
$XDG_CONFIG_HOME/udisks-glue/config
/etc/udisks-glue.conf
$XDG_CONFIG_DIRS/udisks-glue/config
DESCRIPTION
udisks-glue is configured by a series of match directives referencing filter directives. Filter directives define parameters that filter
the UDisks events. Match directives specify actions to be taken by udisks-glue in case the corresponded filter matches.
Filter and match directives can be specified in any order. You should use unique names for filter directives. The rules are evaluated in
the order the match directives are specified. A default directive is a special directive used as a fallback in case no other directives
match. It does not reference a filter directive. You may choose not to specify a default directive.
Due to the way the rules are evaluated, it's recommended that more specific match directives are defined before less specific ones. If a
match directive does not specify one of the available actions, another directive may be chosen. The currently available match directives
are:
automount If set, try to automatically mount the device (unset by default)
automount_filesystem Filesystem type to use when automounting the device
automount_options List of options to use when automounting the device
post_insertion_command Command to run after a device is inserted or after its media has been made available
post_mount_command Command to run after a device has been mounted
post_unmount_command Command to run after a device has been unmounted
post_removal_command Command to run after a device or its media has been removed
udisks-glue will substitute some tokens with information about the device in each of the commands listed above:
%device_file Path to the device file
%mount_point Last known mount point for the device (only replaced in post_mount_command and post_unmount_command)
The currently supported filter parameters are:
label (string) User-visible label of the detected file system
optical (boolean) Set if the device uses optical disc as its media
optical_disc_closed (boolean) Set if the optical disc is closed
optical_disc_has_audio_tracks (boolean)
Set if the optical disc has audio tracks
optical_disc_has_audio_tracks_only (boolean)
Set if all tracks in the optical disc are audio tracks
partition (boolean) Set if the device is a partition of another device
partition_table (boolean) Set if the device has a partition table
readonly (boolean) Set if the device is a ready-only device
removable (boolean) Set if the device is a removable device
type (string) Extended information about the device, generally set to the name of the detected file system if the usage
property is set to filesystem
usage (string) The result of probing for signatures on the block device, generally set to filesystem if a mountable file
system was detected
uuid (string) UUID of the detected file system
Note that the rules are evaluated only at the time the device or its media is inserted. Internal drives are always ignored.
EXAMPLE
The following configuration example shows how you can automount USB pendrives and similar devices. Notifications are provided by a custom
script that could display on-screen information or provide notifications in some other way:
filter disks {
optical = false
partition_table = false
usage = filesystem
}
match disks {
automount = true
automount_options = sync
post_mount_command = "mount-notify mounted %device_file %mount_point"
post_unmount_command = "mount-notify unmounted %device_file %mount_point"
}
A more complex example shows how the filters can be used to mount optical and non-optical media (USB pendrives and the like) using differ-
ent mount options and how a specific program can be launched on non-closed optical discs.
#
# Filters
#
filter disks {
optical = false
partition_table = false
usage = filesystem
}
filter burnable {
optical = true
optical_disc_closed = false
}
filter optical {
optical = true
}
#
# The default entry (only used if no filters match)
#
default {
post_insertion_command = "insertion-notify %device_file"
}
#
# Additional entries
#
match disks {
automount = true
automount_options = { sync, noatime }
post_mount_command = "mount-notify mounted %device_file %mount_point"
post_unmount_command = "mount-notify unmounted %device_file %mount_point"
}
match burnable {
post_insertion_command = "k3b %device_file"
post_mount_command = "mount-notify mounted %device_file %mount_point"
post_insertion_command = "udisks --mount %device_file --mount-options ro"
}
match optical {
automount = true
automount_options = ro
post_mount_command = "mount-notify mounted %device_file %mount_point"
post_insertion_command = "udisks --mount %device_file --mount-options ro"
}
SEE ALSO
udisks(1), udisks-glue(1) udisks(7), udisks-daemon(8)
udisks-glue 2011-04-20 UDISKS-GLUE.CONF(5)