gvfs-mount
Mount virtual file systems
SYNOPSIS
gvfs-mount [OPTION...] LOCATION
gvfs-mount --unmount [OPTION...] LOCATION
gvfs-mount --unmount-all
gvfs-mount --list
gvfs-mount --monitor
PARAMETERS
-h, --help
Shows a help text and exits.
--version
Shows the version number and exits.
-u, --unmount
Unmounts the given location.
--unmount-all
Unmounts all currently mounted locations.
-l, --list
Lists all currently mounted locations.
-m, --monitor
Monitors mount and unmount operations.
-o, --options=OPTIONS
A comma-separated list of options to pass to the mount operation. The exact options depend on the GVfs backend (e.g., cifs supports "user=USERNAME", "pass=PASSWORD", "domain=DOMAINNAME").
--private
Mount the location in private mode. This is mostly useful for GVfs backend implementations.
--do-not-show-ui
Prevents any password or other user interface elements from being shown when mounting.
--anon
Mounts anonymously without asking for a password.
--set-enabled
Sets the enabled state for the location. This is mostly useful for GVfs backend implementations.
--volumeid=VOLUMEID
Uses the given volume ID to mount the location. This is mostly useful for GVfs backend implementations.
-i, --detail
Shows more detailed information when listing mounts.
--shell-interactive
Runs in shell interactive mode.
DESCRIPTION
gvfs-mount is a command-line utility that interacts with GVfs (GNOME Virtual File System), a user-space abstraction for various network and local filesystems. It allows users to mount, unmount, and list GVfs locations, which can be URIs (e.g., sftp://user@host/path) or volume names (e.g., "My Disk").
GVfs provides transparent access to resources like FTP, SFTP, WebDAV, SMB/CIFS, MTP, and more, typically without requiring root privileges or specific kernel modules for each protocol. This command is particularly useful for scripting and managing GVfs mounts from the terminal. When run without arguments, it lists currently mounted locations. It also provides options for unmounting specific locations, unmounting all, monitoring mount operations, and passing protocol-specific options.
CAVEATS
gvfs-mount relies on the GVfs daemon (gvfsd) being active. Its functionality may be limited or unavailable in environments where GVfs is not running or properly configured (e.g., non-GNOME desktop environments without gvfsd-fuse). The specific options for -o, --options are highly backend-dependent and not universally applicable; users should consult documentation for the respective GVfs backend (e.g., CIFS, FTP) for supported options.
EXIT STATUS
The command returns 0 on success, and a non-zero value indicates a failure.
LOCATION ARGUMENT
The LOCATION argument for mounting or unmounting can be either a full URI (e.g., sftp://user@host/path) or a volume name (e.g., "My Disk" or "USB Drive").
HISTORY
GVfs (GNOME Virtual File System) was developed as a modern replacement for the older GnomeVFS library, aiming for improved performance, robustness, and extensibility in handling virtual filesystems. gvfs-mount emerged as a key command-line utility within this new framework, providing a consistent interface for managing remote and local resources within the GNOME ecosystem. Its development is integral to the evolution of the GNOME desktop environment, though it can be utilized independently.
SEE ALSO
gvfs(7), gvfsd(1), gvfsd-fuse(1), gvfs-ls(1), gvfs-info(1), gvfs-cat(1), gvfs-copy(1), gvfs-move(1), gvfs-trash(1), gvfs-rm(1)