<commit_before>
         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 /run/media/$USER 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 x-gvfs-show
and x-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
x-gvfs-name=<value> and x-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 the "Mount and
encryption options" paragraph in this blog entry

 http://davidz25.blogspot.com/2012/03/simpler-faster-better.html

EXAMPLES
--------

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

# forcibly show device in user interface and with name "My Movies"
/dev/disk/by-uuid/4CAE8E5B5AF47502   /Movies  auto   defaults,x-gvfs-show,x-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,x-gvfs-show  0 0

INFLUENTIAL UDEV PROPERTIES
---------------------------

Note that it's also possible to influence what is shown (and if it's
shown) using udev properties. While the udisks(8) man page, see

 http://udisks.freedesktop.org/docs/latest/udisks.8.html

is the authoritative source for the supported properties, we mention<commit_msg>udisks2: update the what-is-shown.txt file to mention multi-seat systems<commit_after>
         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 /run/media/$USER 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 x-gvfs-show
and x-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
x-gvfs-name=<value> and x-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 the "Mount and
encryption options" paragraph in this blog entry

 http://davidz25.blogspot.com/2012/03/simpler-faster-better.html

In a multi-seat system, only drives assigned to the seat the session
is running on is shown. Automounting is turned off for drives attached
to all seats.

EXAMPLES
--------

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

# forcibly show device in user interface and with name "My Movies"
/dev/disk/by-uuid/4CAE8E5B5AF47502   /Movies  auto   defaults,x-gvfs-show,x-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,x-gvfs-show  0 0

INFLUENTIAL UDEV PROPERTIES
---------------------------

Note that it's also possible to influence what is shown (and if it's
shown) using udev properties. While the udisks(8) man page, see

 http://udisks.freedesktop.org/docs/latest/udisks.8.html

is the authoritative source for the supported properties, we mention
{'fraction_non_alphanumeric': 0.08782666225603705, 'fraction_numerical': 0.01935163744624545, 'mean_word_length': 3.9565573770491804, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4131301', 'n_tokens_mistral': 1900, 'n_tokens_neox': 1739, 'n_words': 826}