Difference between revisions of "cmd/gio"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
< cmd
Jump to navigation Jump to search
(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 (incomplete listing):
+
==Commands==
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! subcommand || argument(s) || purpose
 
! subcommand || argument(s) || purpose
 
|-
 
|-
−
| '''{{l/sub|open}}''' || [{{arg|file}} or {{arg|URL}}] || opens files and URLs using the default applications as specified by the user's desktop environment
+
| '''{{l/sub|help}}''' || [{{arg|COMMAND}}] || Displays a short synopsis of the available commands or provides detailed help on a specific command.
 
|-
 
|-
−
| '''{{l/sub|help}}''' || [COMMAND]
+
| '''{{l/sub|version}}''' || || Prints the GLib version to which gio belongs.
 
|-
 
|-
−
| '''{{l/sub|version}}''' ||  
+
| '''{{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|cat}}''' || LOCATION...
+
| '''{{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|copy}}''' || [OPTION...] SOURCE... DESTINATION
+
| '''{{l/sub|info}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Shows information about the given locations; similar to {{l/cmd|ls}}.
 
|-
 
|-
−
| '''{{l/sub|info}}''' || [OPTION...] LOCATION...
+
| '''{{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|launch}}''' || DESKTOP-FILE [FILE-ARG...]
+
| '''{{l/sub|list}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Lists the contents of the given locations; similar to {{l/cmd|ls}}.
 
|-
 
|-
−
| '''{{l/sub|list}}''' || [OPTION...] [LOCATION...]
+
| '''{{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|mime}}''' || MIMETYPE [HANDLER]
+
| '''{{l/sub|mkdir}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Creates directories; similar to {{l/cmd|mkdir}}.
 +
* Options:
 +
** -p, --parent
 +
**: Create parent directories when necessary.
 
|-
 
|-
−
| '''{{l/sub|mkdir}}''' || [OPTION...] LOCATION...
+
| '''{{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.
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>; 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.
  • 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.
list [<OPTION>...] [<LOCATION>...] Lists the contents of the given locations; similar to ls.
mime <MIMETYPE> [<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: org.gnome.gedit.desktop.
mkdir [<OPTION>...] <LOCATION>... Creates directories; similar to mkdir.
  • Options:
    • -p, --parent
      Create parent directories when necessary.
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.
  • GIO obtains this information from the shared-mime-info database, with per-user overrides stored in $XDG_DATA_HOME/applications/mimeapps.list.
  • 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.
rename <LOCATION> <NAME> Renames a file; similar to rename.
remove [<OPTION>...] <LOCATION>... Deletes each given file; similar to 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.
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.
  • Options:
    • -h, --hidden
      Show hidden files.
    • -l, --follow-symlinks
      Follow symbolic links.
Retrieved from "https://htyp.org/mw/index.php?title=cmd/gio&oldid=28883"