gvfs-mkdir
Create directories on GVFS mounts
SYNOPSIS
gvfs-mkdir [OPTION...] URI...
PARAMETERS
--parents, -p
Create parent directories as needed. If parent directories do not exist, they are created automatically.
--mode=MODE, -m MODE
Set the file mode (permissions) for the newly created directory. MODE can be an octal number (e.g., 0755) or a symbolic mode string.
--help
Display a help message and exit.
--version
Output version information and exit.
URI
The Uniform Resource Identifier(s) specifying the path(s) of the directory to be created. This can be a local path or a remote URI (e.g., sftp://user@host/path/to/dir).
DESCRIPTION
gvfs-mkdir is a utility from the GNOME Virtual File System (GVfs) suite, designed to create new directories on remote locations or local file systems that are exposed via GVfs. Unlike the standard mkdir command, gvfs-mkdir operates on URIs (Uniform Resource Identifiers), allowing it to interact seamlessly with various network protocols such as FTP, SFTP, SMB, WebDAV, and more, as long as GVfs has a backend for them.
This command is particularly useful in environments where users need to manipulate files and directories across different network shares or cloud storage providers without explicitly mounting them in the traditional sense. It provides a consistent interface for directory creation, abstracting away the underlying network complexities.
CAVEATS
gvfs-mkdir relies on the GVfs backends and the D-Bus system. Its functionality depends on the availability and proper configuration of GVfs mounts and services. Errors during remote operations (e.g., network issues, authentication failures, insufficient permissions on the remote server) will be reported by the command. It might not be available or fully functional in minimal environments without a running D-Bus session or GVfs daemons.
URI USAGE
Unlike traditional commands that operate on local file paths, gvfs-mkdir exclusively uses URIs. This allows it to target diverse network locations (e.g., sftp://user@host/path, smb://server/share/folder, ftp://example.com/dir) as if they were local paths, providing a powerful abstraction layer for remote file management.
INTEGRATION WITH GNOME
gvfs-mkdir and other gvfs- commands are often used implicitly by GNOME applications. For example, when you drag and drop files to a network share in Nautilus, GVfs handles the underlying operations. These command-line tools provide direct access to this same GVfs functionality for scripting and power users.
HISTORY
GVfs (GNOME Virtual File System) was developed as a replacement for the older GnomeVFS library, aiming for a more robust and modular virtual filesystem architecture. It integrates deeply with the GNOME desktop environment, providing transparent access to remote resources. gvfs-mkdir emerged as part of the gvfs-fuse and command-line utilities, offering a consistent way to manage directories across these virtualized file systems, enhancing user experience by abstracting network complexities. Its development is tied to the evolution of the GNOME desktop.
SEE ALSO
mkdir(1), gvfs-cat(1), gvfs-cp(1), gvfs-ls(1), gvfs-rm(1), gvfs-mount(1)