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)