From fa33e232d2046401fa65c833f63e866ef3443662 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Sun, 8 Dec 2024 22:58:50 +0000 Subject: [PATCH] gio-tool: Clarify that `gio mount -l` only lists user-interesting things MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It doesn’t list all mounts, only the ones you’d expect to see in a file chooser sidebar. Signed-off-by: Philip Withnall Helps: #3555 --- docs/reference/gio/gio.rst | 6 ++++++ gio/gio-tool-mount.c | 4 ++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/reference/gio/gio.rst b/docs/reference/gio/gio.rst index d3ffa3ede..23bed8273 100644 --- a/docs/reference/gio/gio.rst +++ b/docs/reference/gio/gio.rst @@ -58,6 +58,12 @@ Plain filenames which contain a colon will be interpreted as URIs with an unknown protocol. To avoid this, prefix them with a path such as ``./``, or with the ``file:`` protocol. +Volumes, drives and mounts are limited to the ones which are considered +interesting to the user, such as removable drives. System mounts will not be +shown, meaning the output from ``gio mount`` is not equivalent to the output +from tools like ``fdisk``, and ``gio monitor --mounts`` will only list events +relevant to selected mounts. + COMMANDS -------- diff --git a/gio/gio-tool-mount.c b/gio/gio-tool-mount.c index 5a35c1b36..6838775e4 100644 --- a/gio/gio-tool-mount.c +++ b/gio/gio-tool-mount.c @@ -71,8 +71,8 @@ static const GOptionEntry entries[] = { "force", 'f', 0, G_OPTION_ARG_NONE, &force, N_("Ignore outstanding file operations when unmounting or ejecting"), NULL }, { "anonymous", 'a', 0, G_OPTION_ARG_NONE, &anonymous, N_("Use an anonymous user when authenticating"), NULL }, /* Translator: List here is a verb as in 'List all mounts' */ - { "list", 'l', 0, G_OPTION_ARG_NONE, &mount_list, N_("List"), NULL}, - { "monitor", 'o', 0, G_OPTION_ARG_NONE, &mount_monitor, N_("Monitor events"), NULL}, + { "list", 'l', 0, G_OPTION_ARG_NONE, &mount_list, N_("List user-interesting volumes, drives and mounts"), NULL}, + { "monitor", 'o', 0, G_OPTION_ARG_NONE, &mount_monitor, N_("Monitor user-interesting volume, drive and mount events"), NULL}, { "detail", 'i', 0, G_OPTION_ARG_NONE, &extra_detail, N_("Show extra information"), NULL}, { "tcrypt-pim", 0, 0, G_OPTION_ARG_INT, &tcrypt_pim, N_("The numeric PIM when unlocking a VeraCrypt volume"), N_("PIM")}, { "tcrypt-hidden", 0, 0, G_OPTION_ARG_NONE, &tcrypt_hidden, N_("Mount a TCRYPT hidden volume"), NULL},