gio (1) Linux Manual Page

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.

COMMANDS

help [COMMAND]

Displays a short synopsis of the available commands or provides detailed help on a specific command.

version

Prints the GLib version to which gio belongs.

cat LOCATION…

Concatenates the given files and prints them to the standard output.

The cat command works just like the traditional cat utility.

Note: just pipe through cat if you need its formatting options like -n, -T or other.

copy [OPTION…] SOURCE… DESTINATION

Copies one or more files from SOURCE to DESTINATION. If more than one source is specified, the destination must be a directory.

The copy command is similar to the traditional cp utility.

Options

-T, –no-target-directory

Don’t copy into DESTINATION even if it is a directory.

-p, –progress

Show progress.

-i, –interactive

Prompt for confirmation before overwriting files.

–preserve

Preserve all attributes of copied files.

-b, –backup

Create backups of existing destination files.

-P, –no-dereference

Never follow symbolic links.

–default-permissions

Use the default permissions of the current process for the destination file, rather than copying the permissions of the source file.

Shows information about the given locations.

The info command is similar to the traditional ls utility.

Options

-w, –query-writable

List writable attributes.

-f, –filesystem

Show information about the filesystem that the given locations reside on.

-a –attributes=ATTRIBUTES

The attributes to get.

Attributes can be specified with their GIO name, e.g. standard::icon, or just by namespace, e.g. unix, or by *, which matches all attributes. Several attributes or groups of attributes can be specified, separated by comma.

By default, all attributes are listed.

-n, –nofollow-symlinks

Don’t follow symbolic links.

Lists the contents of the given locations. If no location is given, the contents of the current directory are shown.

The list command is similar to the traditional ls utility.

Options

-a –attributes=ATTRIBUTES

The attributes to get.

Attributes can be specified with their GIO name, e.g. standard::icon, or just by namespace, e.g. unix, or by *, which matches all attributes. Several attributes or groups of attributes can be specified, separated by comma.

By default, all attributes are listed.

-h, –hidden

Show hidden files.

-l, –long

Use a long listing format.

-n, –nofollow-symlinks

Don’t follow symbolic links.

-d, –print-display-names

Print display names.

-u, –print-uris

Print full URIs.

Creates directories.

The mkdir command is similar to the traditional mkdir utility.

Options

-p, –parent

Create parent directories when necessary.

Monitors files or directories for changes, such as creation deletion, content and attribute changes, and mount and unmount operations affecting the monitored locations.

The monitor command uses the GIO file monitoring APIs to do its job. GIO has different implementations for different platforms. The most common implementation on Linux uses inotify.

Options

-d, –dir=LOCATION

Monitor the given location as a directory. Normally, the file type is used to determine whether to monitor a file or directory.

-f, –file=LOCATION

Monitor the given location as a file. Normally, the file type is used to determine whether to monitor a file or directory.

-D, –direct=LOCATION

Monitor the file directly. This allows changes made via hardlinks to be captured.

-s, –silent=LOCATION

Monitor the file directly, but don’t report changes.

-n, –no-moves

Report moves and renames as simple deleted/created events.

-m, –mounts

Watch for mount events.

Provides commandline access to various aspects of GIO’s mounting functionality.

Mounting refers to the traditional concept of arranging multiple file systems and devices in a single tree, rooted at /. Classical mounting happens in the kernel and is controlled by the mount utility. GIO expands this concept by introducing mount daemons that can make file systems available to GIO applications without kernel involvement.

GIO mounts can require authentication, and the mount command may ask for user IDs, passwords, and so on, when required.

Options

-m, –mountable

Mount as mountable.

-d, –device=ID

Mount volume with device file, or other identifier.

-u, –unmount

Unmount the location.

-e, –eject

Eject the location.

-t, –stop=DEVICE

Stop drive with device file.

-s, –unmount-scheme=SCHEME

Unmount all mounts with the given scheme.

-f, –force

Ignore outstanding file operations when unmounting or ejecting.

-a, –anonymous

Use an anonymous user when authenticating.

-l, –list

List all GIO mounts.

-o, –monitor

Monitor mount-related events.

-i, –detail

Show extra information.

–tcrypt-pim

The numeric PIM when unlocking a VeraCrypt volume.

–tcrypt-hidden

Mount a TCRYPT hidden volume.

–tcrypt-system

Mount a TCRYPT system volume.

Moves one or more files from SOURCE to DESTINATION. If more than one source is specified, the destination must be a directory.

The move command is similar to the traditional mv utility.

Options

-T, –no-target-directory

Don’t copy into DESTINATION even if it is a directory.

-p, –progress

Show progress.

-i, –interactive

Prompt for confirmation before overwriting files.

-b, –backup

Create backups of existing destination files.

-C, –no-copy-fallback

Don’t use copy and delete fallback.

Deletes each given file.

This command removes files irreversibly. If you want a reversible way to remove files, see the trash command.

Note that not all URI schemes that are supported by GIO may allow deletion of files.

The remove command is similar to the traditional rm utility.

Options

-f, –force

Ignore non-existent and non-deletable files.

Reads from standard input and saves the data to the given location.

This is similar to just redirecting output to a file using traditional shell syntax, but the save command allows saving to location that GIO can write to.

Options

-b, –backup

Back up existing destination files.

-c, –create

Only create the destination if it doesn’t exist yet.

-a, –append

Append to the end of the file.

-p, –private

When creating, restrict access to the current user.

-u, –unlink

When replacing, replace as if the destination did not exist.

-v, –print-etag

Print the new ETag in the end.

-e, –etag=ETAG

The ETag of the file that is overwritten.

EXIT STATUS

On success 0 is returned, a non-zero failure code otherwise.

SEE ALSO

cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).

Index