Provided by: udisks-glue_1.3.2-1_amd64 bug

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  different 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)