SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from OpenSuSE glib2-tools-2.62.5-lp152.mo.1.6.x86_64.rpm

GIO

Section: User Commands (1)
Updated:
Index 

NAME

gio - GIO commandline tool 

SYNOPSIS

gio help [COMMAND]
gio version
gio cat LOCATION...
gio copy [OPTION...] SOURCE... DESTINATION
gio info [OPTION...] LOCATION...
gio list [OPTION...] [LOCATION...]
gio mime MIMETYPE [HANDLER]
gio mkdir [OPTION...] LOCATION...
gio monitor [OPTION...] [LOCATION...]
gio mount [OPTION...] [LOCATION...]
gio move [OPTION...] SOURCE... DESTINATION
gio open LOCATION...
gio rename LOCATION NAME
gio remove [OPTION...] LOCATION...
gio save [OPTION...] DESTINATION
gio set [OPTION...] LOCATION ATTRIBUTE VALUE...
gio trash [OPTION...] [LOCATION...]
gio tree [OPTION...] [LOCATION...]
 

DESCRIPTION

gio

is a utility that makes many of the GIO features available from the commandline. In doing so, it provides commands that are similar to traditional utilities, but let you use GIO locations instead of local files: for example you can use something likesmb://server/resource/file.txtas a location.

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 thefile: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 whichgiobelongs.

cat LOCATION...

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

Thecatcommand works just like the traditionalcatutility.

Note: just pipe throughcatif you need its formatting options like-n,-Tor other.

copy [OPTION...] SOURCE... DESTINATION

Copies one or more files fromSOURCEtoDESTINATION. If more than one source is specified, the destination must be a directory.

Thecopycommand is similar to the traditionalcputility.


Options

-T, --no-target-directory

Doncqt copy intoDESTINATIONeven 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.

info [OPTION...] LOCATION...

Shows information about the given locations.

Theinfocommand is similar to the traditionallsutility.


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

Doncqt follow symbolic links.

list [OPTION...] [LOCATION...]

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

Thelistcommand is similar to the traditionallsutility.


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

Doncqt follow symbolic links.

-u, --print-uris

Print full URIs.

mime MIMETYPE [HANDLER]

If no handler is given, themimecommand lists the registered and recommended applications for the mimetype. If a handler is given, it is set as the default handler for the mimetype.

Handlers must be specified by their desktop file name, including the extension. Example:org.gnome.gedit.desktop.

mkdir [OPTION...] LOCATION...

Creates directories.

Themkdircommand is similar to the traditionalmkdirutility.


Options

-p, --parent

Create parent directories when necessary.

monitor [OPTION...] [LOCATION...]

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

Themonitorcommand 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 doncqt report changes.

-n, --no-moves

Report moves and renames as simple deleted/created events.

-m, --mounts

Watch for mount events.

mount [OPTION...] [LOCATION...]

Provides commandline access to various aspects of GIOcqs 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 themountcommand may ask for user IDs, passwords, and so on, when required.


Options

-m, --mountable

Mount as mountable.

-d, --device=DEVICE

Mount volume with device file.

-u, --unmount

Unmount the location.

-e, --eject

Eject the location.

-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.

move [OPTION...] SOURCE... DESTINATION

Moves one or more files fromSOURCEtoDESTINATION. If more than one source is specified, the destination must be a directory.

Themovecommand is similar to the traditionalmvutility.

open LOCATION...

Opens files with the default application that is registered to handle files of this type.

GIO obtains this information from the shared-mime-info database, with per-user overrides stored in$XDG_DATA_HOME/applications/mimeapps.list.

Themimecommand can be used to change the default handler for a mimetype.

Environment variables will not be set on the application, as it may be an existing process which is activated to handle the new file.

rename LOCATION NAME

Renames a file.

Therenamecommand is similar to the traditionalrenameutility.

remove [OPTION...] LOCATION...

Deletes each given file.

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

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

Theremovecommand is similar to the traditionalrmutility.


Options

-f, --force

Ignore non-existent and non-deletable files.

save [OPTION...] DESTINATION

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 thesavecommand 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 doesncqt 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.

set LOCATION ATTRIBUTE VALUE...

Sets a file attribute on a file.

File attributes can be specified with their GIO name, e.gstandard::icon. Note that not all GIO file attributes are writable. Use the--query-writableoption of theinfocommand to list writable file attributes.

If theTYPEis unset,VALUEdoes not have to be specified. If theTYPEisstringv, multiple values can be given.


Options

-t, --type=TYPE

Specifies the type of the attribute. Supported types arestring,stringv,bytestring,boolean,uint32,int32,uint64,int64andunset.

If the type is not specified,stringis assumed.

-n, --nofollow-symlinks

Doncqt follow symbolic links.

trash [OPTION...] [LOCATION...]

Sends files or directories to the oqTrashcancq. This can be a different folder depending on where the file is located, and not all file systems support this concept. In the common case that the file lives inside a usercqs home directory, the trash folder is$XDG_DATA_HOME/Trash.

Note that moving files to the trash does not free up space on the file system until the oqTrashcancq is emptied. If you are interested in deleting a file irreversibly, see theremovecommand.

Inspecting and emptying the oqTrashcancq is normally supported by graphical file managers such as Nautilus, but you can also see the trash with the command:gio list trash://.


Options

-f, --force

Ignore non-existent and non-deletable files.

--empty

Empty the trash.

tree [OPTION...] [LOCATION...]

Lists the contents of the given locations recursively, in a tree-like format. If no location is given, it defaults to the current directory.

Thetreecommand is similar to the traditionaltreeutility.


Options

-h, --hidden

Show hidden files.

-l, --follow-symlinks

Follow symbolic links.
 

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

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
EXIT STATUS
SEE ALSO

This document was created byman2html,using the manual pages.