gvfs-copy
Copy files using GVFS
SYNOPSIS
gvfs-copy [OPTIONS...] SOURCE... DESTINATION
PARAMETERS
-n, --nofollow
Do not follow symbolic links.
-p, --preserve
Preserve modification times and permissions.
-v, --verbose
Be verbose.
-i, --interactive
Prompt before overwriting existing files.
-t, --no-target-directory
Treat DESTINATION as a normal file, not a directory.
-r, --recursive
Copy directories recursively.
-d, --directory
Create all the components of the specified directories.
SOURCE...
One or more source files or directories to copy.
DESTINATION
The destination directory or file.
DESCRIPTION
The `gvfs-copy` command is a command-line utility for copying files and directories using the GVFS (Gnome Virtual File System) framework. GVFS provides a unified interface for accessing various types of storage, including local filesystems, remote servers (e.g., SSH, FTP, WebDAV), and removable media. `gvfs-copy` utilizes this framework to handle copying across these different locations transparently, handling protocol-specific details behind the scenes. It's especially useful when working with remote filesystems mounted using GVFS, as it can leverage GVFS's capabilities for authentication and file transfer optimization. This tool simplifies file management by offering a consistent way to copy files regardless of their location or underlying protocol.
CAVEATS
GVFS relies on the availability of GVFS daemons and the appropriate GVFS modules for the specific protocols involved. If the necessary GVFS modules are not installed or configured, `gvfs-copy` may fail to copy files to or from certain locations.
Copying very large files over slow network connections can be slow and potentially unreliable. Always verify integrity after copying.
GVFS URI
The source and destination paths can be GVFS URIs (e.g., `sftp://user@host/path/to/file`).
ERROR HANDLING
Pay close attention to error messages as they can be valuable in diagnosing connection problems or permission issues when copying files using `gvfs-copy`. For example, it will fail copying a file if you do not have permission to read it.
HISTORY
The `gvfs-copy` command was developed as part of the GVFS project within the Gnome desktop environment. Its primary purpose is to provide a user-friendly and consistent way to copy files across various virtual file systems, abstracting away the complexities of different protocols and storage mechanisms. It has become a standard tool in Gnome-based systems for managing files across diverse storage locations.
SEE ALSO
gvfs-move(1), gvfs-mount(1), gvfs-open(1)