summaryrefslogtreecommitdiff
path: root/monitor/udisks2/what-is-shown.txt
blob: f31daac7b4d6d4337e02b099657be15451a9b935 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

         CONTROLLING WHAT IS SHOWN IN THE USER INTERFACE
         ===============================================

The gvfs-udisks2-volume-monitor process is responsible for the disks,
media, mounts and fstab entries shown in the desktop user
interface. In particular, the Desktop Shell (gnome-shell), the Files
application (nautilus) as well as any other application using the GLib
APIs, is using information from this process.

In general, disks or media with mountable filesystems are shown, as
are fstab entries. These are collectively referred to as "devices" in
the following.

A device is either mounted (in which case its directory is known) or
it's not. If the device is not mounted, then its directory is known
only if it's referenced in the /etc/fstab file. Similarly, the options
for a device is either the options the device is currently mounted
with, or if not mounted, the options from its /etc/fstab entry, if
any.

If the directory for a device is known and outside /media, $HOME
(typically /home/foo) or $XDG_RUNTIME_DIR (typically /run/user/foo)
then the device is not shown in the user interface. Additionally, if
any of component directories in its directory starts with a dot ("."),
the device is not shown either. This policy may be overriden by use of
the options comment=gvfs-show and comment=gvfs-hide.

The name and icon to use for a device is chosen according to certain
heuristics - for example, if a device has a filesystem label, it is
used - if not, some other characteristic is used. The options
comment=gvfs-name=<value> and comment=gvfs-icon=<value> can be used to
override this policy with <value> being an URL-encoded string. For
icons, the Icon Naming Specification is used.

Users are advised to use (stable) symlinks in the /dev/disk/ hierarchy
for /etc/fstab entries instead of the kernel names sda, sdb and so
on. See udev(7) for more information about this.

The Disks application provides an user interface to easily edit
/etc/fstab entries including these options, see

 http://people.freedesktop.org/~david/palimpsest-fstab-gvfs-show-option.png

EXAMPLES
--------

# forcibly hide device in user interface
/dev/disk/by-id/ata-HITACHI_HTS723232A7A364_E3834563KRG2HN-part1   /home/davidz/Data  auto  defaults,comment=gvfs-hide 0 0

# forcibly show device in user interface and with name "My Movies"
/dev/disk/by-uuid/4CAE8E5B5AF47502   /Movies  auto   defaults,comment=gvfs-show,comment=gvfs-name=My%20Movies  0 0

# forcibly show NFS mount in user interface
10.200.0.210:/tank/media  /mnt/Filer  nfs4  default,users,noauto,comment=gvfs-show  0 0