LinuxCommandLibrary

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)

Copied to clipboard