cmd/gio: Difference between revisions
from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
< cmd
Created page with "==About== '''gio''' is a command line interface to the GIO subsystem. Commands (incomplete listing): {| class="wikitable sortable" |- ! subcommand || argument(s) || pu..." |
oops |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
==About== | ==About== | ||
'''gio''' is a [[command line interface]] to the [[GIO]] subsystem. | '''gio''' is a [[command line interface]] to the [[GIO]] subsystem. | ||
Commands | ==Commands== | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|- | |- | ||
! subcommand || argument(s) || purpose | ! subcommand || argument(s) || purpose | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|help}}''' || [{{arg|COMMAND}}] || Displays a short synopsis of the available commands or provides detailed help on a specific command. | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|version}}''' || || Prints the GLib version to which gio belongs. | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|cat}}''' || {{arg|LOCATION}}... | ||
| <poem> | |||
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. | |||
</poem> | |||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|copy}}''' || [{{arg|OPTION}}...] {{arg|SOURCE}}... {{arg|DESTINATION}} || Copies one or more files from {{arg|SOURCE}} to {{arg|DESTINATION}}; similar to {{l/cmd|cp}}. | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|info}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Shows information about the given locations; similar to {{l/cmd|ls}}. | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|launch}}''' || {{arg|DESKTOP-FILE}} [{{arg|FILE-ARG}}...] | ||
| Launch a desktop file from any location given. | |||
* The launch command extends the behavior of the open command by allowing any desktop file to be launched, not only those registered as file handlers. | |||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|list}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Lists the contents of the given locations; similar to {{l/cmd|ls}}. | ||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|mime}}''' || {{arg|MIMETYPE}} [{{arg|HANDLER}}] | ||
| | |||
* If no handler is given, the mime command 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: <code>org.gnome.gedit.desktop</code>. | |||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|mkdir}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Creates directories; similar to {{l/cmd|mkdir}}. | ||
* Options: | |||
** -p, --parent | |||
**: Create parent directories when necessary. | |||
|- | |- | ||
| '''{{l/sub| | | '''{{l/sub|monitor}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Monitors files or directories for changes | ||
|- | |||
| '''{{l/sub|mount}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Provides commandline access to various aspects of GIO’s mounting functionality. | |||
|- | |||
| '''{{l/sub|move}}''' || [{{arg|OPTION}}...] {{arg|SOURCE}}... {{arg|DESTINATION}} || Moves one or more files from SOURCE to DESTINATION; similar to {{l/cmd|mv}}. | |||
|- | |||
| '''{{l/sub|open}}''' || [{{arg|file}} or {{arg|URL}}] || Opens files with the default application that is registered to handle files of this type; related to [[xdg-open]]. | |||
* GIO obtains this information from the shared-mime-info database, with per-user overrides stored in <code>$XDG_DATA_HOME/applications/mimeapps.list</code>. | |||
* The mime command 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. | |||
|- | |||
| '''{{l/sub|rename}}''' || {{arg|LOCATION}} {{arg|NAME}} || Renames a file; similar to {{l/cmd|rename}}. | |||
|- | |||
| '''{{l/sub|remove}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Deletes each given file; similar to {{l/cmd|rm}}. | |||
* 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. | |||
* Options: | |||
** -f, --force | |||
**: Ignore non-existent and non-deletable files. | |||
|- | |||
| '''{{l/sub|save}}''' || [{{arg|OPTION}}...] {{arg|DESTINATION}} || Reads from standard input and saves the data to the given location. | |||
|- | |||
| '''{{l/sub|set}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}} {{arg|ATTRIBUTE}} {{arg|VALUE}}... || Sets a file attribute on a file. | |||
|- | |||
| '''{{l/sub|trash}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Sends files or directories to the ‘Trashcan’ or restore them from ‘Trashcan’. | |||
|- | |||
| '''{{l/sub|tree}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Lists the contents of the given locations recursively, in a tree-like format; similar to {{l/cmd|tree}}. | |||
* Options: | |||
** -h, --hidden | |||
**: Show hidden files. | |||
** -l, --follow-symlinks | |||
**: Follow symbolic links. | |||
|} | |} | ||
Latest revision as of 23:52, 2 January 2024
About
gio is a command line interface to the GIO subsystem.
Commands
| subcommand | argument(s) | purpose |
|---|---|---|
| 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. |
| copy | [<OPTION>...] <SOURCE>... <DESTINATION> | Copies one or more files from <SOURCE> to <DESTINATION>; similar to cp. |
| info | [<OPTION>...] <LOCATION>... | Shows information about the given locations; similar to ls. |
| launch | <DESKTOP-FILE> [<FILE-ARG>...] | Launch a desktop file from any location given.
|
| list | [<OPTION>...] [<LOCATION>...] | Lists the contents of the given locations; similar to ls. |
| mime | <MIMETYPE> [<HANDLER>] |
|
| mkdir | [<OPTION>...] <LOCATION>... | Creates directories; similar to mkdir.
|
| monitor | [<OPTION>...] [<LOCATION>...] | Monitors files or directories for changes |
| mount | [<OPTION>...] [<LOCATION>...] | Provides commandline access to various aspects of GIO’s mounting functionality. |
| move | [<OPTION>...] <SOURCE>... <DESTINATION> | Moves one or more files from SOURCE to DESTINATION; similar to mv. |
| open | [<file> or <URL>] | Opens files with the default application that is registered to handle files of this type; related to xdg-open.
|
| rename | <LOCATION> <NAME> | Renames a file; similar to rename. |
| remove | [<OPTION>...] <LOCATION>... | Deletes each given file; similar to rm.
|
| save | [<OPTION>...] <DESTINATION> | Reads from standard input and saves the data to the given location. |
| set | [<OPTION>...] <LOCATION> <ATTRIBUTE> <VALUE>... | Sets a file attribute on a file. |
| trash | [<OPTION>...] [<LOCATION>...] | Sends files or directories to the ‘Trashcan’ or restore them from ‘Trashcan’. |
| tree | [<OPTION>...] [<LOCATION>...] | Lists the contents of the given locations recursively, in a tree-like format; similar to tree.
|
